GENWQE_PEEK(1)

✨ GENWQE_PEEK 💖

okay bestie, gather round, because we're talking about genwqe_peek — a little cutie from the User Commands corner of the manual, section 1, and it's an IBM Hardware Accelerator Tool. yes that's the whole vibe. it peeks at hardware registers and tells you what it saw. main character energy ngl 🦋

---

🌸 NAME 🌸

genwqe_peek — IBM Hardware Accelerator Tool. 💅

that's it. that's the name section. short, sweet, iconic.

---

🌈 SYNOPSIS 🌈

genwqe_peek [-h] [-v,--verbose]

she's lowkey minimal in the synopsis and then the DESCRIPTION goes absolutely feral with options. classic. 💀

---

🎀 DESCRIPTION 🎀

so here's the whole menu of flags, bestie. every single one, no skips, no cuts, because we don't gatekeep here. 🫶

🌟 the flags 🌟

• -C, --card <cardno> — which card are we peeking at? it can be (0...3) 💳
• -A, --accelerator-type=GENWQE|CAPI — pick your accelerator type: GENWQE or CAPI. heads up though: CAPI is only available for System p ⚠️ (iykyk)
• -V, --version — print version. that's it. she tells you who she is. 👑
• -q, --quiet — quiece output. (yes, "quiece" — the original says it like that and I'm not gonna gaslight you, we keep it fr fr) 🤫
• -w, --width <32|64> — access width. 64: default 🧚
• -X, --cpu <id> — only run on this CPU. one CPU. exclusive. no sharing bestie. 📌
• -i, --interval <intv> — interval in usec, 0: default ⏱️
• -c, --count <num> — number of peeks do be done, 1: default 🔢 (yes it says "do be done", we love a grammatically adventurous icon)
• -e, --must-be <value> — compare and exit if not equal 🎯
• -n, --must-not-be <value> — compare and exit if equal 🚫
• -a, --and-mask <value> — mask read value before compare 🎭
• -p, --psl-bar <bar> — access PSL bar (CAPI only) 🧱

and then there's:

<addr> — the address you're peeking at, obviously. the whole point of the operation. ✨

🍓 Example: 🍓

genwqe_peek 0x0000 [00000000] 000000021032a178

💜 for CAPI card (-A CAPI): 💜

here's the register map, bestie, laid out for you like a lil tour:

• Reg 0x0000 — CAPI Card Version Reg 1 (RO) 👀
• Reg 0x0008 — CAPI Card Version Reg 2 (RO) 👀
• Reg 0x0080 — CAPI Card Free Run Timer in 4 nsec (RO) ⏳
• Reg 0x0180 — Queue Work Time in 4 nsec (RO) ⏳
• Reg 0x1000 ... 0x1028 — 6 Fir Registers (RW) 🔥

👑 Only CAPI (debugging): 👑

genwqe_peek -ACAPI -C0 --psl-bar=2 --width=64 0x150

that's the debugging-flavoured invocation, and honestly? she ate. 🫶

ngl this tool is very specific and very hardware-coded, so if you're here you probably know exactly why you're here. vibe check: passed. ✅

---

so yeah, that's genwqe_peek — peek at registers, compare values, mask stuff before comparing, optionally spam it on a loop with -c and -i, and honestly just have a good time with it. 💖

this lil page is from genwqe_peek version 4.0.20, dated August 2025 — periodt, that's the sign-off, love u bye 🎀✨🦋