IBM Aspera HST Admin Manual page 105

• Only one --file-list or --file-pair-list option is allowed per ascp session. If
multiple lists are specified, only the last one is used.
• Only files and directories specified in the file list are transferred; any sources specified on the
command line are ignored.
• If the source paths are URIs, the size of the file list cannot exceed 24 KB.
To create a file list that also specifies destination paths, use --file-pair-list.
--file-manifest={none|text}
Generate a list of all transferred files when set to text. Requires --file-manifest-path to
specify the location of the list. (Default: none)
--file-manifest-path=directory
Save the file manifest to the specified location when using --file-manifest=text. File
manifests must be stored locally. For cloud or other non-local storage, specify a local manifest path.
--file-manifest-inprogress-suffix=suffix
Apply the specified suffix to the file manifest's temporary file. For use with --file-
manifest=text. (Default suffix: .aspera-inprogress)
--file-pair-list=file
Transfer files and directories listed in file to their corresponding destinations. Each source is
specified on a separate line, with its destination on the line following it.
Specify destinations relative to the transfer user's docroot. Even if a destination is specified as an
absolute path, the path at the destination is still relative to the docroot. Destination paths specified in
the list are created automatically if they do not already exist.
For example, if the file pairlist.txt contains the following list of sources and destinations:
Dir1
Dir2
my_images/iris.png
project_images/iris.png
/tmp/code/compute.php
/tmp/code/compute.php
/tmp/tests/testfile
testfile2
and the following command is run:
# ascp --file-pair-list=pairlist.txt --mode=send --user=username
--host=ip_addr .
then the destination, in this case the transfer user's docroot, now contains the following:
Dir2
project_images/iris.png
tmp/code/compute.php
testfile2
Restrictions:
• The command line cannot use the user@host:source syntax. Instead, specify this
information with the options --mode, --host, and --user.
• The user@host:source syntax cannot be used with paths specified in the file list.
• Because multiple sources are being transferred, the destination specified on the command line
must be a directory.
• Only one --file-pair-list or --file-list option is allowed per ascp session. If
multiple lists are specified, only the last one is used.
(and its contents)
| ascp: Transferring from the Command Line with Ascp | 105