| 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 |