xrdcp-old(1) - Linux man page
Name
xrdcp - copy files
Synopsis
xrdcp [options] source destination options: [-adler] [-d lvl] [-Dproxyaddr:proxyport] [-DSpname stringval] [-DIpname numberval] [-f] [-F] [-force] [-h] [-md5] [-ML libname] [-np] [-ODopaqueinfo] [-OSopaqueinfo] [-P] [-R] [-s] [-S num] [-v] [-version] [-x] [-X rdr]
Description
The xrdcp utility copies one or more files from one location to another. The data source and destination may be a local or remote file or directory. Additionally, the data source may also reside on multiple servers.
Options
-adler
- calculate the adler32 checksum during transfers. This option may not be available on all platforms.
- -d lvl
- debug level: 1 (low), 2 (medium), 3 (high)
- -Dproxyaddr:proxyport
- use proxyaddr:proxyport as a SOCKS4 proxy. Only numerical addresses are supported.
- -DSpname stringval
- set the internal parameter pname with the string value stringval.
- -DIpname numberval
- set the internal parameter pname with the numeric value numberval.
- -f re-create a file if already present.
- -F set the 'force' flag for xrootd dest file opens (ignore if file is already opened).
- -force
- -F set the 'force' flag for xrootd dest file opens (ignore if file is already opened).
- set 1-min (re)connect attempts to retry for up to 1 week, to block until xrdcp is executed.
- -h display usage information.
-md5 calculate the md5 sum during transfers.
-ML libname
- use libname as the external monitoring reporting library. The default name is "XrdCpMonitorClient.so". Make sure it is reachable.
- -np no progress bar.
-ODopaqueinfo
- add opaque information opaqueinfo to any destination xrootd URL.
- -OSopaqueinfo
- add opaque information opaqueinfo to any source xrootd URL.
- -P request POSC (persist-on-successful-close) processing to create a new file.
- -R recurse through source subdirectories.
-s silent mode.
-S num
- -R recurse through source subdirectories.
- use num additional parallel streams to do the transfer. The maximum value is 15. The default is 0 (i.e., use only the main stream).
- -v display summary output.
-version
- display version information.
- -x activate the Xtreme copy algorithm. Use the source hostname to query for additional sources.
- -x rdr
- activate the Xtreme copy algorithm. Use rdr as hostname where to query for additional sources.
Operands
source
- a local file, a local directory name suffixed by /, or an xrootd URL in the form of
root://[user@]host[:port]/absolutepath
The absolutepath can be a directory. In this case the -R option can be fully honored only on a standalone server.
- destination
- a local file, a local directory name suffixed by /, or an xrootd URL in the form
root://[user@]host[:port]/absolutepath
The absolutepath can be a directory. In this case the -R option, the the absolutepath must be a directory and all files are copied into this directory.
EXAMPLES (GENERIC)
local file upload:
- $ xrdcp /tmp/myfile root://foo.bar.com//data/myfile
- remote file download:
- $ xrdcp root://foo.bar.com//data/myfile /tmp/myfile
- remote-remote copy:
- $ xrdcp root://foo.bar.com//data/myfile1 root://foo.bar.com//data/myfile2
EXAMPLES (CASTOR)
local file upload to a Castor instance using a specific service class and stager:
- $ xrdcp /tmp/myfile root://<stagerhost>.cern.ch//castor/cern.ch/data/myfile -ODstagerHost=$STAGE_HOST&svcClass=$STAGE_SVCCLASS
[ you need to escape the '&' in the shell ] - remote file download from a Castor instance using a specific stager:
- $ xrdcp /tmp/myfile root://<stagerhost>.cern.ch//castor/cern.ch/data/myfile -OSstagerHost=$STAGE_HOST
- client-proxy copy to-/from- a Castor instance:
- $ xrdcp
root://<stagerA>.cern.ch//castor/cern.ch/data/stagerA/myfile -OSstagerHost=<stagerA>
root://<stagerB>.cern.ch//castor/cern.ch/data/stagerB/myfile -ODstagerHost=<stagerA>
[ you cannot copy between stagers using the same logical filename in the castor namespace! ]
Notes
Documentation for all components associated with xrdcp can be found at http://xrootd.org/docs.html
Diagnostics
Errors yield an error message and a non-zero exit status.
License
License terms can be displayed by typing "xrootd -H".
Support Level
The xrdcp command is supported by the xrootd collaboration. Contact information can be found at
http://xrootd.org/contact.html