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