1DPM_RM(3)                         DPM      Library      Functions
2DPM_RM(3)
3
4
5
6[1mNAME[0m
7       dpm_rm ‐ delete a set of files
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint    dpm_rm    (int    [4m[22mnbsurls[24m[1m,    char
14**[4m[22msurls[24m[1m,  int  *[4m[22mnbreplies[24m[1m,  struct[0m
15       [1mdpm_filestatus **[4m[22mfilestatuses[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mdpm_rm  [22mdeletes  a  set of files from disk and from
19the name space.
20
21       The input arguments are:
22
23       [4mnbsurls[0m
24              specifies the number of files belonging to the  re‐
25quest.
26
27       [4msurls[24m  specifies the array of file names.
28
29       The output arguments are:
30
31       [4mnbreplies[0m
32              will  be  set to the number of replies in the array
33of  file  sta‐
34              tuses.
35
36       [4mfilestatuses[0m
37              will   be  set  to  the  address  of  an  array  of
38dpm_filestatus struc‐
39              tures  allocated by the API. The client application
40is  responsi‐
41              ble for freeing the array when not needed anymore.
42
43       struct dpm_filestatus {
44            char      *surl;
45            int       status;
46            char      *errstring;
47       };
48
49[1mRETURN VALUE[0m
50       This  routine  returns  0  if the operation was successful
51or ‐1 if the
52       operation failed. In the latter case, [1mserrno [22mis set
53appropriately.
54
55[1mERRORS[0m
56       [1mEFAULT        [4m[22msurls[24m,   [4mnbreplies[24m   or
57[4mfilestatuses[24m is a NULL pointer.
58
59       [1mENOMEM       [22mMemory could not be allocated for mar‐
60shalling the request.
61
62       [1mEINVAL       [4m[22mnbsurls[24m is not  strictly  posi‐
63tive or all file requests have
64                    errors.
65
66       [1mSENOSHOST    [22mHost unknown.
67
68       [1mSEINTERNAL   [22mDatabase error.
69
70       [1mSECOMERR     [22mCommunication error.
71
72
73
74LCG                         $Date:    2004/12/15    08:31:49    $
75DPM_RM(3)
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132