> 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/qat.4.md).

# qat.4

`qat` — Intel QuickAssist Technology 压缩与加密驱动程序

## 名称

`qat`

## 概要

若要加载驱动程序，调用：

`kldload qat`

*

若要在引导时加载驱动程序，将以下行加入 loader.conf(5)：

`qat_200xx_fw_load="YES"`

`qat_c3xxx_fw_load="YES"`

`qat_c4xxx_fw_load="YES"`

`qat_c62x_fw_load="YES"`

`qat_dh895xcc_fw_load="YES"`

`qat_4xxx_fw_load="YES"`

`qat_load="YES"`

*
*
*
*
*
*
*

## 描述

`qat` 驱动程序支持 Intel (R) QuickAssist Technology (QAT) 设备的加密和压缩加速。

内核中暴露了用于卸载这些操作的完整 API，任何其他实体都可以直接使用。除了暴露用于卸载加密和压缩操作的完整内核 API 外，`qat` 驱动程序还与 [crypto(4)](/man/man4/crypto.4.md) 集成，允许将受支持的操作卸载到 Intel QuickAssist Technology 设备。

## 硬件

`qat` 驱动程序支持以下 Intel QuickAssist Technology 引擎：

* Intel (R) C62x 芯片组
* Intel (R) Atom C3000 处理器产品家族
* Intel (R) QuickAssist Adapter 8960/Intel (R) QuickAssist Adapter 8970（前称“Lewis Hill”）
* Intel (R) Communications Chipset 8925 至 8955 系列
* Intel (R) Atom P5300 处理器产品家族
* Intel (R) QAT 4xxx 系列

## SYSCTL 变量

以下 [sysctl(8)](/man/man8/sysctl.8.md) 变量可用于重新配置 `qat` 设备。为了保持配置持久化，这些变量可在加载驱动程序之前设置，可通过 [kenv(1)](/man/man1/kenv.1.md) 或 loader.conf(5)。

更改配置前，特定设备必须处于“down”状态。

**`dev.qat.X.state`** 显示或设置设备的当前状态。可能取值：“down”、“up”。注意：如果设备使用了对称服务，则在重新配置设备之前需要禁用 **qat\_ocf** 驱动程序。

**`dev.qat_ocf.0.enable`** 启用/禁用 QAT 加密框架连接。默认启用。

**`dev.qat.X.cfg_services`** 覆盖启用的设备服务，可为以下之一：symmetric、asymmetric、data compression。可能取值：“sym”、“asym”、“dc”、“sym;dc”、“asym;dc”、“sym;asym”。默认配置的服务对于偶数设备为“sym;asym”，对于奇数设备为“dc”。

**`dev.qat.X.cfg_mode`** 覆盖内核空间和用户空间实例的设备模式配置。可能取值：“ks”、“us”、“ks;us”。默认值为“ks;us”。

**`dev.qat.X.num_user_processes`** 覆盖可连接到 QAT 设备的 uio 用户空间进程数。默认：2

**`dev.qat.X.disable_safe_dc_mode`** 覆盖历史缓冲区缓解。默认禁用。启用后解压吞吐量会增加，但若 `dev.qat.X.num_user_processes` 大于 1 可能导致数据泄漏。仅当你的系统不易发生用户数据泄漏时才启用此选项。

以下 [sysctl(8)](/man/man8/sysctl.8.md) 变量为只读：

**`dev.qat.X.frequency`** QAT 设备频率值。

**`dev.qat.X.mmp_version`** QAT MMP 库修订号。

**`dev.qat.X.hw_version`** QAT 硬件修订号。

**`dev.qat.X.fw_version`** QAT 固件修订号。

**`dev.qat.X.dev_cfg`** 设备特定配置摘要。

**`dev.qat.X.heartbeat`** QAT 设备心跳状态。值‘1’表示设备运行正常。值‘0’表示设备无响应。设备需要重启。

**`dev.qat.X.heartbeat_failed`** 收到的 QAT 心跳失败次数。

**`dev.qat.X.heartbeat_sent`** 发送的 QAT 心跳请求数。

## 参见

[crypto(4)](/man/man4/crypto.4.md), [ipsec(4)](/man/man4/ipsec.4.md), [pci(4)](/man/man4/pci.4.md), [crypto(7)](/man/man7/crypto.7.md), [crypto(9)](/man/man9/crypto.9.md)

有关用法及受支持的操作和算法的详细信息，请参阅 Intel 下载中心 Lk <https://downloadcenter.intel.com> 提供的以下文档：

> Intel (R), "QuickAssist Technology API Programmer's Guide".

> Intel (R), "QuickAssist Technology Cryptographic API Reference Manual".

> Intel (R), "QuickAssist Technology Data Compression API Reference Manual".

> Intel (R), "QuickAssist Technology Performance Optimization Guide".

*
*
*
*

## 历史

`qat` 驱动程序出现于 FreeBSD 13.0。在 FreeBSD 14.0 中被上游驱动程序取代。

## 作者

`qat` 驱动程序由 Intel (R) Corporation 编写。


---

# 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/qat.4.md?ask=<question>&goal=<endgoal>
```

`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.