1LFC_GETREPLICASS(3)               LFC      Library      Functions
2LFC_GETREPLICASS(3)
3
4
5
6[1mNAME[0m
7       lfc_getreplicass  ‐  get  the replica  entries  associated
8with a list of
9       sfns
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "lfc_api.h"[0m
14
15       [1mint  lfc_getreplicass  (int [4m[22mnbsfns[24m[1m, const
16char  **[4m[22msfns[24m[1m,  int  *[4m[22mnbentries[24m[1m,[0m
17       [1mstruct lfc_filereplicas **[4m[22mrep_entries[24m[1m)[0m
18
19[1mDESCRIPTION[0m
20       [1mlfc_getreplicass  [22mgets  the  replica  entries asso‐
21ciated with a list of
22       sfns.
23
24       [4mnbsfns[24m  specifies  the  number of path names in the
25array [4msfns[24m.
26
27       [4msfns[24m   specifies the list of Site File Names.
28
29       [4mnbentries[0m
30              will be set to the number of entries in  the  array
31of replicas.
32
33       [4mrep_entries[0m
34              will  be  set  to  the   address  of  an  array  of
35lfc_filereplicas
36              structures  allocated  by  the  API.   The   client
37application is
38              responsible  for  freeing the array when not needed
39anymore.
40
41       struct lfc_filereplicas {
42            char      guid[CA_MAXGUIDLEN+1];
43            int       errcode;
44            u_signed64     filesize;
45            time_t         ctime;         /* GUID  creation  time
46*/
47            char      csumtype[3];
48            char      csumvalue[33];
49            time_t         r_ctime;  /* replica creation time */
50            time_t         r_atime;  /* last access to replica */
51            char      status;
52            char      host[CA_MAXHOSTNAMELEN+1];
53            char      sfn[CA_MAXSFNLEN+1];
54       };
55
56[1mRETURN VALUE[0m
57       This routine returns 0 if the operation was successful  or
58‐1  if  the
59       operation failed. In the latter case, [1mserrno [22mis set
60appropriately.
61
62[1mERRORS[0m
63       [1mENOENT       [22mThe named file does not exist.
64
65       [1mENOMEM        [22mMemory   could  not  be allocated for
66marshalling the request
67                    or unmarshalling the reply.
68
69       [1mEFAULT         [4m[22msfns[24m,   [4mnbentries[24m   or
70[4mrep_entries[24m is a NULL pointer.
71
72       [1mEINVAL        [4m[22mnbsfns[24m  is  not strictly posi‐
73tive.
74
75       [1mENAMETOOLONG  [22mThe  length  of  [4msfn[24m   exceeds
76[1mCA_MAXSFNLEN[22m.
77
78       [1mSENOSHOST    [22mHost unknown.
79
80       [1mSENOSSERV    [22mService unknown.
81
82       [1mSEINTERNAL   [22mDatabase error.
83
84       [1mSECOMERR     [22mCommunication error.
85
86       [1mENSNACT      [22mName server is not running or is being
87shutdown.
88
89[1mSEE ALSO[0m
90       [1mCastor_limits(4)[22m, [1mlfc_chdir(3)[0m
91
92[1mAUTHOR[0m
93       [1mLCG Grid Deployment [22mTeam
94
95
96
97LFC                                                        $Date$
98LFC_GETREPLICASS(3)
99
100
101
102
103
104
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