next up previous contents
Next: getTurl Up: Management Commands Previous: deleteFile   Contents

Command Line Tool

usage: edg-replica-manager deleteFile fileName [options]
Delete a file from the Grid. All replicas of a file may be deleted by
specifying the GUID and setting the --all-available flag.
 -s,--storage <host>   The storage host from which the physical instance is
                       to be deleted. This is mandatory for LFNs, ignored
                       for SURLs and mandatory for GUIDs if the --all-available
                       flag is not set.
 -a,--all-available    If this is set and the file-name is a GUID, make a
                       best-effort attempt to delete all replicas of this
                       file.
 Arguments:
  fileName              File to delete. This has to be a grid-file, i.e.
                        LFN, SURL or GUID. For GUIDs the --all-available 
                        flag may be set to attempt to delete all instances
                        (on a best-effort basis). For LFNs the storage
                        option has to be set.

The deleteFile call performs the task of removing a file from grid-aware storage and unregistering the entry in the Replica Catalog as an atomic operation.

Semantics

The fileName argument may be either a SURL, a LFN or a GUID. If it is a SURL, only the specified file will be deleted and the corresponding GUID-SURL mapping removed from the catalog. If the fileName is an LFN, the -storage option is mandatory in order to specify which replica must be removed. The same is true if the fileName argument is a GUID, but for GUIDs the -all-available flag can be specified instead of the storage option, which will remove all entries in the RLS but not from the RMC! (In order to delete all LFNs from the RMC, you need to use the command removeAlias).

Arguments

fileName
The file to be deleted. The fileName may be:

Options

storage
The host name of the SE where the file resides.
all-available
A flag specifying whether all instances of the given GUID should be removed. An error is returned if this flag is given for an LFN or SURL.

Return value

The call returns 0 on success and -1 on failure.

Errors

The call can fail for many reasons. Some of the reasons are:


next up previous contents
Next: getTurl Up: Management Commands Previous: deleteFile   Contents
2004-06-14