DRAWVALMAP(1)

📦 version 2.2.3, in arch rolling

💅 drawvalmap — like, the manual page, bestie 💅

okay so this is DRAWVALMAP(1), and it lives in the User Contributed Perl Documentation section of the man pages. yes, perl. she's vintage, she's iconic, we respect her 🫶

✨ NAME ✨

drawvalmap — generates a graphical output of validation status values encountered by the validator library. it's giving "make the numbers pretty" and honestly? ate. 🔥

🌸 SYNOPSIS 🌸

drawvalmap <logfile>

drawvalmap

that's it. that's the whole vibe. either you hand her a logfile or you don't. 💁‍♀️

🦋 DESCRIPTION 🦋

so drawvalmap is a simple utility that displays the validator status values in a graphical format. like, it takes your boring text and makes it a picture. main character energy, fr fr.

the input to this script is a set of log messages, and you can read them either from a file or from a socket. the output? an image file containing an image of the various validator authentication chain status values. yes. an image of your auth chain. gorgeous. 🎀

drawvalmap reads data from STDIN if the logfile and the socket option are both unspecified — so if you give her nothing, she'll just sit there and listen to you. no cap. and if the -f option is given, the output image file is embedded in an HTML file with the given name. that HTML file auto-refreshes according to the refresh time supplied by the -r option, which means you can constantly track changes to the validator graph. live footage of your validation status. obsessed. 😭

the typical usage of this script is in the following way:

# drawvalmap <logfile>

and 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:

# dt-validate -o6:stdout secure.example.com. | drawvalmap -f val_log_map.html

In each case the script generates the results in a val_log_map.png file. In the second case, an HTML file with the name val_log_map.html is also generated. two files. one queen. 💅

💖 OPTIONS 💖

  • -a IP-address — changes the address to which drawvalmap binds itself to the specified value. ⚠️ this option takes effect only if the -s option is also specified. so alone? nothing. with -s? slay.
  • -f file.ext — creates an image of the type determined by the file extension. the extension picks the format, so choose wisely bestie. 🖼️
  • -g xxxx — (deprecated) use -f instead. she's retired, don't use her, she had her moment. 🙈
  • -h file.html — creates an HTML file with the given name, which contains the image of the validation map. cute little HTML wrapper for your map. 🎀
  • -i ignore_pattern_string — causes drawvalmap to ignore log records that match the given ignore pattern. bye-bye, matching records. 👋
  • -l log_event1,log_event2 — causes drawvalmap to enable display of events for the given list of log types. the following log event types are defined, with their default enabled status indicated in parenthesis: SUCCESS(1), BOGUS(1), DATA_MISSING(1), ERROR(1), and IGNORED(0). so four are on out of the box and IGNORED is, fittingly, ignored. 💀
  • -m match_pattern_string — causes drawvalmap to include only log records that match the given pattern. ⚠️ important caveat: if a given log record matches a pattern given by the -m option and also matches the pattern given by the -i option, the effective result is that of ignoring the record. ignore wins. ignore always wins. periodt.
  • -p port — changes the port to which drawvalmap binds itself to the specified value. ⚠️ this option takes effect only if the -s option is also specified. same deal as -a, bestie. 🌈
  • -r refresh-period — changes the refresh period in the HTML file to the given value. the default is 5 seconds. five seconds of pure anticipation. ⭐
  • -s — changes the mode of operation to read input from a socket. the default address and port to which drawvalmap binds are 127.0.0.1:1053. 🧚

🍓 PRE-REQUISITES 🍓

GraphViz

that's the whole list. if you don't have GraphViz, she cannot draw. tragic but true. 😭

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

(yes, all of that. every word matters, we do not delete copyright lines in this house.) 💜

🌟 AUTHOR 🌟

Suresh Krishnaswamy, hserus@users.sourceforge.net

🔥 SEE ALSO 🔥

  • libval(3) — go read it, it's the whole point. iykyk. ✨

okay that's the page!! and before you go — this lovely little doc is perl v5.44.0, dated 2026-10-17, so like… put some respect on her timestamp. mwah 💋 byeeee bestie, go draw some valmaps 🌈💖

📦 where this page comes from