acl_copy_ext()

Copy an ACL from system space to user space

Synopsis:

#include <sys/acl.h>

ssize_t acl_copy_ext( void *buf_p,
                      acl_t acl,
                      ssize_t size );

Arguments:

buf_p
A pointer to the buffer that you want to copy the ACL into.
acl
The ACL that you want to copy.
size
The size of the buffer pointed to by buf_p, in bytes.

Library:

libc

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

Description:

The acl_copy_ext() function copies an access control list from system-managed space to the user-managed buffer pointed to by buf_p. You can call acl_size() to determine the size of buffer needed.

Returns:

The number of bytes placed in the buffer, or -1 if an error occurred (errno is set).

Errors:

EINVAL
The size argument is smaller than the size of the contiguous, persistent form of the ACL, acl doesn't point to a valid ACL, or the ACL contains some improperly formed entries.

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