1LFC_GETREPLICAS(3)                LFC      Library      Functions
2LFC_GETREPLICAS(3)
3
4
5
6[1mNAME[0m
7       lfc_getreplicas  ‐  get  the  replica  entries  associated
8with a list of
9       GUIDs
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "lfc_api.h"[0m
14
15       [1mint  lfc_getreplicas  (int [4m[22mnbguids[24m[1m, const
16char **[4m[22mguids[24m[1m, const  char  *[4m[22mse[24m[1m,[0m
17       [1mint *[4m[22mnbentries[24m[1m,  struct  lfc_filereplicas
18**[4m[22mrep_entries[24m[1m)[0m
19
20[1mDESCRIPTION[0m
21       [1mlfc_getreplicas  [22mgets  the  replica  entries  asso‐
22ciated with a list of
23       GUIDs.
24
25       [4mnbguids[0m
26              specifies  the  number  of  guids  in   the   array
27[4mguids[24m.
28
29       [4mguids[24m   specifies  the  list of Grid Unique IDenti‐
30fiers.
31
32       [4mse[24m     allows to restrict the replica entries to  a
33given SE.
34
35       [4mnbentries[0m
36              will  be  set to the number of entries in the array
37of replicas.
38
39       [4mrep_entries[0m
40              will be set to the   address   of   an   array   of
41lfc_filereplicas
42              structures   allocated   by  the  API.  The  client
43application is
44              responsible for freeing the array when  not  needed
45anymore.
46
47       struct lfc_filereplicas {
48            char      guid[CA_MAXGUIDLEN+1];
49            int       errcode;
50            u_signed64     filesize;
51            time_t          ctime;          /* GUID creation time
52*/
53            char      csumtype[3];
54            char      csumvalue[33];
55            time_t         r_ctime;  /* replica creation time */
56            time_t         r_atime;  /* last access to replica */
57            char      status;
58            char      host[CA_MAXHOSTNAMELEN+1];
59            char      sfn[CA_MAXSFNLEN+1];
60       };
61
62[1mRETURN VALUE[0m
63       This routine returns 0 if the operation was successful  or
64‐1  if  the
65       operation failed. In the latter case, [1mserrno [22mis set
66appropriately.
67
68[1mERRORS[0m
69       [1mENOENT       [22mThe named guid does not exist.
70
71       [1mENOMEM       [22mMemory  could  not  be  allocated  for
72marshalling the request
73                    or unmarshalling the reply.
74
75       [1mEFAULT         [4m[22mguids[24m,   [4mnbentries[24m  or
76[4mrep_entries[24m is a NULL pointer.
77
78       [1mEINVAL       [4m[22mnbguids[24m is not  strictly  posi‐
79tive, the length of one of the
80                    [4mguids[24m     exceeds     [1mCA_MAXGUIDLEN
81[22mor the length of [4mse[24m exceeds
82                    [1mCA_MAXHOSTNAMELEN[22m.
83
84       [1mSENOSHOST    [22mHost unknown.
85
86       [1mSENOSSERV    [22mService unknown.
87
88       [1mSEINTERNAL   [22mDatabase error.
89
90       [1mSECOMERR     [22mCommunication error.
91
92       [1mENSNACT      [22mName server is not running or is being
93shutdown.
94
95[1mSEE ALSO[0m
96       [1mCastor_limits(4)[22m, [1mlfc_chdir(3)[0m
97
98[1mAUTHOR[0m
99       [1mLCG Grid Deployment [22mTeam
100
101
102
103LFC                                                        $Date$
104LFC_GETREPLICAS(3)
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
Impressum