| ascp: Transferring from the Command Line with Ascp |
112
at the start of each second and incremented for each additional file saved during that second. The
saved copies retain the attributes of the original. Not supported for URI path destinations.
--skip-special-files
Skip special files, such as devices and pipes, without reporting errors for them.
--source-prefix=
prefix
Prepend
prefix
to each source path. The prefix can be a conventional path or a URI; however, URI
paths can be used only if no docroot is defined.
--source-prefix64=
prefix
Prepend the base64-encoded
prefix
to each source path. If
--source-prefix=
prefix
is also
used, the last option takes precedence.
--src-base=
prefix
Strip the specified path prefix from the source path of each transferred file or directory. The
remaining portion of the path remains intact at the destination.
Without
--src-base
, source files and directories are transferred without their source path.
(However, directories do include their contents.)
Note:
Sources located outside the source base are not transferred. No errors or warnings are issued,
but the skipped files are logged.
Use with URIs
: The
--src-base
option performs a character-to-character match with the source
path. For object storage source paths, the prefix must specify the URI in the same manner as the
source paths. For example, if a source path includes an embedded passphrase, the prefix must also
include the embedded passphrase otherwise it will not match.
For examples, see
Ascp File Manipulation Examples
on page 116.
--symbolic-links={follow|copy|copy+force|skip}
Handle symbolic links using the specified method, as allowed by the server. For more information
on symbolic link handling, see
on page 132. On Windows, the only
method is
skip
. On other operating systems, any of the following methods can be used:
•
follow
- Follow symbolic links and transfer the linked files. (Default)
•
copy
- Copy only the alias file. If a file with the same name is found at the destination, the
symbolic link is not copied.
•
copy+force
- Copy only the alias file. If a file (not a directory) with the same name is found
at the destination, the alias replaces the file. If the destination is a symbolic link to a directory,
it's not replaced.
•
skip
- Skip symbolic links. Do not copy the link or the file it points to.
-T
Disable in-transit encryption for maximum throughput.
--tags
string
Metatags in JSON format. The value is limited to 4 Kb.
--tags64
string
Metatags in JSON format and base64 encoded. The value is limited to 4 Kb.
-u
user_string
Define a user string, such as variables, for pre- and post-processing. This string is passed to the pre-
and -post-processing scripts as the environment variable
$USERSTR
.
--user=
username
Authenticate the transfer using the specified username. Use this option instead of specifying the
username as part of the destination path (as
user
@
host
:
file
).
