ACL\_FROM\_MODE(3) Library Functions Manual ACL\_FROM\_MODE(3)

# [NAME](#NAME)

`acl_from_mode` — create an ACL from file permission bits

# [LIBRARY](#LIBRARY)

Linux Access Control Lists library (libacl, -lacl).

# [SYNOPSIS](#SYNOPSIS)

`#include <sys/types.h>`  
`#include <acl/libacl.h>`

`acl_t`  
`acl_from_mode`(`mode_t mode`);

# [DESCRIPTION](#DESCRIPTION)

The [`acl_from_mode`](#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](#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](#ERRORS)

If any of the following conditions occur, the `acl_from_mode`() function returns a value of `(acl_t)NULL` and sets `errno` to the corresponding value:

\[[`ENOMEM`](#ENOMEM)]

The ACL working storage requires more memory than is allowed by the hardware or system-imposed memory management constraints.

# [STANDARDS](#STANDARDS)

This is a non-portable, Linux specific extension to the ACL manipulation functions defined in IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned).

# [SEE ALSO](#SEE_ALSO)

[acl\_equiv\_mode(3)](/man/os/acl/acl_equiv_mode.3), [acl\_get\_file(3)](/man/os/acl/acl_get_file.3), [acl(5)](/man/os/acl/acl.5)

# [AUTHOR](#AUTHOR)

Written by Andreas Gruenbacher ⟨andreas.gruenbacher@gmail.com⟩.

March 23, 2002 Linux ACL

---

Document: acl_from_mode(3) from acl 2.4.0-r3 (Chainguard OS)
Source: https://git.savannah.nongnu.org/git/acl.git