NAME
lfc_getreplicas - get the replica entries associated with a list of
GUIDs
SYNOPSIS
#include <sys/types.h>
#include "lfc_api.h"
int lfc_getreplicas (int nbguids, const char **guids, const char *se,
int *nbentries, struct lfc_filereplicas **rep_entries)
DESCRIPTION
lfc_getreplicas gets the replica entries associated with a list of
GUIDs.
nbguids
specifies the number of guids in the array guids.
guids specifies the list of Grid Unique IDentifiers.
se allows to restrict the replica entries to a given SE.
nbentries
will be set to the number of entries in the array of replicas.
rep_entries
will be set to the address of an array of lfc_filereplicas
structures allocated by the API. The client application is
responsible for freeing the array when not needed anymore.
struct lfc_filereplicas {
char guid[CA_MAXGUIDLEN+1];
int errcode;
u_signed64 filesize;
time_t ctime; /* GUID creation time */
char csumtype[3];
char csumvalue[33];
time_t r_ctime; /* replica creation time */
time_t r_atime; /* last access to replica */
char sfn[CA_MAXSFNLEN+1];
};
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 guid does not exist.
ENOMEM Memory could not be allocated for marshalling the request
or unmarshalling the reply.
EFAULT guids, nbentries or rep_entries is a NULL pointer.
EINVAL nbguids is not strictly positive, the length of one of the
guids exceeds CA_MAXGUIDLEN or the length of se exceeds
CA_MAXHOSTNAMELEN.
SENOSHOST Host unknown.
SENOSSERV Service unknown.
SEINTERNAL Database error.
SECOMERR Communication error.
ENSNACT Name server is not running or is being shutdown.
SEE ALSO
Castor_limits(4), lfc_chdir(3)
AUTHOR
LCG Grid Deployment Team