1DPNS_MKDIR(3)                    DPNS      Library      Functions
2DPNS_MKDIR(3)
3
4
5
6[1mNAME[0m
7       dpns_mkdir ‐ create a new DPNS directory in the name serv‐
8er
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "dpns_api.h"[0m
13
14       [1mint  dpns_mkdir (const char *[4m[22mpath[24m[1m, mode_t
15[4m[22mmode[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mdpns_mkdir [22mcreates a new DPNS directory in the name
19server.
20
21       An   entry   is   created  in the name server database and
22the directory’s
23       owner ID is set to the effective user ID of the requestor.
24The  group
25       ID   of  the directory is set to the effective group ID of
26the requestor
27       or is taken from the parent directory if  the  latter  has
28the [1mS_ISGID [22mbit
29       set.
30
31       The   access  permission  bits for the directory are taken
32from [4mmode[24m, then
33       all bits set in the requestor’s file mode  creation   mask
34are  cleared
35       (see     [1mdpns_umask[22m(3)).     The    [1mS_ISGID[22m,
36[1mS_ISUID  [22mand  [1mS_ISVTX  [22mbits  are
37       silently cleared.
38
39       [4mpath[24m   specifies the logical pathname  relative  to
40the  current  DPNS
41              directory or the full DPNS pathname.
42
43[1mRETURN VALUE[0m
44       This  routine  returns  0  if the operation was successful
45or ‐1 if the
46       operation failed. In the latter case, [1mserrno [22mis set
47appropriately.
48
49[1mERRORS[0m
50       [1mENOENT       [22mA component of [4mpath[24m prefix does
51not exist  or  [4mpath[24m  is  a
52                    null pathname.
53
54       [1mEACCES       [22mSearch  permission  is  denied   on  a
55component of the [4mpath[0m
56                    prefix  or  write permission  on  the  parent
57directory  is
58                    denied.
59
60       [1mEFAULT       [4m[22mpath[24m is a NULL pointer.
61
62       [1mEEXIST       [4m[22mpath[24m exists already.
63
64       [1mENOTDIR      [22mA component of [4mpath[24m  prefix  is
65not a directory.
66
67       [1mENOSPC       [22mThe name server database is full.
68
69       [1mENAMETOOLONG  [22mThe   length  of  [4mpath[24m exceeds
70[1mCA_MAXPATHLEN [22mor the length of
71                    a [4mpath[24m  component  exceeds  [1mCA_MAX‐
72NAMELEN[22m.
73
74       [1mSENOSHOST    [22mHost unknown.
75
76       [1mSENOSSERV    [22mService unknown.
77
78       [1mSECOMERR     [22mCommunication error.
79
80       [1mENSNACT      [22mName server is not running or is being
81shutdown.
82
83[1mSEE ALSO[0m
84       [1mCastor_limits(4)[22m,   [1mdpns_chdir(3)[22m,    [1mdp‐
85ns_chmod(3)[22m, [1mdpns_umask(3)[0m
86
87[1mAUTHOR[0m
88       [1mLCG Grid Deployment [22mTeam
89
90
91
92DPNS                        $Date:    2001/10/04    12:12:45    $
93DPNS_MKDIR(3)
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132