STRUCT IDPF_ADAPTER(9)

🎀 NAME 🎀

struct idpf_adapter — the device data struct that gets generated on probe ✨

(okay so this is from the Kernel API Manual, section 9, and it's genuinely the main-character struct of the whole idpf show 💅)

🦋 SYNOPSIS 🦋

struct idpf_adapter {
    struct pci_dev *pdev;
    u32 virt_ver_maj;
    u32 virt_ver_min;
    u32 msg_enable;
    u32 mb_wait_count;
    enum idpf_state state;
    unsigned long flags[BITS_TO_LONGS( IDPF_FLAGS_NBITS)];
    struct idpf_reset_reg reset_reg;
    struct libie_ctlq_ctx ctlq_ctx;
    struct libie_ctlq_info *asq;
    struct libie_ctlq_info *arq;
    struct libie_ctlq_xn_manager *xnm;
    u16 num_avail_msix;
    u16 num_msix_entries;
    struct msix_entry *msix_entries;
    u16 num_rdma_msix_entries;
    struct msix_entry *rdma_msix_entries;
    struct virtchnl2_alloc_vectors *req_vec_chunks;
    struct idpf_q_vector mb_vector;
    struct idpf_vector_lifo vector_stack;
    irqreturn_t (*irq_mb_handler)(int irq, void *data);
    u32 tx_timeout_count;
    struct idpf_avail_queue_info avail_queues;
    struct idpf_vport **vports;
    struct net_device **netdevs;
    struct virtchnl2_create_vport **vport_params_recvd;
    u32 *vport_ids;
    struct libeth_rx_pt *singleq_pt_lkup;
    struct libeth_rx_pt *splitq_pt_lkup;
    struct idpf_vport_config **vport_config;
    u16 max_vports;
    u16 num_alloc_vports;
    u16 next_vport;
    struct delayed_work init_task;
    struct workqueue_struct *init_wq;
    struct delayed_work serv_task;
    struct workqueue_struct *serv_wq;
    struct delayed_work mbx_task;
    struct workqueue_struct *mbx_wq;
    struct delayed_work vc_event_task;
    struct workqueue_struct *vc_event_wq;
    struct delayed_work stats_task;
    struct workqueue_struct *stats_wq;
    struct virtchnl2_get_capabilities caps;
    struct idpf_dev_ops dev_ops;
    struct iidc_rdma_core_dev_info *cdev_info;
    int num_vfs;
    bool crc_enable;
    bool req_tx_splitq;
    bool req_rx_splitq;
    struct mutex vport_ctrl_lock;
    struct mutex vector_lock;
    struct mutex queue_lock;
    struct mutex vc_buf_lock;
    struct idpf_ptp *ptp;
 };

💖 Members 💖

like, every field, bestie, in order, no skips 🫶

• pdev — the PCI device struct they hand you on probe 🎀
• virt_ver_maj — Virtchnl version, the major one
• virt_ver_min — Virtchnl version, the minor one
• msg_enable — debug message level that's currently enabled 👀
• mb_wait_count — how many times the mailbox got attempted-initialized
• state — the init state machine 🌈
• flags — peep enum idpf_flags
• reset_reg — peep struct idpf_reset_reg
• ctlq_ctx — controlq context
• asq — Send control queue info 📤
• arq — Receive control queue info 📥
• xnm — Xn transaction manager
• num_avail_msix — how many MSIX vectors are available
• num_msix_entries — how many entries are in the MSIX table
• msix_entries — the MSIX table itself
• num_rdma_msix_entries — how many MSIX vectors are available for RDMA
• rdma_msix_entries — the RDMA MSIX table
• req_vec_chunks — requested vector chunk data
• mb_vector — mailbox vector data 💌
• vector_stack — stack that stores the msix vector indexes
• irq_mb_handler — handler for the hard interrupt for the mailbox ⚡
• tx_timeout_count — how many TX timeouts have happened 😭
• avail_queues — queue limits that the device gave you
• vports — array holding the vports the driver created
• netdevs — the associated Vport netdevs
• vport_params_recvd — vport params that got received
• vport_ids — array of vport identifiers handed out by the device
• singleq_pt_lkup — lookup table for singleq RX ptypes
• splitq_pt_lkup — lookup table for splitq RX ptypes
• vport_config — vport config parameters
• max_vports — max vports that can be allocated
• num_alloc_vports — current number of vports allocated
• next_vport — next free slot in pf->vport[] — 0-based! 🚨
• init_task — initialization task
• init_wq — workqueue for the initialization task
• serv_task — the periodically recurring maintenance task
• serv_wq — workqueue for the service task
• mbx_task — task that handles mailbox interrupts
• mbx_wq — workqueue for mailbox responses
• vc_event_task — task that handles out-of-band virtchnl event notifications
• vc_event_wq — workqueue for virtchnl events
• stats_task — periodic statistics retrieval task 📊
• stats_wq — workqueue for the statistics task
• caps — negotiated capabilities with the device 🤝
• dev_ops — peep idpf_dev_ops
• cdev_info — IDC core device info pointer
• num_vfs — number of allocated VFs through sysfs. The PF does not directly talk to VFs, but it is used to initialize them
• crc_enable — enable CRC insertion offload
• req_tx_splitq — TX split or single queue model to request
• req_rx_splitq — RX split or single queue model to request
• vport_ctrl_lock — lock protecting the vport control flow 🔒
• vector_lock — lock protecting vector distribution
• queue_lock — lock protecting queue distribution
• vc_buf_lock — lock protecting virtchnl buffer
• ptp — storage for PTP-related data ⏰

👑 SEE ALSO 👑

Kernel file ./drivers/net/ethernet/intel/idpf/idpf.h (that's where the goods live, iykyk):

• struct idpf_mac_filter(9)
• enum idpf_state(9)
• enum idpf_flags(9)
• enum idpf_cap_field(9)
• enum idpf_vport_state(9)
• struct idpf_netdev_priv(9)
• struct idpf_reset_reg(9)
• struct idpf_vport_max_q(9)
• struct idpf_reg_ops(9)
• struct idpf_dev_ops(9)
• enum idpf_vport_reset_cause(9)
• enum idpf_vport_flags(9)
• struct idpf_tstamp_stats(9)
• struct idpf_q_vec_rsrc(9)
• struct idpf_vport(9)
• enum idpf_user_flags(9)
• struct idpf_rss_data(9)
• struct idpf_q_coalesce(9)
• struct idpf_vport_user_config_data(9)
• enum idpf_vport_config_flags(9)
• struct idpf_avail_queue_info(9)
• struct idpf_vector_info(9)
• struct idpf_vector_lifo(9)
• struct idpf_queue_id_reg_chunk(9)
• struct idpf_queue_id_reg_info(9)
• struct idpf_vport_config(9)
• idpf_is_queue_model_split(9)
• idpf_is_rdma_cap_ena(9)
• idpf_get_reserved_vecs(9)
• idpf_get_reserved_rdma_vecs(9)
• idpf_get_default_vports(9)
• idpf_get_max_vports(9)
• idpf_get_max_tx_bufs(9)
• idpf_get_min_tx_pkt_len(9)
• idpf_is_reset_detected(9)
• idpf_is_reset_in_prog(9)
• idpf_netdev_to_vport(9)
• idpf_netdev_to_adapter(9)
• idpf_is_feature_ena(9)
• idpf_get_max_tx_hdr_size(9)
• idpf_vport_ctrl_lock(9)
• idpf_vport_ctrl_unlock(9)

lowkey a whole ecosystem in here fr fr — read the friends too, don't leave them on read 🙈

okay that's the whole page, bestie!! this one came from ./drivers/net/ethernet/intel/idpf, dated October 2026, and it's struct idpf_adapter(9) from the Kernel API Manual — go forth and slay your probe path 💅✨🦋