Ausam/doc/man/man2/access.2

Find at most related files.
including files from this version of Unix. 
.th ACCESS II 29/6/88
.sh NAME
access \*- get access permission on file
.sh SYNOPSIS
(access = 33.; not in assembler)
.br
.ft B
sys access; name; mode
.s3
access(name, mode)
.br
char *name;
.br
int mode;
.ft R
.sh DESCRIPTION
.it Name
points to a null-terminated string naming
a file;
.it mode
specifies the type of access required,
and can be formed by any combination of the following:
.lp 20 +8
04	read permission
.lp 20 +8
02	write permission
.lp 20 +8
01	execute permission
.i0
.s3
It is unnecessary to have any
permissions at all with respect to the file, but all directories
leading to the file must be searchable.
.sh "SEE ALSO"
ls (I), stat (II), fs (V)
.sh DIAGNOSTICS
Error bit (c-bit)
is set if access is denied.
From C, a \*-1 return indicates access denied.