fh_enter_nap(9)

💤 fh_enter_nap(9) 💤

Okay bestie, welcome to fh_enter_nap(9) from the Kernel API Manual — we're making a vcpu take a lil nap, and it's giving power-nap energy, no cap. ✨

✨ NAME ✨

fh_enter_nap — enter nap on a vcpu 💅

🛌 SYNOPSIS 🛌

unsigned int fh_enter_nap (unsigned int handle , unsigned int vcpu );

🫶 ARGUMENTS 🫶

• handle — handle of partition containing the vcpu. That's the partition pass, iykyk 🎀
• vcpu — vcpu number within the partition. The specific vcpu bestie we're talking about 😴

💤 DESCRIPTION 💤

So here's the tea: even though the API supports entering nap on a vcpu other than the caller, this may not be implemented and may return EINVAL. Periodt. 🫠

It returns 0 for success, or an error code. So 0 is the slay outcome, and anything else is an error code doing its own thing 💀

👀 SEE ALSO 👀

Kernel file ./arch/powerpc/include/asm/fsl_hcalls.h — plus the whole fh cinematic universe, bestie:

• 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_exit_nap(9)
• fh_claim_device(9)

xoxo, the Kernel API Manual 🫶 — source/version ./arch/powerpc/include/asm, dated October 2026, page fh_enter_nap(9) 💖