zpci_iov_find_parent_pf(9)

okay bestie, welcome to the zpci_iov_find_parent_pf(9) page from the Kernel API Manual 💅 this one is literally about finding a parent PF, no cap. let’s get into it 🫶

🌸 NAME 🌸

zpci_iov_find_parent_pf — Find the parent PF, if any, of the given function

✨ SYNOPSIS ✨

struct pci_dev * zpci_iov_find_parent_pf (struct zpci_bus *zbus , struct
zpci_dev *zdev );

🎀 ARGUMENTS 🎀

• zbus — The bus that the PCI function is on, or would be added on.
• zdev — The PCI function.

🦋 DESCRIPTION 🦋

okay so this function finds the parent PF, if it exists and is configured, of the given PCI function — and then it increments its refcount. iconic behavior honestly ✨

the PF is searched for on the provided bus, so the caller has to ensure that this is the correct bus to search. lowkey important, bestie 👀

this function may be used before adding the PCI function to a zbus. yes queen, it works pre-add 💖

🌈 RETURN 🌈

pointer to the struct pci_dev of the parent PF, or NULL if it not found. if the function is not a VF or has no RequesterID information, NULL is returned as well. so yeah — no parent PF, no VF, or no RequesterID info means you get NULL 🫶

👑 SEE ALSO 👑

Kernel file ./arch/s390/pci/pci_iov.c

that’s the whole vibe 💖 source: ./arch/s390/pci, dated October 2026. stay slay, bestie 🧚💜