fh_err_get_info(9)

📦 version 7.3.1, in nixpkgs unstable

💖 fh_err_get_info — the Kernel API Manual page, bestie edition 🎀

okay so this is a page from the Kernel API Manual (fh_err_get_info(9)), and honestly it's giving "short but iconic." sit down, grab a strawberry drink 🍓, and let's get into it.

✨ NAME ✨

fh_err_get_info — get platform error information.

and there's this little tag-along note attached to it: @queue id: 0 for guest error event queue 1 for global error event queue 🫶 like, that's the whole vibe of the queue situation right there.

🌸 SYNOPSIS 🌸

unsigned int fh_err_get_info (int queue , uint32_t *bufsize , uint32_t addr_hi , uint32_t addr_lo , int peek );

that's the whole signature, no cap. five things go in, an unsigned int comes out 💅

🦋 ARGUMENTS 🦋

ngl bestie, the original page literally does not describe these 😭 every single one says -- undescribed --. so I'm not gonna make stuff up (that's not the move), but here's the roster so you know who's on the cast list:

  • queue — -- undescribed -- (but heeey, remember the NAME section said 0 = guest error event queue, 1 = global error event queue 👀)
  • bufsize — -- undescribed --
  • addr_hi — -- undescribed --
  • addr_lo — -- undescribed --
  • peek — -- undescribed --
lowkey the manpage author left us on read for all five of these 🙈 but we respect the documented facts and nothing more, periodt.

💜 DESCRIPTION 💜

okay here's the actual tea ☕ — this is a pointer to store the platform error data, and the platform error data is returned in registers r4 - r11. like, that's the whole bit. registers r4 through r11 are carrying the payload, bestie, main character energy fr fr 🔥

and the return situation: it returns 0 for success, or an error code. so 0 = we ate, anything else = something went sideways 💀

🧚 SEE ALSO 🧚

the kernel file in question is ./arch/powerpc/include/asm/fsl_hcalls.h, and here's the whole friend group of related calls — go say hi to all of them:

like, that's a whole squad 🌈 and yes, struct fh_sg_list(9) is in there too — structs can hang, we don't gatekeep 👑

<div align="center">💫 and that's the page!! 💫</div>

signing off with the receipts 🫶: this one ships from the source/version line ./arch/powerpc/include/asm, dated October 2026, and it's filed under fh_err_get_info(9) forever and ever. slay, go read the docs, ily, bye!! 💖✨🎀

📦 where this page comes from