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_CREATE_ENTRY(3) FreeBSD Library Functions Manual ACL_CREATE_ENTRY(3)

acl_create_entry, acl_create_entry_np
create a new ACL entry

Standard C Library (libc, -lc)

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

int
acl_create_entry(acl_t *acl_p, acl_entry_t *entry_p);

int
acl_create_entry_np(acl_t *acl_p, acl_entry_t *entry_p, int index);

The acl_create_entry() function is a POSIX.1e call that creates a new ACL entry in the ACL pointed to by acl_p. The acl_create_entry_np() function is a non-portable version that creates the ACL entry at position index. Positions are numbered starting from zero, i.e. calling acl_create_entry_np() with index argument equal to zero will prepend the entry to the ACL.

The acl_create_entry() 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_create_entry() function fails if:
[]
Argument acl_p does not point to a pointer to a valid ACL. Argument index is out of bounds.
[]
The ACL working storage requires more memory than is allowed by the hardware or system-imposed memory management constraints.

acl(3), acl_delete_entry(3), acl_get_entry(3), posix1e(3)

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

POSIX.1e support was introduced in FreeBSD 4.0. The acl_create_entry() function was added in FreeBSD 5.0.

The acl_create_entry() function was written by Chris D. Faulhaber <jedgar@fxp.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.