sc_erosprober — scamper driver to periodically probe addresses and rotate output files.

sc_erosprober was written by Matthew Luckie.

Debian                                          September 8, 2019                               SC_EROSPROBER(1)

       The sc_erosprober utility provides the ability to connect to a running scamper(1) instance and use it  to
       periodically probe a set of addresses at a defined interval, and periodically rotate the output file at a
       defined interval.  The supported options to sc_erosprober are as follows:

       -aaddrfile
               specifies  the  name of the input file which consists of a sequence of IP addresses to probe, one
               address per line.

       -ccommand
               specifies the command to use with each  address.   sc_erosprober  supports  the  trace  and  ping
               commands, and their options, in scamper.  scamper(1) documents the options available in trace and
               ping.

       -Iinterval
               specifies  the  probe  interval,  in  seconds,  between probing each address.  sc_erosprober will
               spread the probing of the addresses across the interval.  If there are 10 addresses to  probe  at
               an interval of 20 seconds, then sc_erosprober will issue a command every two seconds.

       -llogfile
               specifies the name of a file to log progress output from sc_erosprober generated at run time.

       -ooutfile
               specifies  the prefix of the name of the output file to be written.  The output file will use the
               warts(5) format.  sc_erosprober will create a sequence of files named  using  the  prefix  and  a
               timestamp.

       -Ooptions
               allows the behavior of sc_erosprober to be further tailored.  The current choices for this option
               are:
                 -noshuffle: do not shuffle the order of addresses before probing starts.
                 -nooutfile: do not write to warts files, just do the probing.

       -pport
               specifies the port on the local host where scamper(1) is accepting control socket connections.

       -Rrotation
               specifies the rotation interval, in seconds, between rotating output files.

       -Uunix-scamper
               specifies  the  name  of  a  unix  domain  socket  where  scamper(1)  is accepting control socket
               connections.  This socket is used by sc_erosprober to send probing commands to scamper(1)

       -xunix-control
               specifies the name of a unix domain  socket  where  sc_erosprober  is  accepting  control  socket
               connections.  This socket can be used by a local process to adjust the probing list at run time.

       Given a set of IPv4 and IPv6 addresses contained in a file named addrs and a scamper process listening at
       sock configured to probe at 100 packets per second started as follows:

             scamper-Uscamper-sock-p100

       the  following  command  will ping the addresses every two minutes using one packet, and create an output
       file every thirty seconds prefixed with foo:

             sc_erosprober-Uscamper-sock-aaddrs-ofoo-I120-R30-c'ping-c1'

       The following command will traceroute towards the addresses every 15 minutes,  creating  an  output  file
       every minute, with an sc_erosprober control socket:

             sc_erosprober-Uscamper-sock-xerosprober-sock-aaddrs-ofoo-I900-R60-c'trace'

       To add an address to the probeset at runtime, using netcat, use:
             nc-Uerosprober-sock+192.0.2.1

       To remove an address from the probeset at runtime, using netcat, use:
             nc-Uerosprober-sock-192.0.31.60

       sc_erosprober — scamper driver to periodically probe addresses and rotate output files.

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

sc_erosprober  [-aaddrfile]  [-ccommand] [-Iinterval] [-llogfile] [-ooutfile] [-Ooption] [-pport]
                     [-Rrotation] [-Uunix-scamper] [-xunix-control]