gfal-copy(1)

1GFAL-COPY(1)                General Commands Manual               GFAL-COPY(1)
2
3
4

NAME

6       gfal-copy - Copy files
7

SYNOPSIS

9       gfal-copy [ OPTION ]...  SOURCE DEST1 [ DEST2 ]...
10
11

DESCRIPTION

13       gfal-copy Copies files from source to destination(s). If several desti‐
14       nations are specified, the file will be copy in a chain: src  ->  dst1,
15       dst1  -> dst2, ... If used in an interactive console, transfer informa‐
16       tion will be giving during the copy,  which  varies  depending  on  the
17       available  information.  This command can be used to upload local files
18       to remote file systems and to register files in the file  catalog  (see
19       examples).
20
21

OPTIONS

23       -h, --help
24              show help about the command.
25
26       -V, --version
27              output version information and exit.
28
29       -v, --verbose
30              verbose mode. Repeat up to 3 times for the most verbose mode.
31
32       -D, --definition DEFINITION
33              define properties for gfal2. Definitions have the following syn‐
34              tax: "CONFIG_GROUP:KEY=VALUE"
35
36       -t, --timeout TIMEOUT
37              global timeout for the execution of the command. Command is  in‐
38              terrupted  if time expires before it finishes. Note: A grace pe‐
39              riod of 30 seconds is given to the global timeout.
40
41       -E, --cert CERT
42              user  certificate.  (This  option  takes   effect   only   after
43              X509_USER_PROXY     environment     variable     and     default
44              /tmp/x509up_u`id -u` location cannot provide a certificate)
45
46       --key KEY
47              user private key.
48
49       -4     forces Gfal2 to use IPv4 addresses only. (Option valid only  for
50              GridFTP protocol)
51
52       -6     forces  Gfal2 to use IPv6 addresses only. (Option valid only for
53              GridFTP protocol)
54
55       -C, --client-info CLIENT_INFO
56              provide custom client-side information.
57
58       --log-file LOG_FILE
59              write Gfal2 library logs to the given file location.
60
61       -f, --force
62              if destination file(s) cannot be overwritten, delete it and  try
63              again.
64
65       -p, --parent
66              if the destination directory does not exist, create it,
67
68       -n, --nbstreams NBSTREAMS
69              specify  the  maximum  number of parallel streams to use for the
70              copy.
71
72       --tcp-buffersize TCP_BUFFERSIZE
73              specify the TCP buffersize.
74
75       -s, --src-spacetoken SRC_SPACETOKEN
76              source spacetoken to use for the transfer.
77
78       -S, --dst-spacetoken DST_SPACETOKEN
79              destination spacetoken to use for the transfer.
80
81       -T, --transfer-timeout TRANSFER_TIMEOUT
82              timeout for the transfer operation. This timeout is enforced  by
83              each  plugin,  so it applies to the transfer operation only. En‐
84              sure it is equal or smaller than "--timeout" setting.
85
86       -K, --checksum CHECKSUM
87              checksum algorithm to use, or algorithm:value.
88
89       --from-file FROM_FILE
90              read sources from a file.
91
92       --copy-mode COPY_MODE
93              select the TPC copy mode: 'pull', 'push' or 'streamed'.  (Option
94              valid only for HTTP protocol)
95
96       --just-copy
97              just  do the copy and skip any preparation (i.e. checksum, over‐
98              write, stats etc.). Warning: use of this switch is  incompatible
99              with the presence of directories in the argument list.
100
101       --no-delegation
102              disable TPC with proxy delegation.
103
104       -r, --recursive
105              copy directories recursively.
106
107       --abort-on-failure
108              abort the whole copy as soon as one failure is encountered.
109
110       --dry-run
111              print what would have happened without any actual change.
112
113

EXAMPLES

115       Copy a file to srm://endpoint.cern.ch/path/group, preferring a protocol
116       as specified in the configuration file:
117              gfal-copy file:///etc/group srm://endpoint.cern.ch/path/
118
119       You can specify directly a protocol, if you know that it  is  supported
120       by the end point:
121              gfal-copy file:///tmp/test gsiftp://endpoint.cern.ch/path/test
122
123       Do a chained copy:
124              gfal-copy  file:///tmp/test  gsiftp://endpoint.cern.ch/path/test
125              file:///tmp/test2
126
127       Registration of a file in the LFC:
128              gfal-copy file:///tmp/source gsiftp://endpoint.cern.ch/path/test
129              lfc://lfc-host.cern.ch/lfn
130
131

FILES

133       /etc/gfal2.d/*
134              All configuration files in this directory affect the behavior of
135              the underlying gfal2,  in  particular,  the  default  choice  of
136              transfer protocols.
137
138

AUTHORS

140       Duarte Meneses <duarte.meneses@cern.ch>
141       Adrien Devresse <adrien.devresse@cern.ch>
142       Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@cern.ch>
143       Andrea Manzi <andrea.manzi@cern.ch>
144       Mihai Patrascoiu <mihai.patrascoiu@cern.ch>
145       Joao Lopes <joao.pedro.batista.lopes@cern.ch>
146
147