NAME

sc_pinger —

scamper driver to run ping with different probe methods on a list of addresses.

SYNOPSIS

sc_pinger [-?D] [-a infile] [-o outfile] [-p port] [-U unix-socket] [-c probe-count] [-m method] [-t logfile]

DESCRIPTION

The sc_pinger utility provides the ability to connect to a running scamper(1) instance and run ping on a set of IPv4 and IPv6 addresses. For each address in the file, sc_pinger will try ICMP, UDP, and TCP-ack probe methods to solicit responses from the address. sc_pinger will not try all methods if one method obtains responses. The output of sc_pinger is written to a warts(5) file, which can then be processed to extract details of responses. The options are as follows:

-?: prints a list of command line options and a synopsis of each.
-D: causes sc_pinger to detach and become a daemon.
-a infile: specifies the name of the input file which consists of a sequence of IPv4 and IPv6 addresses, one per line.
-o outfile: specifies the name of the output file to be written. The output file will use the warts(5) format.
-p port: specifies the port on the local host where scamper(1) is accepting control socket connections.
-U unix-socket: specifies the name of a unix domain socket where scamper(1) is accepting control socket connections.
-c probe-count: specifies the number of probes to send for each method. sc_pinger accepts two formats: a single integer that specifies the number of probes (and responses) desired; or, two integers, separated by /, that specify the number of responses desired and maximum number of probes to send. By default, sc_pinger seeks three responses from up to five probes.
-m method: specifies a single probe method to try. The available probe methods are the same as scamper's ping implementation, listed in scamper(1) manual page. By default, sc_pinger uses ICMP-echo, UDP-dport, and TCP-ack-sport to destination port 80.
-t logfile: specifies the name of a file to log output from sc_pinger generated at run time.

EXAMPLES

Given a set of IPv4 and IPv6 address sets in a file named infile.txt:

192.0.2.1
192.0.32.10
192.0.31.60
2001:db8::1

and a scamper(1) daemon listening on port 31337, then these addresses can be probed using

sc_pinger -a infile.txt -o
  outfile.warts -p 31337

To send 4 probes, and stop after receiving two responses:

sc_pinger -a infile.txt -o
  outfile.warts -p 31337 -c 2/4

To use ICMP-echo and TCP-syn probes to destination port 443

sc_pinger -a infile.txt -o
  outfile.warts -p 31337 -m icmp-echo -m 'tcp-syn -d 443'

AUTHORS

sc_pinger was written by Matthew Luckie <mjl@luckie.org.nz>.

NAME

SYNOPSIS

DESCRIPTION

EXAMPLES

SEE ALSO

AUTHORS