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, etc.)
87
88
89

EXAMPLES

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

FILES

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

AUTHORS

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