ACLTOSTR(3C)

NAME

acltostr − convert access control list (ACL) structure to string form

SYNOPSIS

#include <acllib.h>

char ∗ acltostr (nentries, acl, form)
intnentries;
structacl_entry acl[];
intform;

Remarks:

To ensure continued conformance with emerging industry standards, features described in this manual entry are likely to change in a future release.

DESCRIPTION

Acltostr converts an access control list from structure form to string representation. Acltostr takes a pointer to the first element of an array of ACL entries (acl), containing the indicated number (nentries) of valid entries (zero or more), and the output form desired (FORM_SHORT or FORM_LONG). 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 ACL_NSUSER and a group ID of ACL_NSGROUP are both represented by %. Like ls(1), if an entry contains any other user ID or group ID value not listed in /etc/passwd or /etc/group, acltostr returns a string equivalent of the ID number instead.

Like routines that manage the /etc/passwd file, acltostr truncates user and group names to eight characters.

Note: acltostr is complementary in function to strtoacl.

RETURN VALUE

If acltostr 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 NACLENTRIES (defined in <sys/acl.h>), or if form is an invalid value, the call returns (char ∗) NULL.

EXAMPLES

The following code fragment reads the ACL on file “/users/ggd/test” 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);

AUTHOR

Acltostr was developed by HP.

FILES

/etc/passwd
/etc/group

Museum

Related Articles