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 valida‐
16       tor status values in a graphical format. The input to this script is a
17       set of log messages that can be read either from file or from a socket.
18       The output is an GIF file containing an image of the various validator
19       authentication chain status values.
20
21       The script reads data from STDIN if the logfile and the socket option
22       are both unspecified.  If the -f option is given, the output GIF 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       bash# drawvalmap <logfile>
30
31       It would not be uncommon to use this script for troubleshooting pur‐
32       poses in which case output generated by a driver program would be
33       "piped" to this script in the manner shown below.
34
35       bash# validate -o6:stdout secure.example.com. ⎪ drawvalmap -f
36       val_log_map.html
37
38       In each case the script generates the results in a "val_log_map.gif"
39       file.  In the second case, an HTML file with the name val_log_map.html
40       is also generated.
41

OPTIONS

43       -s  This changes the mode of operation to read input from a socket.
44           The default address and port to which drawvalmap binds is
45           127.0.0.1:1053
46
47       -a <IP address>
48           This changes the address to which drawvalmap binds itself to the
49           specified value. This option takes effect only if the -s option is
50           also specified.
51
52       -p <port>
53           This changes the port to which drawvalmap binds itself to the spec‐
54           ified value. This option takes effect only if the -s option is also
55           specified.
56
57       -h <file.html>
58           This creates an html file with the given name, which contains the
59           gif image of the validation map.
60
61       -r <refresh period>
62           This changes the refresh period in the HTML file to the given
63           value. The default is 5 seconds.
64
65       -g <file.gif>
66           This changes the name of .gif file to the given value.
67
68       -i <ignore_pattern_string>
69           This causes drawvalmap to ignore log records that match the given
70           ignore pattern.
71
72       -m <match_pattern_string>
73           This causes drawvalmap to include only log records that match the
74           given pattern.  If a given log record matches a pattern given by
75           the -m option and also matches the pattern given by the -i option
76           the effective result is that of ignoring the record.
77

PRE-REQUISITES

79       GraphViz
80

82       Copyright 2005 SPARTA, Inc.  All rights reserved.  See the COPYING file
83       included with the DNSSEC-Tools package for details.
84

AUTHOR

86       Suresh Krishnaswamy, hserus@users.sourceforge.net
87
88
89
90perl v5.8.8                       2007-07-10                     DRAWVALMAP(1)
Impressum