pci_host_common_parse_port(9)

💅 pci_host_common_parse_port(9) 💅

✨ NAME ✨

pci_host_common_parse_port — Parse a single Root Port node. okay bestie, welcome to the pci_host_common_parse_port(9) page in the Kernel API Manual — this one is all about parsing one Root Port node, and we're gonna get into it. 🎀

🌸 SYNOPSIS 🌸

here's the exact signature, no cap:

int pci_host_common_parse_port (struct device *dev , struct
       pci_host_bridge *bridge , struct device_node *node );

🦋 ARGUMENTS 🦋

• dev — Device pointer. literally the device pointer, bestie. 💖
• bridge — PCI host bridge. the host bridge in question. 🌉
• node — Device tree node of the Root Port. yep, the DT node for the Root Port. 🌳

💜 DESCRIPTION 💜

okay so this helper parses Root Port properties from the device tree. Currently it only handles the PERST# GPIO — and yes, that includes PERST# GPIOs from all PCIe bridge nodes under this Root Port — and that GPIO is optional. ✨

🎀 NOTE 🎀

bestie, read this twice: this helper fetches resources (like PERST# GPIO) optionally. If a controller driver has a hard dependency on certain resources (PHY, clocks, regulators, etc.), those resources MUST be modeled correctly in the DT binding and validated in DTS. This helper cannot enforce such dependencies and the driver may fail to operate if required resources are missing. 💀

🌈 RETURN 🌈

0 on success, negative error codes on failure. periodt. 🫶

⭐ SEE ALSO ⭐

• Kernel file: ./drivers/pci/controller/pci-host-common.c
• pci_host_common_delete_ports(9)
• pci_host_common_parse_perst(9)
• pci_host_common_parse_ports(9)
• pci_host_common_d3cold_possible(9)

mwah 💋 this page came from ./drivers/pci/controller and it’s dated October 2026 — bye bestie, go slay that Root Port parsing! ✨🫶✨