Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
SC_PINGER(1)		FreeBSD	General	Commands Manual		  SC_PINGER(1)

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

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

     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 de-
     tails 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 accept-
	     ing 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 gener-
	     ated at run time.

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

     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'

     scamper(1), sc_wartsdump(1), sc_warts2json(1), sc_warts2text(1)

     sc_pinger was written by Matthew Luckie <>.

FreeBSD	13.0			 Jun 24, 2020			  FreeBSD 13.0


Want to link to this manual page? Use this URL:

home | help