x SuSE Linux 13.1-RELEASE x
x SuSE Linux 13.1-RELEASEx
ACL_SET_QUALIFIER(3) BSD Library Functions Manual ACL_SET_QUALIFIER(3)
NAME
acl_set_qualifier -- set the qualifier of an ACL entry
LIBRARY
Linux Access Control Lists library (libacl, -lacl).
SYNOPSIS
#include <sys/types.h>
#include <sys/acl.h>
int
acl_set_qualifier(acl_entry_t entry_d, const void *qualifier_p);
DESCRIPTION
The acl_set_qualifier() function sets the qualifier of the ACL entry in-
dicated 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 sup-
ported, 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 al-
located. The caller should free any releasable memory, when the ACL is no
longer required, by calling acl_free() with a pointer to the ACL as argu-
ment.
RETURN VALUE
The acl_set_qualifier() function returns the value 0 if successful; oth-
erwise the value -1 is returned and the global variable errno is set to
indicate the error.
ERRORS
If any of the following conditions occur, the acl_set_qualifier() func-
tion returns -1 and sets errno to the corresponding value:
[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] The acl_set_qualifier() function is unable to allocate
the memory required for the ACL qualifier.
STANDARDS
IEEE Std 1003.1e draft 17 ("POSIX.1e", abandoned)
SEE ALSO
acl_create_entry(3), acl_free(3), acl_get_permset(3),
acl_get_qualifier(3), acl_get_tag_type(3), acl_set_entry(3),
acl_set_permset(3), acl_set_tag_type(3), acl(5)
AUTHOR
Derived from the FreeBSD manual pages written by Robert N M Watson
<rwatson@FreeBSD.org>, and adapted for Linux by Andreas Gruenbacher
<a.gruenbacher@bestbits.at>.
Linux ACL March 23, 2002 Linux ACL
Want to link to this manual page? Use this URL:
<http://star2.abcm.com/cgi-bin/bsdi-man?query=acl_set_qualifier&sektion=3&manpath=>