1DPNS_LISTREPSET(3)           DPNS  Library Functions          DP‐
2NS_LISTREPSET(3)
3
4
5
6[1mNAME[0m
7       dpns_listrepset ‐ list replica entries that  belong  to  a
8given set
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "dpns_api.h"[0m
13
14       [1mstruct    dpns_filereplicax   *dpns_listrepset   (const
15char *[4m[22msetname[24m[1m, int[0m
16       [4mflags[24m[1m, dpns_list *[4m[22mlistp[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mdpns_listrepset [22mlists replica entries  that  belong
20to a given set.  This
21       routine  returns  a  pointer to a structure containing the
22current replica
23       entry.
24
25       struct dpns_filereplicax {
26            u_signed64     fileid;
27            u_signed64     nbaccesses;
28            time_t          ctime;          /*  replica  creation
29time */
30            time_t           atime;          /*  last  access  to
31replica */
32            time_t         ptime;         /* replica pin time */
33            time_t         ltime;         /* replica lifetime */
34            char      r_type;        /* ’P’ for Primary, ’S’  for
35Secondary */
36            char      status;
37            char      f_type;        /* ’V’ for Volatile, ’P’ for
38Permanent */
39            char      setname[37];
40            char      poolname[CA_MAXPOOLNAMELEN+1];
41            char      host[CA_MAXHOSTNAMELEN+1];
42            char      fs[80];
43            char      sfn[CA_MAXSFNLEN+1];
44       };
45
46       [4msetname[0m
47              is either the replica set name or the space token.
48
49       [4mflags[24m  may be one of the following constant:
50
51              [1mCNS_LIST_BEGIN[0m
52                     the first call must have this  flag  set  to
53allocate  buf‐
54                     fers and initialize pointers.
55
56              [1mCNS_LIST_CONTINUE[0m
57                     all  the following calls must have this flag
58set.
59
60              [1mCNS_LIST_END[0m
61                     final call to terminate the  list  and  free
62resources.
63
64[1mRETURN VALUE[0m
65       This   routine  returns  a pointer to a structure contain‐
66ing the current
67       replica entry if the operation was successful or NULL   if
68all  entries
69       have been returned or if the operation failed. In the lat‐
70ter case, [1mser‐[0m
71       [1mrno [22mis set appropriately.
72
73[1mERRORS[0m
74       [1mENOMEM       [22mMemory could not be allocated for  the
75output buffer.
76
77       [1mEFAULT        [4m[22msetname[24m  or  [4mlistp[24m is a
78NULL pointer.
79
80       [1mEINVAL       [22mThe length of  [4msetname[24m  exceeds
8136.
82
83       [1mSENOSHOST    [22mHost unknown.
84
85       [1mSENOSSERV    [22mService unknown.
86
87       [1mSECOMERR     [22mCommunication error.
88
89       [1mENSNACT      [22mName server is not running or is being
90shutdown.
91
92[1mSEE ALSO[0m
93       [1mCastor_limits(4)[22m,       [1mdpns_addreplicax(3)[22m,
94[1mdpns_modreplica(3)[0m
95
96
97
98DPNS                      $Date:  2006/12/01 09:19:37 $       DP‐
99NS_LISTREPSET(3)
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