new_pcichild_device(9)

💫 new_pcichild_device — like, the whole manual page, but make it make sense 💫

okay so bestie, you're reading new_pcichild_device(9) from the Kernel API Manual ✨ (yes, section 9, the kernel-functions one, you got this 🫶). this is the entire page, nothing skipped, and it's about to be iconic.

---

🌸 NAME 🌸

new_pcichild_device — literally creates a new child device 💅

---

✨ SYNOPSIS ✨

struct hv_pci_dev * new_pcichild_device (struct hv_pcibus_device *hbus ,
struct hv_pcidev_description *desc );

two arguments, one return, no cap. ⭐

---

🎀 ARGUMENTS 🎀

• hbus — the internal struct that keeps track of this root PCI bus. like its little home base 🏠
• desc — everything the host has told us so far about the device. the lore, basically 📜

---

🦋 DESCRIPTION 🦋

so this function builds the tracking structure for a brand-new child device, and then it kicks off the whole process of figuring out what that device actually is. it's giving detective main character energy 🔍👑

---

🌈 RETURN 🌈

a pointer to that shiny new tracking struct. periodt 💖

---

👑 SEE ALSO 👑

the kernel file is ./drivers/pci/controller/pci-hyperv.c, and ngl the guest list here is long — every single one of these pulled up to the function party:

• struct hv_msi_desc(9)
• struct hv_msi_desc2(9)
• struct tran_int_desc(9)
• hv_irq_retarget_interrupt(9)
• hv_pci_generic_compl(9)
• devfn_to_wslot(9)
• wslot_to_devfn(9)
• _hv_pcifront_read_config(9)
• _hv_pcifront_write_config(9)
• hv_pcifront_read_config(9)
• hv_pcifront_write_config(9)
• hv_pci_read_config_compl(9)
• hv_read_config_block(9)
• hv_pci_write_config_compl(9)
• hv_write_config_block(9)
• hv_register_block_invalidate(9)
• hv_msi_free(9)
• hv_compose_msi_msg(9)
• hv_pcie_init_irq_domain(9)
• get_bar_size(9)
• survey_child_resources(9)
• prepopulate_bars(9)
• create_root_hv_pci_bus(9)
• q_resource_requirements(9)
• get_pcichild_wslot(9)
• pci_devices_present_work(9)
• hv_pci_start_relations_work(9)
• hv_pci_devices_present(9)
• hv_pci_devices_present2(9)
• hv_eject_device_work(9)
• hv_pci_eject_device(9)
• hv_pci_onchannelcallback(9)
• hv_pci_protocol_negotiation(9)
• hv_pci_free_bridge_windows(9)
• hv_pci_allocate_bridge_windows(9)
• hv_allocate_config_window(9)
• hv_pci_enter_d0(9)
• hv_pci_query_relations(9)
• hv_send_resources_allocated(9)
• hv_send_resources_released(9)
• hv_pci_probe(9)
• hv_pci_remove(9)

---

aaaand that's the whole page, bestie, you ate it 🍓✨ cute little sign-off: this one comes from ./drivers/pci/controller and it's dated October 2026 — go forth and new_pcichild_device responsibly 🧚💜