STRUCT PCI_EPF(9)

🌸 NAME 🌸

okay bestie, welcome to the Kernel API Manual page for struct pci_epf — yes, the (9) one, iykyk. 💅

struct pci_epf — represents the PCI EPF device. That’s the vibe, that’s the whole assignment. ✨

🦋 SYNOPSIS 🦋

okay so here’s the full struct, literally every field, no cap:

       struct pci_epf {
           struct device           dev;
           const char              *name;
           struct pci_epf_header   *header;
           struct pci_epf_bar      bar[PCI_STD_NUM_BARS];
           u8 msi_interrupts;
           u16 msix_interrupts;
           u8 func_no;
           u8 vfunc_no;
           struct pci_epc          *epc;
           struct pci_epf          *epf_pf;
           struct pci_epf_driver   *driver;
           const struct pci_epf_device_id *id;
           struct list_head        list;
           struct mutex            lock;
           struct pci_epc          *sec_epc;
           struct list_head        sec_epc_list;
           struct pci_epf_bar      sec_epc_bar[PCI_STD_NUM_BARS];
           u8 sec_epc_func_no;
           struct config_group     *group;
           unsigned int            is_bound;
           unsigned int            is_vf;
           unsigned long           vfunction_num_map;
           struct list_head        pci_vepf;
           const struct pci_epc_event_ops *event_ops;
           struct pci_epf_doorbell_msg *db_msg;
           u16 num_db;
        };

💖 Members 💖

• dev — the PCI EPF device 🫶
• name — the name of the PCI EPF device
• header — represents standard configuration header
• bar — represents the BAR of EPF device
• msi_interrupts — number of MSI interrupts required by this function
• msix_interrupts — number of MSI-X interrupts required by this function
• func_no — unique (physical) function number within this endpoint device
• vfunc_no — unique virtual function number within a physical function
• epc — the EPC device to which this EPF device is bound
• epf_pf — the physical EPF device to which this virtual EPF device is bound
• driver — the EPF driver to which this EPF device is bound
• id — pointer to the EPF device ID
• list — to add pci_epf as a list of PCI endpoint functions to pci_epc
• lock — mutex to protect pci_epf_ops
• sec_epc — the secondary EPC device to which this EPF device is bound
• sec_epc_list — to add pci_epf as list of PCI endpoint functions to secondary EPC device
• sec_epc_bar — represents the BAR of EPF device associated with secondary EPC
• sec_epc_func_no — unique (physical) function number within the secondary EPC
• group — configfs group associated with the EPF device
• is_bound — indicates if bind notification to function driver has been invoked
• is_vf — true - virtual function, false - physical function
• vfunction_num_map — bitmap to manage virtual function number
• pci_vepf — list of virtual endpoint functions associated with this function
• event_ops — callbacks for capturing the EPC events
• db_msg — data for MSI from RC side
• num_db — number of doorbells

🌈 SEE ALSO 🌈

Kernel file ./include/linux/pci-epf.h keeps company with struct pci_epf_header(9), struct pci_epf_ops(9), struct pci_epc_event_ops(9), struct pci_epf_driver(9), struct pci_epf_bar_submap(9), struct pci_epf_bar(9), struct pci_epf_doorbell_msg(9), and struct pci_epf_msix_tbl(9). 👑

🫶 this page came from ./include/linux and is dated October 2026 — bye bestie, stan the kernel 💜