ACCESS(S)                XENIX System V                 ACCESS(S)



     Name
          access - Determines accessibility of a file.

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

     Description
          path points to a pathname 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 bit pattern for amode can be formed
          by adding any combination of the following:

               04   Read
               02   Write
               01   Execute (search)
               00   Check existence of file

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

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

               Read, write, or execute (search) permission is
               requested for a null pathname.  [ENOENT]

               The named file does not exist.  [ENOENT]

               Search permission is denied on a component of the path
               prefix.  [EACCES]

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

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

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

               path points outside the process' allocated address
               space.  [EFAULT]

          access checks the permissions for the owner of a file by
          checking the ``owner'' read, write, and execute mode bits.
          For members of the file's group, the ``group'' mode bits are
          checked.  For all others, the ``other'' mode bits are
          checked.



     Page 1                                           (printed 8/7/87)

     ACCESS(S)                XENIX System V                 ACCESS(S)



     Return Value
          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.

     See Also
          chmod(S), stat(S)

     Notes
          The super-user (root) may access any file, regardless of
          permission settings.












































     Page 2                                           (printed 8/7/87)