lfc_listrepset man page

LFC_LISTREPSET(3)            LFC Library Functions           LFC_LISTREPSET(3)

[1mNAME[0m
      lfc_listrepset - list replica entries that belong to a given set

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

      [1mstruct  lfc_filereplicax  *lfc_listrepset  (const  char  *[4m[22msetname[24m[1m,  int[0m
      [4mflags[24m[1m, lfc_list *[4m[22mlistp[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mlfc_listrepset [22mlists replica entries that belong to a given set.   This
      routine returns a pointer to a structure containing the current replica
      entry.

      struct lfc_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];
      };

      [4msetname[0m
             is either the replica set name or the space token.

      [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
      replica entry if the operation was successful or NULL  if  all  entries
      have been returned or if the operation failed. In the latter case, [1mser-[0m
      [1mrno [22mis set appropriately.

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

      [1mEFAULT       [4m[22msetname[24m or [4mlistp[24m is a NULL pointer.

      [1mEINVAL       [22mThe length of [4msetname[24m exceeds 36.

      [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_addreplicax(3)[22m, [1mlfc_modreplica(3)[0m

LFC                      $Date: 2006/12/01 09:19:37 $        LFC_LISTREPSET(3)