NAME

       acl_size — get the size of the external representation of an ACL

LIBRARY

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

SYNOPSIS

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

       ssize_t
       acl_size(acl_t acl);

DESCRIPTION

       The  acl_size()  function  return  the  size,  in  bytes,  of the buffer required to hold the exportable,
       contiguous, persistent form of the ACL pointed to by the argument acl, when converted by acl_copy_ext().

       Any existing ACL entry descriptors that refer to entries in acl continue to refer to  the  same  entries.
       Any  existing  ACL  pointers  that  refer to the ACL referred to by acl continue to refer to the ACL. The
       order of ACL entries within acl remains unchanged.

RETURN VALUE

       On success, the acl_size() function returns the size in bytes of the contiguous, persistent form  of  the
       ACL. On error, a value of (ssize_t)-1 is returned and errno is set appropriately.

ERRORS

       If any of the following conditions occur, the acl_size() function returns a value of (ssize_t)-1 and sets
       errno to the corresponding value:

       [EINVAL]           The argument acl is not a valid pointer to an ACL.

STANDARDS

       IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)

SEE ALSO

       acl_copy_ext(3), acl(5)

AUTHOR

       Derived from the FreeBSD manual pages written by Robert N M Watson <rwatson@FreeBSD.org>, and adapted for
       Linux by Andreas Gruenbacher <andreas.gruenbacher@gmail.com>.

Linux ACL                                        March 23, 2002                                      ACL_SIZE(3)