IBM Aspera HST Admin Manual page 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
-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.
Ascp General Examples on page 114.
| ascp: Transferring from the Command Line with Ascp | 106