pseries_eeh_get_state(9)
πΈ pseries_eeh_get_state π
okay bestie, so this one's from the Kernel API Manual (pseries_eeh_get_state(9)) and it's giving "tiny function, whole lotta lore." sit down, we're learning how to get the state of a PE π«Ά
β¨ NAME β¨
pseries_eeh_get_state β Retrieve PE state π₯
π SYNOPSIS π
int pseries_eeh_get_state (struct eeh_pe *pe , int *delay );
like, that's it. two args. one int back. slay.
π ARGUMENTS π
peβ the EEH PE. yeah. that's the one. the main character of this whole operation πdelayβ the suggested time to wait if the state is unavailable. it's literally a "hang on bestie, gimme a sec" value π
π¦ DESCRIPTION π¦
okay so, the whole vibe here: you're retrieving the state of the specified PE β¨
now, on an RTAS-compliant pseries platform, there already has one dedicated RTAS function for this purpose. like they built it for exactly this. iconic.
but here's the notable part (and the manpage literally says "It's notable", so pay attention π): the associated PE config address might be ready when you call this function. so when that's the case, endeavour to use the PE config address if possible. use the address, bestie. it's right there. π
and further more β yes, further more β there are 2 RTAS calls for this purpose. so you need to try the new one, and back to the old one if the new one couldn't work properly. new one first, old one as the fallback. that's the whole strategy, no cap πΈ
β SEE ALSO β
- Kernel file
./arch/powerpc/platforms/pseries/eeh_pseries.c pseries_eeh_get_pe_config_addr(9)pseries_eeh_phb_reset(9)pseries_eeh_phb_configure_bridge(9)pseries_eeh_pe_get_parent(9)pseries_eeh_init_edev(9)pseries_eeh_init_edev_recursive(9)pseries_eeh_set_option(9)pseries_eeh_reset(9)pseries_eeh_get_log(9)pseries_eeh_configure_bridge(9)pseries_eeh_read_config(9)pseries_eeh_write_config(9)pseries_eeh_err_inject(9)eeh_pseries_init(9)
like a whole friend group of functions and this one's the one holding the state-checking duties ππ
ngl the whole family tree is here β go read eeh_pseries.c if you want the full tea π
okay that's the page!! and for the cute sign-off: this one lives in ./arch/powerpc/platforms/pseries, dated October 2026 π« mwah, go forth and get those PE states, bestie ππ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms