ACL\_SET\_QUALIFIER(3) Library Functions Manual ACL\_SET\_QUALIFIER(3)

# [NAME](#NAME)

`acl_set_qualifier` — set the qualifier of an ACL entry

# [LIBRARY](#LIBRARY)

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

# [SYNOPSIS](#SYNOPSIS)

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

`int`  
`acl_set_qualifier`(`acl_entry_t entry_d`, `const void *qualifier_p`);

# [DESCRIPTION](#DESCRIPTION)

The [`acl_set_qualifier`](#acl_set_qualifier)() function sets the qualifier of the ACL entry indicated by the argument `entry_d` to the value referred to by the argument `qualifier_p`. If the value of the tag type in the ACL entry referred to by `entry_d` is ACL\_USER, then the value referred to by `qualifier_p` shall be of type `uid_t`. If the value of the tag type in the ACL entry referred to by `entry_d` is ACL\_GROUP, then the value referred to by `qualifier_p` shall be of type `gid_t`. If the value of the tag type in the ACL entry referred to by `entry_d` is a tag type for which a qualifier is not supported, `acl_set_qualifier`() returns an error.

Any ACL entry descriptors that refer to the entry referred to by `entry_d` continue to refer to that entry. This function may cause memory to be allocated. The caller should free any releasable memory, when the ACL is no longer required, by calling [`acl_free`](#acl_free)() with a pointer to the ACL as argument.

# [RETURN VALUE](#RETURN_VALUE)

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](#ERRORS)

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

\[[`EINVAL`](#EINVAL)]

The argument `entry_d` is not a valid descriptor for an ACL entry.

The value of the tag type in the ACL entry referenced by the argument `entry_d` is neither ACL\_USER nor ACL\_GROUP.

The value pointed to by the argument `qualifier_p` is not valid.

\[[`ENOMEM`](#ENOMEM)]

The `acl_set_qualifier`() function is unable to allocate the memory required for the ACL qualifier.

# [STANDARDS](#STANDARDS)

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

# [SEE ALSO](#SEE_ALSO)

[acl\_create\_entry(3)](/man/os/acl/acl_create_entry.3), [acl\_free(3)](/man/os/acl/acl_free.3), [acl\_get\_permset(3)](/man/os/acl/acl_get_permset.3), [acl\_get\_qualifier(3)](/man/os/acl/acl_get_qualifier.3), [acl\_get\_tag\_type(3)](/man/os/acl/acl_get_tag_type.3), [acl\_set\_entry(3)](/man/os/acl/acl_set_entry.3), [acl\_set\_permset(3)](/man/os/acl/acl_set_permset.3), [acl\_set\_tag\_type(3)](/man/os/acl/acl_set_tag_type.3), [acl(5)](/man/os/acl/acl.5)

# [AUTHOR](#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⟩.

March 23, 2002 Linux ACL

---

Document: acl_set_qualifier(3) from acl 2.4.0-r5 (Chainguard OS)
Source: https://git.savannah.nongnu.org/git/acl.git