acltostr() - convert access control list (ACL) structure to string form (HFS File Systems only)
To ensure continued conformance with emerging industry standards, features described in this manual entry are likely to change in a future
converts an access control list from structure form to string representation. takes a pointer to the first element of an array of ACL
entries containing the indicated number (nentries) of valid entries (zero or more), and the output form desired or It returns a pointer to
a static string (overwritten by the next call), which is a symbolic representation of the ACL, ending in a null character. The output
forms are described in acl(5). In long form, the string returned contains newline characters.
A user ID of and a group ID of are both represented by As with the command (see ls(1)), if an entry contains any other user ID or group ID
value not listed in or returns a string equivalent of the ID number instead.
Just as in routines that manage the file, truncates user and group names to eight characters.
Note: is complementary in function to
converts access control list (ACL) structure to string form.
If succeeds, it returns a pointer to a null-terminated string. If nentries is zero or less, the string is of zero length. If nentries is
greater than (defined in or if form is an invalid value, the call returns (char *) NULL .
If succeeds, it returns 0. If it fails, it returns -1 and sets If nentries is zero or less, the string is of zero length.
strbuf equals to NULL, or nentries is greater than (defined in or form is not one of the valid forms, or length of strbuf is
length is less than or equal zero.
The following code fragment reads the ACL on file and prints its short-form representation.
struct acl_entry acl [NACLENTRIES];
if ((nentries = getacl ("/users/ggd/test", NACLENTRIES, acl)) < 0)
fputs (acltostr (nentries, acl, FORM_SHORT), stdout);
The value returned by is a pointer into a buffer, the contents of which are overwritten by subsequent calls to by the same thread.
is an obsolescent interface supported only for compatibility with existing DCE applications. New multithreaded applications should use
is only supported on HFS file system on standard HP-UX operating system.
was developed by HP.
getacl(2), setacl(2), cpacl(3C), chownacl(3C), setaclentry(3C), strtoacl(3C), acl(5), thread_safety(5).