dpm_rm3
Delete a set of files
Usage
#include <sys/types.h>
#include "dpm_api.h"
int dpm_rm (int nbsurls, char **surls, int *nbreplies, struct dpm_filestatus **filestatuses)
Overview
dpm_rm deletes a set of files from disk and from the name space.
The input arguments are:
nbsurls
|
specifies the number of files belonging to the request. |
|---|---|
surls
|
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_filestatus structures allocated by the API. The client application is responsible for freeing the array when not needed anymore.
struct dpm_filestatus {char *surl;int status;char *errstring;};
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
|
surls, nbreplies or filestatuses is a NULL pointer. |
|---|---|
ENOMEM
|
Memory could not be allocated for marshalling the request. |
EINVAL
|
nbsurls is not strictly positive or all file requests have errors. |
SENOSHOST
|
Host unknown. |
SEINTERNAL
|
Database error. |
SECOMERR
|
Communication error. |
Releases
Unchanged in 5 releases since Debian 6.0 (Squeeze).