acl_to_text()

Convert an access control list (ACL) into text

Synopsis:

#include <sys/acl.h>

char *acl_to_text( acl_t acl,
                   ssize_t *len_p );

Arguments:

acl: A pointer to the ACL that you want to convert into text.
len_p: NULL, or a pointer to a location where the function can store the length of the string (not including the terminating null character).

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The acl_to_text() function converts an access control list into the long text form:

tag_type:qualifier:permissions

The tag_type is user, group, other, or mask, the qualifier is the name or numeric ID of a user or group, and the permissions are in the form rwx, with a hyphen (-) replacing any permissions that aren't granted.

When you're finished with the text form of the ACL, you should call acl_free() to release it.

Returns:

A pointer to the text form of the ACL, or NULL if an error occurred (errno is set).

Errors:

EINVAL: The acl argument doesn't point to a valid ACL, or the ACL contains some improperly formed entries or otherwise can't be converted.
ENOMEM: There wasn't enough memory available to allocate for the string.

Classification:

QNX Neutrino

This function is based on the withdrawn POSIX draft P1003.1e.

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	No
Thread	Yes