dpns_addreplica man page

DPNS_ADDREPLICA(3)          DPNS Library Functions          DPNS_ADDREPLICA(3)

[1mNAME[0m
      dpns_addreplica - add a replica for a given file

[1mSYNOPSIS[0m
      [1m#include <sys/types.h>[0m
      [1m#include "dpns_api.h"[0m

      [1mint    dpns_addreplica    (const   char   *[4m[22mguid[24m[1m,   struct   dpns_fileid[0m
      [1m*[4m[22mfile_uniqueid[24m[1m, const char *[4m[22mserver[24m[1m, const char *[4m[22msfn[24m[1m, const char [4m[22mstatus[24m[1m,[0m
      [1mconst char [4m[22mf_type[24m[1m, const char *[4m[22mpoolname[24m[1m, const char *[4m[22mfs[24m[1m)[0m

      [1mint    dpns_addreplicax   (const   char   *[4m[22mguid[24m[1m,   struct   dpns_fileid[0m
      [1m*[4m[22mfile_uniqueid[24m[1m, const char *[4m[22mserver[24m[1m, const char *[4m[22msfn[24m[1m, const char [4m[22mstatus[24m[1m,[0m
      [1mconst  char  [4m[22mf_type[24m[1m,  const  char *[4m[22mpoolname[24m[1m, const char *[4m[22mfs[24m[1m, const char[0m
      [4mr_type[24m[1m, const char *[4m[22msetname[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_addreplica [22madds a replica for a given file.  The file can be spec-
      ified by [4mguid[24m or by [4mfile_uniqueid[24m.  If both are given, [4mfile_uniqueid[24m is
      used.

      [4mguid[24m   specifies the Grid Unique IDentifier.

      [4mserver[24m is either the Storage Element fully qualified  hostname  or  the
             disk server.

      [4msfn[24m    is  either  the  Site  URL  or  the  Physical  File Name for the
             replica.

      [4mstatus[24m can be set to

             [1m-      [22mfile is available

             [1mP      [22mfile is being populated

             [1mD      [22mfile is being deleted.

      [4mf_type[24m may be one of the following:

             [1mV      [22mVolatile

             [1mD      [22mDurable

             [1mP      [22mPermanent.

      [4mpoolname[0m
             specifies the disk pool name (this argument is  only  meaningful
             for the Disk Pool Manager).

      [4mfs[24m     specifies  the  mount  point  of  the dedicated filesystem (this
             argument is only meaningful for the Disk Pool Manager).

      [4mr_type[24m may be one of the following:

             [1mP      [22mPrimary

             [1mS      [22mSecondary.

      [4msetname[0m
             is either the replica set name or the space token.

[1mRETURN VALUE[0m
      This routine returns 0 if the operation was successful  or  -1  if  the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mENOENT       [22mThe named file does not exist.

      [1mEACCES       [22mSearch  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.

      [1mEFAULT       [4m[22mguid[24m and [4mfile_uniqueid[24m are NULL pointers or [4mserver[24m or  [4msfn[0m
                   is a NULL pointer.

      [1mEEXIST       [22mThe [4msfn[24m exists already.

      [1mEISDIR       [22mThe file is not a regular file.

      [1mEINVAL       [22mThe  length  of  [4mguid[24m exceeds [1mCA_MAXGUIDLEN[22m, the length of
                   [4mserver[24m exceeds [1mCA_MAXHOSTNAMELEN[22m, the length  of  [4mpoolname[0m
                   exceeds  [1mCA_MAXPOOLNAMELEN  [22mor the length of [4mfs[24m exceeds 79
                   or [4msetname[24m exceeds 36.

      [1mENAMETOOLONG [22mThe length of [4msfn[24m exceeds [1mCA_MAXSFNLEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

      [1mENSNACT      [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
      [1mCastor_limits(4)[22m, [1mdpns_delreplica(3)[22m, [1mdpns_listreplica(3)[0m

DPNS                     $Date: 2006/12/01 09:19:37 $       DPNS_ADDREPLICA(3)

Referenced By

dpns_addreplicax(3) is an alias of dpns_addreplica(3).