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