| 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.
To Next Page
Loading...
Need help?
General