| ascp: Transferring from the Command Line with Ascp |
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
(and its contents)
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.