acl_delete_entry() — Delete an extended ACL entry from the ACL

Standards

Format

#define _OPEN_SYS	1
#include <sys/acl.h>

int acl_delete_entry(lacl_t acl_d, acl_entry_t entry_d);

General description

Use access control lists (ACLs) in conjunction with permission bits to control access to files and directories. Currently, ACLs are supported by the HFS, TFS, and zFS file systems. You must know whether your security product supports ACLs and what rules are used when determining file access. See z/OS UNIX System Services Planning for details.

The acl_delete_entry() function removes the extended ACL entry indicated by entry_d in the ACL pointed to by argument acl_d. The first call to acl_get_entry() following the call to acl_delete_entry() will obtain the first extended ACL entry in the ACL, as ordered by the system.

Returned value

Upon successful completion, the function returns a value of zero.

If any of the following conditions occur, the acl_delete_entry() function returns -1 and sets errno to the corresponding value:

Error Code

Description

EINVAL

Argument acl_d does not point to a pointer to an ACL structure. Argument entry_d does not point to a valid extended ACL entry or not within the given ACL structure.

Related information

• sys/acl.h