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

NAME

6       dpm_getstatus_putreq - get status for a dpm_put request
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpm_api.h"
11
12       int dpm_getstatus_putreq (char *r_token, int nbtosurls, char **tosurls,
13       int *nbreplies, struct dpm_putfilestatus **filestatuses)
14

DESCRIPTION

16       dpm_getstatus_putreq gets status for a dpm_put request.
17
18       The input arguments are:
19
20       r_token
21              specifies the token returned by a previous put request.
22
23       nbtosurls
24              specifies the number of files for which the status is requested.
25              If zero, the status of all files in the put request is returned.
26
27       tosurls
28              specifies the array of file names.
29
30       The output arguments are:
31
32       nbreplies
33              will  be  set to the number of replies in the array of file sta‐
34              tuses.
35
36       filestatuses
37              will be set to the address  of  an  array  of  dpm_putfilestatus
38              structures  allocated  by  the  API.  The  client application is
39              responsible for freeing the array when not needed anymore.
40
41       struct dpm_putfilestatus {
42            char      *to_surl;
43            char      *turl;
44            u_signed64     filesize;
45            int       status;
46            char      *errstring;
47            time_t    pintime;
48            time_t    f_lifetime;
49       };
50

RETURN VALUE

52       This routine returns 0 if the operation was successful  or  -1  if  the
53       operation failed. In the latter case, serrno is set appropriately.
54

ERRORS

56       EFAULT       nbtosurls  is  strictly  positive  and  tosurls is NULL or
57                    r_token, nbreplies or filestatuses is a NULL pointer.
58
59       ENOMEM       Memory could not be allocated for marshalling the request.
60
61       EINVAL       nbtosurls is not positive, the token is invalid/unknown or
62                    all file requests have errors.
63
64       SENOSHOST    Host unknown.
65
66       SEINTERNAL   Database error.
67
68       SECOMERR     Communication error.
69
70
71
72LCG                      $Date: 2006/12/20 15:59:47 $  DPM_GETSTATUS_PUTREQ(3)
Impressum