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
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
51
52       -6     Forces gfal2-util to use IPv6 addresses only
53
54       -f, --force
55              if destination file(s) cannot be overwritten, delete it and  try
56              again
57
58       -p, --parent
59              if the destination directory does not exist, create it
60
61       -n, --nbstreams NBSTREAMS
62              specify  the  maximum  number of parallel streams to use for the
63              copy
64
65       --tcp-buffersize TCP_BUFFERSIZE
66              specify the TCP buffersize
67
68       -s, --src-spacetoken SRC_SPACETOKEN
69              source spacetoken to use for the transfer
70
71       -S, --dst-spacetoken DST_SPACETOKEN
72              destination spacetoken to use for the transfer
73
74       -T, --transfer-timeout TRANSFER_TIMEOUT
75              timeout for the transfer operation. This timeout is enforced  by
76              each plugin, so it applies to the transfer operation only.
77
78       -K, --checksum CHECKSUM
79              checksum algorithm to use, or algorithm:value
80
81       --from-file FROM_FILE
82              read sources from a file
83
84       --just-copy
85              just  do the copy and skip any preparation (i.e. checksum, over‐
86              write, stats etc.). Warning - use of this switch is incompatible
87              with the presence of directories in the argument list.
88
89
90

EXAMPLES

92       Copy a file to srm://endpoint.cern.ch/path/group, preferring a protocol
93       as specified in the configuration file:
94              gfal-copy file:///etc/group srm://endpoint.cern.ch/path/
95
96       You can specify directly a protocol, if you know that it  is  supported
97       by the end point:
98              gfal-copy file:///tmp/test gsiftp://endpoint.cern.ch/path/test
99
100       Do a chained copy:
101              gfal-copy          file:///tmp/test         gsiftp://end‐
102              point.cern.ch/path/test file:///tmp/test2
103
104       Registration of a file in the LFC:
105              gfal-copy        file:///tmp/source         gsiftp://end‐
106              point.cern.ch/path/test lfc://lfc-host.cern.ch/lfn
107
108

FILES

110       /etc/gfal2.d/*
111              All  configuration  files  in  this  directory affect the
112              behavior of the  underlying  gfal2,  in  particular,  the
113              default choice of transfer protocols.
114
115

AUTHORS

117       Duarte Meneses <duarte.meneses@cern.ch>
118       Adrien Devresse <adrien.devresse@cern.ch>
119       Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@cern.ch>
120
121