vn_getacl Entry Point

Kernel and Subsystems Technical Reference, Volume 1

vn_getacl Entry Point

Purpose

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

Syntax

#include <sys/acl.h>
 
int vn_getacl (vp, uiop, crp)
struct vnode *vp;
struct uio *uiop;
struct ucred *crp;

Description

The vn_getacl entry point is used by the logical file system to retrieve the access control list (ACL) for a file to implement the getacl subroutine.

Parameters

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

Execution Environment

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

Return Values

0	Indicates a successful operation.

Nonzero return values are returned from the /usr/include/sys/errno.h file to indicate failure. A valid value includes:

ENOSPC

Indicates that the buffer size specified in the uiop parameter was not large enough to hold the ACL. If this is the case, the first word of the user buffer (data in the uio structure specified by the uiop parameter) is set to the appropriate size.

Related Information

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

The uio structure.

Virtual File System Overview, Virtual File System Kernel Extensions Overview, Logical File System Overview, Understanding Virtual Nodes (V-nodes) in AIX Kernel Extensions and Device Support Programming Concepts.