acl_copy_entry(3)

acl_copy_entry3

Copy an acl entry to another acl entry

Usage

#include <sys/types.h>

#include <sys/acl.h>

int

acl_copy_entry(acl_entry_t dest_d, acl_entry_t src_d);

Library

Standard C Library (libc, -lc)

Overview

The acl_copy_entry() function is a POSIX.1e call that copies the contents of ACL entry src_d to ACL entry dest_d.

Return values

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

Errors

The acl_copy_entry() function fails if:

[EINVAL]

Argument src_d or dest_d is not a valid descriptor for an ACL entry, or arguments src_d and dest_d reference the same ACL entry.

Releases

56 releases since FreeBSD 5.0-RELEASE; the text changed 33 times.

  1. 5.0
  2. 5.1–6.3
  3. 6.4
  4. 7.0
  5. 7.1
  6. 7.2
  7. 7.3
  8. 7.4
  9. 8.0
  10. 8.1
  11. 8.2
  12. 8.3
  13. 8.4
  14. 9.0
  15. 9.1
  16. 9.2
  17. 9.3
  18. 10.0
  19. 10.1
  20. 10.2
  21. 10.3
  22. 10.4
  23. 11.0
  24. 11.1
  25. 11.2
  26. 11.3
  27. 11.4
  28. 12.0
  29. 12.1
  30. 12.2
  31. 12.3
  32. 12.4
  33. 13.0–13.2
  34. 13.3–16.0

Standards

POSIX.1e is described in IEEE POSIX.1e draft 17.

History

POSIX.1e support was introduced in FreeBSD 4.0. The acl_copy_entry() function was added in FreeBSD 5.0.

Authors

The acl_copy_entry() function was written by Chris D. Faulhaber ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.