.TH ACCESS 2
.UC 4
.SH NAME
access \- determine a users permissions for a file.
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.B int access (const char *filename, int mode);
.fi
.SH DESCRIPTION
.B access()
returns weather a user can have permissions 
.I mode
on a given file.  If this succeeds, 0 is returned, if not,
.B  -EACCESS 
is returned.
.SH ERRORS
.B -EACCESS 
is returned if the user does not have permissions on the specified file.
.SH FILES
linux/fs/open.c, /usr/include/linux/sys.h, /usr/include/unistd.h
.SH SEE ALSO
stat(2)