HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

131

132

133

134

135

136

137

138

139

140

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/!!!intro.3c

________________________________________________________________

___ ___

cpacl(3C) cpacl(3C)

RETURN VALUE

If successful, cpacl() and fcpacl() return zero. If an error occurs, they set errno to indicate the

cause of failure and return a negative value, as follows:

−1 Unable to perform acl() or getacl() (fgetacl()) on a local fromﬁle (fromfd).

−2 Unable to perform chmod() (fchmod())ontoﬁle (tofd) to set its ﬁle miscellaneous mode bits.

cpacl() (fcpacl()) attempts this regardless of whether a ﬁle is local or remote, as long as

fromﬁle (fromfd)islocal.

−3 Unable to perform acl() or setacl() (fsetacl()) on a local toﬁle (tofd). As a consequence,

the ﬁle’s optional ACL entries are deleted (HFS only), its ﬁle access permission bits are zeroed, and its

miscellaneous mode bits might be altered.

−4 Unable to perform chmod() (fchmod())ontoﬁle (tofd) to set its mode. As a consequence, if

fromﬁle (fromfd) is local, toﬁle’s (tofd’s) optional ACL entries are deleted (HFS only), its access permis-

sion bits are zeroed, and its ﬁle miscellaneous mode bits might be altered, regardless of whether the

ﬁle is local or remote.

EXAMPLES

The following code fragment gets stat information on oldfile

and copies its ﬁle miscellaneous bits and

access control list to

newfile owned by the caller. If either ﬁle is remote, only the

st_mode on old-

file

is copied.

#include <sys/types.h>

#include <sys/stat.h>

struct stat statbuf;

if (stat ("oldfile", & statbuf) < 0)

error (...);

if (cpacl ("oldfile", newfile , statbuf.st_mode,

statbuf.st_uid, statbuf.st_gid, geteuid(), getegid()) < 0)

{

error (...);

}

DEPENDENCIES

cpacl() and fcpacl() are only supported on HFS ﬁle system on standard HP-UX operating system.

AUTHOR

cpacl() and fcpacl() were developed by HP.