unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (v7man)
Page:
Section:
Apropos / Subsearch:
optional field

ACCESS(2)                     System Calls Manual                    ACCESS(2)



NAME
       access - determine accessibility of file

SYNOPSIS
       access(name, mode)
       char *name;

DESCRIPTION
       Access  checks the given file name for accessibility according to mode,
       which is 4 (read), 2 (write) or 1 (execute) or a  combination  thereof.
       Specifying mode 0 tests whether the directories leading to the file can
       be searched and the file exists.

       An appropriate error indication is returned if name cannot be found  or
       if any of the desired access modes would not be granted.  On disallowed
       accesses -1 is returned and the error code is in errno.  0 is  returned
       from successful tests.

       The  user and group IDs with respect to which permission is checked are
       the real UID and GID of the process, so this call is useful to  set-UID
       programs.

       Notice  that  it is only access bits that are checked.  A directory may
       be announced as writable by access, but an attempt to open it for writ-
       ing  will  fail  (although files may be created there); a file may look
       executable, but exec will fail unless it is in proper format.

SEE ALSO
       stat(2)

ASSEMBLER
       (access = 33.)
       sys access; name; mode



                                                                     ACCESS(2)