1DPM_MODIFYPOOL(3)            DPM Library Functions           DPM_MODIFYPOOL(3)
2
3
4

NAME

6       dpm_modifypool - modify a disk pool definition
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpm_api.h"
11
12       int dpm_modifypool (struct dpm_pool *dpm_pool)
13

DESCRIPTION

15       dpm_modifypool modifies a disk pool definition.
16
17       dpm_pool
18              contains the new pool definition.
19
20       struct dpm_pool {
21            char      poolname[CA_MAXPOOLNAMELEN+1];
22            u_signed64     defsize;
23            int       gc_start_thresh;
24            int       gc_stop_thresh;
25            int       def_lifetime;
26            int       defpintime;
27            int       max_lifetime;
28            int       maxpintime;
29            char      fss_policy[CA_MAXPOLICYLEN+1];
30            char      gc_policy[CA_MAXPOLICYLEN+1];
31            char      mig_policy[CA_MAXPOLICYLEN+1];
32            char      rs_policy[CA_MAXPOLICYLEN+1];
33            int       nbgids;
34            gid_t          *gids;
35            char      ret_policy;
36            char      s_type;
37            u_signed64     capacity;
38            u_signed64     free;
39            int       nbelem;
40       };
41
42       poolname
43              specifies the disk pool name.
44
45       defsize
46              specifies  the  default  amount of space reserved for a file (in
47              bytes).  If set to -1, the current value is unchanged.
48
49       gc_start_thresh
50              specifies the minimum free space in the pool.  If the percentage
51              of  free  space  goes below this value, the garbage collector is
52              started. If set to -1, the current value is unchanged.
53
54       gc_stop_thresh
55              specifies the percentage of free space in the pool  above  which
56              the  garbage  collector  is  stopped.  If set to -1, the current
57              value is unchanged.
58
59       def_lifetime
60              specifies the default time a space or volatile file is  kept  in
61              the  system  (in  seconds).   If set to -1, the current value is
62              unchanged.
63
64       defpintime
65              specifies the default time a file is kept on a  given  disk  (in
66              seconds).  If set to -1, the current value is unchanged.
67
68       max_lifetime
69              specifies  the  maximum time a space or volatile file is kept in
70              the system (in seconds).  If set to -1,  the  current  value  is
71              unchanged.
72
73       maxpintime
74              specifies  the  maximum  time a file is kept on a given disk (in
75              seconds).  If set to -1, the current value is unchanged.
76
77       nbgids is the size of the array of group ids gids.  If set to  -1,  the
78              current set is unchanged.
79
80       gids   The disk pool is restricted to this set of gids unless the group
81              gid is zero.
82
83       ret_policy
84              specifies the retention policy supported by the  disk  pool.  It
85              can be R (for Replica), O (for Output) or C (for Custodial).  If
86              set to 0, the current value is unchanged.
87
88       s_type indicates the type of space supported in the disk pool.  It  can
89              be V (for Volatile), D (for Durable), P (for Permanent) or - (to
90              accept any type).  If set to 0, the current value is unchanged.
91
92       This function requires ADMIN privilege.
93

RETURN VALUE

95       This routine returns 0 if the operation was successful  or  -1  if  the
96       operation failed. In the latter case, serrno is set appropriately.
97

ERRORS

99       ENOENT       This pool does not exist.
100
101       EACCES       The caller does not have ADMIN privilege.
102
103       EFAULT       dpm_pool is a NULL pointer.
104
105       EINVAL       The length of poolname exceeds CA_MAXPOOLNAMELEN.
106
107       SENOSHOST    Host unknown.
108
109       SEINTERNAL   Database error.
110
111       SECOMERR     Communication error.
112
113
114
115LCG          $Date: 2010-02-05 10:56:02 +0100 (Fri, 05 Feb 201D0P)M_$MODIFYPOOL(3)