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).