1LFC_LISTLINKS(3)             LFC Library Functions            LFC_LISTLINKS(3)
2
3
4

NAME

6       lfc_listlinks - list link entries for a given file
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "lfc_api.h"
11
12       struct lfc_linkinfo *lfc_listlinks (const char *path, const char *guid,
13       int flags, lfc_list *listp)
14

DESCRIPTION

16       lfc_listlinks lists link entries for a given file.  The first entry  in
17       the  list is the actual file name, while the other entries are the sym‐
18       bolic links pointing at this file.
19
20       path   specifies the logical pathname.
21
22       guid   specifies the Grid Unique IDentifier.
23
24       flags  may be one of the following constant:
25
26              CNS_LIST_BEGIN
27                     the first call must have this flag set to  allocate  buf‐
28                     fers and initialize pointers.
29
30              CNS_LIST_CONTINUE
31                     all the following calls must have this flag set.
32
33              CNS_LIST_END
34                     final call to terminate the list and free resources.
35

RETURN VALUE

37       This  routine  returns  a pointer to a structure containing the current
38       link entry if the operation was successful or NULL if all entries  have
39       been returned or if the operation failed. In the latter case, serrno is
40       set appropriately.
41

ERRORS

43       ENOENT       The named file does not exist.
44
45       EACCES       Search permission is denied on a component of  the  parent
46                    directory.
47
48       ENOMEM       Memory could not be allocated for the output buffer.
49
50       EFAULT       path  and  guid  are  NULL  pointers  or  listp  is a NULL
51                    pointer.
52
53       ENOTDIR      A component of path prefix is not a directory.
54
55       EINVAL       The length of guid exceeds CA_MAXGUIDLEN or path and  guid
56                    are both given and they point at a different file.
57
58       ENAMETOOLONG The length of path exceeds CA_MAXPATHNAMELEN.
59
60       SENOSHOST    Host unknown.
61
62       SENOSSERV    Service unknown.
63
64       SECOMERR     Communication error.
65
66       ENSNACT      Name server is not running or is being shutdown.
67

SEE ALSO

69       Castor_limits(4), lfc_symlink(3)
70
71
72
73LFC          $Date: 2010-09-14 13:37:49 +0200 (Tue, 14 Sep 2010L)FC$_LISTLINKS(3)
Impressum