Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

acl(2) OSS System Calls Reference Manual
For more information about restricted-access filesets and file privileges, see the Open System Ser-
vices Management and Operations Guide.
NOTES
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit applications or 64-bit OSS applications.
RETURN VALUES
Upon successful completion, the acl() function returns one of the following values, depending on
the value of the cmd parameter:
• For successful ACL_CNT or ACL_GET commands, the acl() function returns the
number of ACL entries.
• For successful ACL_SET commands, the acl( ) function returns a 0 (zero).
If the acl() function fails, the value -1 is returned and errno is set to indicate the error.
ERRORS
If any of these conditions occurs, the acl() function sets errno to the corresponding value:
[EACCES] The caller does not have access to a component of the pathname.
[EINVAL] One of these conditions occurred:
• The value of the cmd parameter is not ACL_GET, ACL_SET,or
ACL_CNT.
• The value of the cmd parameter is ACL_SET, and the value of the nen-
tries parameter is less than the number of mandatory ACL entries.
• The value of the cmd parameter is ACL_SET, and the ACL specified in
the aclbufp parameter is not valid.
[EIO] A disk I/O error occurred while attempting to store or retrieve the ACL
[EPERM] One of the following conditions exist:
• The value of the cmd parameter is ACL_SET, and the effective user ID
of the caller does not match the owner of the file or the super ID, and the
effective user ID or one of its group affiliations does not qualify the
caller for membership in the Safeguard SECURITY-OSS-
ADMINISTRATOR group.
• The program attempted an operation on a SEEP-protected fileset. Valid
for J06.15 and later J-series RVUs, and H06.26 and later H-series RVUs.
[ENOENT] A component of the path does not exist.
[ENOSPC] One of these conditions occurred:
• The value of the cmd parameter is ACL_GET, and the value of the nen-
tries parameter is less than the number of entries in the ACL for the file.
• The value of the cmd parameter is ACL_SET, and there is not enough
disk space to store the ACL.
• The value of the cmd parameter is ACL_SET, and nentries is greater
than the number of NACLENTRIES specfied in the acl.h header file.
1−12 Hewlett-Packard Company 527186-023