1LFC_LISTREPLICAX(3)               LFC      Library      Functions
2LFC_LISTREPLICAX(3)
3
4
5
6[1mNAME[0m
7       lfc_listreplicax    ‐    list    replica    entries    for
8a   given
9       pool/server/filesystem
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "lfc_api.h"[0m
14
15       [1mstruct  lfc_filereplica  *lfc_listreplicax  (const char
16*[4m[22mpoolname[24m[1m,  const[0m
17       [1mchar      *[4m[22mserver[24m[1m,       const       char
18*[4m[22mfs[24m[1m,      int     [4m[22mflags[24m[1m,     lfc_list
19*[4m[22mlistp[24m[1m)[0m
20
21[1mDESCRIPTION[0m
22       [1mlfc_listreplicax [22mlists replica entries for a  given
23pool/server/filesys‐
24       tem.   This  routine returns a pointer to a structure con‐
25taining the cur‐
26       rent replica entry.
27
28       struct lfc_filereplica {
29            u_signed64     fileid;
30            u_signed64     nbaccesses;
31            time_t          atime;          /*  last  access   to
32replica */
33            time_t         ptime;         /* replica pin time */
34            char      status;
35            char      f_type;        /* ’V’ for Volatile, ’P’ for
36Permanent */
37            char      poolname[CA_MAXPOOLNAMELEN+1];
38            char      host[CA_MAXHOSTNAMELEN+1];
39            char      fs[80];
40            char      sfn[CA_MAXSFNLEN+1];
41       };
42
43       [4mpoolname[0m
44              specifies the disk pool (only  meaningful  for  the
45DPM).
46
47       [4mserver[24m specifies the Storage Element or disk server
48hostname.
49
50       [4mfs[24m     specifies the file system  (only  meaningful
51for the DPM).
52
53       [4mflags[24m  may be one of the following constant:
54
55              [1mCNS_LIST_BEGIN[0m
56                     the   first  call must have this flag set to
57allocate buf‐
58                     fers and initialize pointers.
59
60              [1mCNS_LIST_CONTINUE[0m
61                     all the following calls must have this  flag
62set.
63
64              [1mCNS_LIST_END[0m
65                     final  call  to  terminate the list and free
66resources.
67
68[1mRETURN VALUE[0m
69       This routine returns a pointer to a structure   containing
70the  current
71       replica   entry   if  the operation was successful or NULL
72if all entries
73       have been returned or if the operation failed. In the lat‐
74ter case, [1mser‐[0m
75       [1mrno [22mis set appropriately.
76
77[1mEXAMPLES[0m
78       A   C   program   listing   the  files residing on a given
79server could look
80       like:
81
82            int flags;
83            lfc_list list;
84            struct lfc_filereplica *lp;
85
86            flags = CNS_LIST_BEGIN;
87            while ((lp = lfc_listreplicax  (NULL,  server,  NULL,
88flags, &list))) {
89                 flags = CNS_LIST_CONTINUE;
90                 /* process the entry */
91                 .....
92            }
93            (void)    lfc_listreplicax   (NULL,   server,   NULL,
94CNS_LIST_END, &list);
95
96[1mERRORS[0m
97       [1mENOMEM       [22mMemory could not be allocated for  the
98output buffer.
99
100       [1mEFAULT         [4m[22mpoolname[24m,  [4mserver[24m  and
101[4mfs[24m are NULL pointers or  [4mlistp[24m  is  a
102                    NULL pointer.
103
104       [1mEINVAL       [22mThe  length  of   [4mpoolname[24m  ex‐
105ceeds [1mCA_MAXPOOLNAMELEN [22mor the
106                    length  of  [4mserver[24m  exceeds [1mCA_MAX‐
107HOSTNAMELEN [22mor  the  length
108                    of [4mfs[24m exceeds 79.
109
110       [1mSENOSHOST    [22mHost unknown.
111
112       [1mSENOSSERV    [22mService unknown.
113
114       [1mSECOMERR     [22mCommunication error.
115
116       [1mENSNACT      [22mName server is not running or is being
117shutdown.
118
119[1mSEE ALSO[0m
120       [1mCastor_limits(4)[22m, [1mlfc_addreplica(3)[0m
121
122
123
124LFC                         $Date:    2005/07/21    08:31:48    $
125LFC_LISTREPLICAX(3)
126
127
128
129
130
131
132
Impressum