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)