ACL_FROM_MODE
Section: C Library Functions (3)
Index
Return to Main Contents
BSD mandoc
Linux ACL
NAME
acl_from_mode
- create an ACL from file permission bits
LIBRARY
Linux Access Control Lists library (libacl, -lacl).
SYNOPSIS
In sys/types.h
In acl/libacl.h
Ft acl_t
Fn acl_from_mode mode_t mode
DESCRIPTION
The
Fn acl_from_mode
function creates a minimal ACL that contains the three entries with tag
types ACL_USER_OBJ, ACL_GROUP_OBJ, and ACL_OTHER, with permissions
corresponding to the owner, group, and other permission bits of its
argument
mode
RETURN VALUE
On success, this function returns a pointer to the
working storage. On error, a value of
(acl_t)NULL
is returned, and
errno
is set appropriately.
ERRORS
If any of the following conditions occur, the
Fn acl_from_mode
function returns a value of
(acl_t)NULL
and sets
errno
to the corresponding value:
- Bq Er ENOMEM
-
The ACL working storage requires more memory than is allowed by the
hardware or system-imposed memory management constraints.
STANDARDS
This is a non-portable, Linux specific extension to the ACL manipulation
functions defined in IEEE Std 1003.1e draft 17 (lqPOSIX.1erq, abandoned).
SEE ALSO
acl_equiv_mode3,
acl_get_file3,
acl(5)
AUTHOR
Written by
An Andreas Gruenbacher Aq a.gruenbacher@bestbits.at .