acl_from_mode (3)

Leading comments

Access Control Lists manual pages

(C) 2002 Andreas Gruenbacher, <a.gruenbacher@bestbits.at>

This is free documentation; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.

The GNU General Public License's references to "object code"
and "executables" are to be interpreted as the output of any
document formatting or typesetting system, ...

(The comments found at the beginning of the groff file "man3/acl_from_mode.3".)

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 .