acl_update_entry() — Update the extended ACL entry

Standards

Format

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

int acl_update_entry(lacl_t acl_d, acl_entry_t entry_s, acl_entry_t entry_d
		 int version);

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_update_entry() function updates the extended ACL entry entry_s with the values from entry_d. The version tells the function the version of ACL entry. See sys/acl.h for ACL entry mapping.

Returned value

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

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

Error Code

Description

EINVAL

Argument entry_s or entry_d do not point to a valid extended ACL entry. Argument acl_d does not point to a valid ACL structure.

Related information

• sys/acl.h