lfc_mkdir man page

LFC_MKDIR(3)                 LFC Library Functions                LFC_MKDIR(3)

[1mNAME[0m
      lfc_mkdir - create a new LFC directory in the name server

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

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

[1mDESCRIPTION[0m
      [1mlfc_mkdir [22mcreates a new LFC directory in the name server.

      An  entry  is  created  in the name server database and the directory's
      owner ID is set to the effective user ID of the requestor.   The  group
      ID  of  the directory is set to the effective group ID of the requestor
      or is taken from the parent directory if the latter has the [1mS_ISGID [22mbit
      set.

      The  access permission bits for the directory are taken from [4mmode[24m, then
      all bits set in the requestor's file mode  creation  mask  are  cleared
      (see [1mlfc_umask[22m(3)).  The [1mS_ISGID[22m, [1mS_ISUID [22mand [1mS_ISVTX [22mbits are silently
      cleared.

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

[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
      [1mENOENT       [22mA component of [4mpath[24m prefix does not exist  or  [4mpath[24m  is  a
                   null pathname.

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

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

      [1mEEXIST       [4m[22mpath[24m exists already.

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

      [1mENOSPC       [22mThe name server database is full.

      [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, [1mlfc_chmod(3)[22m, [1mlfc_umask(3)[0m

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

LFC                      $Date: 2001/10/04 12:12:45 $             LFC_MKDIR(3)