Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for acl_equiv_mode (redhat section 3)

ACL_EQUIV_MODE(3)			     BSD Library Functions Manual			    ACL_EQUIV_MODE(3)

NAME
acl_equiv_mode -- check for an equivalent ACL
LIBRARY
Linux Access Control Lists library (libacl, -lacl).
SYNOPSIS
#include <sys/types.h> #include <acl/libacl.h> int acl_equiv_mode(acl_t acl, mode_t *mode_p);
DESCRIPTION
The acl_equiv_mode() function checks if the ACL pointed to by the argument acl contains only the required ACL entries of tag types ACL_USER_OBJ, ACL_GROUP_OBJ, and ACL_OTHER, and contains no permissions other that ACL_READ, ACL_WRITE or ACL_EXECUTE. If the ACL has this form, it can can be fully represented with the tradi- tional file permission bits, and is considered equivalent with the traditional file permission bits. If acl is an equivalent ACL and the pointer mode_p is not NULL, the value pointed to by mode_p is set to the value that defines the same owner, group and other permissions as contained in the ACL.
RETURN VALUE
Upon successful completion, this function returns the value 0 if acl is an equivalent ACL, and the value 1 if acl is not an equivalent ACL. Otherwise, the value -1 is returned, and errno is set to indicate the error.
ERRORS
If any of the following conditions occur, the acl_equiv_mode() function returns the value -1 and sets errno to the corresponding value: [EINVAL] The argument acl is not a valid pointer to an ACL.
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
acl_from_mode(3), acl(5)
AUTHOR
Written by Andreas Gruenbacher <a.gruenbacher@computer.org>. Linux ACL March 23, 2002 Linux ACL


All times are GMT -4. The time now is 04:35 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password