HP 3000 Manuals

access [ HP C/iX Library Reference Manual ] MPE/iX 5.0 Documentation


HP C/iX Library Reference Manual

access 

Determines the accessibility of a file.

Syntax 

     #include <unistd.h>
     int access (char *fname, int amode);

Parameters 

fname         A pointer to a character string containing a file name.

amode         An integer indicating whether read or write access to a
              file is requested.

Return Values 

0             Requested access is permitted.

-1            Requested access is denied; errno is set to one of the
              following values:

              ENOENT        Read, write, or execute (search) permission
                            is requested for a null path name, or the
                            named file does not exist.
              EACCES        The requested access is denied.
              ESYSERR       A call to a system intrinsic failed.

Description 

The access function checks for read or read/write access for the file
referenced by fname.  The bit pattern contained in amode is constructed
as follows:

04            Read access
02            Write access

Other values of amode are not supported.
[REV BEG]

The access function is not supported in the POSIX/iX library.  If called,
access() returns a -1 and sets errno to ENOSYS.[REV END]



MPE/iX 5.0 Documentation