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
33 define properties for gfal2.
34
35 -C, --client-info
36 provide custom client-side information
37
38 -t, --timeout TIMEOUT
39 maximum time for the operation to terminate - default is 1800
40 seconds. This timeout is enforced by gfal2-util, so it applies
41 to the overall operation. It should be greater or equal than
42 --transfer-timeout.
43
44 -E, --cert CERT
45 user certificate
46
47 --key KEY
48 user private key
49
50 -4 Forces gfal2-util to use IPv4 addresses only (Option valid only
51 for gsiftp endpoints)
52
53 -6 Forces gfal2-util to use IPv6 addresses only (Option valid only
54 for gsiftp endpoints)
55
56 -f, --force
57 if destination file(s) cannot be overwritten, delete it and try
58 again
59
60 -p, --parent
61 if the destination directory does not exist, create it
62
63 -n, --nbstreams NBSTREAMS
64 specify the maximum number of parallel streams to use for the
65 copy
66
67 --tcp-buffersize TCP_BUFFERSIZE
68 specify the TCP buffersize
69
70 -s, --src-spacetoken SRC_SPACETOKEN
71 source spacetoken to use for the transfer
72
73 -S, --dst-spacetoken DST_SPACETOKEN
74 destination spacetoken to use for the transfer
75
76 -T, --transfer-timeout TRANSFER_TIMEOUT
77 timeout for the transfer operation. This timeout is enforced by
78 each plugin, so it applies to the transfer operation only.
79
80 -K, --checksum CHECKSUM
81 checksum algorithm to use, or algorithm:value
82
83 --from-file FROM_FILE
84 read sources from a file
85
86 --just-copy
87 just do the copy and skip any preparation (i.e. checksum, over‐
88 write, stats etc.). Warning - use of this switch is incompatible
89 with the presence of directories in the argument list.
90
91 --copy-mode
92 select the TPC copy mode for HTTP transfers. Valid options are
93 'pull', 'push' and 'streamed'
94
95
97 Copy a file to srm://endpoint.cern.ch/path/group, preferring a protocol
98 as specified in the configuration file:
99 gfal-copy file:///etc/group srm://endpoint.cern.ch/path/
100
101 You can specify directly a protocol, if you know that it is supported
102 by the end point:
103 gfal-copy file:///tmp/test gsiftp://endpoint.cern.ch/path/test
104
105 Do a chained copy:
106 gfal-copy file:///tmp/test gsiftp://end‐
107 point.cern.ch/path/test file:///tmp/test2
108
109 Registration of a file in the LFC:
110 gfal-copy file:///tmp/source gsiftp://end‐
111 point.cern.ch/path/test lfc://lfc-host.cern.ch/lfn
112
113
115 /etc/gfal2.d/*
116 All configuration files in this directory affect the
117 behavior of the underlying gfal2, in particular, the
118 default choice of transfer protocols.
119
120
122 Duarte Meneses <duarte.meneses@cern.ch>
123 Adrien Devresse <adrien.devresse@cern.ch>
124 Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@cern.ch>
125 Andrea Manzi <andrea.manzi@cern.ch>
126
127
129 gfal-copy(1), gfal-rm(1), gfal-cat(1), gfal-save(1), gfal-
130 mkdir(1), gfal-ls(1), gfal-xattr(1)
131
132
133
134v1.5.0 May 2017 GFAL-COPY(1)