1DPNS_SETRSTATUS(3)           DPNS  Library Functions          DP‐
2NS_SETRSTATUS(3)
3
4
5
6[1mNAME[0m
7       dpns_setrstatus ‐ set replica status
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpns_api.h"[0m
12
13       [1mint  dpns_setrstatus  (const  char  *[4m[22msfn[24m[1m,
14const char [4m[22mstatus[24m[1m)[0m
15
16[1mDESCRIPTION[0m
17       [1mdpns_setrstatus  [22msets  the  replica  status.   This
18function should be
19       called for example when a replica becomes available,  i.e.
20fully  popu‐
21       lated.
22
23       [4msfn[24m    is the Physical File Name for the replica.
24
25       [4mstatus[24m  specifies  the  new status.  Valid statuses
26are:
27
28              [1m‐      [22mreplica is available.
29
30              [1mP      [22mreplica is being populated.
31
32              [1mD      [22mreplica is going to be deleted.
33
34[1mRETURN VALUE[0m
35       This  routine  returns  0  if the operation was successful
36or ‐1 if the
37       operation failed. In the latter case, [1mserrno [22mis set
38appropriately.
39
40[1mERRORS[0m
41       [1mENOENT       [22mThe named replica does not exist.
42
43       [1mEACCES       [22mSearch permission is denied on a  com‐
44ponent  of  the  file
45                    prefix   or the caller effective user ID does
46not match the
47                    owner ID of the file or  read  permission  on
48the file itself
49                    is denied.
50
51       [1mEFAULT       [4m[22msfn[24m is a NULL pointer.
52
53       [1mENAMETOOLONG   [22mThe  length  of  [4msfn[24m  exceeds
54[1mCA_MAXSFNLEN[22m.
55
56       [1mSENOSHOST    [22mHost unknown.
57
58       [1mSENOSSERV    [22mService unknown.
59
60       [1mSECOMERR     [22mCommunication error.
61
62       [1mENSNACT      [22mName server is not running or is being
63shutdown.
64
65[1mSEE ALSO[0m
66       [1mCastor_limits(4)[22m, [1mdpns_listreplica(3)[0m
67
68
69
70DPNS                      $Date:  2005/04/27 09:11:24 $       DP‐
71NS_SETRSTATUS(3)
72
73
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