DPNS_LISTREPLICAX(3) | DPNS Library Functions | DPNS_LISTREPLICAX(3) |
dpns_listreplicax - list replica entries for a given pool/server/filesystem
#include <sys/types.h>
#include "dpns_api.h"
struct dpns_filereplica *dpns_listreplicax (const char *poolname, const char *server, const char *fs, int flags, dpns_list *listp)
dpns_listreplicax lists replica entries for a given pool/server/filesystem. This routine returns a pointer to a structure containing the current replica entry.
struct dpns_filereplica { u_signed64 fileid; u_signed64 nbaccesses; time_t atime; /* last access to replica */ time_t ptime; /* replica pin time */ char status; char f_type; /* 'V' for Volatile, 'P' for Permanent */ char poolname[CA_MAXPOOLNAMELEN+1]; char host[CA_MAXHOSTNAMELEN+1]; char fs[80]; char sfn[CA_MAXSFNLEN+1]; };
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, serrno is set appropriately.
A C program listing the files residing on a given server could look like:
int flags; dpns_list list; struct dpns_filereplica *lp; flags = CNS_LIST_BEGIN; while ((lp = dpns_listreplicax (NULL, server, NULL, flags, &list))) { flags = CNS_LIST_CONTINUE; /* process the entry */ ..... } (void) dpns_listreplicax (NULL, server, NULL, CNS_LIST_END, &list);
$Date: 2005/07/21 08:31:48 $ | DPNS |