Skip to content

amp udpstream

Brendon Jones edited this page Sep 21, 2016 · 2 revisions

NAME

amp-udpstream - AMP standalone UDP jitter test

SYNOPSIS

amp-udpstream -s [options]

amp-udpstream -c server [options]

DESCRIPTION

amp-udpstream is the standalone version of the amplet2(8) UDP jitter test. It sends streams of UDP packets between two endpoints (either one being this standalone test or a running instance of amplet2(8)) and reports on the jitter, latency and loss observed. These values can be used to calculate Mean Opinion Scores for possible Voice Over IP streams.

GENERAL OPTIONS

-p, --port port Set server control port to connect to/listen on to be port. The default is 8815.

-I, --interface iface Specifies the interface (device) that tests should use when sending packets. By default the interface will be selected according to the routing table.

-4, --ipv4 a.b.c.d Specifies the source IPv4 address that tests should use when sending packets to IPv4 targets. This address must belong to one of the interfaces. By default the IPv4 address of the outgoing interface will be used.

-6, --ipv6 a:b:c:d:e:f:g:h Specifies the source IPv6 address that tests should use when sending packets to IPv6 targets. This address must belong to one of the interfaces. By default the IPv6 address of the outgoing interface will be used.

SERVER OPTIONS

-s, --server Run in server mode.

CLIENT OPTIONS

-c, --client host Run in client mode, connecting to host.

-d, --direction dir Magic value describing direction. Valid values are 0 (client to server), 1 (server to client), 2 (client to server then server to client), 3 (server to client then client to server). The default is 2.

-D, --delay usec Delay between sending consecutive packets in the stream. The default is 20000usec (20ms).

-n, --packet-count count Number of packets to send in the stream. The default is 11.

-P, --test-port port Perform the actual throughput test using port port. The default is 8816.

-Q, --dscp codepoint IP differentiated services codepoint to set. This should be a string representing a 6-bit value in binary, octal, decimal or hexadecimal, or the short name of a predefined, commonly used codepoint. The default is 0.

-r, --rtt-samples N Reflect every Nth probe packet to provide an estimate of the round trip time. At large packet volumes or with low delay between packets, you may want to lower this to reduce load on the network and/or hosts. The default is to use every packet.

-z, --packet-size bytes Specifies the total number of bytes to be sent per packet (including headers). The default is 100 bytes.

MISCELLANEOUS OPTIONS

-h, --help Show summary of options.

-v, --version Show version of program.

-x, --debug Enable extra debugging output.

EXAMPLES

amp-udpstream -c <target> -d 1 -D 10000 Run a server to client test with 10ms between packets in the stream.

amp-udpstream -c <target> -d 3 -n 1000 -r 2 Run a server to client test, then a client to server test, both streams having 1000 packets, using every second packet as an RTT estimate.

SEE ALSO

amplet2(8), amplet2-remote(8), amp-icmp(8), amp-trace(8), amp-dns(8), amp-throughput(8), amp-http(8), amp-tcpping(8).

AUTHOR

amp-udpstream was written by Brendon Jones <brendonj@waikato.ac.nz>.

This manual page was written by Brendon Jones <brendonj@waikato.ac.nz>.