usb_hcd_pci_probe(9)

📦 version 7.3.1, in nixpkgs unstable

💖 usb_hcd_pci_probe(9) 💖

okay so bestie, welcome to the kernel API manual page for usb_hcd_pci_probe — she's a function, she lives in the PCI/HCD corner of the USB world, and honestly? she's kind of the main character of bringing a USB host controller to life. ✨

🌸 NAME 🌸

usb_hcd_pci_probe — literally the function that initializes PCI-based HCDs. that's it, that's the vibe. 🎀

🦋 SYNOPSIS 🦋

int usb_hcd_pci_probe (struct pci_dev *dev , const struct hc_driver
       *driver );

yes the signature is exactly that, no cap, copy it character for character if you're typing it out, okay? 💅

🎀 ARGUMENTS 🎀

  • dev — the USB Host Controller that's being probed rn 👀 like this is the device we're checking out.
  • driver — the USB HC driver handle. the little handle that says "hi, this is the driver I'm working with" 🫶

⭐ CONTEXT ⭐

runs in task context, and heads up — it might sleep 😴 so don't go calling it from somewhere spicy where sleeping is not allowed. it's giving "chill, we have time" energy, not "atomic, no interruptions" energy. 💀

🔥 DESCRIPTION 🔥

so what does she actually do? she allocates the basic PCI resources for this USB host controller — like, sets up the essentials, gets the foundation right — and then she invokes the start method for the HCD associated with it through the hotplug entry's driver_data. yes, that's the whole pipeline, and she ate. 👑

and here's the important bit bestie, don't miss it: store this function in the HCD's struct pci_driver as probe. that's literally how it gets wired up. that's the assignment. write it down. 🍓

🌈 RETURN 🌈

returns 0 if successful. that's the only thing listed, so if you see a 0, it slayed. 💖

💜 SEE ALSO 💜

go read the whole friend group, iykyk 🧚

fr fr take the context warning seriously — task context, might sleep is not a suggestion, it's a whole boundary. 🙈

okay that's the page!! mwah 💋 this one lives in ./drivers/usb/core, it's from the Kernel API Manual, dated October 2026, and the page itself is usb_hcd_pci_probe(9) — go be iconic with your PCI-based HCD initialization bestie!! 🌸💅🦋

📦 where this page comes from