IBM Aspera HST, Admin Manual

Page: 108 / 353

| ascp: Transferring from the Command Line with Ascp | 108
If --multi-session-threshold is not used, the threshold value is taken from the setting for
<multi_session_threshold_default> in the aspera.conf file on the client. If not
found in aspera.conf on the client, the setting is taken from aspera.conf on the server. The
command-line setting overrides any aspera.conf settings, including when the command-line
setting is 0 (zero).
Multi-session uploads to cloud storage are supported for S3 only and require additional
configuration. For more information, see Multi-Session Transfers on page 121.
-N ' pattern '
Include files or directories in the transfer based on matching the specified pattern to file names and
paths. Rules are applied in the order in which they are encountered, from left to right, such that -N
rules protect files from -E rules that follow them.
Note:
An include rule
must
be followed by at least one exclude rule, otherwise all files are
transferred because none are excluded. To exclude all files that do not match the include rule, use -
N '/**/' -E '/**' at the end of your filter arguments.
The following symbols can be used in the pattern:
•
*
(asterisk) represents zero or more characters in a string, for example *.tmp matches .tmp
and abcde.tmp .
• ? (question mark) represents any single character, for example t?p matches tmp but not temp .
For details on specifying patterns and rules, including examples, see Using Filters to Include and
Exclude Files on page 126.
Note: Filtering rules can also be specified in aspera.conf . Rules found in aspera.conf are
applied before any -E and -N rules specified on the command line.
-O fasp_port
Use the specified UDP port for FASP transfers. (Default: 33001)
--overwrite={never|always|diff|diff+older|older}
Overwrite destination files with source files of the same name. Default:
diff
. This option takes the
following values:
•
never
- Never overwrite the file. However, if the parent folder is not empty, its access, modify,
and change times may still be updated.
• always - Always overwrite the file.
• diff - Overwrite the file if different from the source. If a complete file at the destination is
the same as a file on the source, it is not overwritten. Partial files are overwritten or resumed
depending on the resume policy.
• diff+older - Overwrite the file if older and also different than the source. For example,
if the destination file is the same as the source, but with a different timestamp, it will not be
overwritten. Plus, if the destination file is different than the source, but newer, it will not be
overwritten.
•
older
- Overwrite the file if its timestamp is older than the source timestamp.
Interaction with resume policy (-k): If the overwrite method is
diff
or
diff+older
,
difference is determined by the resume policy (
-k {0|1|2|3}
). If
-k 0
or no
-k
is specified,
the source and destination files are always considered different and the destination file is always
overwritten. If
-k 1
, the source and destination files are compared based on file attributes
(currently file size). If
-k 2
, the source and destination files are compared based on sparse
checksums. If
-k 3
, the source and destination files are compared based on full checksums.
-P ssh-port
Use the specified TCP port to initiate the FASP session. (Default: 22)
-p