| ascp: Transferring from the Command Line with Ascp |
101
Note:
If the local token is a basic or bearer token, the access key settings for cipher and
preserve_time are not respected and the server settings are used. To set the cipher and timestamp
preservation options as a client, set them in the command line.
ASPERA_PROXY_PASS=
proxy_server_password
The password for an Aspera Proxy server.
ASPERA_SCP_COOKIE=
cookie
A cookie string that you want associated with transfers.
ASPERA_SCP_DOCROOT=
docroot
The transfer user docroot. Equivalent to using
--apply-local-docroot
when a docroot is set
in
aspera.conf
.
ASPERA_SCP_FILEPASS=
password
The passphrase to be used to encrypt or decrypt files. For use with
--file-crypt
.
ASPERA_SCP_KEY="-----BEGIN RSA PRIVATE KEY..."
The transfer user private key. Use instead of the
-i
option.
ASPERA_SCP_PASS=
password
The password for the transfer user.
ASPERA_SCP_TOKEN=
token
The transfer user authorization token. Overridden by
-W
.
ASPERA_SRC_PASS=
password
The password to authenticate to a URI source.
Ascp Options
-6
Enable IPv6 address support. When specifying an IPv6 numeric
host for
src_host
or
dest_host
, write it in brackets. For example,
username
@[2001:0:4137:9e50:201b:63d3:ba92:da]:/
path
or
--
host=[fe80::21b:21ff:fe1c:5072%eth1]
.
-@
range_start
:
range_end
Transfer only part of a file:
range_start
is the first byte to send, and
range_end
is the last. If either
position is unspecified, the file's first and last bytes (respectively) are assumed. This option only
works for downloads of a single file and does not support transfer resume.
-A, --version
Display version and license information.
--apply-local-docroot
Apply the local docroot that is set in
aspera.conf
for the transfer user. Use to avoid entering
object storage access credentials in the command line. This option is equivalent to setting the
environment variable
ASPERA_SCP_DOCROOT
.
-C
nodeid
:
nodecount
Enable multi-session transfers (also known as parallel transfers) on a multi-node/multi-core system.
A node ID (
nodeid
) and count (
nodecount
) are required for each session.
nodeid
and
nodecount
can
be 1-128, but
nodeid
must be less than or equal to
nodecount
, such as 1:2, 2:2. Each session must
use a different UDP port specified with the
-O
option. Large files can be split across sessions, see
--multi-session-threshold
. For more information, see
121.
-c
cipher
Encrypt in-transit file data using the specified cipher. Aspera supports three sizes of AES cipher
keys (128, 192, and 256 bits) and supports two encryption modes, cipher feedback mode (CFB) and
