drawvalmap(1)

1DRAWVALMAP(1)         User Contributed Perl Documentation        DRAWVALMAP(1)
2
3
4

NAME

6       drawvalmap - Generate a graphical output of validation status values
7                    encountered by the validator library.
8

SYNOPSIS

10       drawvalmap <logfile>
11
12       drawvalmap
13

DESCRIPTION

15       drawvalmap is a simple utility that can be used to display the
16       validator status values in a graphical format.  The input to this
17       script is a set of log messages that can be read either from file or
18       from a socket.  The output is an image file containing an image of the
19       various validator authentication chain status values.
20
21       drawvalmap reads data from STDIN if the logfile and the socket option
22       are both unspecified.  If the -f option is given, the output image file
23       is embedded in an HTML file with the given name.  The HTML file auto-
24       refreshes according to the refresh time supplied by the -r option,
25       allowing changes to the validator graph to be constantly tracked.
26
27       The typical usage of this script is in the following way:
28
29           # drawvalmap <logfile>
30
31       It would not be uncommon to use this script for troubleshooting
32       purposes, in which case output generated by a driver program would be
33       "piped" to this script in the manner shown below.
34
35           # dt-validate -o6:stdout secure.example.com. | drawvalmap -f val_log_map.html
36
37       In each case the script generates the results in a val_log_map.png
38       file.  In the second case, an HTML file with the name val_log_map.html
39       is also generated.
40

OPTIONS

42       -a IP-address
43           This changes the address to which drawvalmap binds itself to the
44           specified value. This option takes effect only if the -s option is
45           also specified.
46
47       -f file.ext
48           This creates an image of the type determined by the file extension
49
50       -g xxxx (deprecated)
51           Use -f instead.
52
53       -h file.html
54           This creates an HTML file with the given name, which contains the
55           image of the validation map.
56
57       -i ignore_pattern_string
58           This causes drawvalmap to ignore log records that match the given
59           ignore pattern.
60
61       -l log_event1,log_event2
62           This causes drawvalmap to enable display of events for the given
63           list of log types. The following log event types are defined with
64           their default enabled status indicated in parenthesis: SUCCESS(1),
65           BOGUS(1), DATA_MISSING(1), ERROR(1), and IGNORED(0).
66
67       -m match_pattern_string
68           This causes drawvalmap to include only log records that match the
69           given pattern.  If a given log record matches a pattern given by
70           the -m option and also matches the pattern given by the -i option
71           the effective result is that of ignoring the record.
72
73       -p port
74           This changes the port to which drawvalmap binds itself to the
75           specified value. This option takes effect only if the -s option is
76           also specified.
77
78       -r refresh-period
79           This changes the refresh period in the HTML file to the given
80           value. The default is 5 seconds.
81
82       -s  This changes the mode of operation to read input from a socket.
83           The default address and port to which drawvalmap binds are
84           127.0.0.1:1053.
85

PRE-REQUISITES

87       GraphViz
88

COPYRIGHT

90       Copyright 2005-2013 SPARTA, Inc.  All rights reserved.  See the COPYING
91       file included with the DNSSEC-Tools package for details.
92

AUTHOR

94       Suresh Krishnaswamy, hserus@users.sourceforge.net
95