1DPM_GETPOOLFS(3)             DPM Library Functions            DPM_GETPOOLFS(3)
2
3
4

NAME

6       dpm_getpoolfs - get list of filesystems for a given pool
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpm_api.h"
11
12       int dpm_getpoolfs (char *poolname, int *nbfs, struct dpm_fs **dpm_fs)
13

DESCRIPTION

15       dpm_getpoolfs gets list of filesystems for a given pool.
16
17       The input argument is:
18
19       poolname
20              specifies   the   disk   pool   name  previously  defined  using
21              dpm_addpool.
22
23       The output arguments are:
24
25       nbfs   will be set to the number of replies in the  array  of  filesys‐
26              tems.
27
28       dpm_fs will  be  set  to  the  address of an array of dpm_fs structures
29              allocated by the API. The client application is responsible  for
30              freeing the array when not needed anymore.
31
32       struct dpm_fs {
33            char      poolname[CA_MAXPOOLNAMELEN+1];
34            char      server[CA_MAXHOSTNAMELEN+1];
35            char      fs[80];
36            u_signed64     capacity;
37            u_signed64     free;
38            int       status;
39       };
40

RETURN VALUE

42       This  routine  returns  0  if the operation was successful or -1 if the
43       operation failed. In the latter case, serrno is set appropriately.
44

ERRORS

46       EFAULT       poolname, nbfs or dpm_fs is a NULL pointer.
47
48       ENOMEM       Memory could not be allocated for storing the reply.
49
50       EINVAL       The pool is unknown or  the  length  of  poolname  exceeds
51                    CA_MAXPOOLNAMELEN.
52
53       SENOSHOST    Host unknown.
54
55       SECOMERR     Communication error.
56
57
58
59LCG                      $Date: 2004/12/15 11:04:36 $         DPM_GETPOOLFS(3)
Impressum