ACL_COPY_ENTRY(3)       BSD Library Functions Manual       ACL_COPY_ENTRY(3)

NAME         top

     acl_copy_entry — copy an ACL entry

LIBRARY         top

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

SYNOPSIS         top

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

     acl_copy_entry(acl_entry_t dest_d, acl_entry_t src_d);

DESCRIPTION         top

     The acl_copy_entry() function copies the contents of the ACL entry
     indicated by the src_d descriptor to the existing ACL entry indicated
     by the dest_d descriptor. The src_d and dest_d descriptors may refer to
     entries in different ACLs.

RETURN VALUE         top

     The acl_copy_entry() function returns the value 0 if successful; other‐
     wise the value -1 is returned and the global variable errno is set to
     indicate the error.

ERRORS         top

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

     [EINVAL]           The argument src_d or dest_d is not a valid descrip‐
                        tor for an ACL entry.

                        The arguments src_d and dest_d reference the same
                        ACL entry.

STANDARDS         top

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

SEE ALSO         top

     acl_get_entry(3), acl(5)

AUTHOR         top

     Derived from the FreeBSD manual pages written by Robert N M Watson
     <>, and adapted for Linux by Andreas Gruenbacher

COLOPHON         top

     This page is part of the acl (manipulating access control lists)
     project.  Information about the project can be found at  If you have a bug report for
     this manual page, see ⟨⟩.
     This page was obtained from the project's upstream Git repository
     ⟨git://⟩ on 2018-02-02.  (At that time,
     the date of the most recent commit that was found in the repository was
     2018-01-21.)  If you discover any rendering problems in this HTML ver‐
     sion of the page, or you believe there is a better or more up-to-date
     source for the page, or you have corrections or improvements to the
     information in this COLOPHON (which is not part of the original manual
     page), send a mail to

Linux ACL                      March 23, 2002                      Linux ACL