SC_SPEEDTRAP(1)

🛰️ NAME 🛰️

sc_speedtrap — the scamper driver bestie that resolves aliases for a whole 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 💖

okay so. sc_speedtrap is the utility that lets you connect to a scamper(1) instance that's already running, and use it to collect data so you can do alias resolution on a set of IPv6 addresses using the "speedtrap" technique. no cap.

Here's the vibe: sc_speedtrap induces each address to send fragmented ICMP echo replies, and the whole goal of that is to get an incrementing Identifier (ID) field in the fragmentation header. Because if two addresses are actually aliases, they'll come back with ICMP echo replies where the ID field is a monotonically increasing value — and the reason is that the ID field is implemented as a counter shared amongst all interfaces. 💅

sc_speedtrap implements a scalable algorithm to quickly figure out which addresses are aliases. if you want the full algorithm lore, it's down in the "see also" section, bestie. 📚

The supported options to sc_speedtrap are as follows:

✨ OPTIONS ✨

• -a addressfile — names the input file that's a sequence of IPv6 addresses to resolve for aliases, one address per line.
• -A aliasfile — names an output file that will receive pairs of aliases, one address-pair per line.
• -d dump — names the number identifying which analysis task to conduct. valid dump numbers are 1-3. check the examples section for what each one does.
• -I — says that the addressfile contains only interfaces known to send fragmentation headers containing incrementing values. iykyk.
• -l logfile — names a file to log output from sc_speedtrap that gets generated at run time.
• -o outfile — names the output file to be written. the output file will use the warts format.
• -p port — names the port on the local host where scamper(1) is accepting control socket connections.
• -s stop — names the step at which sc_speedtrap should halt. the available steps are "classify", "descend", "overlap", "descend2", "candidates", and "ally".
• -S skipfile — names an input file containing known aliases that do not need to be resolved, one address-pair per line.
• -U unix-socket — names a unix domain socket where scamper(1) is accepting control socket connections.

---

🌸 EXAMPLES 🌸

Say you've got a set of IPv6 addresses chillin' in a file named addressfile.txt, and a scamper process listening on port 31337 that's configured to probe at 30 packets per second, started like this:

scamper -P 31337 -p 30

then this next 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 lowkey so useful when you're inferring aliases from multiple vantage points. Given the output of aliases.txt from a previous measurement, the following will resolve the addressfile for aliases, skip the ones already in aliases.txt, and append the new aliases to aliases.txt:

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

---

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

sc_speedtrap -d 1 outfile1.warts

---

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

sc_speedtrap -d 2 outfile1.warts

---

To get 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 was written by Matthew Luckie <mjl@luckie.org.nz>. iconic honestly 💖

---

this Debian edition dropped on August 18, 2013 — yeah she's an elder but she still ate, periodt. go resolve some aliases bestie, ily, bye 🦋✨🎀