1ARCCP(1) NorduGrid Users Manual ARCCP(1)
2
6 arccp - copy files
7
10 The arccp command copies files to, from and between grid storage ele‐
11 ments.
12
15 arccp [options] source destination
16
19 -p, --passive
20 use passive transfer (off by default if secure is on, on by de‐
21 fault if secure is not requested)
22 -n, --nopassive
24 do not try to force passive transfer
25 -f, --force
27 if the destination is an indexing service and not the same as
28 the source and the destination is already registered, then the
29 copy is normally not done. However, if this option is specified
30 the source is assumed to be a replica of the destination created
31 in an uncontrolled way and the copy is done like in case of
32 replication. Using this option also skips validation of com‐
33 pleted transfers.
34 -i, --indicate
36 show progress indicator. Using this option forces a check of the
37 source file before trying to transfer it, in order to find its
38 size. Depending on other information obtained about the source,
39 there may be side-effects of using this option, for example
40 checksum verification or pre-staging data from tape.
41 -T, --notransfer
43 do not transfer, but register source into destination. destina‐
44 tion must be a meta-url. If destination already exists then
45 meta-information of source must match meta-information of desti‐
46 nation. This can be overridden using the --force option.
47 -3, --thirdparty
49 perform third party transfer, where the destination pulls from
50 the source (only available with GFAL plugin)
51 -u, --secure
53 use secure transfer (insecure by default)
54 -y, --cache=path
56 path to local cache (use to put file into cache)
57 -r, --recursive
59 operate recursively
60 -D, --depth=level
62 operate recursively up to specified level
63 -R, --retries=number
65 number of retries before failing file transfer
66 -L, --location=URL
68 physical file to write to when destination is an indexing ser‐
69 vice. Must be specified for indexing services which do not auto‐
70 matically generate physical locations. Can be specified multiple
71 times - locations will be tried in order until one succeeds.
72 -P, --listplugins
74 list the available plugins (protocols supported)
75 -t, --timeout=seconds
77 timeout in seconds (default 20). This timeout applies to connec‐
78 tions to remote services and indicates the maximum allowed idle
79 time of the transfer.
80 -z, --conffile=filename
82 configuration file (default ~/.arc/client.conf)
83 -d, --debug=debuglevel
85 FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
86 -v, --version
88 print version information
89 -?, --help
91 print help
92
95 source the source of the transfer
96 destination
98 the destination of the transfer
99
101 The arccp command copies files to, from and between grid storage ele‐
102 ments. It can also be used to register files in file index catalogues,
103 either automatically as the result of a file transfer, or by using the
104 --notransfer option. For more information on ARC URL syntax please read
105 "Protocols, Uniform Resource Locators (URL) and Extensions Supported in
106 ARC" [NORDUGRID-TECH-7].
107 If source and/or destination start from '@', the remaining argument is
109 assumed to be a path to a local file containing a list of URLs, one per
110 line. In this case arccp performs like it were called multiple times -
111 once for every URL.
112 When copying directories both the source and destination must end with
114 the directory separator character and a recursion option -r or -D must
115 be specified.
116 All data transfer goes through the machine of the caller of arccp, even
118 in the case of two remote endpoints, unless the --thirdparty option is
119 used. With this option credentials are delegated to the destination and
120 it pulls the data directly from the source. The timeout option in this
121 case applies to the entire transfer itself and default timeouts are
122 used for connections to the remote endpoints. Note that third-party
123 transfer is only possible if the GFAL2 plugin is installed.
124 Depending on the installed libraries (check with -P ), the following
126 protocols may be used: file (file:// prefix may be omitted), http,
127 https, httpg, ftp, gsiftp, srm, root. To connect source or destination
128 to standard input/output use '-' instead of URL.
129
132 ~/.arc/client.conf
133 Some options can be given default values by specifying them in
134 the ARC client configuration file. By using the --conffile op‐
135 tion a different configuration file can be used than the de‐
136 fault.
137
140 X509_USER_PROXY
141 The location of the user's Grid proxy file. Shouldn't be set un‐
142 less the proxy is in a non-standard location.
143 ARC_LOCATION
146 The location where ARC is installed can be specified by this
147 variable. If not specified the install location will be deter‐
148 mined from the path to the command being executed, and if this
149 fails a WARNING will be given stating the location which will be
150 used.
151 ARC_PLUGIN_PATH
154 The location of ARC plugins can be specified by this variable.
155 Multiple locations can be specified by separating them by : (;
156 in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
157 Windows).
158
161 arccp -i gsiftp://example.com/grid/file1.dat /tmp/file1.dat
162
165 APACHE LICENSE Version 2.0
166
169 ARC software is developed by the NorduGrid Collaboration
170 (http://www.nordugrid.org), please consult the AUTHORS file distributed
171 with ARC. Please report bugs and feature requests to
172 http://bugzilla.nordugrid.org
173
176 arcls(1), arcmkdir(1), arcrename(1), arcrm(1),
177NorduGrid ARC 6.17.0 2022-11-24 ARCCP(1)