pci_hp_ignore_link_change(9)

📦 version 7.3.1, in nixpkgs unstable

okay bestie, welcome to the Kernel API Manual ✨ this page is all about telling the PCI hotplug world “hey, ignore that link-change noise for a sec.” No cap. 💅

🌸 NAME 🌸

pci_hp_ignore_link_change — begin a code section that causes spurious link changes 🫶

✨ SYNOPSIS ✨

void pci_hp_ignore_link_change (struct pci_dev *pdev );

🎀 ARGUMENTS 🎀

  • pdev — the PCI hotplug bridge 🌉💖

🦋 DESCRIPTION 🦋

Call this to mark the beginning of a code section that causes spurious link changes on the Secondary Bus of pdev — like, as a side effect of a Secondary Bus Reset, a D3cold transition, a firmware update, or an FPGA reconfiguration. It’s giving “don’t freak out, the link is fine, this is expected” energy. 😭✨

Hotplug drivers can use this to check whether such a code section is executing concurrently, await it with pci_hp_spurious_link_change, and then ignore the resulting link change events. Iconic teamwork, fr fr. 🤝👑

Must be paired with pci_hp_unignore_link_change. Like, do not leave it hanging, bestie. 🚨💀

May be called both from the PCI core and from Endpoint drivers. It may also be called for bridges which are not hotplug-capable — in that case it has no effect, because no hotplug driver is bound to the bridge. Lowkey harmless, highkey by design. 🌈💜

🌟 SEE ALSO 🌟

Kernel file ./drivers/pci/hotplug/pci_hotplug_core.c 📁✨

This lil page lives in ./drivers/pci/hotplug, dated October 2026 — stay sparkly, bestie 💖🎀🦋

📦 where this page comes from