PVIMG-TEST(1)

📦
version 2.44.1 · 3 versions
, in centos-stream 10, centos-stream 9, opensuse-leap 16.0

💖 PVIMG-TEST 💖

okay bestie, welcome to the pvimg-test page — it lives in the Pvimg Manual and it's literally all about putting an existing IBM Secure Execution image through its paces ✨

🌸 NAME 🌸

pvimg-test — no cap, this one tests different aspects of an existing IBM Secure Execution image 🫶

🦋 SYNOPSIS 🦋

pvimg test <--host-key-document <FILE>|--key-hashes[=<FILE>]> <INPUT>

that's the whole vibe. one of the two key-checking flags, plus your input. pick a side, you can't have both (more on that in a sec 👀)

🎀 DESCRIPTION 🎀

Test different aspects of an existing IBM Secure Execution image. that's it. that's the assignment. she shows up, she tests the aspects, she leaves 💅

✨ OPTIONS ✨

  • <INPUT> — use INPUT as the Secure Execution image. this is the main character right here 👑
  • -k, --host-key-document <FILE> — use FILE to check for a host key document. she verifies that the image contains the host key hash of one of the specified host keys, and the check fails if none of the host keys match the hash in the image 😭. also, key detail (pun intended): this parameter can be specified multiple times 🔥. --key-hashes? mutually exclusive with it, sorry babes, they don't mix.
  • --key-hashes[=<FILE>] — use FILE to check for the host key hashes provided by the ultravisor 🧚. if no FILE is specified, FILE defaults to /sys/firmware/uv/keys/all. heads up though: that default file is only available if the local system supports the Query Ultravisor Keys UVC — so if your system doesn't, the default's just not there 🙈. she verifies that the image contains the host key hash of one of the specified hashes in FILE, and the check fails if none of the host keys match a hash in the response 💀. and yeah — mutually exclusive with --host-key-document. choose wisely.
  • -h, --help — print help (see a summary with -h) ⭐

🌈 EXIT STATUS 🌈

  • 0 — Program finished successfully the command was executed successfully. slay. we love a zero 💚
  • 1 — Generic error something went wrong during the operation. refer to the error message. it's giving "not me, something else" 😭
  • 2 — Usage error the command was used incorrectly — for example: unsupported command line flag, or wrong number of arguments. bestie, read the synopsis again 🫠

👑 SEE ALSO 👑

pvimg(1), zipl(8), qemu(1) — go read these next, iykyk 📚

fr fr, the rule of thumb: pick one of --host-key-document or --key-hashes, never both, and let her cook 💅

okay that's the page!! this came from s390-tools, dated 2026-08-11 — mwah, go test some images, love u 🎀💜🦋

📦 where this page comes from