VIRT-PKI-QUERY-DN(1)

✨ VIRT-PKI-QUERY-DN(1) ✨

okay bestie, so this is virt-pki-query-dn — a little tool from the virtualization support squad 🖥️💖 and honestly? it's giving tiny-but-mighty main character energy. it does literally one thing and it does it slay.

---

🎀 NAME 🎀

virt-pki-query-dn — pull the Distinguished Name out of a PEM certificate, no cap 💅

---

🦋 SYNOPSIS 🦋

virt-pki-query-dn [OPTION]... FILE

---

🌸 DESCRIPTION 🌸

So what does it do?? It extracts the Distinguished Name from a PEM certificate. That's it. That's the whole vibe. ✨

And here's the tea on why you'd even want that: the output is meant to be used in the tls_allowed_dn_list configuration option in the libvirtd.conf file. So you run this, you get your DN, you drop it into that config option, and you're literally done. iykyk 🫶

---

💜 OPTIONS 💜

• -h, --help — shows you the command line help usage, then dips. super simple, we love her 🙈
• -V, --version — prints the version info, then peaces out. iconic behavior honestly 👑

---

⭐ EXIT STATUS ⭐

ok so the vibe check on exit codes:

• it'll be zero when things go right (success, slay 💅)
• it'll be non-zero when things go wrong (failure, not slay 😭)

that's it, that's the rule.

---

🌈 AUTHOR 🌈

Martin Kletzander — the legend who made this happen 🫶

---

💀 BUGS 💀

found a bug?? bestie please report it, we want to know. 😭 you can do it either way:

1. the mailing list

https://libvirt.org/contact.html

2. the bug tracker

https://libvirt.org/bugs.html

alternatively, you can also report bugs to your software distributor / vendor — like, whoever you got this from. they'll pass it along 🧚

---

👑 COPYRIGHT 👑

Copyright (C) 2021 Red Hat, Inc.

---

🍓 LICENSE 🍓

virt-pki-query-dn is distributed under the terms of the GNU GPL v2+. it's free software — see the source for copying conditions.

⚠️ okay this part is important, no funny business: there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. like, zero. nil. hope that's clear bestie 💀

---

🔥 SEE ALSO 🔥

• virsh(1)
• virt-pki-validate(1)
• the online PKI setup instructions 👀
• https://libvirt.org/ — the mothership 🌐

---

mwah 💋 that's the whole page! this little gem lives in Virtualization Support, brought to you by the VIRT-PKI-QUERY-DN(1) era, and the page itself is dated the same as the footer says — so go forth, query those DNs, and stay slay ✨🎀🦋