Skip to content

amplet2 remote

Brendon Jones edited this page Sep 20, 2016 · 1 revision

NAME

amplet2-remote - AMP client remote control

SYNOPSIS

amplet2-remote [-hlx] -c host -t test --cacert file --cert file --key file [-p port] [-I iface] [-4 address] [-6 address] [-a arguments] -- destination1 [destination2 ...]

DESCRIPTION

amplet2-remote can be used to connect to a running amplet2 process and trigger tests to be run remotely. All destinations listed on the command line will be passed to the specified test. Any destinations that are hostnames will be resolved by the remote client. amplet2 only accepts secure connections, you must specify --cacert, --cert and --key with appropriate credentials that will be trusted.

OPTIONS

-a, --args arguments A quoted string of all the arguments that should be passed through to the test being run on the remote amplet2 process.

-c, --connect host Connect to the amplet2 process running on host.

--cacert file Use the specified file as the trusted CA certificate.

--cert file Use the specified file as the certificate to present when connecting to the remote amplet2 process. The certificate should be in PEM format.

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

--key file Use the specified file as the private key when connecting to the remote amplet2 process. The key should be in PEM format.

-l, --list List all the available tests that this program (but not necessarily the remote client!) understands.

-p, --port port Connect to the amplet2 control socket on port port. The default is 8869.

-t, --test test Run test on the remote amplet2 process. Use -l to see all available tests that this program (but not necessarily the remote client!) understands.

-x, --debug Enable extra debugging output.

-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), amp-icmp(8), amp-trace(8), amp-dns(8), amp-throughput(8), amp-http(8), amp-tcpping(8), amp-udpstream(8).

AUTHOR

amplet2-remote was written by Brendon Jones <brendonj@waikato.ac.nz>.

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