HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/nan.3m
________________________________________________________________
___ ___
s
strtoacl(3C) strtoacl(3C)
NAME
strtoacl(), strtoaclpatt(), aclentrystart[] - convert string form to access control list (ACL) structure (HFS
File System only)
SYNOPSIS
#include <acllib.h>
int strtoacl(
const char *string,
int nentries,
int maxentries,
struct acl_entry *acl,
uid_t fuid,
gid_t fgid);
int strtoaclpatt(
const char *string,
int maxentries,
struct acl_entry_patt *acl);
int strtoacl_r(
const char *string,
int nentries,
int maxentries,
struct acl_entry *acl,
uid_t fuid,
gid_t fgid,
char *entrystart[]);
int strtoaclpatt_r(
const char *string,
int maxentries,
struct acl_entry_patt *acl
char *entrystart[]);
DESCRIPTION
strtoacl() converts an access control list from exact symbolic (string) representation to structure form.
It parses the input string and verifies its validity. Optionally it applies the entries in the string as a series
of changes to an existing ACL.
strtoaclpatt() converts an access control list pattern from symbolic (string) representation to struc-
ture form. It parses the input string and verifies its validity.
The external array
aclentrystart[]
, only valid until the next call of either routine, is useful for error
reporting. See ERRORS below.
The ‘‘operator’’ and ‘‘short’’ symbolic forms of ACLs and ACL patterns (described in acl(5)) are acceptable as
input strings. If the first non-whitespace character in string is
(, the ACL or ACL pattern in string must
be in short form. Otherwise operator form is assumed.
strtoacl() takes a pointer to the string to be converted, and a pointer to the first element of an array
of ACL entries (acl[]) initially containing the indicated number (nentries) of valid entries (zero or more).
This array can grow to the indicated number of entries (maxentries). strtoacl() also takes file user ID
(fuid) and group ID (fgid) values to substitute for
@ characters in string and returns the resulting number
of entries in
acl[].
Redundant entries (identical user ID and group ID values after processing @ characters) are combined, so
that acl[] contains unique entries in the order encountered. If a new entry is mentioned, it is added to
the end of the acl array.
strtoaclpatt()
strtoaclpatt() differs from strtoacl() because it processes an ACL pattern instead of an ACL.
Since modification of an existing initial ACL is not useful, it is not supported.
Entries with matching user and group ID values are not combined. Each entry input yields one entry in
the returned array.
Section 3−−894 − 1 − HP-UX Release 11i: December 2000
___
___