acl_set_fd(3) Library Functions Manual acl_set_fd(3)NAME
acl_set_fd - Sets the ACL on the file or directory designated by the file descriptor
LIBRARY
Security Library (libpacl.a)
SYNOPSIS
#include <sys/acl.h>
int acl_set_fd( int fd; acl_type_t type_d; acl_t acl_d);
PARAMETERS
Refers to the open file descriptor of the file or directory to set the ACL on. Designates the type of ACL to set: ACL_TYPE_ACCESS,
ACL_TYPE_DEFAULT, or ACL_TYPE_DEFAULT_DIR. Working storage internal representation of the ACL that is being set.
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 standard.
Given a file descriptor to a file or directory, the acl_set_fd() function sets the designated ACL. The type of ACL being set is determined
by the type_d parameter. If acl_d is NULL then the designated ACL is removed from the designated file or directory. The entry pointer used
by the acl_get_entry() function becomes undefined after a call to the acl_set_fd() function.
RETURN VALUES
Upon successful completion, the acl_set_fd() function returns a value of 0 (zero). Otherwise, a value of -1 is returned and errno is set
to indicate the error.
ERRORS
If any of the following conditions occur, the acl_set_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 acl_d argument does not contain a valid
ACL.
Argument type_d does not contain a valid ACL type number. The directory or file system that would contain the new ACL cannot be extended
or the file system is out of file allocation resources. The argument type_d indicates a default ACL, and fd does not point to a directory.
The designated file or directory resides on a file system that does not support ACLs. The process does not have the appropriate permis-
sions to perform the operation.
The setting and changing of ACLs have been disabled by the system administrator. The designated file or directory resides on a read-only
file system.
RELATED INFORMATION acl_get_fd(3), acl_valid(3), acl_set_file(3)
Security delim off
acl_set_fd(3)
Check Out this Related Man Page
ACL_GET_ENTRY(3) BSD Library Functions Manual ACL_GET_ENTRY(3)NAME
acl_get_entry -- retrieve an ACL entry from an ACL
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/types.h>
#include <sys/acl.h>
int
acl_get_entry(acl_t acl, int entry_id, acl_entry_t *entry_p);
DESCRIPTION
The acl_get_entry() function is a POSIX.1e call that retrieves a descriptor for an ACL entry specified by the argument entry_d within the ACL
indicated by the argument acl.
If the value of entry_id is ACL_FIRST_ENTRY, then the function will return in entry_p a descriptor for the first ACL entry within acl. If a
call is made to acl_get_entry() with entry_id set to ACL_NEXT_ENTRY when there has not been either an initial successful call to
acl_get_entry(), or a previous successful call to acl_create_entry(), acl_delete_entry(), acl_dup(), acl_from_text(), acl_get_fd(),
acl_get_file(), acl_set_fd(), acl_set_file(), or acl_valid(), then the result is unspecified.
RETURN VALUES
If the acl_get_entry() function successfully obtains an ACL entry, a value of 1 is returned. If the ACL has no ACL entries, the
acl_get_entry() returns a value of 0. If the value of entry_id is ACL_NEXT_ENTRY and the last ACL entry in the ACL has already been returned
by a previous call to acl_get_entry(), a value of 0 will be returned until a successful call with entry_id of ACL_FIRST_ENTRY is made. Oth-
erwise, a value of -1 will be returned and the global variable errno will be set to indicate the error.
ERRORS
The acl_get_entry() fails if:
[EINVAL] Argument acl does not point to a valid ACL. Argument entry_id is neither ACL_FIRST_ENTRY nor ACL_NEXT_ENTRY.
SEE ALSO acl(3), acl_calc_mask(3), acl_create_entry(3), acl_delete_entry(3), acl_dup(3), acl_from_text(3), acl_get_fd(3), acl_get_file(3),
acl_init(3), acl_set_fd(3), acl_set_file(3), acl_valid(3), posix1e(3)STANDARDS
POSIX.1e is described in IEEE POSIX.1e draft 17.
HISTORY
POSIX.1e support was introduced in FreeBSD 4.0. The acl_get_entry() function was added in FreeBSD 5.0.
AUTHORS
The acl_get_entry() function was written by Chris D. Faulhaber <jedgar@fxp.org>.
BSD April 13, 2001 BSD