# intel/ethernet-linux-igb architecture

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

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

## Overview

igb is a Linux loadable Ethernet driver for Intel network adapters. The principal workflow is kernel/network-stack interaction with the driver, which configures the adapter and exposes a network interface for host networking. The source separates Linux-facing driver logic from shared and device-family hardware support, with additional management, virtualization, timestamping, and ethtool features. The README documents SR-IOV and IEEE 1588 support. Some feature files and most driver call paths were not sampled, so uncertain links are omitted.

Main entry points: [`src/igb_main.c`](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_main.c) (Device and packet driver), [`src/igb.h`](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb.h) (Driver state and interfaces), [`src/e1000_api.c`](https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_api.c) (Hardware API), [`src/igb_param.c`](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_param.c) (Module parameters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_driver["Linux driver"]
  node_igb_core["Device and packet driver<br/>[igb_main.c]"]
  node_driver_types["Driver state and interfaces<br/>[igb.h]"]
  node_driver_params["Module parameters<br/>[igb_param.c]"]
end

subgraph group_hardware["Hardware support"]
  node_hardware_api["Hardware API<br/>[e1000_api.c]"]
  node_mac["MAC operations<br/>[e1000_mac.c]"]
  node_phy["PHY operations<br/>[e1000_phy.c]"]
  node_nvm["NVM operations<br/>[e1000_nvm.c]"]
  node_family["82575 family support<br/>[e1000_82575.c]"]
  node_i210["i210 support<br/>[e1000_i210.c]"]
  node_management["Management interface<br/>[e1000_manage.c]"]
  node_mailbox["VF mailbox<br/>[e1000_mbx.c]"]
end

subgraph group_features["Driver features"]
  node_ethtool["Ethtool controls<br/>[igb_ethtool.c]"]
  node_ptp["PTP timestamping<br/>[igb_ptp.c]"]
  node_vmdq["VMDq virtualization<br/>[igb_vmdq.c]"]
  node_hwmon["Hardware monitoring<br/>[igb_hwmon.c]"]
  node_procfs["Proc filesystem<br/>[igb_procfs.c]"]
  node_debugfs["Debug filesystem<br/>[igb_debugfs.c]"]
end

subgraph group_compat["Kernel compatibility"]
  node_compat_api["Kernel API backports<br/>[kcompat_impl.h]"]
  node_compat_core["Kernel compatibility layer<br/>[kcompat.c]"]
  node_compat_xarray["XArray backport<br/>[kcompat_xarray.c]"]
  node_compat_packing["Packing backport<br/>[kcompat_packing.c]"]
end

node_network_stack(("Linux networking"))
node_adapter["Intel Ethernet adapter"]

node_network_stack -->|"uses driver"| node_igb_core
node_igb_core -->|"provides interface"| node_network_stack
node_igb_core -->|"configures adapter"| node_adapter
node_igb_core -->|"accepts parameters"| node_driver_params
node_igb_core -->|"supports timestamping"| node_ptp
node_igb_core -->|"references VMDq interface"| node_vmdq
node_igb_core -->|"includes driver definitions"| node_driver_types
node_driver_types -->|"includes hardware API"| node_hardware_api
node_hardware_api -.->|"accesses hardware"| node_adapter
node_igb_core -.->|"exposes controls"| node_ethtool

click node_igb_core "https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_main.c"
click node_driver_types "https://github.com/intel/ethernet-linux-igb/blob/main/src/igb.h"
click node_driver_params "https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_param.c"
click node_ethtool "https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_ethtool.c"
click node_ptp "https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_ptp.c"
click node_vmdq "https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_vmdq.c"
click node_hwmon "https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_hwmon.c"
click node_procfs "https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_procfs.c"
click node_debugfs "https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_debugfs.c"
click node_hardware_api "https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_api.c"
click node_mac "https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_mac.c"
click node_phy "https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_phy.c"
click node_nvm "https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_nvm.c"
click node_family "https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_82575.c"
click node_i210 "https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_i210.c"
click node_management "https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_manage.c"
click node_mailbox "https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_mbx.c"
click node_compat_api "https://github.com/intel/ethernet-linux-igb/blob/main/src/kcompat_impl.h"
click node_compat_core "https://github.com/intel/ethernet-linux-igb/blob/main/src/kcompat.c"
click node_compat_xarray "https://github.com/intel/ethernet-linux-igb/blob/main/src/kcompat_xarray.c"
click node_compat_packing "https://github.com/intel/ethernet-linux-igb/blob/main/src/kcompat_packing.c"

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_igb_core,node_driver_types,node_driver_params toneBlue
class node_hardware_api,node_mac,node_phy,node_nvm,node_family,node_i210,node_management,node_mailbox toneAmber
class node_ethtool,node_ptp,node_vmdq,node_hwmon,node_procfs,node_debugfs toneMint
class node_compat_api,node_compat_core,node_compat_xarray,node_compat_packing toneRose
class node_network_stack,node_adapter toneIndigo
```

## Components

### Linux driver

- [Device and packet driver](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_main.c): `src/igb_main.c`
- [Driver state and interfaces](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb.h): `src/igb.h`
- [Module parameters](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_param.c): `src/igb_param.c`

### Hardware support

- [Hardware API](https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_api.c): `src/e1000_api.c`
- [MAC operations](https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_mac.c): `src/e1000_mac.c`
- [PHY operations](https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_phy.c): `src/e1000_phy.c`
- [NVM operations](https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_nvm.c): `src/e1000_nvm.c`
- [82575 family support](https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_82575.c): `src/e1000_82575.c`
- [i210 support](https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_i210.c): `src/e1000_i210.c`
- [Management interface](https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_manage.c): `src/e1000_manage.c`
- [VF mailbox](https://github.com/intel/ethernet-linux-igb/blob/main/src/e1000_mbx.c): `src/e1000_mbx.c`

### Driver features

- [Ethtool controls](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_ethtool.c): `src/igb_ethtool.c`
- [PTP timestamping](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_ptp.c): `src/igb_ptp.c`
- [VMDq virtualization](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_vmdq.c): `src/igb_vmdq.c`
- [Hardware monitoring](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_hwmon.c): `src/igb_hwmon.c`
- [Proc filesystem](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_procfs.c): `src/igb_procfs.c`
- [Debug filesystem](https://github.com/intel/ethernet-linux-igb/blob/main/src/igb_debugfs.c): `src/igb_debugfs.c`

### Kernel compatibility

- [Kernel API backports](https://github.com/intel/ethernet-linux-igb/blob/main/src/kcompat_impl.h): `src/kcompat_impl.h`
- [Kernel compatibility layer](https://github.com/intel/ethernet-linux-igb/blob/main/src/kcompat.c): `src/kcompat.c`
- [XArray backport](https://github.com/intel/ethernet-linux-igb/blob/main/src/kcompat_xarray.c): `src/kcompat_xarray.c`
- [Packing backport](https://github.com/intel/ethernet-linux-igb/blob/main/src/kcompat_packing.c): `src/kcompat_packing.c`

### Other components

- **Linux networking**
- **Intel Ethernet adapter**

## Connections

- Linux networking → Device and packet driver: uses driver (evidence: `README`)
- Device and packet driver → Linux networking: provides interface (evidence: `README`)
- Device and packet driver → Intel Ethernet adapter: configures adapter (evidence: `README`)
- Device and packet driver → Module parameters: accepts parameters (evidence: `README`)
- Device and packet driver → PTP timestamping: supports timestamping (evidence: `README`)
- Device and packet driver → VMDq virtualization: references VMDq interface (evidence: `src/igb_main.c`)
- Device and packet driver → Driver state and interfaces: includes driver definitions (evidence: `src/igb_main.c`)
- Driver state and interfaces → Hardware API: includes hardware API (evidence: `src/igb.h`)
- Hardware API → Intel Ethernet adapter: accesses hardware
- Device and packet driver → Ethtool controls: exposes controls
