vnop_setacl Entry Point

Purpose

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

Syntax

#include <sys/acl.h>

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

Description

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

Parameters

Item Description
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.

Execution Environment

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

Return Values

Item Description
0 Indicates success.

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

Item Description
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.