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)
AUTHORS¶
sc_warts2text is written by Matthew Luckie
<mjl@luckie.org.nz>.