Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

PXFACCESS

POSIX Subroutine: Determines the accessibility of a file.

Module

USE IFPOSIX

CALL PXFACCESS (path,ilen,iamode,ierror)

path

(Input) Character. The name of the file.

ilen

(Input) INTEGER(4). The length of the path string.

iamode

(Input) INTEGER(4). One or more of the following:

0

Checks for existence of the file.

11

Checks for execute permission.

2

Checks for write access.

4

Checks for read access.

6

Checks for read/write access.

1Linux* only

ierror

(Output) INTEGER(4). The error status.

If access is permitted, the result value is zero; otherwise, an error code. Possible error codes are:

  • -1: A bad parameter was passed.

  • ENOENT: The named directory does not exist.

  • EACCES: Access requested was denied.

On Windows* systems, if the name given is a directory name, the function only checks for existence. All directories have read/write access on Windows systems.