Skip to content

amp trace

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

NAME

amp-trace - AMP standalone UDP traceroute test

SYNOPSIS

amp-trace [-abhrx] [-p milliseconds] [-s packetsize] [-w window] [-I iface] [-4 address] [-6 address] [-Q codepoint] [-Z microseconds] -- destination1 [destination2 ...]

DESCRIPTION

amp-trace is the standalone version of the amplet2(8) UDP traceroute test. It is very similar in function to traceroute(1), except that it can test to multiple destinations simultaneously. All destinations listed on the command line will be tested to. Any destinations that are hostnames will be resolved, and every address that they resolve to will be tested.

OPTIONS

-a, --asn Lookup AS numbers for all addresses using http://www.team-cymru.org/IP-ASN-mapping.html. Please be respectful of the demands that this places on their infrastructure and use their service appropriately. Any large deployments that will use this test option should contact Team Cymru directly.

-b, --noip Don't report IP addresses for each hop in the path.

-h, --help Show summary of options.

-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.

-p, --perturbate milliseconds Delay the test by a random number of milliseconds, up to a maximum of milliseconds. The default is to not perturbate tests (no delay).

-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, --random Use a random packet size for each test.

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

-w, --window count Maximum number of targets to probe at one time. Only one probe will be outstanding for each target, so this number is also the total number of packets that can be put on to the network at any one time until a loss timeout occurs or a response is received. The default is 50.

-v, --version Show version of program.

-x, --debug Enable extra debugging output.

-Z, --interpacketgap microseconds Minimum number of microseconds between sending probe/query packets.

-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.

SEE ALSO

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

SECURITY

amp-trace requires raw socket access to run.

AUTHOR

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

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

Clone this wiki locally