1xrdcp(1)                    General Commands Manual                   xrdcp(1)
2
3
4

NAME

6       xrdcp - copy files
7

SYNOPSIS

9       xrdcp [options] source destination
10
11       options: [-adler] [-d lvl] [-Dproxyaddr:proxyport]
12       [-DSpname stringval] [-DIpname numberval] [-f] [-F]
13       [-force] [-h] [-md5] [-ML libname] [-np] [-ODopaqueinfo]
14       [-OSopaqueinfo] [-P] [-R] [-s] [-S num] [-v] [-version]
15       [-x] [-X rdr]
16
17

DESCRIPTION

19       The xrdcp utility copies one or more files from one location to
20       another. The data source and destination may be a local or remote file
21       or directory.  Additionally, the data source may also reside on multi‐
22       ple servers.
23

OPTIONS

25       -adler
26            calculate the adler32 checksum during transfers.  This option may
27            not be available on all platforms.
28
29       -d lvl
30            debug level: 1 (low), 2 (medium), 3 (high)
31
32       -Dproxyaddr:proxyport
33            use proxyaddr:proxyport as a SOCKS4 proxy. Only numerical
34            addresses are supported.
35
36       -DSpname stringval
37            set the internal parameter pname with the string value stringval.
38
39       -DIpname numberval
40            set the internal parameter pname with the numeric value numberval.
41
42       -f   re-create a file if already present.
43
44
45       -F   set the 'force' flag for xrootd dest file opens (ignore if file is
46              already opened).
47
48       -force
49            set 1-min (re)connect attempts to retry for up to 1 week, to block
50            until xrdcp is executed.
51
52       -h   display usage information.
53
54       -md5 calculate the md5 sum during transfers.
55
56       -ML libname
57            use libname as the external monitoring reporting library. The
58            default name is "XrdCpMonitorClient.so". Make sure it is reach‐
59            able.
60
61       -np   no progress bar.
62
63       -ODopaqueinfo
64            add opaque information opaqueinfo to any destination xrootd URL.
65
66       -OSopaqueinfo
67            add opaque information opaqueinfo to any source xrootd URL.
68
69       -P   request POSC (persist-on-successful-close) processing
70                   to create a new file.
71
72       -R   recurse through source subdirectories.
73
74       -s   silent mode.
75
76       -S num
77            use num additional parallel streams to do the transfer.  The maxi‐
78            mum value is 15. The default is 0 (i.e., use only the main
79            stream).
80
81       -v   display summary output.
82
83       -version
84            display version information.
85
86       -x   activate the Xtreme copy algorithm. Use the source
87                   hostname to query for additional sources.
88
89       -x rdr
90            activate the Xtreme copy algorithm. Use rdr as hostname where to
91            query for additional sources.
92
93

OPERANDS

95       source
96            a local file, a local directory name suffixed by /, or an xrootd
97            URL in the form of
98                          root://[user@]host[:port]/absolutepath
99            The absolutepath can be a directory. In this case the -R option
100            can be fully honored only on a standalone server.
101
102       destination
103            a local file, a local directory name suffixed by /, or an xrootd
104            URL in the form
105                          root://[user@]host[:port]/absolutepath
106            The absolutepath can be a directory. In this case the -R option,
107            the the absolutepath must be a directory and all files are copied
108            into this directory.
109
110

EXAMPLES (GENERIC)

112       local file upload:
113              $ xrdcp /tmp/myfile root://foo.bar.com//data/myfile
114
115       remote file download:
116              $ xrdcp root://foo.bar.com//data/myfile /tmp/myfile
117
118       remote-remote copy:
119              $ xrdcp root://foo.bar.com//data/myfile1
120              root://foo.bar.com//data/myfile2
121

EXAMPLES (CASTOR)

123       local file upload to a Castor instance using a specific service class
124       and stager:
125              $ xrdcp /tmp/myfile root://<stagerhost>.cern.ch//cas‐
126              tor/cern.ch/data/myfile -ODstagerHost=$STAGE_HOST&svc‐
127              Class=$STAGE_SVCCLASS
128              [ you need to escape the '&' in the shell ]
129
130       remote file download from a Castor instance using a specific stager:
131              $ xrdcp /tmp/myfile root://<stagerhost>.cern.ch//cas‐
132              tor/cern.ch/data/myfile -OSstagerHost=$STAGE_HOST
133
134       client-proxy copy to-/from- a Castor instance:
135              $ xrdcp
136              root://<stagerA>.cern.ch//castor/cern.ch/data/stagerA/myfile
137              -OSstagerHost=<stagerA>
138              root://<stagerB>.cern.ch//castor/cern.ch/data/stagerB/myfile
139              -ODstagerHost=<stagerA>
140              [ you cannot copy between stagers using the same logical file‐
141              name in the castor namespace! ]
142

NOTES

144       Documentation for all components associated with xrdcp can be found at
145       http://xrootd.org/docs.html
146

DIAGNOSTICS

148       Errors yield an error message and a non-zero exit status.
149

LICENSE

151       License terms can be displayed by typing "xrootd -H".
152

SUPPORT LEVEL

154       The xrdcp command is supported by the xrootd collaboration.  Contact
155       information can be found at
156                           http://xrootd.org/contact.html
157
158
159
160                                 8 March 2011                         xrdcp(1)