How intel/ethernet-linux-idpf works
IDPF is an out-of-tree Linux network driver for Infrastructure Data-Plane Function devices, operating as both PF and VF. The principal workflow is kernel/device initialization, control-plane negotiation and virtual-port setup, followed by packet transmission and reception through network queues; administrators configure and inspect the interface through ethtool and devlink. The graph retains documented PTP, XDP/AF_XDP, subfunction, and auxiliary-bus capabilities. Many implementation files were not sampled, so internal runtime links that cannot be verified are shown as unverified rather than asserted.
Main entry points: idpf_lib.c Driver core · idpf_txrx.c Queue packet I/O · idpf_dev.c Device management · idpf_virtchnl.c Virtchnl transactions
Components 23
Device lifecycle
- Module entry
idpf/src/idpf_main.c - Device management
idpf/src/idpf_dev.c - Driver core
idpf/src/idpf_lib.c
Control plane
- Control queues
idpf/src/idpf_controlq.c - Virtchnl transactions
idpf/src/idpf_virtchnl.c - Virtchnl2 protocol
idpf/src/virtchnl2.h - Virtual-port setup
idpf/src/idpf_virtchnl.c
Packet datapath
- Queue packet I/O
idpf/src/idpf_txrx.c - Single-queue I/O
idpf/src/idpf_singleq_txrx.c - LAN descriptors
idpf/src/virtchnl2_lan_desc.h
Driver features
- Ethtool interface
idpf/src/idpf_ethtool.c - Devlink subfunctions
idpf/src/idpf_devlink.c - PTP timestamping
idpf/src/idpf_ptp.c - AF_XDP support
idpf/src/idpf_xsk.c - XDP support
idpf/src/idpf_txrx.c - Auxiliary bus
auxiliary/src/_auxiliary.c - IDC interface
idpf/src/iidc.h
Kernel compatibility
- Kernel API backports
idpf/src/kcompat_impl.h - Compatibility definitions
idpf/src/kcompat.h - XArray backport
idpf/src/kcompat_xarray.c - Auxiliary compatibility
auxiliary/src/auxiliary_compat.h
Other components
- Linux kernel
- Administrator
Connections 21
- Linux kernel → Module entry: loads module
README - Administrator → Ethtool interface: configures driver
README - Administrator → Devlink subfunctions: manages subfunctions
README - Module entry → Device management: initializes
- Device management → Driver core: sets up device
- Driver core → Control queues: uses queues
- Control queues → Virtchnl transactions: carries messages
- Virtchnl transactions → Virtchnl2 protocol: encodes protocol
- Virtchnl transactions → Virtual-port setup: negotiates vports
idpf/src/idpf_virtchnl.c - Virtual-port setup → Queue packet I/O: configures queues
- Queue packet I/O → LAN descriptors: uses descriptors
- Queue packet I/O → XDP support: supports
README - Queue packet I/O → AF_XDP support: supports zero-copy
README - Ethtool interface → PTP timestamping: configures timestamps
- Driver core → Single-queue I/O: dispatches queues
- Device management → Devlink subfunctions: registers interface
- Driver core → Auxiliary bus: uses bus support
- Auxiliary bus → IDC interface: exposes interface
- Compatibility definitions → Kernel API backports: provides wrappers
idpf/src/kcompat.h - Kernel API backports → XArray backport: backs XArray API
- Auxiliary compatibility → Auxiliary bus: supports bus APIs
auxiliary/src/_auxiliary.c