ACCESS(2-POSIX)     RISC/os Reference Manual      ACCESS(2-POSIX)



NAME
     access - determine accessibility of a file

SYNOPSIS
     int access (path, amode)
     char *path;
     int amode;

DESCRIPTION
     path points to a path name naming a file.  access checks the
     named file for accessibility according to the bit pattern
     contained in amode, using the real user ID in place of the
     effective user ID and the real group ID in place of the
     effective group ID. The value of amode is either the bitwise
     OR of the access permissions to be checked or the existence
     test, and is constructed from the following:

         Constant            Description
         ROK                Test for read permission.
         WOK                Test for write permission.
         XOK                Test for execute (search) permission.
         FOK                Test for existence of a file.

ERRORS
     Access to the file is denied if one or more of the following
     are true:

     [EINVAL]            amode is invalid.

     [ENOTDIR]           A component of the path prefix is not a
                         directory.

     [ENOENT]            Read, write, or execute (search) permis-
                         sion is requested for a null path name,
                         or path points to an empty string.

     [ENOENT]            The named file does not exist.

     [EACCES]            Search permission is denied on a com-
                         ponent of the path prefix.

     [EACCES]            Permission bits of the file mode do not
                         permit the requested access.

     [EROFS]             Write access is requested for a file on
                         a read-only file system.

     [ETXTBSY]           Write access is requested for a pure
                         procedure(shared text) file that is
                         being executed.

     [EFAULT]            path points outside the allocated



                         Printed 1/15/91                   Page 1

ACCESS(2-POSIX)     RISC/os Reference Manual      ACCESS(2-POSIX)



                         address space for the process.

     [EINTR]             A signal was caught during the access
                         system call.

     [ENAMETOOLONG]      The length of path exceeds {PATH_MAX},
                         or a pathname component is longer than
                         {NAME_MAX} while {_POSIX_NO_TRUNC) is in
                         effect.

     The owner of a file has permission checked with respect to
     the ``owner'' read, write, and execute mode bits.  Members
     of the file's group other than the owner have permissions
     checked with respect to the ``group'' mode bits, and all
     others have permissions checked with respect to the
     ``other'' mode bits.

SEE ALSO
     chmod(2), stat(2).

DIAGNOSTICS
     If the requested access is permitted, a value of 0 is
     returned.  Otherwise, a value of -1 is returned and errno is
     set to indicate the error.































 Page 2                  Printed 1/15/91