> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man4/ixl.4.md).
# ixl.4
`ixl` — Intel Ethernet 700 系列驱动
## 名称
`ixl`
## 概要
`要将此驱动编译进内核，请在你的内核配置文件中加入以下行：`
> device iflib device ixl
`要在引导时以模块形式加载此驱动，请在 loader.conf(5) 中加入以下行：`
```sh
if_ixl_load="YES"
```
## 描述
### 特性
`ixl` 驱动为 Intel Ethernet 700 系列中的任何 PCI Express 适配器或 LOM（LAN On Motherboard）提供支持。截至本文撰写时，该系列包括以下型号的设备：
* XL710 (40G)
* X710 (10G)
* XXV710 (25G)
* X722 (10G)
该驱动支持 Jumbo Frames、TX/RX 校验和卸载、TCP 分段卸载（TSO）、大接收卸载（LRO）、VLAN 标签插入/提取、VLAN 校验和卸载、VLAN TSO 以及接收端转向（RSS），以上功能均同时支持 IPv4 和 IPv6。有关硬件信息和硬件需求相关问题，请参阅 Lk 。
通过接口 MTU 设置提供对 Jumbo Frames 的支持。使用 [ifconfig(8)](/man/man8/ifconfig.8.md) 工具选择大于 1500 字节的 MTU 可将适配器配置为接收和发送 Jumbo Frames。Jumbo Frames 的最大 MTU 大小为 9706。
卸载也通过接口控制，例如，可以设置和取消设置 IPv4 和 IPv6 的校验和、TSO4 和/或 TSO6，最后是 LRO。
有关配置此设备的更多信息，请参见 [ifconfig(8)](/man/man8/ifconfig.8.md)。
### 附加工具
Intel 提供了附加工具来帮助配置和更新此驱动涵盖的适配器。这些工具可以直接从 Intel 下载，下载地址为 Lk ，通过搜索其名称，或通过安装某些软件包：
* 要更改 XL710 适配器上 QSFP+ 端口的行为，使用 Intel QCU（QSFP+ configuration utility）；通过 *sysutils/intel-qcu* 软件包安装。
* 要更新适配器上的固件，使用 Intel Non-Volatile Memory (NVM) Update Utility；通过 *sysutils/intel-nvmupdate-10g*、*sysutils/intel-nvmupdate-40g* 或 *sysutils/intel-nvmupdate-100g* 软件包安装。
* 驱动由 Intel 在 FreeBSD 内核之外提供；安装 *net/intel-ixl-kmod* 软件包以获取最新驱动。
## 硬件
`ixl` 驱动支持 Intel Ethernet 700 系列。此系列中大多数带有 SFP+/SFP28/QSFP+ 笼的适配器的固件要求使用 Intel 认证模块；以下列出了这些认证模块。驱动无法禁用此认证检查。
`ixl` 驱动支持使用以下 QSFP+ 模块的 40Gb 以太网适配器：
* Intel 4x10G/40G QSFP+ 40GBASE-SR4 E40GQSFPSR
* Intel 4x10G/40G QSFP+ 40GBASE-LR4 E40GQSFPLR
`ixl` 驱动支持使用以下 SFP28 模块的 25Gb 以太网适配器：
* Intel 10G/25G SFP28 25GBASE-SR E25GSFP28SR
* Intel 10G/25G SFP28 25GBASE-SR E25GSFP28SRX（扩展温度）
`ixl` 驱动支持使用以下 SFP+ 模块的 25Gb 和 10Gb 以太网适配器：
* Intel 1G/10G SFP+ SR FTLX8571D3BCV-IT
* Intel 1G/10G SFP+ SR AFBR-703SDZ-IN2
* Intel 1G/10G SFP+ LR FTLX1471D3BCV-IT
* Intel 1G/10G SFP+ LR AFCT-701SDZ-IN2
* Intel 1G/10G SFP+ 10GBASE-SR E10GSFPSR
* Intel 10G SFP+ 10GBASE-SR E10GSFPSRX（扩展温度）
* Intel 1G/10G SFP+ 10GBASE-LR E10GSFPLR
注意，适配器还支持所有符合 SFF-8431 v4.1 和 SFF-8472 v10.4 规范的无源和有源限幅直连电缆。
此列表并不完整；请查阅产品文档以获取受支持介质的最新列表。
## 加载器可调参数
可调参数可在引导内核前于 [loader(8)](/man/man8/loader.8.md) 提示符下设置，或存储在 loader.conf(5) 中。
```sh
0 - 最佳可用方法
1 - 通过 I2CPARAMS 寄存器位操作
2 - 通过 I2CCMD 寄存器读写
3 - 使用 Admin Queue 命令（默认最佳）
```
**`hw.ixl.rx_itr`** RX 中断率值，默认设置为 62（124 微秒）。
**`hw.ixl.tx_itr`** TX 中断率值，默认设置为 122（244 微秒）。
**`hw.ixl.i2c_access_method`** 驱动通过 [sysctl(8)](/man/man8/sysctl.8.md) 或详细的 [ifconfig(8)](/man/man8/ifconfig.8.md) 信息显示进行 I2C 读写时使用的访问方法：使用 Admin Queue 仅在固件版本 1.7 或更新的 710 设备上受支持。默认设置为 0。
**`hw.ixl.enable_tx_fc_filter`** 过滤掉非适配器源发出的 Ethertype 0x8808 数据包。这可防止（可能不可信的）软件或 [iavf(4)](/man/man4/iavf.4.md) 设备发出流控制数据包并造成 DoS（拒绝服务）事件。默认启用。
**`hw.ixl.enable_head_writeback`** 当驱动查找硬件处理的最后一个 TX 描述符时，使用硬件写入内存的值，而非扫描描述符环查找已完成的描述符。默认启用；禁用可模拟 ix(4) 中的 TX 行为。
## SYSCTL 过程
**`dev.ixl.#.fc`** 设置适配器将在链路上通告的 802.3x 流控制模式。值为 0 时禁用流控制，3 启用全双工流控制，1 为 RX，2 为 TX 暂停。协商后的流控制设置可在 [ifconfig(8)](/man/man8/ifconfig.8.md) 中接口的 media 字段中查看。
**`dev.ixl.#.advertise_speed`** 设置接口将在链路上通告的速度。`dev.ixl.#.supported_speeds` 包含允许设置的速度。
**`dev.ixl.#.current_speed`** 显示当前速度。
**`dev.ixl.#.fw_version`** 显示适配器的当前固件和 NVM 版本。
**`dev.ixl.#.debug.switch_vlans`** 设置硬件自身用于处理内部服务的 Ethertype。具有此 Ethertype 的帧将被静默丢弃。默认值为 `0x88a8`，这是 IEEE 802.1ad VLAN 堆叠的知名编号。如果需要 802.1ad 支持，请将此编号设置为任何其他 Ethertype，即 `0xffff`。
## 中断风暴
需要注意的是，40G 操作可能产生大量中断，通常被内核错误地解释为风暴状态。建议通过设置以下参数解决此问题：
**`hw.intr_storm_threshold: 0`**
## IOVCTL 选项
使用 iovctl(8) 时，驱动支持为创建的 VF（虚拟功能）提供附加可选参数：
**mac-addr** (unicast-mac) 设置 VF 将使用的以太网 MAC 地址。如果未指定，VF 将使用随机生成的 MAC 地址。
**mac-anti-spoof** (bool) 防止 VF 发送源地址与其自身不匹配的以太网帧。
**allow-set-mac** (bool) 允许 VF 设置自己的以太网 MAC 地址。
**allow-promisc** (bool) 允许 VF 检查发送到端口的所有流量。
**num-queues** (uint16\_t) 指定 VF 将拥有的队列数量。默认情况下，此值设置为 VF 支持的 MSI-X 向量数减一。
使用 iovctl(8) 的 `-S` 选项可找到最新的参数及其默认值列表。
## 支持
如需一般信息和支持，请访问 Intel 支持网站：Lk 。
如果使用受支持的适配器发现此驱动的问题，请将与问题相关的所有具体信息发送邮件至 。
## 参见
arp(4), [iavf(4)](/man/man4/iavf.4.md), [iflib(4)](/man/man4/iflib.4.md), netintro(4), vlan(4), [ifconfig(8)](/man/man8/ifconfig.8.md), iovctl(8)
## 历史
`ixl` 设备驱动最早出现于 FreeBSD 10.1。它在 FreeBSD 12 中被转换为使用 iflib(9)。
## 作者
`ixl` 驱动由 Jack Vogel 和 Eric Joyner 编写。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://book.bsdcn.org/man/man4/ixl.4.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.