| ascp4: Transferring from the Command Line with Ascp 4 |
148
• If more than one read thread is specified (default is 2) for a transfer that uses
--file-list
,
the files in the file list must be unique. Duplicates can produce unexpected results on the
destination.
• Because multiple sources are being transferred, the destination must be a directory.
• If the source paths are URIs, the size of the file list cannot exceed 24 KB.
For very large file lists (~100 MB+), use with
--memory
to increase available buffer space.
-h, --help
Display the usage summary.
--host=
host
Transfer to the specified host name or address. Requires
--mode
. This option can be used instead
of specifying the host as part of the filename (as
hostname
:
filepath
).
-i
private_key_file
Authenticate the transfer using public key authentication with the specified SSH private key
file (specified with a full or relative path). The private key file is typically in the directory
$HOME/.ssh/
. If multiple
-i
options are specified, only the last one is used.
-k {0|1|2|3}
Enable the resumption of partially transferred files at the specified resume level. Default: 0. This
option must be specified for your first transfer or it does not work for subsequent transfers. Resume
levels:
•
-k 0
: Always re-transfer the entire file (same as
--overwrite=always
).
•
-k 1
: Compare file modification time and size and resume if they match (same as
--
overwrite=diff --compare=size --resume
).
•
-k 2
: Compare sparse checksum and resume if they match (same as
--overwrite=diff
--compare=md5-sparse --resume
).
•
-k 3
: Compare full checksum and resume if they match (same as
--overwrite=diff --
compare=md5 --resume
).
--keepalive
Enable
ascp4
to run in persistent mode. This option enables a persistent session that does not
require that source content and its destination are specified at execution. Instead, the persistent
session reads source and destination paths through mgmt commands. Requires
--mode
and
--
host
.
-L
local_log_dir
[:
size
]
Log to the specified directory on the client machine rather than the default directory. Optionally, set
the size of the log file (default 10 MB).
-l
max_rate
Transfer at rates up to the specified target rate. Default: 10 Mbps. This option accepts suffixes "G/
g" for Giga, "M/m" for Mega, "K/k" for Kilo, and "P/p/%" for percentage. Decimals are allowed.
If this option is not set by the client, the server target rate is used. If a rate cap is set in the local or
server
aspera.conf
, then the rate does not exceed the cap.
-m
min_rate
Attempt to transfer no slower than the specified minimum transfer rate. Default: 0. If this option is
not set by the client, then the server's
aspera.conf
setting is used. If a rate cap is set in the local
or server
aspera.conf
, then the rate does not exceed the cap.
--memory=
bytes
Allow the local
ascp4
process to use no more than the specified memory. Default: 256 MB. See
also
--remote-memory
.
--meta-threads=
num
Use the specified number of directory "creation" threads (receiver only). Default: 2.
