lfc_mkdirg man page

LFC_MKDIRG(3)                LFC Library Functions               LFC_MKDIRG(3)

[1mNAME[0m
      lfc_mkdirg  -  create  a  new LFC directory in the name server with the
      specified GUID

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

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

[1mDESCRIPTION[0m
      [1mlfc_mkdirg [22mcreates a new LFC directory in  the  name  server  with  the
      specified GUID.

      An entry is created in the name server database with the given GUID 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.

      [4mguid[24m   specifies the Grid Unique IDentifier.

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

      [1mEINVAL       [22mThe length of the [4mguid[24m exceeds [1mCA_MAXGUIDLEN[22m.

      [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: 2005/02/01 07:12:45 $            LFC_MKDIRG(3)