1LFC_LISTLINKS(3)                  LFC      Library      Functions
2LFC_LISTLINKS(3)
3
4
5
6[1mNAME[0m
7       lfc_listlinks ‐ list link entries for a given file
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "lfc_api.h"[0m
12
13       [1mstruct   lfc_linkinfo   *lfc_listlinks   (const    char
14*[4m[22mpath[24m[1m, const char *[4m[22mguid[24m[1m,[0m
15       [1mint            [4m[22mflags[24m[1m,            lfc_list
16*[4m[22mlistp[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mlfc_listlinks [22mlists link entries for a given  file.
20The first entry  in
21       the  list is the actual file name, while the other entries
22are the sym‐
23       bolic links pointing at this file.
24
25       [4mpath[24m   specifies the logical pathname.
26
27       [4mguid[24m   specifies the Grid Unique IDentifier.
28
29       [4mflags[24m  may be one of the following constant:
30
31              [1mCNS_LIST_BEGIN[0m
32                     the first call must have this  flag  set  to
33allocate  buf‐
34                     fers and initialize pointers.
35
36              [1mCNS_LIST_CONTINUE[0m
37                     all  the following calls must have this flag
38set.
39
40              [1mCNS_LIST_END[0m
41                     final call to terminate the  list  and  free
42resources.
43
44[1mRETURN VALUE[0m
45       This   routine  returns  a pointer to a structure contain‐
46ing the current
47       link entry if the operation was successful or NULL if  all
48entries  have
49       been  returned  or  if the operation failed. In the latter
50case, [1mserrno [22mis
51       set appropriately.
52
53[1mERRORS[0m
54       [1mENOENT       [22mThe named file does not exist.
55
56       [1mEACCES       [22mSearch permission is denied on a  com‐
57ponent of  the  parent
58                    directory.
59
60       [1mENOMEM        [22mMemory could not be allocated for the
61output buffer.
62
63       [1mEFAULT        [4m[22mpath[24m   and   [4mguid[24m   are
64NULL  pointers  or  [4mlistp[24m  is a NULL
65                    pointer.
66
67       [1mENOTDIR       [22mA  component of [4mpath[24m prefix is
68not a directory.
69
70       [1mEINVAL        [22mThe  length  of  [4mguid[24m  exceeds
71[1mCA_MAXGUIDLEN [22mor path and  guid
72                    are  both given and they point at a different
73file.
74
75       [1mENAMETOOLONG  [22mThe  length  of  [4mpath[24m  exceeds
76[1mCA_MAXPATHNAMELEN[22m.
77
78       [1mSENOSHOST    [22mHost unknown.
79
80       [1mSENOSSERV    [22mService unknown.
81
82       [1mSECOMERR     [22mCommunication error.
83
84       [1mENSNACT      [22mName server is not running or is being
85shutdown.
86
87[1mSEE ALSO[0m
88       [1mCastor_limits(4)[22m, [1mlfc_symlink(3)[0m
89
90
91
92LFC                                                        $Date$
93LFC_LISTLINKS(3)
94
95
96
97
98
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