| ascp: Transferring from the Command Line with Ascp |
106
• Only files from the file pair list are transferred; any additional source files specified on the
command line are ignored.
• If the source paths are URIs, the file list cannot exceed 24 KB.
For additional examples, see
on page 114.
-G
write_size
If the transfer destination is a server, use the specified write-block size, which is the maximum
number of bytes that the receiver can write to disk at a time. Default: 256 KB, Range: up to
500 MB. This option accepts suffixes "M" or "m" for
mega
and "K" or "k" for
kilo
, such that a
write_size
of
1M
is one MB.
This is a performance-tuning option that overrides the
write_block_size
set in the client's
aspera.conf
. However, the
-G
setting is overridden by the
write_block_size
set in the
server's
aspera.conf
. The receiving server never uses the
write_block_size
set in the
client's
aspera.conf
.
-g
read_size
If the transfer source is a server, use the specified read-block size, which is the maximum number of
bytes that the sender reads from the source disk at a time. Default: 256 KB, Range: up to 500 MB.
This option accepts suffixes "M" or "m" for
mega
and "K" or "k" for
kilo
, such that a
read_size
of
1M
is one MB.
This is a performance-tuning option that overrides the
read_block_size
set in the client's
aspera.conf
. However, the
-g
setting is overridden by the
read_block_size
set in the
server's
aspera.conf
. When set to the default value, the read size is the default internal buffer
size of the server, which might vary by operating system. The sending server never uses the
read_block_size
set in the client's
aspera.conf
.
-h, --help
Display the help text.
--host=
hostname
Transfer to the specified host name or address. Requires
--mode
. This option can be used instead
of specifying the host with the
hostname
:
file
syntax.
-i
private_key_file
Authenticate the transfer using public key authentication with the specified SSH private key file.
The argument can be just the filename if the private key is located in
user_home_dir
/.ssh/
,
because
ascp
automatically searches for key files there. Multiple private key files can be specified
by repeating the
-i
option. The keys are tried in order and the process ends when a key passes
authentication or when all keys have been tried without success, at which point authentication fails.
-K
probe_rate
Measure bottleneck bandwidth at the specified probing rate (Kbps). (Default: 100Kbps)
-k {0|1|2|3}
Enable the resuming of partially transferred files at the specified resume level. (Default: 0)
Specify this option for the first transfer or it will not work for subsequent transfers. Resume levels:
-k 0
– Always re-transfer the entire file.
-k 1
– Compare file attributes and resume if they match, and re-transfer if they do not.
-k 2
– Compare file attributes and the sparse file checksums; resume if they match, and re-
transfer if they do not.
-k 3
– Compare file attributes and the full file checksums; resume if they match, and re-
transfer if they do not.
If a complete file exists at the destination (no
.aspx
), the source and destination file sizes are
compared. If a partial file and a valid
.aspx
file exist at the destination, the source file size and the
file size recorded in the
.aspx
file are compared.
