1GFAL-COPY(1) General Commands Manual GFAL-COPY(1)
2
3
4
6 gfal-copy - Copy files
7
9 gfal-copy [ OPTION ]... SOURCE DEST1 [ DEST2 ]...
10
11
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
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
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
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
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
149 gfal-cat(1), gfal-chmod(1), gfal-copy(1), gfal-ls(1), gfal-mkdir(1),
150 gfal-rename(1), gfal-rm(1), gfal-save(1), gfal-stat(1), gfal-sum(1),
151 gfal-token(1), gfal-xattr(1), gfal-evict(1), gfal-bringonline(1), gfal-
152 archivepoll(1)
153
154
155
156v1.7.1 March 2022 GFAL-COPY(1)