Content-type: text/html Man page of LCG_DEL

LCG_DEL

Section: Library Functions (3)
Updated: $Date: 2009/07/08 15:40:05 $
Index Return to Main Contents

NAME

lcg_del - delete files (SURLs or LFNs)

SYNOPSIS

#include "lcg_util.h"

int lcg_del (char *file, int aflag, char *se, char *vo, char *conf_file, int insecure, int verbose);

int lcg_delt (char *file, int aflag, char *se, char *vo, char *conf_file, int insecure, int verbose, int timeout);

int lcg_delx (char *file, int aflag, char *se, char *vo, char *conf_file, int insecure, int verbose, char *errbuf, int errbufsz);

int lcg_delxt (char *file, int aflag, char *se, char *vo, char *conf_file, int insecure, int verbose, int timeout, char *errbuf, int errbufsz);

int lcg_del3 (char *file, enum se_typedefaulttype, enum se_typesetype, int nobdii, int aflag, char *se, char *vo, char *conf_file, int insecure, int verbose, int timeout, char *errbuf, int errbufsz);

int lcg_del4 (char *file, enum se_typedefaulttype, enum se_typesetype, int nobdii, int nolfc, int aflag, char *se, char *vo, char *conf_file, int insecure, int verbose, int timeout, char *errbuf, int errbufsz);

int lcg_del5 (intnbfiles, char **files, enum se_typedefaulttype, enum se_typesetype, int nobdii, int nolfc, int aflag, char *se, char *vo, char *conf_file, int insecure, int verbose, int timeout, lcg_filestatus **statuses, char *errbuf, int errbufsz);

int lcg_del6 (intnbfiles, char **files, enum se_typedefaulttype, enum se_typesetype, int nobdii, int nolfc, int aflag, char *se, char *vo, char *conf_file, int insecure, int verbose, int bool_force, int timeout, lcg_filestatus **statuses, char *errbuf, int errbufsz);

int lcg_del7 (intnbfiles, char **files, enum se_typedefaulttype, enum se_typesetype, int nobdii, int nolfc, int aflag, char *se, char *vo, char *conf_file, int insecure, int verbose, int bool_force, int bool_rmdir, int timeout, lcg_filestatus **statuses, char *errbuf, int errbufsz);

DESCRIPTION

lcg_del deletes one file (either one replica or all replicas). If it was the last or only valid replica, the entries corresponding to this GUID are also removed from the RMC or the LFC.

file

specifies the Logical File Name, the Grid Unique IDentifier or the Site URL. An SURL scheme can be sfn: for a classical SE or srm:.

nbfiles

specifies the number of elements in files.

files

specifies a list of files of size nbfiles.

defaulttype

specifies the default SE type you want to use. Possible values are TYPE_NONE, TYPE_SE, TYPE_SRM, TYPE_SRMv2, for respectively no default type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type is not available for this SE, it will use another type.

setype

specifies the SE type you want to use for the source file. Possible values are TYPE_NONE, TYPE_SE, TYPE_SRM, TYPE_SRMv2, for respectively no type, classic SE, SRMv1, and SRMv2. But if according to the BDII the default type is not available for this SE, it will fail.

nobdii

If set to a non-zero value, it means that you don't want to make BDII calls to get SE type. So, you must provide the type of the SE for srm: arguments, and full endpoint in SURLs. For SE type, defaulttype can be used.

nolfc

If set to a non-zero value, it means that the SURL is not registered in any LFC server, and so you explicitely ask lcg_del to not connect to the LFC server.

aflag

An attempt is made to delete all replicas for the file specified as a GUID or LFN.

se

Only the replica residing on se is deleted.

vo

specifies the Virtual Organization the user belongs to. If it is not specified, the environment variable LCG_GFAL_VO will be used.

conf_file

This argument is currently ignored.

insecure

This argument is currently ignored. The access to the Replica Catalog or the LFC is done according to the endpoints published in MDSS while the access to the SE is always done in secure mode.

bool_force

if non equals 0, then all errors during file deletion of file unregistration will be ignored. The function will return 0, as if no errors happened. Note that it means that files will be unregistered even if the function wasn't able to remove them, so it may create some inconsistencies!

bool_rmdir

if non equals 0, then it means that the user want to delete (empty) directory. Note that it is possible to delete only one directory at a time.

verbose

Verbose level. Here are the possible levels:

0: Only critical errors are displayed on stderr or put into errbuf if not null.
1: Warnings are displayed on stderr as well as critical errors.
2: Debug information is displayed as well as warnings and critical errors.

timeout

specifies the value of timeout (default 0).

statuses

It is an out argument to show the status of each each file, with possibly an explanation. So this is a pointer to a table of structures, which contains the following fields:

char *file: the file name
int status: the status of the file, which is a value of errno
char *explanation: an explanation of this status (can be NULL)

errbuf

specifies a buffer of size errbufsz to receive detailed error messages. If this pointer is NULL, the message goes to stderr. The pointer should not be NULL if the application is a daemon or is multi-threaded.

NOTE

The environment variable LCG_GFAL_INFOSYS must point to the BDII, unless nobdii is set to a non-zero value. To use the RLS as catalog instead of the LFC, the environment variable LCG_CATALOG_TYPE must explicitely be set to "edg". By default, it is set to "lfc".

RETURN VALUE

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

ERRORS

ENOENT: The named file does not exist.
EACCES: Permission denied.
EFAULT: file or vo is an invalid pointer.
ECOMM: Communication error.
ENAMETOOLONG: vo is too long.
EPROTONOSUPPORT: Access method not supported.

FILES

/opt/lcg/include/lcg_util.h

/opt/lcg/lib/liblcg_util.so

This document was created by man2html, using the manual pages.
Time: 14:16:52 GMT, July 14, 2009