GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
ACL_GET_BRAND_NP(3) FreeBSD Library Functions Manual ACL_GET_BRAND_NP(3)

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>

int
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 <trasz@FreeBSD.org>.
June 25, 2009 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.