*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> access (2)              



NAME    [Toc]    [Back]

       access - Determines the accessibility of a file

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       int access(
               const char *path,
               int access_mode );

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       access(): XSH4.0, XSH4.2, XSH5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Points  to  the  file  pathname.  When  the path parameter
       refers to a symbolic link, the access()  function  returns
       information  about  the  file  pointed  to by the symbolic

              Permission to access all  components  of  the  path
              parameter  is  determined  by  using a real user ID
              instead of an effective user ID, and a group access
              list  (including  a  real  group  ID) instead of an
              effective group ID.  Specifies the type of  access.
              The bit pattern contained in the access_mode parameter
 is constructed by a logical OR of the  following
  values:  Checks read permission.  Checks write
              permission.  Checks  execute  (search)  permission.
              Checks to see if the file exists.

DESCRIPTION    [Toc]    [Back]

       The access() function checks for accessibility of the file
       specified by a pathname.

       Only access bits are checked. A directory may be indicated
       as  writable  by  access(),  but an attempt to open it for
       writing will fail (although files may be created there); a
       file's access bits may indicate that it is executable, but
       the execve() function can fail if the file does  not  contain
 the proper format.

NOTES    [Toc]    [Back]

       The  access()  function  is  supported  for multi-threaded

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the access() function  returns
       value  of  0  (zero). Otherwise, a value of -1 is returned
       and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       If the access() function fails, access to the file  specified
  by the path parameter is denied and errno may be set
       to one of the following values:  Permission  bits  of  the
       file  mode  do  not permit the requested access, or search
       permission is denied on a component of  the  path  prefix.
       The owner of a file has permission checked with respect to
       the ``user'' read, write, and execute mode  bits,  members
       of  the  file's group other than the owner have permission
       checked with respect to the ``group'' mode bits,  and  all
       others  have  permissions  checked  with  respect  to  the
       ``other'' mode bits.  The path  parameter  points  outside
       the  allocated  address  space  of  the  process.   [Tru64
       UNIX]  The pathname contains a character  with  the  highorder
  bit set.  [Tru64 UNIX]  An I/O error occurred while
       reading from or writing to the file system.  Too many symbolic
  links were encountered in translating the pathname.
       A component of a pathname exceeded PATH_MAX characters, or
       an  entire  pathname  exceeded  NAME_MAX  characters.  The
       named file does not exist or is an empty string.  A component
  of the path prefix is not a directory.  Write access
       is requested for a file on a read-only file system.

SEE ALSO    [Toc]    [Back]

       Functions: chmod(2), stat(2) eaccess(3)

       Standards: standards(5)

[ Back ]
 Similar pages
Name OS Title
access HP-UX determine accessibility of a file
access FreeBSD check accessibility of a file
eaccess FreeBSD check accessibility of a file
access IRIX determine accessibility of a file
pxfaccess IRIX Checks the accessibility of a named file
jfile Tru64 Determines file type
file Tru64 Determines file type
cd_type Tru64 determines the type of file system recorded on a
sizeof_proplist_entry Tru64 determines space necessary to store an Extended File Attribute
pxfisatty IRIX Determines if file descriptor corresponds to a valid file descriptor
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service