sc_analysis_dump, sc_tracediff, sc_ttlexp, sc_warts2csv, sc_warts2json, sc_warts2pcap, sc_warts2text, sc_wartscat, sc_wartsdump, sc_wartsfilter, sc_wartsfix, scamper: add page (#12230)

Signed-off-by: Marek Küthe <m.k@mk16.de>

pages/common/sc_analysis_dump.md

@@ -0,0 +1,8 @@
+# sc_analysis_dump
+
+> Dump of traceroute data in an easily parsed format.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Output the traceroute of `warts` files one after the other in an easy-to-parse format:
+
+`sc_analysis_dump {{path/to/file1.warts path/to/file2.warts ...}}`

pages/common/sc_tracediff.md

@@ -0,0 +1,16 @@
+# sc_tracediff
+
+> Display traceroute paths where the path has changed.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Show the difference between traceroutes in two `warts` files:
+
+`sc_tracediff {{path/to/file1.warts}} {{path/to/file2.warts}}`
+
+- Show the difference between the traceroutes in two `warts` files, including those that have not changed:
+
+`sc_tracediff -a {{path/to/file1.warts}} {{path/to/file2.warts}}`
+
+- Show the difference between the traceroutes in two `warts` files and try to show DNS names and not IP addresses if possible:
+
+`sc_tracediff -n {{path/to/file1.warts}} {{path/to/file2.warts}}`

pages/common/sc_ttlexp.md

@@ -0,0 +1,8 @@
+# sc_ttlexp
+
+> Dump source addresses from ICMP TTL expired messages in `warts` files.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Output the source address of ICMP TTL expire messages in `warts` files one after the other:
+
+`sc_ttlexp {{path/to/file1.warts path/to/file2.warts ...}}`

pages/common/sc_warts2csv.md

@@ -0,0 +1,8 @@
+# sc_warts2csv
+
+> Dump traceroutes collected by `scamper` in CSV format.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Convert traceroute data in `warts` files to CSV and output it:
+
+`sc_warts2csv {{path/to/file1.warts path/to/file2.warts ...}}`

pages/common/sc_warts2json.md

@@ -0,0 +1,8 @@
+# sc_warts2json
+
+> JSON dump of information contained in a `warts` file.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Convert `warts` files to JSON and output the result:
+
+`sc_warts2json {{path/to/file1.warts path/to/file2.warts ...}}`

pages/common/sc_warts2pcap.md

@@ -0,0 +1,13 @@
+# sc_warts2pcap
+
+> Write packets included in `warts` object to a `pcap` file.
+> This is only possible for tbit, sting and sniff.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Convert the data from several `warts` files into one `pcap` file:
+
+`sc_warts2pcap -o {{path/to/output.pcap}} {{path/to/file1.warts path/to/file2.warts ...}}`
+
+- Convert the data from a `warts` file into a `pcap` file and sort the packets by timestamp:
+
+`sc_warts2pcap -s -o {{path/to/output.pcap}} {{path/to/file.warts}}`

pages/common/sc_warts2text.md

@@ -0,0 +1,8 @@
+# sc_warts2text
+
+> Simple dump of information contained in a `warts` file.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Output the information in `warts` files as text:
+
+`sc_warts2text {{path/to/file1.warts path/to/file2.warts ...}}`

pages/common/sc_wartscat.md

@@ -0,0 +1,8 @@
+# sc_wartscat
+
+> Concatenate `warts` files.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Concatenate `warts` files into one:
+
+`sc_wartscat -o {{path/to/output.warts}} {{path/to/file1.warts path/to/file2.warts ...}}`

pages/common/sc_wartsdump.md

@@ -0,0 +1,8 @@
+# sc_wartsdump
+
+> Verbose dump of information contained in a `warts` file.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Output the content of `warts` files verbose:
+
+`sc_wartsdump {{path/to/file1.warts path/to/file2.warts ...}}`

pages/common/sc_wartsfilter.md

@@ -0,0 +1,16 @@
+# sc_wartsfilter
+
+> Select specific records from a `warts` file.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Filter all data records that had specific destinations and write them to a separate file:
+
+`sc_wartsfilter -i {{path/to/input.warts}} -o {{path/to/output.warts}} -a {{192.0.2.5}} -a {{192.0.2.6}}`
+
+- Filter all records that had certain destinations in a prefix and write them to a separate file:
+
+`sc_wartsfilter -i {{path/to/input.warts}} -o {{path/to/output.warts}} -a {{2001:db8::/32}}`
+
+- Filter all records that using a specific action and output them as JSON:
+
+`sc_wartsfilter -i {{path/to/input.warts}} -t {{ping}} | sc_warts2json`

pages/common/sc_wartsfix.md

@@ -0,0 +1,8 @@
+# sc_wartsfix
+
+> Truncate damaged `warts` files.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Save all records (in a separate file) up to the last intact one:
+
+`sc_wartsfix {{path/to/file1.warts path/to/file2.warts ...}}`

pages/common/scamper.md

@@ -0,0 +1,29 @@
+# scamper
+
+> Actively probes the Internet in order to analyze topology and performance.
+> Includes some tools that start with `sc_`, for example `sc_warts2text` or `sc_ttlexp`.
+> More information: <https://www.caida.org/catalog/software/scamper/>.
+
+- Execute the standard option (traceroute) to a destination:
+
+`scamper -i {{192.0.2.1}}`
+
+- Execute two actions (ping and traceroute) on two different targets:
+
+`scamper -I "{{ping}} {{192.0.2.1}}" -I "{{trace}} {{192.0.2.2}}`
+
+- Ping several hosts with UDP, use a specific port number for the first ping and increase it for each subsequent ping:
+
+`scamper -c "{{ping}} -P {{UDP-dport}} -d {{33434}}" -i {{192.0.2.1}} -i {{192.0.2.2}}`
+
+- Use the Multipath Discovery Algorithm (MDA) to determine the presence of load-balanced paths to the destination and use ICMP echo packets to sample with a maximum of three attempts, write the result to a `warts` file:
+
+`scamper -O {{warts}} -o {{path/to/output.warts}} -I "{{tracelb}} -P {{ICMP-echo}} -q {{3}} {{192.0.2.1}}"`
+
+- Execute a Paris traceroute with ICMP to a destination and save the result in a compressed `warts` file:
+
+`scamper -O {{warts.gz}} -o {{path/to/output.warts}} -I "{{trace}} -P {{icmp-paris}} {{2001:db8:dead:beaf::4}}"`
+
+- Record all ICMP packets that arrive at a specific IP address and have a specific ICMP ID in a `warts` file:
+
+`scamper -O {{warts}} -o {{path/to/output.warts}} -I "sniff -S {{2001:db8:dead:beef::6}} icmp[icmpid] == {{101}}"`