1DPNS_MODREPLICA(3)           DPNS  Library Functions          DP‐
2NS_MODREPLICA(3)
3
4
5
6[1mNAME[0m
7       dpns_modreplica ‐ modify information about a given replica
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpns_api.h"[0m
12
13       [1mint  dpns_modreplica  (const  char  *[4m[22msfn[24m[1m,
14const char *[4m[22msetname[24m[1m, const char[0m
15       [1m*[4m[22mpoolname[24m[1m,   const   char   *[4m[22mserv‐
16er[24m[1m)[0m
17
18       [1mint dpns_modreplicax  (const  char  *[4m[22msfn[24m[1m,
19const char *[4m[22msetname[24m[1m, const  char[0m
20       [1m*[4m[22mpoolname[24m[1m,   const   char   *[4m[22mserv‐
21er[24m[1m,   const    char    *[4m[22mfs[24m[1m,    const    char
22[4m[22mr_type[24m[1m)[0m
23
24[1mDESCRIPTION[0m
25       [1mdpns_modreplica  [22mmodifies information about a given
26replica.
27
28       [4msfn[24m    is  either  the  Site  URL  or  the   Physi‐
29cal  File Name for the
30              replica.
31
32       [4msetname[0m
33              is either a replica set name or a space token.
34
35       [4mserver[24m  is  either the Storage Element fully quali‐
36fied  hostname  or  the
37              disk server.
38
39       [4mpoolname[0m
40              specifies  the  disk pool name  (this  argument  is
41only meaningful
42              for the Disk Pool Manager).
43
44       [1mdpns_modreplicax[0m
45              is  similar  to  [1mdpns_modreplica [22mbut has the
46additional arguments:
47
48       [4mfs[24m     specifies the mount point  of  the  dedicat‐
49ed  filesystem  (this
50              argument  is only meaningful for the Disk Pool Man‐
51ager).
52
53       [4mr_type[24m may be one of the following:
54
55              [1mP      [22mPrimary
56
57              [1mS      [22mSecondary.
58
59[1mRETURN VALUE[0m
60       These  routines  return  0 if the operation was successful
61or ‐1 if the
62       operation failed. In the latter case, [1mserrno [22mis set
63appropriately.
64
65[1mERRORS[0m
66       [1mENOENT       [22mThe named replica does not exist.
67
68       [1mEACCES       [22mSearch permission is denied on a  com‐
69ponent of  the  parent
70                    directory   or  the  effective  user  ID does
71not match the
72                    owner of the file or read permission  on  the
73file  entry
74                    itself is denied.
75
76       [1mEFAULT       [4m[22msfn[24m is a NULL pointer.
77
78       [1mEINVAL       [22mThe  length  of [4msetname[24m exceeds
7936, the length of [4mpoolname[0m
80                    exceeds   [1mCA_MAXPOOLNAMELEN   [22mor   the
81length of [4mserver[24m  exceeds
82                    [1mCA_MAXHOSTNAMELEN[22m.
83
84       [1mENAMETOOLONG   [22mThe  length  of  [4msfn[24m  exceeds
85[1mCA_MAXSFNLEN[22m.
86
87       [1mSENOSHOST    [22mHost unknown.
88
89       [1mSENOSSERV    [22mService unknown.
90
91       [1mSECOMERR     [22mCommunication error.
92
93       [1mENSNACT      [22mName server is not running or is being
94shutdown.
95
96[1mSEE ALSO[0m
97       [1mCastor_limits(4)[22m, [1mdpns_addreplica(3)[22m, [1mdp‐
98ns_listreplica(3)[0m
99
100
101
102DPNS                     $Date: 2008/08/27 12:43:28  $        DP‐
103NS_MODREPLICA(3)
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