fh_claim_device(9)

💅 fh_claim_device — Kernel API Manual, section 9 🎀

okay so bestie, welcome to fh_claim_device(9) — this one lives in the Kernel API Manual (section 9, hypervisor call territory, iykyk) and it's literally the "dibs" function for shared hardware. yes, calling dibs is a real syscall vibe now 💖

---

✨ NAME ✨

fh_claim_device — claim a "claimable" shared device 👑

like, you're not building it, you're not owning it forever, you're just claiming it so nobody else grabs it. shared custody energy fr fr 🫶

---

🦋 SYNOPSIS 🦋

unsigned int fh_claim_device (unsigned int handle );

that's it. one arg. one return. iconic minimalism 💅

---

🌸 ARGUMENTS 🌸

• handle — the fsl,hv-device-handle of the node you wanna claim 🎀 (yes it's written with a comma, that's the actual property name, don't come for me — copy it exactly bestie)

---

⭐ DESCRIPTION ⭐

So you call it, and it comes back with one of two moods:

• returns 0 for success — slay, the device is yours, go do your thing ✨
• or an error code — not slay, something went wrong, read the code and cope 😭

that's genuinely the whole description, no cap. short king of a manpage 👑

---

💜 SEE ALSO 💜

first up, the kernel file itself — the source of truth, the origin story:

./arch/powerpc/include/asm/fsl_hcalls.h

and then the whole friend group of related hypervisor calls, all in section 9, all matching the vibe check:

• fh_send_nmi(9)
• fh_partition_get_dtprop(9)
• fh_partition_restart(9)
• fh_partition_get_status(9)
• fh_partition_start(9)
• fh_partition_stop(9)
• struct fh_sg_list(9)
• fh_partition_memcpy(9)
• fh_dma_enable(9)
• fh_dma_disable(9)
• fh_vmpic_get_msir(9)
• fh_system_reset(9)
• fh_err_get_info(9)
• fh_get_core_state(9)
• fh_enter_nap(9)
• fh_exit_nap(9)

ngl the nap ones are lowkey the most relatable 🧚 and fh_system_reset(9) is giving main character energy 💀

---

real talk though: this page keeps every single one of those references on purpose — don't skip them just because they're long, they're the ones you'll actually need 🌈

---

okay that's the whole page!! shoutout to ./arch/powerpc/include/asm for the source, October 2026 for the date, and the Kernel API Manual for hosting the slayest section 9 has to offer. mwah 💋 go claim ur device bestie, ily 🍓