Content-type: text/html Man page of acl_get_file

acl_get_file

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

NAME

acl_get_file - Given the pathname to an object, retrieve the designated ACL  

LIBRARY

Security Library (libpacl.a)  

SYNOPSIS

#include <sys/acl.h>

acl_t "acl_get_file(        char *path_p);
       acl_type_t type_d);
 

PARAMETERS

Designates the pathname to retrieve 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_file() function retrieves the designated ACL via a pathname. The type of ACL being retrieved is designated in acl_type_t. Working system storage is allocated as needed.  

RETURN VALUES

Upon successful completion, the acl_get_file() 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_file() function sets errno to the corresponding value:

The required access to the file was denied. The type_d argument is not a recognized ACL type. The path name is longer then allowed. The object does not exist. There is not enough memory available to the process to allocate the working storage. The argument type_d indicates a default ACL, and path_p does not point to a directory object.  

RELATED INFORMATION

acl_set_file(3), acl_get_entry(3), acl_get_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:31 GMT, October 02, 2010