IBM Aspera HST Admin Manual page 123

A named pipe can be specified as a stdio destination, with the syntax stdio:///path for single files, or stdio-
tar:///path for multiple files, where path is the path of the named pipe. If a docroot is configured on the
destination, then the transfer goes to the named pipe docroot/path.
Note: Do not use stdio:///path to transfer multiple files. The file data is asynchronously concatenated in the
output stream and might be unusable. Use stdio-tar:///path instead, which demarcates multiple files with
headers.
Single File Transfers
To upload data that is piped into stdin, set the source as stdio:///?fsize, wherefsize is the number of bytes (as
a decimal) that are received from stdin. The destination is set as the path and filename. The file modification time is
set to the time at which the upload starts. Standard input must transfer the exact amount of data that is set by fsize. If
more or less data is received by the server, an error is generated.
To download data and pipe it into stdout, set the destination as stdio://.
Restrictions:
• stdio:// cannot be used for persistent sessions. Use stdio-tar:// instead.
• Only --overwrite=always or --overwrite=never are supported with stdio://. The behavior of --
overwrite=diff and --overwrite=diff+older is undefined.
Single-file Transfer Examples:
• Upload 1025 bytes of data from the client stdin to /remote-dir on the server at 10.0.0.2. Save the data as the
file newfile. Transfer at 100 Mbps.
file_source | ascp -l 100m --mode=send --user=username --host=10.0.0.2
stdio:///?1025 /remote-dir/newfile
• Download the file remote_file from the server at 10.0.0.2 to stdout on the client. Transfer at 100 Mbps.
ascp -l 100m --mode=recv --user=username --host=10.0.0.2 remote_file
stdio://
• Upload the file local_file to the server at 10.0.0.2 to the named pipe /tmp/outpipe. Transfer at 100
Mbps.
ascp -l 100m --mode=send --user=username --host=10.0.0.2 local_file
stdio:////tmp/outpipe
Multi-File Transfers
Ascp can transfer one or more files in an encoded, streamed interface, similar to single file transfers. The primary
difference is that the stream includes headers that demarcate data from individual files.
To upload files that are piped into stdin, set the source as stdio-tar://. The file modification time is set to the
time at which the upload starts.
The file(s) in the input stream must be encoded in the following format. File can be the file name or file path, Size
is the size of the file in bytes, and Offset is an optional parameter that sets where in the destination file to begin
overwriting with the raw inline data:
[0 - n blank lines]
File: /path/to/file_1
Size: file_size
Offset: bytes
file_1 data
[0 - n blank lines]
File: /path/to/file_2
| ascp: Transferring from the Command Line with Ascp | 123