lcg-cr(1) - Linux man page

Name

lcg-cr - copy and register a file

Synopsis

lcg-cr [ --config config_file ] [ -d dest_file | dest_host ] [ -g guid ] [ -h,--help ] [ -D,--defaultsetype defaulttype ] [ -T,--setype setype ] [ -l lfn ] [ -P relative_path ] [ -s,--st spacetokendesc ] [ -n nbstreams ] [ --connect-timeout conntimeout ] [ --sendreceive-timeout sndtimeout ] [ --bdii-timeout bdiitimeout ] [ --srm-timeout srmtimeout ] [ --vo virtual_organization ] [ --checksum-type cksmtype ] [ --checksum ] [ -b,--nobdii ] [ -v,--verbose ] [ -f,--nofilesizecheck ] [ --version ] --dst-protocols protocol_list ] src_file

Description

lcg-cr copies a file to a Storage Element and registers the file in the Replica Catalog or the LFC. If you specify a given command line option multiple times, the command takes into account only the very last one so that in a script, you can override a particular option in a pre-set option set (like gcc does).

The program prints the actual GUID on stdout.

src_file: specifies the source file name: the protocol can be file: or gsiftp:.
dest_file: specifies the destination. It can be the Storage Element fully qualified hostname or an SURL. In the latter case, the scheme can be sfn: for a classical SE or srm:. If only the fully qualified hostname is given, a filename is generated in the same format as with the Replica Manager.
guid: specifies the Grid Unique IDentifier. If this option is not present, a GUID is generated internally.
lfn: specifies the Logical File Name associated with the file. If this option is present, an entry is added to the Replica Metadata Catalog or the LFC. The entry must not exist otherwise the command fails.
relative_path: specifies the path relative to the SARoot for the given VO.
nbstreams: specifies the number of parallel streams (default 1).
defaulttype: specifies the default SE type you want to use. Possible values are none, se, srmv1, 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 destination file. Possible values are none, se, srmv1, 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.
spacetokendesc: specifies the space token to use with src_file
conntimeout: Sets the connect timeout, used when connecting to a remote host. The connection will be aborted if the remote host doesn't reply after conntimeout seconds. Default: 60 seconds.
sndtimeout: Sets the send/receive data timeout, used when transferring data to/from a remote host. The connection will be aborted if no data is transfered after sndtimeout seconds. Default: 0 (blocking).
bdiitimeout: Sets the BDII timeout, used when searching information into BDII. The connection will be aborted if the search is longer than bdiitimeout seconds. Default: 60 seconds.
srmtimeout: Sets the SRM timeout, used when doing an asynchronous SRM request. The request will be aborted if it is still queued after srmtimeout seconds. Default: 3600 seconds (1 hour).
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.
cksmtype: is the checksum type (algorithm) to use. Possible values (case insensitive) are:
NONE: No checksum verification
CRC32: CRC32 algorithm will be used
ADLER32: Adler32 algorithm will be used
MD5: MD5 algorithm will be used
SHA1

SHA-1 algorithm will be used

protocol_list: A comma-separated list of protocols (for example protocol1,protocol2 )
--checksum: If this flag is present, verification of data integrity between source and destination files will be dine using default checksum algorithm (Adler32). In case of failure, the destination won't be removed, but an error message will be printed.
-b,--nobdii: If this flag is present, 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.
-v,--verbose: Verbose mode. You can specify it twice for extra verbose mode.
-f,--nofilesizecheck: Disables the file size check between the source and destionation file sizes.This option must be specified in case of copying named pipe.
--dst-protocols: The ordered list of transfer protocols to help TURL construction. The list is passed to the SE, it should pick up an appropriate one and construct destination TURL-s according to it. Ignored if the destination file does not follow the SURL scheme.

Note

The environment variable LCG_GFAL_INFOSYS must point to the BDII, unless --nobdii option is used. 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".

If no no destination SE is specified, we use the environment variable VO_<VO>_DEFAULT_SE, which is normally set on the Worker Node.

Example

    lcg-cr --vo dteam -d lxshare0236.cern.ch file:/etc/hosts

Exit Status

This program returns 0 if the operation was successful or >0 if the operation failed.

Referenced By

lcg-bringonline(1), lcg-get-checksum(1)