1DPM_GETPOOLFS(3)                  DPM      Library      Functions
2DPM_GETPOOLFS(3)
3
4
5
6[1mNAME[0m
7       dpm_getpoolfs ‐ get list of filesystems for a given pool
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint dpm_getpoolfs  (char  *[4m[22mpoolname[24m[1m,  int
14*[4m[22mnbfs[24m[1m, struct dpm_fs **[4m[22mdpm_fs[24m[1m)[0m
15
16[1mDESCRIPTION[0m
17       [1mdpm_getpoolfs  [22mgets list of filesystems for a given
18pool.
19
20       The input argument is:
21
22       [4mpoolname[0m
23              specifies   the   disk    pool    name   previously
24defined  using
25              [1mdpm_addpool[22m.
26
27       The output arguments are:
28
29       [4mnbfs[24m    will be set to the number of replies in the
30array  of  filesys‐
31              tems.
32
33       [4mdpm_fs[24m will  be  set  to  the  address of an  array
34of dpm_fs structures
35              allocated by the API. The client application is re‐
36sponsible  for
37              freeing the array when not needed anymore.
38
39       struct dpm_fs {
40            char      poolname[CA_MAXPOOLNAMELEN+1];
41            char      server[CA_MAXHOSTNAMELEN+1];
42            char      fs[80];
43            u_signed64     capacity;
44            u_signed64     free;
45            int       status;
46            int       weight;
47       };
48
49[1mRETURN VALUE[0m
50       This  routine  returns  0  if the operation was successful
51or ‐1 if the
52       operation failed. In the latter case, [1mserrno [22mis set
53appropriately.
54
55[1mERRORS[0m
56       [1mEFAULT         [4m[22mpoolname[24m,   [4mnbfs[24m    or
57[4mdpm_fs[24m is a NULL pointer.
58
59       [1mENOMEM        [22mMemory  could  not  be  allocated for
60storing the reply.
61
62       [1mEINVAL       [22mThe pool is unknown  or   the   length
63of  [4mpoolname[24m  exceeds
64                    [1mCA_MAXPOOLNAMELEN[22m.
65
66       [1mSENOSHOST    [22mHost unknown.
67
68       [1mSECOMERR     [22mCommunication error.
69
70
71
72LCG                                                        $Date$
73DPM_GETPOOLFS(3)
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
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