1DPM_ADDPOOL(3) DPM Library Functions
2DPM_ADDPOOL(3)
3[1mNAME[0m
7 dpm_addpool ‐ define a new disk pool
8[1mSYNOPSIS[0m
10 [1m#include <sys/types.h>[0m
11 [1m#include "dpm_api.h"[0m
12 [1mint dpm_addpool (struct dpm_pool
14*[4m[22mdpm_pool[24m[1m)[0m
15[1mDESCRIPTION[0m
17 [1mdpm_addpool [22mdefines a new disk pool.
18 [4mdpm_pool[0m
20 contains the 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).
51 [4mgc_start_thresh[0m
53 specifies the minimum free space in the pool. If
54the percentage
55 of free space goes below this value, the garbage
56collector is
57 started. Default is 0.
58 [4mgc_stop_thresh[0m
60 specifies the percentage of free space in the pool
61above which
62 the garbage collector is stopped. Default is 0.
63 [4mdef_lifetime[0m
65 specifies the default time a space or volatile
66file is kept in
67 the system (in seconds).
68 [4mdefpintime[0m
70 specifies the default time a file is kept on a
71given disk (in
72 seconds).
73 [4mmax_lifetime[0m
75 specifies the maximum time a space or volatile
76file is kept in
77 the system (in seconds).
78 [4mmaxpintime[0m
80 specifies the maximum time a file is kept on a
81given disk (in
82 seconds).
83 [4mnbgids[24m is the size of the array of group ids
85[4mgids[24m.
86 [4mgids[24m The disk pool is restricted to this set of
88gids unless the group
89 gid is zero.
90 [4mret_policy[0m
92 specifies the retention policy supported by the
93disk pool. It
94 can be [1mR [22m(for Replica), [1mO [22m(for Out‐
95put) or [1mC [22m(for Custodial).
96 [4ms_type[24m indicates the type of space supported in
98the disk pool. It can
99 be [1mV [22m(for Volatile), [1mD [22m(for Durable),
100[1mP [22m(for Permanent) or [1m‐ [22m(to
101 accept any type).
102 This function requires ADMIN privilege.
104[1mRETURN VALUE[0m
106 This routine returns 0 if the operation was successful
107or ‐1 if the
108 operation failed. In the latter case, [1mserrno [22mis set
109appropriately.
110[1mERRORS[0m
112 [1mEACCES [22mThe caller does not have ADMIN privi‐
113lege.
114 [1mEFAULT [4m[22mdpm_pool[24m is a NULL pointer.
116 [1mEEXIST [22mThis pool exists already.
118 [1mENOMEM [22mMemory could not be allocated for
120storing the pool defini‐
121 tion.
122 [1mEINVAL [22mThe length of [4mpoolname[24m ex‐
124ceeds [1mCA_MAXPOOLNAMELEN [22mor the
125 number of gids is too big.
126 [1mSENOSHOST [22mHost unknown.
128 [1mSEINTERNAL [22mDatabase error.
130 [1mSECOMERR [22mCommunication error.
132LCG $Date$
136DPM_ADDPOOL(3)
137