1SC_WARTS2TEXT(1)          BSD General Commands Manual         SC_WARTS2TEXT(1)
2

NAME

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

SYNOPSIS

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

DESCRIPTION

10     The sc_warts2text utility provides a simple dump of information contained
11     in a sequence of warts files.  The output is the same as that which would
12     have been provided by scamper if the text output option had been chosen
13     instead of the warts output option when the data was collected.  The
14     options are as follows:
15
16     -d ip2descr-file
17             specifies the name of a file with IP-address, description map‐
18             pings, one mapping per line.  See the examples section for fur‐
19             ther information.
20
21     While the output of sc_warts2text is structured and suitable for initial
22     analyses of results, the format of the output is not suitable for auto‐
23     mated parsing and analysis as the output of sc_warts2text will change
24     overtime with no regard to backwards compatibility.  Analyses of the con‐
25     tents of a warts file should be made using specialised programs which
26     link against the scamper file API.
27

EXAMPLES

29     The command:
30
31        sc_warts2text file1.warts file2.warts
32
33     will decode and print the contents of file1.warts, followed by the con‐
34     tents of file2.warts.
35
36     The command:
37
38        gzcat file1.warts.gz | sc_warts2text
39
40     will print the contents of the uncompressed file supplied on stdin.
41
42     Given a set of IP-address, description pairs in a file name mappings.txt:
43
44        192.0.2.1 "foo"
45        192.0.2.2 "bar"
46
47     then the command gzcat file1.warts.gz | sc_warts2text -d mappings.txt
48     will print the description associated with a given destination address
49     before each result is presented.
50

SEE ALSO

52     scamper(1), sc_wartsdump(1), sc_warts2json(1)
53

AUTHORS

55     sc_warts2text is written by Matthew Luckie <mjl@luckie.org.nz>.
56
57BSD                            October 15, 2010                            BSD
Impressum