1LFC_MKDIRG(3)                     LFC      Library      Functions
2LFC_MKDIRG(3)
3
4
5
6[1mNAME[0m
7       lfc_mkdirg  ‐  create  a  new LFC directory  in  the  name
8server with the
9       specified GUID
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "lfc_api.h"[0m
14
15       [1mint  lfc_mkdirg  (const char *[4m[22mpath[24m[1m, const
16char *[4m[22mguid[24m[1m, mode_t [4m[22mmode[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mlfc_mkdirg [22mcreates a  new  LFC  directory  in   the
20name  server  with  the
21       specified GUID.
22
23       An  entry  is created in the name server database with the
24given GUID and
25       the directory’s owner ID is  set  to  the  effective  user
26ID  of  the
27       requestor.   The  group  ID of the directory is set to the
28effective group
29       ID of the requestor or is taken from the parent  directory
30if the latter
31       has the [1mS_ISGID [22mbit set.
32
33       The   access  permission  bits for the directory are taken
34from [4mmode[24m, then
35       all bits set in the requestor’s file mode  creation   mask
36are  cleared
37       (see [1mlfc_umask[22m(3)).  The [1mS_ISGID[22m, [1mS_ISUID
38[22mand [1mS_ISVTX [22mbits are silently
39       cleared.
40
41       [4mguid[24m   specifies the Grid Unique IDentifier.
42
43       [4mpath[24m   specifies the  logical   pathname   relative
44to  the  current  LFC
45              directory or the full LFC pathname.
46
47[1mRETURN VALUE[0m
48       This  routine  returns  0  if the operation was successful
49or ‐1 if the
50       operation failed. In the latter case, [1mserrno [22mis set
51appropriately.
52
53[1mERRORS[0m
54       [1mENOENT       [22mA component of [4mpath[24m prefix does
55not exist  or  [4mpath[24m  is  a
56                    null pathname.
57
58       [1mEACCES       [22mSearch  permission  is  denied   on  a
59component of the [4mpath[0m
60                    prefix  or  write permission  on  the  parent
61directory  is
62                    denied.
63
64       [1mEFAULT       [4m[22mpath[24m is a NULL pointer.
65
66       [1mEEXIST       [4m[22mpath[24m exists already.
67
68       [1mEINVAL       [22mThe length of the [4mguid[24m  exceeds
69[1mCA_MAXGUIDLEN[22m.
70
71       [1mENOTDIR       [22mA  component of [4mpath[24m prefix is
72not a directory.
73
74       [1mENOSPC       [22mThe name server database is full.
75
76       [1mENAMETOOLONG [22mThe   length  of  [4mpath[24m  exceeds
77[1mCA_MAXPATHLEN [22mor the length of
78                    a  [4mpath[24m  component  exceeds [1mCA_MAX‐
79NAMELEN[22m.
80
81       [1mSENOSHOST    [22mHost unknown.
82
83       [1mSENOSSERV    [22mService unknown.
84
85       [1mSECOMERR     [22mCommunication error.
86
87       [1mENSNACT      [22mName server is not running or is being
88shutdown.
89
90[1mSEE ALSO[0m
91       [1mCastor_limits(4)[22m,              [1mlfc_chdir(3)[22m,
92[1mlfc_chmod(3)[22m, [1mlfc_umask(3)[0m
93
94[1mAUTHOR[0m
95       [1mLCG Grid Deployment [22mTeam
96
97
98
99LFC                         $Date:    2005/02/01    07:12:45    $
100LFC_MKDIRG(3)
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
Impressum