NAME

       sc_speedtrap — scamper driver to resolve aliases for a set of IPv6 interfaces.

SYNOPSIS

       sc_speedtrap  [-I]  [-a  addressfile]  [-A  aliasfile]  [-l  logfile]  [-o  outfile]  [-p port] [-s stop]
                    [-S skipfile] [-U unix-socket]

       sc_speedtrap [-d dump] [file ...]

DESCRIPTION

       The sc_speedtrap utility provides the ability to connect  to  a  running  scamper(1)  instance  and  have
       resolve  a  set of IPv6 addresses for aliases using the "speedtrap" technique.  sc_speedtrap induces each
       address to send fragmented ICMP echo replies, with the goal of obtaining an incrementing Identifier  (ID)
       field in the fragmentation header.  If two addresses are aliases, they will return ICMP echo replies with
       a  monotonically increasing value in the ID field because the ID field is implemented as a counter shared
       amongst all interfaces.   sc_speedtrap  implements  a  scalable  algorithm  to  quickly  determine  which
       addresses  are  aliases.  For further information about the algorithm is found in the "see also" section.
       The supported options to sc_speedtrap are as follows:

       -a addressfile
               specifies the name of the input file which consists of a sequence of IPv6  addresses  to  resolve
               for aliases, one address per line.

       -A aliasfile
               specifies  the  name  of an output file which will receive pairs of aliases, one address-pair per
               line.

       -d dump
               specifies the number identifying an analysis task to conduct.  Valid dump numbers are  1-3.   See
               the examples section.

       -I      specifies  that  the  addressfile  contains  only  interfaces known to send fragmentation headers
               containing incrementing values.

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

       -o outfile
               specifies the name of the output file to be written.  The output file will use the warts format.

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

       -s stop
               specifies the step at which sc_speedtrap  should  halt.   The  available  steps  are  "classify",
               "descend", "overlap", "descend2", "candidates", and "ally".

       -S skipfile
               specifies the name of an input file which contains known aliases that do not need to be resolved,
               one address-pair per line.

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

EXAMPLES

       Given a set of IPv6 addresses contained in a file named addressfile.txt and a scamper  process  listening
       on port 31337 configured to probe at 30 packets per second started as follows:

             scamper -P 31337 -p 30

       the   following  command  will  resolve  the  addresses  for  aliases,  store  the  raw  measurements  in
       outfile1.warts, and record the interface-pairs that are aliases in aliases.txt:

             sc_speedtrap -p 31337 -a addressfile.txt -o outfile1.warts -A aliases.txt

       The next example is useful when inferring aliases from multiple vantage  points.   Given  the  output  of
       aliases.txt from a previous measurement, the following will resolve the addressfile for aliases, skipping
       those in aliases.txt, and appending the new aliases to aliases.txt:

             sc_speedtrap -p 31337 -a addressfile.txt -o outfile2.warts -A aliases.txt -S aliases.txt

       To obtain a transitive closure of routers from an input warts file:

             sc_speedtrap -d 1 outfile1.warts

       To obtain a list of the interfaces probed and their IPID behaviour:

             sc_speedtrap -d 2 outfile1.warts

       To obtain statistics of how many probes are sent in each stage, and how long the stage takes:

             sc_speedtrap -d 3 outfile1.warts

SEE ALSO

       M.  Luckie,  R.  Beverly,  W. Brinkmeyer, and k. claffy, Speedtrap: Internet-scale IPv6 Alias Resolution,
       Proc.  ACM/SIGCOMM  Internet  Measurement  Conference  2013.   scamper(1),  sc_ally(1),   sc_ipiddump(1),
       sc_wartsdump(1), sc_warts2text(1), sc_warts2json(1),

AUTHORS

       sc_speedtrap is written by Matthew Luckie <mjl@luckie.org.nz>.

Debian                                           August 18, 2013                                 SC_SPEEDTRAP(1)