VACCESS(9) | Kernel Developer's Manual | VACCESS(9)

# NAME

`vaccess` — check access permissions based on vnode parameters

# SYNOPSIS

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

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

# DESCRIPTION

The `vaccess`() function checks if the credentials described in cred are sufficient to perform the operation described by acc_mode, based on the type, 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

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

# ERRORS

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

# SEE ALSO

vnode(9)

# HISTORY

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

June 4, 2013 | Debian