Unix/Linux Go Back    


CentOS 7.0 - man page for acl_equiv_mode (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


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 con-
     tains 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 traditional file permission bits, and is con-
     sidered 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 con-
     tained in the ACL.

RETURN VALUE
     On success, this function returns the value 0 if acl is an equivalent ACL, and the value 1
     if acl is not an equivalent ACL. On error, the value -1 is returned, and errno is set appro-
     priately.

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@bestbits.at>.

Linux ACL				  March 23, 2002				Linux ACL
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 10:51 PM.