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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

131

132

133

134

135

136

137

138

139

140

cpacl(3C) cpacl(3C)

−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.