Content-type: text/html
Man page of LFC_GETREPLICAS
LFC_GETREPLICAS
Section: LFC Library Functions (3)
Updated: $Date: 2008/09/29 08:02:48 $
Index
Return to Main Contents
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
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ERRORS
-
- SEE ALSO
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 11:46:11 GMT, June 26, 2009