tail head cat sleep
QR code linking to this page

Manual Pages  — ACL_GET_BRAND_NP


acl_get_brand_np – retrieve the ACL brand from an ACL entry



Standard C Library (libc, -lc)


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

acl_get_brand_np(acl_t acl, int *brand_p);


The acl_get_brand_np() function is a non-portable call that returns the ACL brand for the ACL acl. Upon successful completion, the location referred to by the argument brand_p will be set to the ACL brand of the ACL acl.

Branding is an internal mechanism intended to prevent mixing POSIX.1e and NFSv4 entries by mistake. It's also used by the libc to determine how to print out the ACL. The first call to function that is specific for one particular brand - POSIX.1e or NFSv4 - "brands" the ACL. After that, calling function specific to another brand will result in error.


The acl_get_brand_np function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.


The acl_get_brand_np() function fails if:
  Argument acl does not point to a valid ACL.


acl(3), posix1e(3)


POSIX.1e is described in IEEE POSIX.1e draft 17.


POSIX.1e support was introduced in FreeBSD 4.0 . The acl_get_brand_np() function was added in FreeBSD 8.0 .


The acl_get_brand_np() function was written by Edward Tomasz Napierala <Mt trasz@FreeBSD.org>.

ACL_GET_BRAND_NP (3) June 25, 2009

tail head cat sleep
QR code linking to this page

Please direct any comments about this manual page service to Ben Bullock.

"I liken starting one's computing career with Unix, say as an undergraduate, to being born in East Africa. It is intolerably hot, your body is covered with lice and flies, you are malnourished and you suffer from numerous curable diseases. But, as far as young East Africans can tell, this is simply the natural condition and they live within it. By the time they find out differently, it is too late. They already think that the writing of shell scripts is a natural act."
— Ken Pier, Xerox PARC