| ascp4: Transferring from the Command Line with Ascp 4 |
155
The restriction can be set to allow all access (*) or limited by protocol, hostname or path:
Restriction
Format Example
By protocol
udp://*
tcp://*
By protocol and hostname
udp://hostname*
By protocol, hostname, and port
tcp://hostname:5000*
General Command Line Usage
# ascp4 -m
minimum_rate
-l
target_rate
--mode=
mode
--host=
remote_hostname
--compression=none --user=
username
--read-threads=1 --write-
threads=1
input_uri
output_uri
•
ascp4
streaming supports two transfer directions:
send
and
recv
.
• The
ascp4
command defaults to multiple threads, but for reliable and in-order transport of streams you must use
only one read and write thread by specifying
--read-threads=1 --write-threads=1
.
• The data stream source and destination can be
udp://
,
tcp://
, or
file://
on page 153
• For command line examples, see
Ascp 4 Data Streaming Examples
on page 156.
Recommended Rate Settings for Video Streams
ascp4 Option
Description
Recommendation
-m
Minimum rate
Take the encoding rate of the
transport stream and add 1 Mbps.
-l
Target rate
Take the minimum rate and add 10%
of the minimum rate.
For example, if the encoding rate is 10 Mbps, use the following settings:
# ascp4 -m 11M -l 13M ...
Multicast URI Syntax
The input multicast URI and the output multicast URI uses the same syntax.
multicast_protocol_scheme
://
stream_ip_address
:
port
?
option
=
value
&
option
=
value
...
The multicast protocol scheme can be either
udp
or
mcast
. If the IP address of your data stream is a multicast
address,
ascp4
uses multicast regardless of the protocol scheme (in other words, both
udp
and
mcast
use
multicast). In order to use unicast addresses, you must use the
udp
scheme.
You can configure properties of the stream by adding options to the URI after the question mark (?), each separated
by an ampersand (&). The following table describes the supported options.
Option
Description
Default
pktbatch={1|0}
How to handle packet read and
write. If 1, batch read and write UDP
datagrams. If 0, read and write one
packet at a time.
1
