arccp(1) - f14

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 (does not work if secure is on, default  if
21              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
37
38       -T, --notransfer
39              do  not  transfer  file,  just register it - destination must be
40              non-existing meta-url
41
42       -u, --secure
43              use secure transfer (insecure by default)
44
45       -y, --cache=path
46              path to local cache (use to put file into cache)
47
48       -r, --recursive=level
49              operate recursively up to specified level
50
51       -R, --retries=number
52              number of retries before failing file transfer
53
54       -L, --location=URL
55              physical file to write to when destination is an  indexing  ser‐
56              vice. Must be specified for indexing services which do not auto‐
57              matically generate physical locations. Can be specified multiple
58              times - locations will be tried in order until one succeeds.
59
60       -P, --listplugins
61              list the available plugins (protocols supported)
62
63       -t, --timeout=seconds
64              timeout in seconds (default 20)
65
66       -z, --conffile=filename
67              configuration file (default ~/.arc/client.conf)
68
69       -d, --debug=debuglevel
70              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
71
72       -v, --version
73              print version information
74
75       -?, --help
76              print help
77
78

ARGUMENTS

80       source the source of the transfer
81
82       destination
83              the destination of the transfer
84

EXTENDED DESCRIPTION

86       The  arccp  command copies files to, from and between grid storage ele‐
87       ments. It can also be used to register files in file index  catalogues,
88       either  automatically as the result of a file transfer, or by using the
89       --notransfer option. For more information on ARC URL syntax please read
90       "Protocols, Uniform Resource Locators (URL) and Extensions Supported in
91       ARC" [NORDUGRID-TECH-7]
92
93
94       If source and/or destination start from '@', the remaining argument  is
95       assumed to be a path to a local file containing a list of URLs, one per
96       line.  In this case arccp performs like it were called multiple times -
97       once for every URL.
98
99       Depending  on  the  installed libraries (check with -P ), the following
100       protocols may be used: file  (file://  prefix  may  be omitted),  http,
101       https, httpg, ftp, gsiftp, lfc, rls, srm. To connect source or destina‐
102       tion to standard input/output use '-' instead of URL.
103
104

FILES

106       ~/.arc/client.conf
107              Some options can be given default values by specifying  them  in
108              the  ARC  client  configuration  file.  By  using the --conffile
109              option a different configuration  file  can  be  used  than  the
110              default.
111
112

ENVIRONMENT VARIABLES

114       X509_USER_PROXY
115              The  location  of  the  user's grid proxy file. Shouldn't be set
116              unless the proxy is in a non-standard location.
117
118
119       ARC_LOCATION
120              The location where ARC is installed can  be  specified  by  this
121              variable.  If  not specified the install location will be deter‐
122              mined from the path to the command being executed, and  if  this
123              fails a WARNING will be given stating the location which will be
124              used.
125
126
127       ARC_PLUGIN_PATH
128              The location of ARC plugins can be specified by  this  variable.
129              Multiple  locations  can be specified by separating them by : (;
130              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
131              Windows).
132
133

EXAMPLE

135       arccp -i lfc://lfc.org/grid/file1.dat /tmp/file1.dat
136
137

COPYRIGHT

139       APACHE LICENSE Version 2.0
140
141

AUTHOR

143       Mattias Ellert <mattias.ellert@fysast.uu.se>
144
145