acltostr(3C)acltostr(3C)NAMEacltostr() - convert access control list (ACL) structure to string form
(HFS File Systems only)
To ensure continued conformance with emerging industry standards, fea‐
tures described in this manual entry are likely to change in a future
converts an access control list from structure form to string represen‐
tation. 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 con‐
tains newline characters.
A user ID of and a group ID of are both represented by As with the com‐
mand (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
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 nen‐
tries 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 nen‐
tries 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 too short.
length is less than or equal zero.
The following code fragment reads the ACL on file and prints its short-
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 sys‐
was developed by HP.
FILESSEE ALSOgetacl(2), setacl(2), cpacl(3C), chownacl(3C), setaclentry(3C), str‐
toacl(3C), acl(5), thread_safety(5).