acltostr(3C)acltostr(3C)NAMEacltostr() - convert access control list (ACL) structure to string form
(HFS File Systems only)
SYNOPSIS
Obsolescent Interface
Remarks
To ensure continued conformance with emerging industry standards, fea‐
tures described in this manual entry are likely to change in a future
release.
DESCRIPTION
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
instead.
Just as in routines that manage the file, truncates user and group
names to eight characters.
Note: is complementary in function to
Obsolescent Interface
converts access control list (ACL) structure to string form.
RETURN VALUE
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.
ERRORS
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.
EXAMPLES
The following code fragment reads the ACL on file and prints its short-
form representation.
#include <stdio.h>
#include <acllib.h>
int nentries;
struct acl_entry acl [NACLENTRIES];
if ((nentries = getacl ("/users/ggd/test", NACLENTRIES, acl)) < 0)
error (...);
fputs (acltostr (nentries, acl, FORM_SHORT), stdout);
WARNINGS
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
DEPENDENCIES
is only supported on HFS file system on standard HP-UX operating sys‐
tem.
AUTHOR
was developed by HP.
FILESSEE ALSOgetacl(2), setacl(2), cpacl(3C), chownacl(3C), setaclentry(3C), str‐
toacl(3C), acl(5), thread_safety(5).
acltostr(3C)