sets the access permission portion of the mode of a LFC directory/file in
the name server to the bit pattern in
specifies the logical pathname relative to the current LFC directory or
the full LFC pathname.
is constructed by OR'ing the bits defined in
under Unix or "statbits.h" under Windows/NT:
set user ID on execution
set group ID on execution
read by owner
write by owner
execute/search by owner
read by group
write by group
execute/search by group
read by others
write by others
execute/search by others
The effective user ID of the process must match the owner of the file or
the caller must have ADMIN privilege in the Cupv database.
If a directory is writable and has the sticky bit set, files/directories within
that directory can be removed or renamed only if:
the effective user ID of the requestor matches the owner ID of the file or
the effective user ID of the requestor matches the owner ID of the directory or
the file is writable by the requestor or
the requestor has ADMIN privilege in the Cupv database.
This routine returns 0 if the operation was successful or -1 if the operation
failed. In the latter case,
is set appropriately.
The effective user ID does not match the owner of the file and
the caller does not have ADMIN privilege in the Cupv database.
The named file/directory does not exist or is a null pathname.
Search permission is denied on a component of the
is a NULL pointer.
A component of
prefix is not a directory.
The length of
or the length of a