drawvalmap

Langue: en

Version: 2007-05-22 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

NAME

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

SYNOPSIS

drawvalmap

DESCRIPTION

drawvalmap is a simple utility that can be used to display the query assertion status in a graphical format. The input to this script is a set of log messages that can be read either from STDIN or from a socket. The default is to read it from STDIN. The output is an HTML file containing an image of the various validator assertion status values. The HTML file auto-refreshes every five seconds so that changes to the validator graph can be constantly tracked. The drawvalmap script executes in an infinite loop and never returns on its own.

This script can be started from the command line by typing

bash# drawvalmap

It would not be uncommon to use this script for troubleshooting purposes in which case output generated by a driver program would be ``piped'' to this script in the manner shown below.

bash# ${LIBVAL}/bin/validate secure.example.com. 2>&1 | drawvalmap -d

In each case the script reads log messages from STDIN, generating a default HTML file with the name val_log_map.html. The gif containing the actual validator map has the default name as val_log_map.gif. Both of these defaults can be modified by using the command-line flags described below.

OPTIONS

-d
If this option is used, the generated image is displayed using an image-viewer program as specified by the 'viewimage' setting in the /usr/local/etc/dnssec/dnssec-tools.conf.
-f
This changes the name of .html file to the given value.
-g
This changes the name of .gif file to the given value.
-r
This changes the refresh period in the HTML file to the given value.
-s
This changes the mode of operation to read input from a socket. The default address and port to which drawvalmap binds is 127.0.0.1:1053
-h
This changes the address to which drawvalmap binds itself to the specified value. This option takes effect only if the -s option is also specified.
-p
This changes the port to which drawvalmap binds itself to the specified value. This option takes effect only if the -s option is also specified.

PRE-REQUISITES

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