1DPNS_LISTREP4GC(3)           DPNS  Library Functions          DP‐
2NS_LISTREP4GC(3)
3
4
5
6[1mNAME[0m
7       dpns_listrep4gc ‐ list replica entries that can be garbage
8collected
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "dpns_api.h"[0m
13
14       [1mstruct    dpns_filereplicax   *dpns_listrep4gc   (const
15char *[4m[22mpoolname[24m[1m, int[0m
16       [4mflags[24m[1m, dpns_list *[4m[22mlistp[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mdpns_listrep4gc [22mlists replica entries that  can  be
20garbage collected.
21
22       [4mpoolname[0m
23              specifies the disk pool.
24
25       [4mflags[24m  may be one of the following constant:
26
27              [1mCNS_LIST_BEGIN[0m
28                     the  first  call  must have this flag set to
29allocate  buf‐
30                     fers and initialize pointers.
31
32              [1mCNS_LIST_CONTINUE[0m
33                     all the following calls must have this  flag
34set.
35
36              [1mCNS_LIST_END[0m
37                     final  call  to  terminate the list and free
38resources.
39
40[1mRETURN VALUE[0m
41       This  routine  returns  a pointer to a structure  contain‐
42ing the current
43       replica  entry if the operation was successful or NULL  if
44all  entries
45       have been returned or if the operation failed. In the lat‐
46ter case, [1mser‐[0m
47       [1mrno [22mis set appropriately.
48
49[1mERRORS[0m
50       [1mENOMEM        [22mMemory could not be allocated for the
51output buffer.
52
53       [1mEFAULT       [4m[22mpoolname[24m or [4mlistp[24m  is  a
54NULL pointer.
55
56       [1mEINVAL        [22mThe length of [4mpoolname[24m exceeds
57[1mCA_MAXPOOLNAMELEN[22m.
58
59       [1mSENOSHOST    [22mHost unknown.
60
61       [1mSENOSSERV    [22mService unknown.
62
63       [1mSECOMERR     [22mCommunication error.
64
65       [1mENSNACT      [22mName server is not running or is being
66shutdown.
67
68[1mSEE ALSO[0m
69       [1mCastor_limits(4)[22m, [1mdpns_addreplicax(3)[0m
70
71
72
73DPNS                      $Date:  2006/12/01 09:19:37 $       DP‐
74NS_LISTREP4GC(3)
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