NAME    [Toc]    [Back]

     vaccess - check access permissions based on vnode parameters

SYNOPSIS    [Toc]    [Back]

     #include <sys/param.h>
     #include <sys/vnode.h>

     int
     vaccess(mode_t  file_mode,  uid_t  uid,  gid_t  gid,  mode_t
acc_mode,
             struct ucred *cred);

DESCRIPTION    [Toc]    [Back]

     The vaccess() function checks if the  credentials  described
in cred are
     sufficient  to  perform the operation described by acc_mode,
based on the
     file_mode, uid, and gid arguments.   These  arguments  would
typically be
     based on the vnode being accessed.

     file_mode is the current mode of the file that is having access checked.
     The uid and gid arguments are the user id and group id  representing the
     owner  of  the  file.   acc_mode describes the operation desired.  It should
     be one of VREAD, VWRITE, or VEXEC representing read,  write,
and execute,
     respectively.

RETURN VALUES    [Toc]    [Back]

     vaccess() will return 0 on success, or a non-zero error value on failure.

ERRORS    [Toc]    [Back]

     [EACCES]      Permission denied.  An attempt was made to access a file in
                   a  way  forbidden  by  its file access permissions.

SEE ALSO    [Toc]    [Back]

     vnode(9)

HISTORY    [Toc]    [Back]

     This man page was originally written by  Robert  Watson  for
FreeBSD.  It
     was  modified to represent the OpenBSD implementation by Peter Werner.

OpenBSD     3.6                        February     18,      2002