1xrdcp-old(1) General Commands Manual xrdcp-old(1)
2
6 xrdcp-old - copy files
7
9 xrdcp-old [options] source destination
10 options: [--cksum args] [--debug lvl] [--coerce] [--force]
12 [--help] [--license] [--nopbar] [--posc] [--proxy ipaddr:port]
13 [--recursive] [--retry time] [--server] [--silent]
14 [--sources num] [--streams num] [--tpc] [--verbose]
15 [--version] [--xrate rate]
16 legacy options: [-adler] [-DSparm string] [-DIparm number]
18 [-md5] [-np] [-ODcgi] [-OScgi] [-x]
19
22 This tool is DEPRECATED. It is what used to be xrdcp prior to xrootd
23 4.0.0 release. Please use xrdcp instead.
24 The xrdcp-old utility copies one or more files from one location to
27 another. The data source and destination may be a local or remote file
28 or directory. Additionally, the data source may also reside on multi‐
29 ple servers.
30
32 {-C | --cksum} type[:{value|print}]
33 obtains the checksum of type (i.e. adler32, crc32, or md5) from
34 the source, computes the checksum at the destination, and verifies
35 that they are the same. If a value is specified, it is used as the
36 source checksum. When print is specified, the checksum at the des‐
37 tination is printed but is not verified.
38 {-d | --debug} lvl
40 debug level: 1 (low), 2 (medium), 3 (high)
41 {-F | --coerce}
43 ignores locking semantics on the destination file. This option may
44 lead to file corruption if not properly used.
45 {-f | --force}
47 re-creates a file if it is already present.
48 {-h | --help}
50 displays usage information.
51 {-H | --license}
53 displays license terms and conditions.
54 {-N | --nopbar}
56 does not display the progress bar.
57 {-P | --posc}
59 requests POSC (persist-on-successful-close) processing to create a
60 new file. Files are automatically deleted should they not be suc‐
61 cessfully closed.
62 {-D | --proxy} proxyaddr:proxyport
64 use proxyaddr:proxyport as a SOCKS4 proxy. Only numerical
65 addresses are supported.
66 {-r | --recursive}
68 recursively copy all files starting at the given source directory.
69 This option is only supported for local files.
70 --server
72 runs as if in a server environment. Used only for server-side
73 third party copy support.
74 {-s | --silent}
76 neither produces summary information nor displays the progress
77 bar.
78 {-y | --sources} num
80 uses up to num sources to copy the file.
81 {-S | --streams} num
83 uses num additional parallel streams to do the transfer. The max‐
84 imum value is 15. The default is 0 (i.e., use only the main
85 stream).
86 --tpc
88 copies the file from remote server to remote server using third-
89 party-copy protocol (i.e., data flows from server to server). The
90 source and destination servers must support third party copies.
91 Additional security restrictions may apply and may cause the copy
92 to fail if they cannot be satisfied.
93 {-v | --verbose}
95 displays summary output.
96 {-V | -version}
98 displays version information and immediately exits.
99 {-X | --xrate} rate
101 limits the copy speed to the specified rate. The rate may be qual‐
102 ified with the letter k, m, or g to indicate kilo, mega, or giga
103 bytes, respectively. The option only applies when the source or
104 destination is local.
105
108 Legacy options are provided for backward compatability. These are now
109 deprecated and should be avoided.
110 --adler
111 equivalent to "--cksum adler32:print".
112 -DIpname numberval
114 set the internal parameter pname with the numeric value numberval.
115 -DSpname stringval
117 set the internal parameter pname with the string value stringval.
118 -md5
120 equivalent to "--cksum md5:print".
121 -np
123 equivalent to "--nopbar".
124 -ODcgi
126 add cgi information cgi to any destination xrootd URL. You should
127 specify the opaque information directly on the destination URL.
128 -OScgi
130 add cgi information cgi to any source xrootd URL.
131 -x
133 equivalent to "--sources 12".
134
137 source
138 a local file, a local directory name suffixed by /, or an xrootd
139 URL in the form of
140 xroot://[user@]host[:port]/absolutepath
141 The absolutepath can be a directory.
142 destination
144 a dash (i.e. -) indicating stanard out, a local file, a local
145 directory name suffixed by /, or an xrootd URL in the form
146 xroot://[user@]host[:port]/absolutepath
147 The absolutepath can be a directory.
148
151 local file upload:
152 $ xrdcp-old /tmp/myfile xroot://foo.bar.com//data/myfile
153 remote file download:
155 $ xrdcp-old xroot://foo.bar.com//data/myfile /tmp/myfile
156 remote-remote copy:
158 $ xrdcp-old xroot://foo.bar.com//data/myfile1
159 xroot://foo.bar.com//data/myfile2
160
162 local file upload to a Castor instance using a specific service class
163 and stager:
164 $ xrdcp-old /tmp/myfile root://<stagerhost>.cern.ch//cas‐
165 tor/cern.ch/data/myfile -ODstagerHost=$STAGE_HOST&svc‐
166 Class=$STAGE_SVCCLASS
167 [ you need to escape the '&' in the shell ]
168 remote file download from a Castor instance using a specific stager:
170 $ xrdcp-old /tmp/myfile root://<stagerhost>.cern.ch//cas‐
171 tor/cern.ch/data/myfile -OSstagerHost=$STAGE_HOST
172 client-proxy copy to-/from- a Castor instance:
174 $ xrdcp-old
175 root://<stagerA>.cern.ch//castor/cern.ch/data/stagerA/myfile
176 -OSstagerHost=<stagerA>
177 root://<stagerB>.cern.ch//castor/cern.ch/data/stagerB/myfile
178 -ODstagerHost=<stagerA>
179 [ you cannot copy between stagers using the same logical file‐
180 name in the castor namespace! ]
181
183 Documentation for all components associated with xrdcp-old can be found
184 at http://xrootd.org/docs.html
185
187 Errors yield an error message and a non-zero exit status.
188
190 License terms can be displayed by typing "xrootd -H".
191
193 The xrdcp command is supported by the xrootd collaboration. Contact
194 information can be found at
195 http://xrootd.org/contact.html
196 v4.11.3 xrdcp-old(1)