next up previous contents
Next: list Up: File Transfer Commands Previous: copyFile   Contents

Command Line Tool

usage: edg-replica-manager copyFile sourceFileName destFileName [options]
Copy a file to a non-grid destination.
 -f,--force                 Overwrite the destination if it's already
                            there.
 -n,--streams <#streams>    The number of parallel streams to use. Defaults
                            to 8.
 -p,--protocol <protocol>   The protocol to be used for transfer. Defaults
                            to gsiftp.
 Arguments:
  sourceFileName        The file to copy from. This can be any kind of
                        file: LFN, GUID, SURL, TURL or local file.
  destFileName          The destination. This can only be a non-grid file -
                        i.e. local file or TURL.

Copies a physical file from source to destination using the specified transport mechanism.

Semantics

This action does not involve any updates to the replica catalogs as the destination cannot be a grid-aware store, in order to avoid catalog corruption. copyAndRegisterFile needs to be used for that purpose, i.e. to bring a file into the grid. The destination does not accept GUIDs, LFNs or SURLs. As said, for those cases copyAndRegisterFile or replicateFile needs to be used.

It provides all the capability of globus-url-copy and more, accepting also GUIDs, LFNs and SURLs as the source file. Since the destination is not on grid-storage, the destination file will not be registered in the catalog.

Example: To get a local copy of a grid file, the source file can be specified as a GUID or LFN and the destination file as a local file. The result will be that the file will be copied `out of the grid' to the local file. Local file URIs need to have the `file' scheme.

Arguments

sourceFileName
The source file. It may be one of the following:
destFileName
The physical destination file. Must be one of the following:

Options

protocol
The protocol to be used. If it is omitted, the default protocol for the given SE is used. This parameter is only considered if the source is specified using an SURL, LFN or GUID.

streams
The number of parallel streams to be used for the copy. If omitted, the default is used for the given protocol.

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: list Up: File Transfer Commands Previous: copyFile   Contents
2005-02-04