acl_to_text()
QNX SDP8.0C Library ReferenceAPIDeveloper
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:
This function is based on the withdrawn POSIX draft P1003.1e.
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | No |
| Thread | Yes |
Page updated: