1DPNS_MODREPLICA(3)          DPNS Library Functions          DPNS_MODREPLICA(3)
2
3
4

NAME

6       dpns_modreplica - modify information about a given replica
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpns_api.h"
11
12       int  dpns_modreplica  (const char *sfn, const char *setname, const char
13       *poolname, const char *server)
14
15       int dpns_modreplicax (const char *sfn, const char *setname, const  char
16       *poolname, const char *server, const char *fs, const char r_type)
17

DESCRIPTION

19       dpns_modreplica modifies information about a given replica.
20
21       sfn    is  either  the  Site  URL  or  the  Physical  File Name for the
22              replica.
23
24       setname
25              is either a replica set name or a space token.
26
27       server is either the Storage Element fully qualified  hostname  or  the
28              disk server.
29
30       poolname
31              specifies  the  disk pool name (this argument is only meaningful
32              for the Disk Pool Manager).
33
34       dpns_modreplicax
35              is similar to dpns_modreplica but has the additional arguments:
36
37       fs     specifies the mount point  of  the  dedicated  filesystem  (this
38              argument is only meaningful for the Disk Pool Manager).
39
40       r_type may be one of the following:
41
42              P      Primary
43
44              S      Secondary.
45

RETURN VALUE

47       These  routines  return  0 if the operation was successful or -1 if the
48       operation failed. In the latter case, serrno is set appropriately.
49

ERRORS

51       ENOENT       The named replica does not exist.
52
53       EACCES       Search permission is denied on a component of  the  parent
54                    directory  or  the  effective  user  ID does not match the
55                    owner of the file or read permission  on  the  file  entry
56                    itself is denied.
57
58       EFAULT       sfn is a NULL pointer.
59
60       EINVAL       The  length  of setname exceeds 36, the length of poolname
61                    exceeds CA_MAXPOOLNAMELEN or the length of server  exceeds
62                    CA_MAXHOSTNAMELEN.
63
64       ENAMETOOLONG The length of sfn exceeds CA_MAXSFNLEN.
65
66       SENOSHOST    Host unknown.
67
68       SENOSSERV    Service unknown.
69
70       SECOMERR     Communication error.
71
72       ENSNACT      Name server is not running or is being shutdown.
73

SEE ALSO

75       Castor_limits(4), dpns_addreplica(3), dpns_listreplica(3)
76
77
78
79DPNS                     $Date: 2008/08/27 12:43:28 $       DPNS_MODREPLICA(3)
Impressum