NAME

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

SYNOPSIS

       sc_erosprober  [-a  addrfile]  [-c command] [-I interval] [-l logfile] [-o outfile] [-O option] [-p port]
                     [-R rotation] [-U unix]

DESCRIPTION

       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:

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

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

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

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

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

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

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

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

       -U unix
               specifies  the  name  of  a  unix  domain  socket  where  scamper(1)  is accepting control socket
               connections.

EXAMPLES

       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 -U sock -p 100

       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 -U sock -a addrs -o foo -I 120 -R 30 -c 'ping -c 1'

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

             sc_erosprober -U sock -a addrs -o foo -I 900 -R 60 -c 'trace'

SEE ALSO

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

AUTHORS

       sc_erosprober was written by Matthew Luckie.

Debian                                          September 8, 2019                               SC_EROSPROBER(1)