dpm_getpools(3) [debian man page]
DPM_GETPOOLS(3) DPM Library Functions DPM_GETPOOLS(3) NAME
dpm_getpools - get list of pools SYNOPSIS
#include <sys/types.h> #include "dpm_api.h" int dpm_getpools (int *nbpools, struct dpm_pool **dpm_pools) DESCRIPTION
dpm_getpools gets list of pools. The output arguments are: nbpools will be set to the number of replies in the array of pools. dpm_pools will be set to the address of an array of dpm_pool structures allocated by the API. The client application is responsible for free- ing the array when not needed anymore. This is also necessary for the gids entry of each dpm_pool. struct dpm_pool { char poolname[CA_MAXPOOLNAMELEN+1]; u_signed64 defsize; int gc_start_thresh; int gc_stop_thresh; int def_lifetime; int defpintime; int max_lifetime; int maxpintime; char fss_policy[CA_MAXPOLICYLEN+1]; char gc_policy[CA_MAXPOLICYLEN+1]; char mig_policy[CA_MAXPOLICYLEN+1]; char rs_policy[CA_MAXPOLICYLEN+1]; int nbgids gid_t *gids; /* restrict the pool to given group(s) */ char ret_policy; /* retention policy: 'R', 'O' or 'C' */ char s_type; /* space type: 'V', 'D' or 'P' */ u_signed64 capacity; u_signed64 free; struct dpm_fs *elemp; int nbelem; int next_elem; /* next pool element to be used */ }; RETURN VALUE
This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case, serrno is set appropriately. ERRORS
EFAULT nbpools or dpm_pools is a NULL pointer. ENOMEM Memory could not be allocated for storing the reply. SENOSHOST Host unknown. SECOMERR Communication error. LCG
$Date: 2007/04/30 06:39:28 $ DPM_GETPOOLS(3)
Check Out this Related Man Page
DPM_GETSTATUS_GETREQ(3) DPM Library Functions DPM_GETSTATUS_GETREQ(3) NAME
dpm_getstatus_getreq - get status for a dpm_get request SYNOPSIS
#include <sys/types.h> #include "dpm_api.h" int dpm_getstatus_getreq (char *r_token, int nbfromsurls, char **fromsurls, int *nbreplies, struct dpm_getfilestatus **filestatuses) DESCRIPTION
dpm_getstatus_getreq gets status for a dpm_get request. The input arguments are: r_token specifies the token returned by a previous get request. nbfromsurls specifies the number of files for which the status is requested. If zero, the status of all files in the get request is returned. fromsurls specifies the array of file names. The output arguments are: nbreplies will be set to the number of replies in the array of file statuses. filestatuses will be set to the address of an array of dpm_getfilestatus structures allocated by the API. The client application is responsible for freeing the array when not needed anymore. struct dpm_getfilestatus { char *from_surl; char *turl; u_signed64 filesize; int status; char *errstring; time_t pintime; }; RETURN VALUE
This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case, serrno is set appropriately. ERRORS
EFAULT nbfromsurls is strictly positive and fromsurls is NULL or r_token, nbreplies or filestatuses is a NULL pointer. ENOMEM Memory could not be allocated for marshalling the request. EINVAL nbfromsurls is not positive, the token is invalid/unknown or all file requests have errors. SENOSHOST Host unknown. SEINTERNAL Database error. SECOMERR Communication error. LCG
$Date: 2006/03/23 06:12:41 $ DPM_GETSTATUS_GETREQ(3)