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)

Info