1ARCCP(1)                    NorduGrid Users Manual                    ARCCP(1)
2
3
4

NAME

6       arccp - copy files
7
8

DESCRIPTION

10       The  arccp  command copies files to, from and between grid storage ele‐
11       ments.
12
13

SYNOPSIS

15       arccp [options] source destination
16
17

OPTIONS

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
23       -n, --nopassive
24              do not try to force passive transfer
25
26       -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
35       -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
42       -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
48       -3, --thirdparty
49              perform third party transfer, where the destination  pulls  from
50              the source (only available with GFAL plugin)
51
52       -u, --secure
53              use secure transfer (insecure by default)
54
55       -y, --cache=path
56              path to local cache (use to put file into cache)
57
58       -r, --recursive
59              operate recursively
60
61       -D, --depth=level
62              operate recursively up to specified level
63
64       -R, --retries=number
65              number of retries before failing file transfer
66
67       -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
73       -P, --listplugins
74              list the available plugins (protocols supported)
75
76       -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
81       -z, --conffile=filename
82              configuration file (default ~/.arc/client.conf)
83
84       -d, --debug=debuglevel
85              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
86
87       -v, --version
88              print version information
89
90       -?, --help
91              print help
92
93

ARGUMENTS

95       source the source of the transfer
96
97       destination
98              the destination of the transfer
99

EXTENDED DESCRIPTION

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
108       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
113       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
117       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
125       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
130

FILES

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
138

ENVIRONMENT VARIABLES

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
144
145       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
152
153       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
159

EXAMPLE

161       arccp -i gsiftp://example.com/grid/file1.dat /tmp/file1.dat
162
163
165       APACHE LICENSE Version 2.0
166
167

AUTHOR

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
174

SEE ALSO

176       arcls(1), arcmkdir(1), arcrename(1), arcrm(1),
177
178
179
180NorduGrid ARC 6.17.0              2022-11-24                          ARCCP(1)
Impressum