1LFC_GETLINKS(3)                   LFC      Library      Functions
2LFC_GETLINKS(3)
3
4
5
6[1mNAME[0m
7       lfc_getlinks ‐ get the link entries associated with a giv‐
8en file
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "lfc_api.h"[0m
13
14       [1mint   lfc_getlinks   (const  char  *[4m[22mpath[24m[1m,
15const char *[4m[22mguid[24m[1m, int *[4m[22mnbentries[24m[1m,[0m
16       [1mstruct lfc_linkinfo **[4m[22mlinkinfos[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mlfc_getlinks [22mgets the link entries associated  with
20a given  file.   The
21       first   entry   in   the  list  is  the  actual file name,
22while the other
23       entries are the symbolic links pointing at this file.
24
25       The file can  be  specified  by  [4mpath[24m  name  or  by
26[4mguid[24m.  If both are  given,
27       they must point at the same file.
28
29       [4mpath[24m    specifies  the  logical  pathname  relative
30to  the current LFC
31              directory or the full LFC pathname.
32
33       [4mguid[24m   specifies the Grid Unique IDentifier.
34
35       [4mnbentries[0m
36              will be set to the number of entries in  the  array
37of link infos.
38
39       [4mlink_entries[0m
40              will  be  set  to  the  address  of  an  array   of
41lfc_linkinfo  struc‐
42              tures  allocated by the API. The client application
43is responsi‐
44              ble for freeing the array when not needed anymore.
45
46       struct lfc_linkinfo {
47            char      path[CA_MAXPATHLEN+1];
48       };
49
50[1mRETURN VALUE[0m
51       This routine returns 0 if the operation was successful  or
52‐1  if  the
53       operation failed. In the latter case, [1mserrno [22mis set
54appropriately.
55
56[1mERRORS[0m
57       [1mENOENT       [22mThe named file does not exist.
58
59       [1mEACCES        [22mSearch   permission  is  denied  on a
60component of the [4mpath[0m
61                    prefix.
62
63       [1mENOMEM       [22mMemory could not be allocated for  un‐
64marshalling the reply.
65
66       [1mEFAULT        [4m[22mpath[24m  and [4mguid[24m are NULL
67pointers or [4mnbentries[24m or  [4mlinkinfos[0m
68                    is a NULL pointer.
69
70       [1mENOTDIR      [22mA component of [4mpath[24m  prefix  is
71not a directory.
72
73       [1mEINVAL        [22mThe   length  of  [4mguid[24m exceeds
74[1mCA_MAXGUIDLEN [22mor path and guid
75                    are both given and they point at a  different
76file.
77
78       [1mENAMETOOLONG  [22mThe  length  of  [4mpath[24m  exceeds
79[1mCA_MAXPATHLEN [22mor the length  of
80                    a [4mpath[24m  component  exceeds  [1mCA_MAX‐
81NAMELEN[22m.
82
83       [1mSENOSHOST    [22mHost unknown.
84
85       [1mSENOSSERV    [22mService unknown.
86
87       [1mSECOMERR     [22mCommunication error.
88
89       [1mENSNACT      [22mName server is not running or is being
90shutdown.
91
92[1mSEE ALSO[0m
93       [1mCastor_limits(4)[22m, [1mlfc_chdir(3)[0m
94
95[1mAUTHOR[0m
96       [1mLCG Grid Deployment [22mTeam
97
98
99
100LFC                         $Date:    2006/04/26    10:12:35    $
101LFC_GETLINKS(3)
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