eeh_pe_bus_get_nolock(9)
π eeh_pe_bus_get_nolock β the Kernel API Manual files
okay so bestie, welcome to the Kernel API Manual, and today's main character is eeh_pe_bus_get_nolock π she's a little helper from the PowerPC EEH world and honestly she's giving "I do one thing and I do it without a lock" energy.
β¨ NAME β¨
eeh_pe_bus_get_nolock β Retrieve PCI bus associated with the given EEH PE without locking π¦
like yes, that's literally the whole vibe: you hand her a PE, she hands you back a bus, and she does not take the lock. no cap.
πΈ SYNOPSIS πΈ
struct pci_bus * eeh_pe_bus_get_nolock (struct eeh_pe *pe );
look at her. one argument. zero drama (lock-wise, anyway π).
π ARGUMENTS π
peβ Pointer to the EEH PE π« that's the PE you're asking about, bestie. that's it, that's the whole input.
π DESCRIPTION π
so here's the tea β this function is a variant of _eeh_pe_bus_get, and what she does is retrieve the PCI bus associated with the specified EEH PE β but without acquiring the pci_lock_rescan_remove lock. not me skipping the lock π (deliberately, though!!).
because of that, you should only use her when the caller can guarantee safe access to PE structures without needing that lock β typically in contexts where the lock is already held or where locking is otherwise managed π«Ά. like, she's not out here being reckless, you are, if you call her wrong. iykyk.
π¦ RETURN π¦
she returns a pointer to the PCI bus associated with the EEH PE, or NULL if none is found π. simple. iconic. periodt.
π NOTE π
use this function carefully to avoid race conditions and data corruption ππ₯ like fr fr, the no-lock life is cute until it isn't.
π§ SEE ALSO π§
Kernel file ./arch/powerpc/kernel/eeh_pe.c β and the whole friend group π:
eeh_set_pe_aux_size(9)eeh_pe_alloc(9)eeh_phb_pe_create(9)eeh_wait_state(9)eeh_phb_pe_get(9)eeh_pe_next(9)eeh_pe_traverse(9)eeh_pe_dev_traverse(9)__eeh_pe_get(9)eeh_pe_get(9)eeh_pe_tree_insert(9)eeh_pe_tree_remove(9)eeh_pe_update_time_stamp(9)eeh_pe_state_mark(9)eeh_pe_mark_isolated(9)eeh_pe_state_clear(9)eeh_restore_one_device_bars(9)eeh_pe_restore_bars(9)eeh_pe_loc_get(9)eeh_pe_loc_get_bus(9)_eeh_pe_bus_get(9)eeh_pe_bus_get(9)
kisses and good vibes from ./arch/powerpc/kernel β this little page is dated October 2026, and it's eeh_pe_bus_get_nolock(9) signing off π
β¨π stay locked (when you should be) 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