sc_wartsdump

Output the content of warts files verbose

$ sc_wartsdump [path/to/file1.warts path/to/file2.warts ...]

sc_wartsdump [options] <warts_file>
sc_wartsdump [options] -

-v, --verbose
    Increases verbosity, showing more detailed processing information.

-x, --xml
    Outputs the Warts file content in XML format.

-j, --json
    Outputs the Warts file content in JSON format.

-d, --dump-records <record_types>
    Dumps only specific record types. <record_types> is a comma-separated list (e.g., 'tr' for traceroute, 'hp' for hop, 'lp' for loop).

-s, --statistics
    Prints summary statistics about the Warts file records instead of dumping full content.

-l, --list-records
    Lists all record types found in the Warts file.

-o, --output <file>
    Writes output to the specified file instead of standard output.

-p, --pretty-print
    Pretty-prints XML/JSON output for readability.

-h, --help
    Displays a help message and exits.

sc_wartsdump is a specialized utility from the scamper suite, designed to parse and display the contents of Warts files. Warts is a binary file format primarily used to store network measurement data collected by the scamper tool, such as traceroute, ping, and other active probing results. This command allows users to extract and view this complex binary data in various human-readable formats, including plain text, XML, and JSON. It is invaluable for researchers and network engineers analyzing large datasets of Internet topology and performance measurements. The tool can output specific record types, provide summary statistics, or dump the entire file content, making it flexible for different analytical needs.

sc_wartsdump is not a standard Linux utility and requires the scamper software suite to be installed on the system. It is primarily used by researchers and network engineers working with Internet topology data, not for general-purpose system administration. The Warts file format itself can be complex, and understanding its structure is beneficial for effective use of this command.

sc_wartsdump can read Warts data from standard input, making it useful in pipelines. For example, `cat file.warts | sc_wartsdump -x -` would dump the XML content of `file.warts`. This allows for flexible integration with other command-line tools.

The Warts format encapsulates various types of measurement records, such as traceroute results, ping data, and hop-by-hop details. Users should consult the Warts format specification (warts(5)) to fully understand the meaning of the data output by sc_wartsdump.

sc_wartsdump is an integral part of the scamper project, developed by the Center for Applied Internet Data Analysis (CAIDA). CAIDA is a research organization dedicated to improving the Internet through data-driven analysis. The scamper suite, including sc_wartsdump, was created to facilitate large-scale, high-fidelity active measurement of Internet topology and performance. Its development reflects the ongoing need for robust tools to collect, process, and analyze complex network measurement data, evolving alongside the Internet's growth and increasing complexity.

scamper(1), warts(5), caida(7)