# intel/ethernet-linux-idpf architecture

> Architecture diagram of the GitHub repository intel/ethernet-linux-idpf, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/intel/ethernet-linux-idpf
- Repository: https://github.com/intel/ethernet-linux-idpf

## Overview

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/src/idpf_lib.c`](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_lib.c) (Driver core), [`idpf/src/idpf_txrx.c`](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_txrx.c) (Queue packet I/O), [`idpf/src/idpf_dev.c`](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_dev.c) (Device management), [`idpf/src/idpf_virtchnl.c`](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_virtchnl.c) (Virtchnl transactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Device lifecycle"]
  node_idpf_main["Module entry<br/>[idpf_main.c]"]
  node_device["Device management<br/>[idpf_dev.c]"]
  node_driver_core["Driver core<br/>[idpf_lib.c]"]
end

subgraph group_control["Control plane"]
  node_controlq["Control queues<br/>[idpf_controlq.c]"]
  node_virtchnl["Virtchnl transactions<br/>[idpf_virtchnl.c]"]
  node_protocol["Virtchnl2 protocol<br/>[virtchnl2.h]"]
  node_vport_setup["Virtual-port setup<br/>[idpf_virtchnl.c]"]
end

subgraph group_datapath["Packet datapath"]
  node_txrx["Queue packet I/O<br/>[idpf_txrx.c]"]
  node_singleq["Single-queue I/O"]
  node_descriptors["LAN descriptors"]
end

subgraph group_features["Driver features"]
  node_ethtool["Ethtool interface<br/>[idpf_ethtool.c]"]
  node_devlink["Devlink subfunctions<br/>[idpf_devlink.c]"]
  node_ptp["PTP timestamping<br/>[idpf_ptp.c]"]
  node_xsk["AF_XDP support<br/>[idpf_xsk.c]"]
  node_xdp["XDP support<br/>[idpf_txrx.c]"]
  node_auxiliary["Auxiliary bus<br/>[_auxiliary.c]"]
  node_iidc["IDC interface<br/>[iidc.h]"]
end

subgraph group_compat["Kernel compatibility"]
  node_compat["Kernel API backports<br/>[kcompat_impl.h]"]
  node_compat_api["Compatibility definitions<br/>[kcompat.h]"]
  node_xarray["XArray backport<br/>[kcompat_xarray.c]"]
  node_aux_compat["Auxiliary compatibility<br/>[auxiliary_compat.h]"]
end

node_kernel(("Linux kernel"))
node_admin(("Administrator"))

node_kernel -.->|"loads module"| node_idpf_main
node_admin -->|"configures driver"| node_ethtool
node_admin -->|"manages subfunctions"| node_devlink
node_idpf_main -.->|"initializes"| node_device
node_device -.->|"sets up device"| node_driver_core
node_driver_core -.->|"uses queues"| node_controlq
node_controlq -.->|"carries messages"| node_virtchnl
node_virtchnl -.->|"encodes protocol"| node_protocol
node_virtchnl -.->|"negotiates vports"| node_vport_setup
node_vport_setup -.->|"configures queues"| node_txrx
node_txrx -.->|"uses descriptors"| node_descriptors
node_txrx -->|"supports"| node_xdp
node_txrx -->|"supports zero-copy"| node_xsk
node_ethtool -.->|"configures timestamps"| node_ptp
node_driver_core -.->|"dispatches queues"| node_singleq
node_device -.->|"registers interface"| node_devlink
node_driver_core -.->|"uses bus support"| node_auxiliary
node_auxiliary -.->|"exposes interface"| node_iidc
node_compat_api -.->|"provides wrappers"| node_compat
node_compat -.->|"backs XArray API"| node_xarray
node_aux_compat -.->|"supports bus APIs"| node_auxiliary

click node_idpf_main "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_main.c"
click node_device "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_dev.c"
click node_driver_core "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_lib.c"
click node_controlq "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_controlq.c"
click node_virtchnl "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_virtchnl.c"
click node_protocol "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/virtchnl2.h"
click node_vport_setup "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_virtchnl.c"
click node_txrx "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_txrx.c"
click node_singleq "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_singleq_txrx.c"
click node_descriptors "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/virtchnl2_lan_desc.h"
click node_ethtool "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_ethtool.c"
click node_devlink "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_devlink.c"
click node_ptp "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_ptp.c"
click node_xsk "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_xsk.c"
click node_xdp "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_txrx.c"
click node_auxiliary "https://github.com/intel/ethernet-linux-idpf/blob/main/auxiliary/src/_auxiliary.c"
click node_iidc "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/iidc.h"
click node_compat "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/kcompat_impl.h"
click node_compat_api "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/kcompat.h"
click node_xarray "https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/kcompat_xarray.c"
click node_aux_compat "https://github.com/intel/ethernet-linux-idpf/blob/main/auxiliary/src/auxiliary_compat.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_idpf_main,node_device,node_driver_core toneBlue
class node_controlq,node_virtchnl,node_protocol,node_vport_setup toneAmber
class node_txrx,node_singleq,node_descriptors toneMint
class node_ethtool,node_devlink,node_ptp,node_xsk,node_xdp,node_auxiliary,node_iidc toneRose
class node_compat,node_compat_api,node_xarray,node_aux_compat,node_kernel,node_admin toneIndigo
```

## Components

### Device lifecycle

- [Module entry](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_main.c): `idpf/src/idpf_main.c`
- [Device management](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_dev.c): `idpf/src/idpf_dev.c`
- [Driver core](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_lib.c): `idpf/src/idpf_lib.c`

### Control plane

- [Control queues](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_controlq.c): `idpf/src/idpf_controlq.c`
- [Virtchnl transactions](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_virtchnl.c): `idpf/src/idpf_virtchnl.c`
- [Virtchnl2 protocol](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/virtchnl2.h): `idpf/src/virtchnl2.h`
- [Virtual-port setup](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_virtchnl.c): `idpf/src/idpf_virtchnl.c`

### Packet datapath

- [Queue packet I/O](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_txrx.c): `idpf/src/idpf_txrx.c`
- [Single-queue I/O](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_singleq_txrx.c): `idpf/src/idpf_singleq_txrx.c`
- [LAN descriptors](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/virtchnl2_lan_desc.h): `idpf/src/virtchnl2_lan_desc.h`

### Driver features

- [Ethtool interface](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_ethtool.c): `idpf/src/idpf_ethtool.c`
- [Devlink subfunctions](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_devlink.c): `idpf/src/idpf_devlink.c`
- [PTP timestamping](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_ptp.c): `idpf/src/idpf_ptp.c`
- [AF_XDP support](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_xsk.c): `idpf/src/idpf_xsk.c`
- [XDP support](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/idpf_txrx.c): `idpf/src/idpf_txrx.c`
- [Auxiliary bus](https://github.com/intel/ethernet-linux-idpf/blob/main/auxiliary/src/_auxiliary.c): `auxiliary/src/_auxiliary.c`
- [IDC interface](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/iidc.h): `idpf/src/iidc.h`

### Kernel compatibility

- [Kernel API backports](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/kcompat_impl.h): `idpf/src/kcompat_impl.h`
- [Compatibility definitions](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/kcompat.h): `idpf/src/kcompat.h`
- [XArray backport](https://github.com/intel/ethernet-linux-idpf/blob/main/idpf/src/kcompat_xarray.c): `idpf/src/kcompat_xarray.c`
- [Auxiliary compatibility](https://github.com/intel/ethernet-linux-idpf/blob/main/auxiliary/src/auxiliary_compat.h): `auxiliary/src/auxiliary_compat.h`

### Other components

- **Linux kernel**
- **Administrator**

## Connections

- Linux kernel → Module entry: loads module (evidence: `README`)
- Administrator → Ethtool interface: configures driver (evidence: `README`)
- Administrator → Devlink subfunctions: manages subfunctions (evidence: `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 (evidence: `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 (evidence: `README`)
- Queue packet I/O → AF_XDP support: supports zero-copy (evidence: `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 (evidence: `idpf/src/kcompat.h`)
- Kernel API backports → XArray backport: backs XArray API
- Auxiliary compatibility → Auxiliary bus: supports bus APIs (evidence: `auxiliary/src/_auxiliary.c`)
