1DPM_MODIFYPOOL(3) DPM Library Functions
2DPM_MODIFYPOOL(3)
3[1mNAME[0m
7 dpm_modifypool ‐ modify a disk pool definition
8[1mSYNOPSIS[0m
10 [1m#include <sys/types.h>[0m
11 [1m#include "dpm_api.h"[0m
12 [1mint dpm_modifypool (struct dpm_pool
14*[4m[22mdpm_pool[24m[1m)[0m
15[1mDESCRIPTION[0m
17 [1mdpm_modifypool [22mmodifies a disk pool definition.
18 [4mdpm_pool[0m
20 contains the new pool definition.
21 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 [4mpoolname[0m
45 specifies the disk pool name.
46 [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 [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 [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 [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 [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 [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 [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 [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 [4mgids[24m The disk pool is restricted to this set of
99gids unless the group
100 gid is zero.
101 [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 [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 This function requires ADMIN privilege.
117[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[1mERRORS[0m
125 [1mENOENT [22mThis pool does not exist.
126 [1mEACCES [22mThe caller does not have ADMIN privi‐
128lege.
129 [1mEFAULT [4m[22mdpm_pool[24m is a NULL pointer.
131 [1mEINVAL [22mThe length of [4mpoolname[24m ex‐
133ceeds [1mCA_MAXPOOLNAMELEN [22mor the
134 number of gids is too big.
135 [1mSENOSHOST [22mHost unknown.
137 [1mSEINTERNAL [22mDatabase error.
139 [1mSECOMERR [22mCommunication error.
141LCG $Date$
145DPM_MODIFYPOOL(3)
146