acl_set_qualifier(3)

acl_set_qualifier3

Set acl tag qualifier

Usage

#include <sys/types.h>

#include <sys/acl.h>

int

acl_set_qualifier(acl_entry_t entry_d, const void *tag_qualifier_p);

Library

Standard C Library (libc, -lc)

Overview

The acl_set_qualifier() function is a POSIX.1e call that sets the qualifier of the tag for the ACL entry entry_d to the value referred to by tag_qualifier_p.

Return values

The acl_set_qualifier() 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_set_qualifier() function fails if:

[EINVAL]

Argument entry_d is not a valid descriptor for an ACL entry. The tag type of the ACL entry entry_d is not ACL_USER or ACL_GROUP. The value pointed to by tag_qualifier_p is not valid.

[ENOMEM]

The value to be returned requires more memory than is allowed by the hardware or system-imposed memory management constraints.

Releases

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

  1. 5.0
  2. 5.1–5.2.1
  3. 5.3–6.3
  4. 6.4
  5. 7.0
  6. 7.1
  7. 7.2
  8. 7.3
  9. 7.4
  10. 8.0
  11. 8.1
  12. 8.2
  13. 8.3
  14. 8.4
  15. 9.0
  16. 9.1
  17. 9.2
  18. 9.3
  19. 10.0
  20. 10.1
  21. 10.2
  22. 10.3
  23. 10.4
  24. 11.0
  25. 11.1
  26. 11.2
  27. 11.3
  28. 11.4
  29. 12.0
  30. 12.1
  31. 12.2
  32. 12.3
  33. 12.4
  34. 13.0–13.2
  35. 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_get_qualifier() function was added in FreeBSD 5.0.

Authors

The acl_get_qualifier() 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.