NAME

       sc_warts2text — simple dump of information contained in a warts file.

SYNOPSIS

       sc_warts2text [-d ip2descr-file] [file ...]

DESCRIPTION

       The  sc_warts2text  utility provides a simple dump of information contained in a sequence of warts files.
       The output is the same as that which would have been provided by scamper if the text  output  option  had
       been chosen instead of the warts output option when the data was collected.  The options are as follows:

       -d ip2descr-file
               specifies  the  name  of a file with IP-address, description mappings, one mapping per line.  See
               the examples section for further information.

       While the output of sc_warts2text is structured and suitable for initial analyses of results, the  format
       of  the  output  is  not  suitable for automated parsing and analysis as the output of sc_warts2text will
       change overtime with no regard to backwards compatibility.  Analyses of the  contents  of  a  warts  file
       should be made using specialised programs which link against the scamper file API.

EXAMPLES

       The command:

          sc_warts2text file1.warts file2.warts

       will decode and print the contents of file1.warts, followed by the contents of file2.warts.

       The command:

          gzcat file1.warts.gz | sc_warts2text

       will print the contents of the uncompressed file supplied on stdin.

       Given a set of IP-address, description pairs in a file name mappings.txt:

          192.0.2.1 "foo"
          192.0.2.2 "bar"

       then  the  command  gzcat  file1.warts.gz  |  sc_warts2text  -d  mappings.txt  will print the description
       associated with a given destination address before each result is presented.

SEE ALSO

       scamper(1), sc_wartsdump(1), sc_warts2json(1)

AUTHORS

       sc_warts2text was written by Matthew Luckie <mjl@luckie.org.nz>.

Debian                                          October 15, 2010                                SC_WARTS2TEXT(1)