1DPM_MODIFYPOOL(3)                 DPM      Library      Functions
2DPM_MODIFYPOOL(3)
3
4
5
6[1mNAME[0m
7       dpm_modifypool ‐ modify a disk pool definition
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint       dpm_modifypool        (struct        dpm_pool
14*[4m[22mdpm_pool[24m[1m)[0m
15
16[1mDESCRIPTION[0m
17       [1mdpm_modifypool [22mmodifies a disk pool definition.
18
19       [4mdpm_pool[0m
20              contains the new pool definition.
21
22       struct dpm_pool {
23            char      poolname[CA_MAXPOOLNAMELEN+1];
24            u_signed64     defsize;
25            int       gc_start_thresh;
26            int       gc_stop_thresh;
27            int       def_lifetime;
28            int       defpintime;
29            int       max_lifetime;
30            int       maxpintime;
31            char      fss_policy[CA_MAXPOLICYLEN+1];
32            char      gc_policy[CA_MAXPOLICYLEN+1];
33            char      mig_policy[CA_MAXPOLICYLEN+1];
34            char      rs_policy[CA_MAXPOLICYLEN+1];
35            int       nbgids;
36            gid_t          *gids;
37            char      ret_policy;
38            char      s_type;
39            u_signed64     capacity;
40            u_signed64     free;
41            int       nbelem;
42       };
43
44       [4mpoolname[0m
45              specifies the disk pool name.
46
47       [4mdefsize[0m
48              specifies   the   default  amount of space reserved
49for a file (in
50              bytes).  If set to ‐1, the  current  value  is  un‐
51changed.
52
53       [4mgc_start_thresh[0m
54              specifies  the  minimum free space in the pool.  If
55the percentage
56              of  free  space  goes below this value, the garbage
57collector is
58              started.  If  set  to  ‐1, the current value is un‐
59changed.
60
61       [4mgc_stop_thresh[0m
62              specifies the percentage of free space in the  pool
63above  which
64              the   garbage   collector   is  stopped.  If set to
65‐1, the current
66              value is unchanged.
67
68       [4mdef_lifetime[0m
69              specifies the default time a space or volatile file
70is  kept  in
71              the   system   (in   seconds).    If set to ‐1, the
72current value is
73              unchanged.
74
75       [4mdefpintime[0m
76              specifies the default time a  file  is  kept  on  a
77given  disk  (in
78              seconds).   If  set to ‐1, the current value is un‐
79changed.
80
81       [4mmax_lifetime[0m
82              specifies  the  maximum time a  space  or  volatile
83file is kept in
84              the  system (in seconds).  If set to ‐1,  the  cur‐
85rent  value  is
86              unchanged.
87
88       [4mmaxpintime[0m
89              specifies  the  maximum  time a file is kept  on  a
90given disk (in
91              seconds).   If  set to ‐1, the current value is un‐
92changed.
93
94       [4mnbgids[24m is the  size  of  the  array  of  group  ids
95[4mgids[24m.  If set to  ‐1,  the
96              current set is unchanged.
97
98       [4mgids[24m    The  disk pool is restricted to this set of
99gids unless the group
100              gid is zero.
101
102       [4mret_policy[0m
103              specifies the retention  policy  supported  by  the
104disk  pool.  It
105              can  be  [1mR [22m(for Replica), [1mO [22m(for Out‐
106put) or [1mC [22m(for Custodial).  If
107              set to 0, the current value is unchanged.
108
109       [4ms_type[24m indicates the type of space supported in the
110disk pool.  It  can
111              be [1mV [22m(for Volatile), [1mD [22m(for Durable),
112[1mP [22m(for Permanent) or [1m‐ [22m(to
113              accept any type).  If set to 0, the  current  value
114is unchanged.
115
116       This function requires ADMIN privilege.
117
118[1mRETURN VALUE[0m
119       This routine returns 0 if the operation was successful  or
120‐1  if  the
121       operation failed. In the latter case, [1mserrno [22mis set
122appropriately.
123
124[1mERRORS[0m
125       [1mENOENT       [22mThis pool does not exist.
126
127       [1mEACCES        [22mThe caller does not have ADMIN privi‐
128lege.
129
130       [1mEFAULT       [4m[22mdpm_pool[24m is a NULL pointer.
131
132       [1mEINVAL       [22mThe  length  of   [4mpoolname[24m  ex‐
133ceeds [1mCA_MAXPOOLNAMELEN [22mor the
134                    number of gids is too big.
135
136       [1mSENOSHOST    [22mHost unknown.
137
138       [1mSEINTERNAL   [22mDatabase error.
139
140       [1mSECOMERR     [22mCommunication error.
141
142
143
144LCG                                                        $Date$
145DPM_MODIFYPOOL(3)
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
Impressum