ACL_GET_QUALIFIER(3) | Library Functions Manual | ACL_GET_QUALIFIER(3) |
acl_get_qualifier
—
#include <sys/types.h>
#include <sys/acl.h>
void *
acl_get_qualifier
(acl_entry_t
entry_d);
acl_get_qualifier
() function is a POSIX.1e call that
retrieves the qualifier of the tag for the ACL entry indicated by the argument
entry_d into working storage and returns a pointer to
that storage.
If the value of the tag type in the ACL entry referred to by
entry_d is ACL_USER
, then the
value returned by acl_get_qualifier
() will be a
pointer to 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 returned by acl_get_qualifier
() will be a
pointer to type gid_t.
If the value of the tag type in the ACL entry referred to by
entry_d is ACL_UNDEFINED_TAG
,
ACL_USER_OBJ
, ACL_GROUP_OBJ
,
ACL_OTHER
, ACL_MASK
, or an
implementation-defined value for which a qualifier is not supported, then
acl_get_qualifier
() will return a value of
(void *)NULL
and the function
will fail.
This function may cause memory to be allocated. The caller should
free any releasable memory, when the new qualifier is no longer required, by
calling acl_free
() with void *
as the argument.
acl_get_qualifier
() function returns a pointer to
the allocated storage if successful; otherwise a NULL
pointer is returned and the global variable errno is set
to indicate the error.
acl_get_qualifier
() fails if:
EINVAL
]ACL_USER
or
ACL_GROUP
.ENOMEM
]acl_get_qualifier
() function was added in
FreeBSD 5.0.
acl_get_qualifier
() function was written by
Chris D. Faulhaber
<jedgar@fxp.org>.
March 13, 2001 | NetBSD 10.0 |