# intel-ice

**Repository Path**: qiminghuhu/intel-ice

## Basic Information

- **Project Name**: intel-ice
- **Description**: Intel Network Adapter Driver for Intel® E810 Ethernet Series Devices
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-15
- **Last Updated**: 2025-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

dnf install intel-ice-2.3.10-1.rpm
# Intel ICE 驱动

## 概述
Intel ICE 驱动为 Intel(R) Ethernet Connection E800 系列网卡提供 Linux 内核支持，具备 SR-IOV、ADQ、DCB 等数据中心级特性。

## 包含内容
- `ice.spec`：RPM 打包脚本，负责构建内核模块并安装附属文件。
- `src/`：驱动源码，在构建阶段由源码包解压得到。
- `scripts/`：可选脚本，若存在将安装到 `/usr/share/ice/`。

## 主要特性
- 内核模块 `ice.ko`
- `/etc/modules-load.d/ice.conf` 自动加载 `vfio`、`mdev`、`ice` 模块
- `/etc/modprobe.d/ice.conf` 定义 `softdep ice pre: vfio mdev`，保证 SR-IOV 依赖先行
- 文档安装到 `/usr/share/doc/ice-<version>/`

## 构建依赖
在执行 `rpmbuild` 之前，请在构建主机安装以下软件包：
- `gcc`
- `make`
- `kernel-devel`
- `kernel-headers`
- `elfutils-libelf-devel`

## 构建步骤
1. 将上游源码包命名为 `ice-<version>.tar.gz` 并放入 `~/rpmbuild/SOURCES/`。
2. 把 `ice.spec` 复制到 `~/rpmbuild/SPECS/`。
3. 执行：
	```bash
	rpmbuild -ba ice.spec
	```
4. 生成的二进制 RPM 位于 `~/rpmbuild/RPMS/`，源码 RPM 位于 `~/rpmbuild/SRPMS/`。

## 安装指南
1. 在目标系统安装 RPM：
	```bash
	sudo dnf install ./ice-2.3.10-1.<arch>.rpm
	# 或者
	sudo rpm -ivh ./ice-2.3.10-1.<arch>.rpm
	```
2. 安装脚本会运行 `depmod` 并尝试加载 `vfio`、`mdev` 模块，可通过以下命令确认：
	```bash
	lsmod | grep -E "^(vfio|mdev|ice)"
	```

## 配置文件
- `/etc/modules-load.d/ice.conf`
- `/etc/modprobe.d/ice.conf`

这两个文件以 `%config(noreplace)` 方式打包，升级时不会覆盖本地修改。

## 使用示例
1. 启用网口：
	```bash
	sudo ip link set dev <interface> up
	```
2. 配置地址：
	```bash
	sudo ip addr add <ip>/<prefix> dev <interface>
	```
3. SR-IOV 场景下创建虚拟功能：
	```bash
	echo <num_vfs> | sudo tee /sys/class/net/<pf>/device/sriov_numvfs
	```

## 故障排查
- 若安装阶段无法加载 `vfio` 或 `mdev`，请确认内核已启用对应模块并可通过 `modinfo` 查到。
- 内核升级后可再次执行 `sudo depmod -a` 与 `sudo modprobe ice` 以刷新依赖。
- 如网卡设备未出现，可查看 `dmesg` 或 `/var/log/messages` 获取更多日志。

## 卸载
```bash
sudo dnf remove ice
```
卸载脚本会再次执行 `depmod`，保持模块依赖一致。

## 参与贡献
1. Fork 仓库
2. 创建 `feat/<topic>` 分支
3. 编写代码并提交
4. 提交 Pull Request，描述改动动机与测试结果