Man Linux: Main Page and Category List

NAME

       dpns_modreplica - modify information about a given replica

SYNOPSIS

       #include <sys/types.h>
       #include "dpns_api.h"

       int  dpns_modreplica  (const char *sfn, const char *setname, const char
       *poolname, const char *server)

       int dpns_modreplicax (const char *sfn, const char *setname, const  char
       *poolname, const char *server, const char *fs, const char r_type)

DESCRIPTION

       dpns_modreplica modifies information about a given replica.

       sfn    is  either  the  Site  URL  or  the  Physical  File Name for the
              replica.

       setname
              is either a replica set name or a space token.

       server is either the Storage Element fully qualified  hostname  or  the
              disk server.

       poolname
              specifies  the  disk pool name (this argument is only meaningful
              for the Disk Pool Manager).

       dpns_modreplicax
              is similar to dpns_modreplica but has the additional arguments:

       fs     specifies the mount point  of  the  dedicated  filesystem  (this
              argument is only meaningful for the Disk Pool Manager).

       r_type may be one of the following:

              P      Primary

              S      Secondary.

RETURN VALUE

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

ERRORS

       ENOENT       The named replica does not exist.

       EACCES       Search permission is denied on a component of  the  parent
                    directory  or  the  effective  user  ID does not match the
                    owner of the file or read permission  on  the  file  entry
                    itself is denied.

       EFAULT       sfn is a NULL pointer.

       EINVAL       The  length  of setname exceeds 36, the length of poolname
                    exceeds CA_MAXPOOLNAMELEN or the length of server  exceeds
                    CA_MAXHOSTNAMELEN.

       ENAMETOOLONG The length of sfn exceeds CA_MAXSFNLEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       ENSNACT      Name server is not running or is being shutdown.

SEE ALSO

       Castor_limits(4), dpns_addreplica(3), dpns_listreplica(3)