1ACL_SET_QUALIFIER(3)     BSD Library Functions Manual     ACL_SET_QUALIFIER(3)
2

NAME

4     acl_set_qualifier — set the qualifier of an ACL entry
5

LIBRARY

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

SYNOPSIS

10     #include <sys/types.h>
11     #include <sys/acl.h>
12
13     int
14     acl_set_qualifier(acl_entry_t entry_d, const void *qualifier_p);
15

DESCRIPTION

17     The acl_set_qualifier() function sets the qualifier of the ACL entry in‐
18     dicated by the argument entry_d to the value referred to by the argument
19     qualifier_p.  If the value of the tag type in the ACL entry referred to
20     by entry_d is ACL_USER, then the value referred to by qualifier_p shall
21     be of type uid_t.  If the value of the tag type in the ACL entry referred
22     to by entry_d is ACL_GROUP, then the value referred to by qualifier_p
23     shall be of type gid_t.  If the value of the tag type in the ACL entry
24     referred to by entry_d is a tag type for which a qualifier is not sup‐
25     ported, acl_set_qualifier() returns an error.
26
27     Any ACL entry descriptors that refer to the entry referred to by entry_d
28     continue to refer to that entry. This function may cause memory to be al‐
29     located. The caller should free any releasable memory, when the ACL is no
30     longer required, by calling acl_free() with a pointer to the ACL as argu‐
31     ment.
32

RETURN VALUE

34     The acl_set_qualifier() function returns the value 0 if successful; oth‐
35     erwise the value -1 is returned and the global variable errno is set to
36     indicate the error.
37

ERRORS

39     If any of the following conditions occur, the acl_set_qualifier() func‐
40     tion returns -1 and sets errno to the corresponding value:
41
42     [EINVAL]           The argument entry_d is not a valid descriptor for an
43                        ACL entry.
44
45                        The value of the tag type in the ACL entry referenced
46                        by the argument entry_d is neither ACL_USER nor
47                        ACL_GROUP.
48
49                        The value pointed to by the argument qualifier_p is
50                        not valid.
51
52     [ENOMEM]           The acl_set_qualifier() function is unable to allocate
53                        the memory required for the ACL qualifier.
54

STANDARDS

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

SEE ALSO

59     acl_create_entry(3), acl_free(3), acl_get_permset(3),
60     acl_get_qualifier(3), acl_get_tag_type(3), acl_set_entry(3),
61     acl_set_permset(3), acl_set_tag_type(3), acl(5)
62

AUTHOR

64     Derived from the FreeBSD manual pages written by Robert N M Watson
65     <rwatson@FreeBSD.org>, and adapted for Linux by Andreas Gruenbacher
66     <andreas.gruenbacher@gmail.com>.
67
68Linux ACL                       March 23, 2002                       Linux ACL
Impressum