vn_setacl Entry Point

AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1

Sets the access control list (ACL) for a file.

#include <sys/acl.h>

int vn_setacl (vp, uiop, crp)
struct vnode *vp;
struct uio *uiop;
struct ucred *crp;

vp	Specifies the virtual node (v-node) of the file system object.
uiop	Specifies the uio structure that defines the storage for the call arguments.
crp	Points to the cred structure. This structure contains data that the file system can use to validate access permission.

The vn_setacl entry point is used by the logical file system to set the access control list (ACL) on a file.

The vn_setacl entry point can be called from the process environment only.

0	Indicates success.

Nonzero return values are returned from the /usr/include/sys/errno.h file to indicate failure. Valid values include:

ENOSPC	Indicates that the space cannot be allocated to hold the new ACL information.
EPERM	Indicates that the effective user ID of the process is not the owner of the file and the process is not privileged.

The uio structure.

The chacl subroutine, chown subroutine, chmod subroutine, statacl subroutine.