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 (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

EXAMPLES

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

FILES

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

AUTHORS

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