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

NAME

6       dpm_getstatus_copyreq - get status for a dpm_copy request
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpm_api.h"
11
12       int  dpm_getstatus_copyreq  (char  *r_token,  int nbsurls, char **from‐
13       surls,  char  **tosurls,  int  *nbreplies,  struct   dpm_copyfilestatus
14       **filestatuses)
15

DESCRIPTION

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

RETURN VALUE

56       This routine returns 0 if the operation was successful  or  -1  if  the
57       operation failed. In the latter case, serrno is set appropriately.
58

ERRORS

60       EFAULT       nbsurls  is  strictly positive and fromsurls or tosurls is
61                    NULL or r_token,  nbreplies  or  filestatuses  is  a  NULL
62                    pointer.
63
64       ENOMEM       Memory could not be allocated for marshalling the request.
65
66       EINVAL       nbsurls  is  not positive, the token is invalid/unknown or
67                    all file requests have errors.
68
69       SENOSHOST    Host unknown.
70
71       SEINTERNAL   Database error.
72
73       SECOMERR     Communication error.
74
75
76
77LCG                      $Date: 2006/12/20 15:55:16 $ DPM_GETSTATUS_COPYREQ(3)
Impressum