acl_get_fd()

Get the access control list associated with a file descriptor

Synopsis:

#include <sys/acl.h>

acl_t acl_get_fd( int fd );

Arguments:

fd: A file descriptor associated with the file whose ACL you want to get.

Library:

libc

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

Description:

The acl_get_fd() function gets the ACL of the object associated with the given file descriptor, puts it into working storage, and returns a pointer to that storage. When you're finished with the ACL, you should call acl_free() to release it.

Note: The ACL in working storage is independent of the file or directory's ACL. Changes that you make to the copy in working storage don't affect the file or directory's ACL.

Returns:

A pointer to the ACL in working storage, or NULL if an error occurred (errno is set).

Errors:

EBADF: The fd argument isn't a valid file descriptor.
ENOMEM: There wasn't enough memory available to create the ACL in working storage.

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