lfc_getreplicasl man page

LFC_GETREPLICASL(3)          LFC Library Functions         LFC_GETREPLICASL(3)

[1mNAME[0m
      lfc_getreplicasl  -  get  the replica entries associated with a list of
      path names

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

      [1mint lfc_getreplicasl (int [4m[22mnbfiles[24m[1m, const char **[4m[22mpaths[24m[1m, const char  *[4m[22mse[24m[1m,[0m
      [1mint *[4m[22mnbentries[24m[1m, struct lfc_filereplicas **[4m[22mrep_entries[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mlfc_getreplicasl  [22mgets  the  replica  entries associated with a list of
      path names.

      [4mnbfiles[0m
             specifies the number of path names in the array [4mpaths[24m.

      [4mpaths[24m  specifies the list of logical path names relative to the current
             LFC directory or the list of full LFC path names.

      [4mse[24m     allows to restrict the replica entries to a given SE.

      [4mnbentries[0m
             will be set to the number of entries in the array of replicas.

      [4mrep_entries[0m
             will  be  set  to  the  address  of an array of lfc_filereplicas
             structures allocated by  the  API.  The  client  application  is
             responsible for freeing the array when not needed anymore.

      struct lfc_filereplicas {
           char      guid[CA_MAXGUIDLEN+1];
           int       errcode;
           u_signed64     filesize;
           time_t         ctime;         /* GUID creation time */
           char      csumtype[3];
           char      csumvalue[33];
           time_t         r_ctime;  /* replica creation time */
           time_t         r_atime;  /* last access to replica */
           char      status;
           char      host[CA_MAXHOSTNAMELEN+1];
           char      sfn[CA_MAXSFNLEN+1];
      };

[1mRETURN VALUE[0m
      This  routine  returns  0  if the operation was successful or -1 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  [4mpath[0m
                   prefix.

      [1mENOMEM       [22mMemory  could not be allocated for marshalling the request
                   or unmarshalling the reply.

      [1mEFAULT       [4m[22mpaths[24m, [4mnbentries[24m or [4mrep_entries[24m is a NULL pointer.

      [1mEINVAL       [4m[22mnbfiles[24m is not strictly  positive  or  the  length  of  [4mse[0m
                   exceeds [1mCA_MAXHOSTNAMELEN[22m.

      [1mENAMETOOLONG [22mThe  length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length of
                   a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSEINTERNAL   [22mDatabase error.

      [1mSECOMERR     [22mCommunication error.

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

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

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

LFC          $Date: 2010-09-13 07:52:37 +0200 (Mon, 13 Sep 2L0F1C0_)GE$TREPLICASL(3)