lfc_chmod man page

LFC_CHMOD(3) LFC Library Functions LFC_CHMOD(3)

[1mNAME[0m
lfc_chmod - change access mode of a LFC directory/file in the name
server

[1mSYNOPSIS[0m
[1m#include <sys/types.h>[0m
[1m#include "lfc_api.h"[0m

[1mint lfc_chmod (const char *[4m[22mpath[24m[1m, mode_t [4m[22mmode[24m[1m)[0m

[1mDESCRIPTION[0m
[1mlfc_chmod [22msets the access permission portion of the mode of a LFC
directory/file in the name server to the bit pattern in [4mmode.[0m

[4mpath[24m specifies the logical pathname relative to the current LFC
directory or the full LFC pathname.

[4mmode[24m is constructed by OR'ing the bits defined in <[1msys/stat.h[22m> under
Unix or [1m"statbits.h" [22munder Windows/NT:

[1mS_ISUID 0004000 [22mset user ID on execution
[1mS_ISGID 0002000 [22mset group ID on execution
[1mS_ISVTX 0001000 [22msticky bit
[1mS_IRUSR 0000400 [22mread by owner
[1mS_IWUSR 0000200 [22mwrite by owner
[1mS_IXUSR 0000100 [22mexecute/search by owner
[1mS_IRGRP 0000040 [22mread by group
[1mS_IWGRP 0000020 [22mwrite by group
[1mS_IXGRP 0000010 [22mexecute/search by group
[1mS_IROTH 0000004 [22mread by others
[1mS_IWOTH 0000002 [22mwrite by others
[1mS_IXOTH 0000001 [22mexecute/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.

[1mRETURN VALUE[0m
This routine returns 0 if the operation was successful or -1 if the
operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
[1mEPERM [22mThe effective user ID does not match the owner of the file
and the caller does not have ADMIN privilege in the Cupv
database.

[1mENOENT [22mThe named file/directory does not exist or is a null path-
name.

[1mEACCES [22mSearch permission is denied on a component of the [4mpath[0m
prefix.

[1mEFAULT [4m[22mpath[24m is a NULL pointer.

[1mENOTDIR [22mA component of [4mpath[24m prefix is not a directory.

[1mENAMETOOLONG [22mThe length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length of
a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[22m.

[1mSENOSHOST [22mHost unknown.

[1mSENOSSERV [22mService unknown.

[1mSECOMERR [22mCommunication error.

[1mENSNACT [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
[1mCastor_limits(4)[22m, [1mlfc_chdir(3)[22m, [1mCupvlist(1)[0m

[1mAUTHOR[0m
[1mLCG Grid Deployment [22mTeam

LFC $Date: 2002/10/16 06:25:40 $ LFC_CHMOD(3)

Info