dpns_mkdir man page

DPNS_MKDIR(3)               DPNS Library Functions               DPNS_MKDIR(3)

[1mNAME[0m
      dpns_mkdir - create a new DPNS directory in the name server

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

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

[1mDESCRIPTION[0m
      [1mdpns_mkdir [22mcreates a new DPNS 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  [1mdpns_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  DPNS
             directory or the full DPNS 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, [1mdpns_chdir(3)[22m, [1mdpns_chmod(3)[22m, [1mdpns_umask(3)[0m

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

DPNS                     $Date: 2001/10/04 12:12:45 $            DPNS_MKDIR(3)