DRAWVALMAP(1)

✨ DRAWVALMAP ✨

okay bestie, welcome to the drawvalmap page 💖 this one lives in the User Contributed Perl Documentation section of the manual (section 1, for the record 👑), and it's literally the glow-up your validation logs have been begging for.

---

🌈 NAME 🌈

drawvalmap — generates a graphical output of the validation status values that the validator library runs into. no cap, it turns your boring log soup into a picture 🎀

---

🦋 SYNOPSIS 🦋

drawvalmap <logfile>

drawvalmap

that's it. that's the whole vibe. ✨

---

💅 DESCRIPTION 💅

so drawvalmap is a simple little utility that shows off the validator status values in a graphical format. the input? a set of log messages, which it can read either from a file or from a socket. the output? an image file containing a picture of all the various validator authentication chain status values. it's giving data visualization but make it adorable 🫶

if you don't give it a logfile and you don't turn on the socket option, drawvalmap just reads data from STDIN. easy.

and if you pass the -f option, the output image file gets embedded in an HTML file with whatever name you gave. that HTML file auto-refreshes based on the refresh time you supply with the -r option, so you can sit there and watch your validator graph change in real time. main character energy fr fr 🔥

the typical usage of this script is like this:

# drawvalmap <logfile>

and ngl, using it for troubleshooting is super common — in that case you'd "pipe" the output from a driver program straight into this script, like so:

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

in both cases the script drops its results into a val_log_map.png file. in the second case, you also get an HTML file named val_log_map.html. two for one, slay 💅

---

🎀 OPTIONS 🎀

• -a IP-address — changes the address that drawvalmap binds itself to, setting it to the value you gave. heads up though: this option only takes effect if you also specified the -s option. it's a package deal bestie 💜
• -f file.ext — creates an image of the type determined by the file extension. yes, the extension picks the format. iconic behavior ✨
• -g xxxx — (deprecated) use -f instead. she's retired, let her rest 💀
• -h file.html — creates an HTML file with the given name, and that file contains the image of the validation map. cute AND functional 🌸
• -i ignore_pattern_string — makes drawvalmap ignore any log records that match the ignore pattern you gave. bye girl, not today 🙈
• -l log_event1,log_event2 — enables display of events for the list of log types you pass in. here are the log event types that are defined, with their default enabled status chillin' in the parentheses: SUCCESS(1), BOGUS(1), DATA_MISSING(1), ERROR(1), and IGNORED(0). so four of them are on by default and IGNORED is... not 💀
• -m match_pattern_string — includes only the log records that match the given pattern. but plot twist: if a log record matches both the pattern from -m and the pattern from -i, the effective result is that the record gets ignored. the ignore wins, periodt. 👑
• -p port — changes the port that drawvalmap binds itself to, setting it to the value you gave. same deal as -a: this only takes effect if you also specified the -s option 💜
• -r refresh-period — changes the refresh period in the HTML file to the given value. the default is 5 seconds. tick tock ⭐
• -s — switches the mode of operation so it reads input from a socket. the default address and port that drawvalmap binds to are 127.0.0.1:1053. iykyk 🔥

---

🧚 PRE-REQUISITES 🧚

GraphViz

that's the one and only requirement, bestie. go get it 🫶

---

💖 COPYRIGHT 💖

Copyright 2005-2013 SPARTA, Inc. All rights reserved. see the COPYING file that comes included with the DNSSEC-Tools package for all the details. legal girlies stay winning 💅

---

🌸 AUTHOR 🌸

Suresh Krishnaswamy, hserus@users.sourceforge.net

---

🦋 SEE ALSO 🦋

libval(3)

---

and that's the whole page, bestie 💜 this was perl v5.42.0, dated 2025-07-23, straight out of the DRAWVALMAP(1) manual — go make some pretty graphs and hydrate!! 🍓✨