access - Determines the accessibility of a file
int access (
const char *path,
int access_mode) ;
Interfaces documented on this reference page conform to industry standards as follows:
access(): XPG4, XPG4-UNIX
Refer to the standards(5) reference page for more information about industry standards and associated tags.
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 link.
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.
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.
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 ``owner'' 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 process' allocated address space. The pathname contains a character with the high-order bit set. 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.
Functions: chmod(2), stat(2)
Standards: standards(5) delim off