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)
RETURN VALUE
If strtoacl() (strtoaclpatt()) succeeds, it returns the number of entries in the resulting ACL
(ACL pattern), always equal to or greater than nentries (zero).
strtoaclpatt() also sets values in global array aclentrystart[] to point to the start of each pat-
tern entry it parsed in string, in some cases including leading or trailing whitespace. It only sets a number
of pointers equal to its return value plus one (never more than NACLENTRIES + 1). The last valid ele-
ment points to the null character at the end of string. After calling strtoaclpatt(), an entry pattern’s
corresponding input string can be used by the caller for error reporting by (temporarily) putting a null at
the start of the next entry pattern in string.
ERRORS
If an error occurs, strtoacl() and strtoaclpatt() return a negative value and the content of acl
is undefined (was probably altered). To help with error reporting in this case, aclentrystart[0] and
aclentrystart[1] are set to point to the start of the current and next entries, respectively, being
parsed when the error occurred. If the current entry does not start with (, aclentrystart[1] points
to the next null character or comma at or after aclentrystart[0]. Otherwise, it points to the next
null, or to the character following the next ).
The following values are returned in case of error:
−1 Syntax error: entry doesn’t start with
( as expected in short form.
−2 Syntax error: entry doesn’t end with
) as expected in short form.
−3 Syntax error: user name is not terminated by a dot.
−4(
strtoacl() only) Syntax error: group name is not terminated by an operator in operator-
form input or a comma in short-form input.
−5 Syntax error: user name is null.
−6 Syntax error: group name is null.
−7 Invalid user name (not found in /etc/passwd file and not a valid number).
−8 Invalid group name (not found in
/etc/group file and not a valid number).
−9 Syntax error: invalid mode character, other than
0..7
, r, w, x, - (allowed in short form only), *
(allowed in patterns only), , (to end an entry in operator form), or ) (to end an entry in short
form). Or,
0..7 or * is followed by other mode characters.
−10 The resulting ACL would have more than maxentries entries.
EXAMPLES
The following code fragment converts an ACL from a string to an array of entries using an fuid of 103 for
the file’s owner and fgid of 45 for the file’s group.
#include <acllib.h>
int nentries;
struct acl_entry acl [NACLENTRIES];
if ((nentries = strtoacl (string, 0, NACLENTRIES, acl, 103, 45)) < 0)
error (...);
The following code gets the ACL, fuid, and fgid for file ../myfile, modifies the ACL using a description
string, and changes the ACL on file
../myfile2 to be the new version.
#include <sys/types.h>
#include <sys/stat.h>
#include <acllib.h>
struct stat statbuf;
int nentries;
struct acl_entry acl [NACLENTRIES];
if (stat ("../myfile", & statbuf) < 0)
error (...);
if ((nentries = getacl ("../myfile", NACLENTRIES, acl)) < 0)
error (...);
Section 3−−896 − 3 − HP-UX Release 11i: December 2000
___
___