dpns_getreplicax man page

DPNS_GETREPLICAX(3)         DPNS Library Functions         DPNS_GETREPLICAX(3)

      dpns_getreplicax  - get the replica entries associated with a DPNS file
      in the name server

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

      [1mint dpns_getreplicax (const char *[4m[22mpath[24m[1m, const char  *[4m[22mguid[24m[1m,  const  char[0m
      [1m*[4m[22mse[24m[1m, int *[4m[22mnbentries[24m[1m, struct dpns_filereplicax **[4m[22mrep_entries[24m[1m)[0m

      [1mdpns_getreplicax  [22mgets  the replica entries associated with a DPNS file
      in the name server.

      The file can be specified by [4mpath[24m name or by [4mguid[24m.  If both are  given,
      they must point at the same file.

      [4mpath[24m   specifies  the  logical  pathname  relative  to the current DPNS
             directory or the full DPNS pathname.

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

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

             will be set to the number of entries in the array of replicas.

             will be set to the address  of  an  array  of  dpns_filereplicax
             structures  allocated  by  the  API.  The  client application is
             responsible for freeing the array when not needed anymore.

      struct dpns_filereplicax {
           u_signed64     fileid;
           u_signed64     nbaccesses;
           time_t         ctime;         /* replica creation time */
           time_t         atime;         /* last access to replica */
           time_t         ptime;         /* replica pin time */
           time_t         ltime;         /* replica lifetime */
           char      r_type;        /* 'P' for Primary, 'S' for Secondary */
           char      status;
           char      f_type;        /* 'V' for Volatile, 'P' for Permanent */
           char      setname[37];
           char      poolname[CA_MAXPOOLNAMELEN+1];
           char      host[CA_MAXHOSTNAMELEN+1];
           char      fs[80];
           char      sfn[CA_MAXSFNLEN+1];

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

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

      [1mEFAULT       [4m[22mpath[24m  and  [4mguid[24m  are  NULL  pointers   or   [4mnbentries[24m   or
                   [4mrep_entries[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 the length of
                   [4mse[24m exceeds [1mCA_MAXHOSTNAMELEN [22mor path  and  guid  are  both
                   given and they point at a different file.

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

      [1mSECOMERR     [22mCommunication error.

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

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

      [1mLCG Grid Deployment [22mTeam

DPNS                     $Date: 2006/12/01 09:19:37 $      DPNS_GETREPLICAX(3)