xsec-xtest.pod(1)

💖 xmlsec-xtest 💖

okay bestie, so this is the manual page for xmlsec-xtest from the XML Security crew (that's the manual section 1, the "run this in your shell" zone). it's a whole vibe and honestly? kinda niche. let's get into it 🦋

---

✨ NAME ✨

xmlsec-xtest — runs a lil set of run-time tests against the XML Security library, no cap

---

🌸 SYNOPSIS 🌸

xmlsec-xtest [--help] [-p]

---

💅 DESCRIPTION 💅

so xmlsec-xtest runs a whole suite of run-time tests against the Apache XML Security for C++ library. and like… if you're just a user of the library, this is lowkey not your business, fr fr. 🙈

but!! it can be used as a sanity check, bestie — to make sure the library is actually working properly and isn't giving broken-fae energy. it's giving "vibe check for your install" and honestly we love that for it. ✨

---

👑 OPTIONS 👑

okay so first things first, a lil warning that matters:

heads up bestie 💀 the single-character options must still occur as separate options on the command line. in other words, -pe to specify both the -p and -e options is not allowed. no smashing them together, the CLI is not a friendship bracelet. 😭

• --help — prints out the usage info and dips. that's it, that's the whole thing. bye 👋
• --print-docs, -p — prints out the test documents while running each test. so you can see the receipts as it goes. iconic.
• --encryption-only, -e — run only the encryption tests
• --encryption-unit-only, -u — run only the encryption unit tests
• --signature-only, -s — run only the signature tests
• --signature-unit-only, -t — run only the signature unit tests
• --xkms-only, -x — run only the xkms tests

so by default, xmlsec-xtest runs all of the tests. but you can specify one of the options above to run only that set of tests. 💖

and listen — all of these options are mutually exclusive. at most one of them should be specified. pick a lane, babe. we're not doing polyamory with test suites. 💅

---

🎀 AUTHOR 🎀

this manual page was written by Russ Allbery for Debian. thank you for your service king 🫶

---

🌈 MANUAL LICENSE 🌈

the authors hereby relinquish any claim to any copyright that they may have in this work, whether granted under contract or by operation of law or international treaty, and hereby commit to the public, at large, that they shall not, at any time in the future, seek to enforce any copyright in this work against any person or entity, or prevent any person or entity from copying, publishing, distributing or creating derivative works of this work.

(translation: it's free, it's yours, go forth and copy/publish/distribute/remix, they promise not to be weird about it. slay. ⭐)

---

and that's the whole page bestie, we ate and left no crumbs 🍓

version 3.0.0, dated 2025-01-11 — shoutout to the xsec-xtest.pod crew, mwah 💜 🧚