diff --git a/pages/common/sc_analysis_dump.md b/pages/common/sc_analysis_dump.md new file mode 100644 index 000000000..3456bdf8b --- /dev/null +++ b/pages/common/sc_analysis_dump.md @@ -0,0 +1,8 @@ +# sc_analysis_dump + +> Dump of traceroute data in an easily parsed format. +> More information: . + +- 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 ...}}` diff --git a/pages/common/sc_tracediff.md b/pages/common/sc_tracediff.md new file mode 100644 index 000000000..8a3157adf --- /dev/null +++ b/pages/common/sc_tracediff.md @@ -0,0 +1,16 @@ +# sc_tracediff + +> Display traceroute paths where the path has changed. +> More information: . + +- 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}}` diff --git a/pages/common/sc_ttlexp.md b/pages/common/sc_ttlexp.md new file mode 100644 index 000000000..a45815e5e --- /dev/null +++ b/pages/common/sc_ttlexp.md @@ -0,0 +1,8 @@ +# sc_ttlexp + +> Dump source addresses from ICMP TTL expired messages in `warts` files. +> More information: . + +- 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 ...}}` diff --git a/pages/common/sc_warts2csv.md b/pages/common/sc_warts2csv.md new file mode 100644 index 000000000..e49a34e93 --- /dev/null +++ b/pages/common/sc_warts2csv.md @@ -0,0 +1,8 @@ +# sc_warts2csv + +> Dump traceroutes collected by `scamper` in CSV format. +> More information: . + +- Convert traceroute data in `warts` files to CSV and output it: + +`sc_warts2csv {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages/common/sc_warts2json.md b/pages/common/sc_warts2json.md new file mode 100644 index 000000000..3c4e90f14 --- /dev/null +++ b/pages/common/sc_warts2json.md @@ -0,0 +1,8 @@ +# sc_warts2json + +> JSON dump of information contained in a `warts` file. +> More information: . + +- Convert `warts` files to JSON and output the result: + +`sc_warts2json {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages/common/sc_warts2pcap.md b/pages/common/sc_warts2pcap.md new file mode 100644 index 000000000..82c0255af --- /dev/null +++ b/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: . + +- 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}}` diff --git a/pages/common/sc_warts2text.md b/pages/common/sc_warts2text.md new file mode 100644 index 000000000..ecf8046b4 --- /dev/null +++ b/pages/common/sc_warts2text.md @@ -0,0 +1,8 @@ +# sc_warts2text + +> Simple dump of information contained in a `warts` file. +> More information: . + +- Output the information in `warts` files as text: + +`sc_warts2text {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages/common/sc_wartscat.md b/pages/common/sc_wartscat.md new file mode 100644 index 000000000..ee14b9c6f --- /dev/null +++ b/pages/common/sc_wartscat.md @@ -0,0 +1,8 @@ +# sc_wartscat + +> Concatenate `warts` files. +> More information: . + +- Concatenate `warts` files into one: + +`sc_wartscat -o {{path/to/output.warts}} {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages/common/sc_wartsdump.md b/pages/common/sc_wartsdump.md new file mode 100644 index 000000000..82355f7c2 --- /dev/null +++ b/pages/common/sc_wartsdump.md @@ -0,0 +1,8 @@ +# sc_wartsdump + +> Verbose dump of information contained in a `warts` file. +> More information: . + +- Output the content of `warts` files verbose: + +`sc_wartsdump {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages/common/sc_wartsfilter.md b/pages/common/sc_wartsfilter.md new file mode 100644 index 000000000..a5fe76572 --- /dev/null +++ b/pages/common/sc_wartsfilter.md @@ -0,0 +1,16 @@ +# sc_wartsfilter + +> Select specific records from a `warts` file. +> More information: . + +- 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` diff --git a/pages/common/sc_wartsfix.md b/pages/common/sc_wartsfix.md new file mode 100644 index 000000000..2dea97880 --- /dev/null +++ b/pages/common/sc_wartsfix.md @@ -0,0 +1,8 @@ +# sc_wartsfix + +> Truncate damaged `warts` files. +> More information: . + +- Save all records (in a separate file) up to the last intact one: + +`sc_wartsfix {{path/to/file1.warts path/to/file2.warts ...}}` diff --git a/pages/common/scamper.md b/pages/common/scamper.md new file mode 100644 index 000000000..186d9ff68 --- /dev/null +++ b/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: . + +- 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}}"`