| ascp: Transferring from the Command Line with Ascp |
99
"
/>
</EMAILNOTIF>
ascp: Transferring from the Command Line with Ascp
Ascp is a scriptable FASP transfer binary that enables you to transfer to and from Aspera transfer servers to which
you have authentication credentials. Transfer settings are customizable and can include file manipulation on the
source or destination, filtering of the source content, and client-side encryption-at-rest.
Ascp Command Reference
The
ascp
executable is a command-line FASP transfer program. This reference describes
ascp
syntax, command
options, and supported environment variables.
For examples of
ascp
commands, see the following topics:
•
on page 114
•
Ascp File Manipulation Examples
on page 116
•
Ascp Transfers with Object Storage and HDFS
on page 118
Another command-line FASP transfer program, Ascp 4 (
ascp4
), is optimized for transfers of many small files. It has
many of the same capabilities as
ascp
, as well as its own features. For more information, see
on page 144 and
Comparison of Ascp and Ascp 4 Options
on page 138.
Ascp Syntax
ascp
options
[[
username
@]
src_host
:]
source1
[
source2
...]
[[
username
@]
dest_host:
]
dest_path
username
The username of the Aspera transfer user can be specified as part of the source or destination,
whichever is the remote server. It can also be specified with the
--user
option. If you do not
specify a username for the transfer, the local username is authenticated by default.
Note:
If you are authenticating on a Windows computer as a domain user, the transfer server
strips the domain from the username. For example,
Administrator
is authenticated rather than
DOMAIN\Administrator
. For this reason, you must specify the domain explicitly.
src_host
The name or IP address of the computer where the files or directories to be transferred reside.
source
The file or directory to be transferred. Separate multiple arguments with spaces.
dest_host
The name or IP address of the computer where the source files or directories are to be transferred.
dest_path
The destination directory where the source files or directories are to be transferred.
• If the source is a single file, the destination can be a filename. However, if there are multiple
source arguments, the destination must be a directory.
• To transfer to the transfer user's docroot, specify "
.
" as the destination.
• If the destination is a symbolic link, then the file or directory is written to the target of the
symbolic link.
