lcg-cp(1) - Linux man page
Name
lcg-cp - copy files from/to/between Storage Element(s), without registering anything in the file
catalog.
Synopsis
lcg-cp [ --config config_file ] [ -h,--help ] [ -n
nbstreams ] [ -D,--defaultsetype defaulttype ] [ -T,--srcsetypesrctype ] [ -U,--dstsetype dsttype ] [
-s,--sst src_spacetokendesc ] [ -S,--dstdest_spacetokendesc ] [ --connect-timeout conntimeout ] [
--sendreceive-timeoutsndtimeout ] [ --bdii-timeout bdiitimeout ] [ --srm-timeout srmtimeout ] [
--vovirtual_organization ] [ --checksum-type cksmtype ] [ --checksum ] [ -b,--nobdii ] [ -v,--verbose ] [
--version ] [ --src-protocols protocol_list ] [ --dst-protocolsprotocol_list ] src_file dest_file
Description
lcg-cp copies a Grid file to a local destination, or copie a local file to a SE (without
registering it in a file catalog). 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).
- src_file
- specifies the source file name. The protocol can be LFN, GUID, SURL, GSIFTP or local file. An SURL scheme can be sfn: for a classical SE or
srm:.
- dest_file
- specifies the destination. The protocol can be SURL, GSIFTP or local file. An SURL scheme can be sfn: for a classical SE or srm:. SURL can be
used only if src_file is GSIFTP or local file. In that case, the SURL will NOT be registered in a file catalog.
- 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.
- srctype
- specifies the SE type you want to use for the source 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.
- dsttype
- 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.
- src_spacetokendesc
- specifies the space token to use with src_file
- dest_spacetokendesc
- specifies the space token to use with dest_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 (it will be used for both source and destination).
- -v,--verbose
- Verbose mode. You can specify it twice for extra verbose mode.
- --src-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 source
TURL-s according to it. Ignored if the source file does not follow the SURL scheme.
- --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".
Examples
lcg-cp --verbose --vo dteam file:///etc/group srm://lxbra1910.cern.ch/dpm/cern.ch/home/dteam/1/test
lcg-cp --verbose --vo dteam srm://lxbra1910.cern.ch/dpm/cern.ch/home/dteam/1/test
srm://lxbra1910.cern.ch/dpm/cern.ch/home/dteam/1/test_new
lcg-cp --verbose --vo dteam --nobdii -D srmv2 srm://lxbra1910.cern.ch:8446/srm/managerv2?SFN=/dpm/cern.ch/home/dteam/1/test
file://home/user/test_copy
lcg-cp --vo dteam lfn:/grid/dteam/tests/testjpb33 file:/tmp/toto
Exit Status
This program returns 0 if the operation was successful or >0 if the operation failed.
See Also
lcg-aa(1), lcg-cp(1), lcg-cr(1),
lcg-del(1), lcg-getturls(1), lcg-gt(1), lcg-la(1), lcg-lg(1), lcg-lr(1),
lcg-ls(1), lcg-ra(1), lcg-rep(1), lcg-rf(1), lcg-sd(1), lcg-stmd(1),
lcg-uf(1)
Referenced By
lcg-bringonline(1),
lcg-get-checksum(1)