lfc_listlinks man page

LFC_LISTLINKS(3)             LFC Library Functions            LFC_LISTLINKS(3)

[1mNAME[0m
      lfc_listlinks - list link entries for a given file

[1mSYNOPSIS[0m
      [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

[1mDESCRIPTION[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:

             [1mCNS_LIST_BEGIN[0m
                    the first call must have this flag set to  allocate  buf-
                    fers and initialize pointers.

             [1mCNS_LIST_CONTINUE[0m
                    all the following calls must have this flag set.

             [1mCNS_LIST_END[0m
                    final call to terminate the list and free resources.

[1mRETURN VALUE[0m
      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.

[1mERRORS[0m
      [1mENOENT       [22mThe named file does not exist.

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

      [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
                   pointer.

      [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)