SC_EROSPROBER(1)

👑 sc_erosprober — from the General Commands Manual, section 1 💅

okay bestie, welcome to the little driver that keeps your probes on a schedule. it lives in section 1 of the General Commands Manual, its name is sc_erosprober, and it is lowkey iconic.

---

💖 NAME 💖

sc_erosprober — the scamper driver that periodically probes addresses and rotates output files. that's the whole job description, and it does it flawlessly, no cap.

---

🦋 SYNOPSIS 🦋

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

---

✨ DESCRIPTION ✨

so here's the tea 🍓: the sc_erosprober utility lets you connect to a scamper(1) instance that's already up and running, and then use it to probe a set of addresses on a repeating schedule at an interval you pick. it also rotates the output file on a schedule, at an interval you pick. two intervals, zero stress, main character energy fr fr.

the supported options to sc_erosprober are as follows:

• -a addrfile — the name of the input file, which is literally just a sequence of IP addresses to probe, one address per line. simple, clean, ate.
• -c command — the command to use with each address. sc_erosprober supports the trace and ping commands, plus their options, in scamper. scamper(1) is where the options available in trace and ping get documented, so go read that one for the deets.
• -I interval — the probe interval, in seconds, between probing each address. sc_erosprober spreads the probing of the addresses across that interval. like, if there are 10 addresses to probe at an interval of 20 seconds, then sc_erosprober will issue a command every two seconds. the math is mathing 💅
• -l logfile — the name of a file to log progress output from sc_erosprober, generated at run time.
• -o outfile — the prefix of the name of the output file to be written. the output file uses the warts(5) format. sc_erosprober will create a sequence of files, named using the prefix and a timestamp. a whole lil family of files 🫶
• -O options — lets the behavior of sc_erosprober be tailored even further. 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 — the port on the local host where scamper(1) is accepting control socket connections.
• -R rotation — the rotation interval, in seconds, between rotating output files.
• -U unix-scamper — 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).
• -x unix-control — 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. runtime glow-ups only ✨

---

🌈 EXAMPLES 🌈

say you've got a set of IPv4 and IPv6 addresses chillin in a file named addrs, and a scamper process listening at sock, configured to probe at 100 packets per second, started like this:

scamper -U scamper-sock -p 100

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

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

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

want to add an address to the probeset at runtime, using netcat? obsessed. do this:

nc -U erosprober-sock
+192.0.2.1

want to remove an address from the probeset at runtime, using netcat? also slay, do this:

nc -U erosprober-sock
-192.0.31.60

---

🧚 SEE ALSO 🧚

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

---

💜 AUTHORS 💜

sc_erosprober was written by Matthew Luckie. king behavior, honestly.

---

and that's the whole page bestie, you're now officially fluent in sc_erosprober 🎀

this one shipped with Debian, dated September 8, 2019 — go forth and probe on schedule, you've got this 💖