Content-type: text/html Man page of acl_get_fd

acl_get_fd

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

acl_get_fd - Retrieves the specified ACL associated with the specified object  

LIBRARY

Security Library (libpacl.a)  

SYNOPSIS

#include <sys/acl.h>

acl_t acl_get_fd(        int fd);
       acl_type_t type_d);
 

PARAMETERS

Designates the file descriptor of the object to retrieve the working storage internal representation copy of the ACL from. Designates the type of ACL to retrieve: ACL_TYPE_ACCESS, ACL_TYPE_DEFAULT, or ACL_TYPE_DEFAULT_DIR.  

DESCRIPTION

NOTE: This function is based on Draft 13 of the POSIX P1003.6 standard. The function may change as the P1003.6 standard is finalized.

The acl_get_fd() function retrieves an ACL for the given descriptor. The acl_tag_t field designates if the ACL being retrieved is an access or default ACL. Working storage is allocated as needed.  

RETURN VALUES

Upon successful completion, the acl_get_fd() function returns a pointer to the working storage internal representation copy of the ACL. Otherwise, a value of NULL is returned and errno is set to indicate the error.  

ERRORS

If any of the following conditions occur, the acl_get_fd() function sets errno to the corresponding value:

The required access to the file was denied. The fd argument is not a valid file descriptor. The argument type_d is not a recognized ACL type. There is not enough memory available to the process to allocate the working storage. The argument type_d indicates a default ACL, and fd does not point to a directory object.  

RELATED INFORMATION

acl_get_file(3), acl_set_file(3), acl_set_fd(3),

Security delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:34 GMT, October 02, 2010