lfc_listlinks man page


lfc_listlinks - list link entries for a given file

[1m#include <sys/types.h>[0m
[1m#include "lfc_api.h"[0m

[1mstruct lfc_linkinfo *lfc_listlinks (const char *[4m[22mpath[24m[1m, const char *[4m[22mguid[24m[1m,[0m
[1mint [4m[22mflags[24m[1m, lfc_list *[4m[22mlistp[24m[1m)[0m

[1mlfc_listlinks [22mlists link entries for a given file. The first entry in
the list is the actual file name, while the other entries are the sym-
bolic links pointing at this file.

[4mpath[24m specifies the logical pathname.

[4mguid[24m specifies the Grid Unique IDentifier.

[4mflags[24m may be one of the following constant:

the first call must have this flag set to allocate buf-
fers and initialize pointers.

all the following calls must have this flag set.

final call to terminate the list and free resources.

This routine returns a pointer to a structure containing the current
link entry if the operation was successful or NULL if all entries have
been returned or if the operation failed. In the latter case, [1mserrno [22mis
set appropriately.

[1mENOENT [22mThe named file does not exist.

[1mEACCES [22mSearch permission is denied on a component of the parent

[1mENOMEM [22mMemory could not be allocated for the output buffer.

[1mEFAULT [4m[22mpath[24m and [4mguid[24m are NULL pointers or [4mlistp[24m is a NULL

[1mENOTDIR [22mA component of [4mpath[24m prefix is not a directory.

[1mEINVAL [22mThe length of [4mguid[24m exceeds [1mCA_MAXGUIDLEN [22mor path and guid
are both given and they point at a different file.

[1mENAMETOOLONG [22mThe length of [4mpath[24m exceeds [1mCA_MAXPATHNAMELEN[22m.

[1mSENOSHOST [22mHost unknown.

[1mSENOSSERV [22mService unknown.

[1mSECOMERR [22mCommunication error.

[1mENSNACT [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
[1mCastor_limits(4)[22m, [1mlfc_symlink(3)[0m

LFC $Date: 2010-09-14 13:37:49 +0200 (Tue, 14 Sep 2010L)FC$_LISTLINKS(3)