DPNS_ADDREPLICA
Section: DPNS Library Functions (3)
Updated: $Date: 2006/12/01 09:19:37 $
Index
Return to Main Contents
NAME
dpns_addreplica - add a replica for a given file
SYNOPSIS
#include <sys/types.h>
#include "dpns_api.h"
int dpns_addreplica (const char *guid,
struct dpns_fileid *file_uniqueid,
const char *server,
const char *sfn,
const char status,
const char f_type,
const char *poolname,
const char *fs)
int dpns_addreplicax (const char *guid,
struct dpns_fileid *file_uniqueid,
const char *server,
const char *sfn,
const char status,
const char f_type,
const char *poolname,
const char *fs,
const char r_type,
const char *setname)
DESCRIPTION
dpns_addreplica
adds a replica for a given file.
The file can be specified by
guid
or by
file_uniqueid.
If both are given,
file_uniqueid
is used.
- guid
-
specifies the Grid Unique IDentifier.
- server
-
is either the Storage Element fully qualified hostname or the disk server.
- sfn
-
is either the Site URL or the Physical File Name for the replica.
- status
-
can be set to
-
- -
-
file is available
- P
-
file is being populated
- D
-
file is being deleted.
- f_type
-
may be one of the following:
-
- V
-
Volatile
- D
-
Durable
- P
-
Permanent.
- poolname
-
specifies the disk pool name (this argument is only meaningful for the Disk Pool
Manager).
- 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.
- setname
-
is either the replica set name or the space token.
RETURN VALUE
This routine returns 0 if the operation was successful or -1 if the operation
failed. In the latter case,
serrno
is set appropriately.
ERRORS
- ENOENT
-
The named file 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
-
guid
and
file_uniqueid
are NULL pointers or
server
or
sfn
is a NULL pointer.
- EEXIST
-
The
sfn
exists already.
- EISDIR
-
The file is not a regular file.
- EINVAL
-
The length of
guid
exceeds
CA_MAXGUIDLEN,
the length of
server
exceeds
CA_MAXHOSTNAMELEN,
the length of
poolname
exceeds
CA_MAXPOOLNAMELEN
or the length of
fs
exceeds 79 or
setname
exceeds 36.
- 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_delreplica(3),
dpns_listreplica(3)