Retrieves the access control list (ACL) for a file.
The vnop_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.
| 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 ACL. |
| crp | Points to the cred structure. This structure contains data that the file system can use to validate access permission. |
The vnop_getacl entry point can be called from the process environment only.
| Item | Description |
|---|---|
| 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:
| Item | Description |
|---|---|
| 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. |
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® Version 7.1 Kernel Extensions and Device Support Programming Concepts.