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

# ng\_checksum.4

`ng_checksum` — 重建 IP 校验和的节点类型

## 名称

`ng_checksum`

## 概要

`#include <netgraph/ng_checksum.h>`

## 描述

`checksum` 节点可以计算或为硬件计算准备 IPv4 头部、TCP 和 UDP 校验和。

## 钩子

此节点类型有两个钩子：

**`in`** 在此钩子上接收的数据包按配置中指定的设置处理，然后转发到 `out` 钩子（如果存在且已连接）。否则它们被反射回 `in` 钩子。

**`out`** 在此钩子上接收的数据包不做任何更改转发到 `in` 钩子。

## 控制消息

此节点类型支持通用控制消息，外加以下消息：

`#include <net/bpf.h>`

```sh
struct ng_checksum_config {
	uint64_t	csum_flags;
	uint64_t	csum_offload;
};
```

**`NGM_CHECKSUM_SETDLT`** (`setdlt`) 设置 `in` 钩子上的数据链路类型。目前支持的类型有 `DLT_RAW`（原始 IP 数据报）和 `DLT_EN10MB`（以太网）。DLT\_ 定义可在头文件中找到。当前使用的值为 `DLT_EN10MB` = 1 和 `DLT_RAW` = 12。

**`NGM_CHECKSUM_GETDLT`** (`getdlt`) 此控制消息获取 `in` 钩子上的数据链路类型。

**`NGM_CHECKSUM_SETCONFIG`** (`setconfig`) 设置节点配置。必须提供以下 `struct ng_checksum_config` 作为参数：`csum_flags` 可设置为 CSUM\_IP、CSUM\_TCP、CSUM\_UDP、CSUM\_TCP\_IPV6 和 CSUM\_UDP\_IPV6 的任意组合（其他值被忽略），用于指示节点计算相应的校验和。`csum_offload` 值可设置为 CSUM\_IP、CSUM\_TCP、CSUM\_UDP、CSUM\_TCP\_IPV6 和 CSUM\_UDP\_IPV6 的任意组合（其他值被忽略），用于指示节点应请求硬件计算哪些校验和。节点还考虑 mbuf 上已标记的 CSUM\_IP、CSUM\_TCP、CSUM\_UDP、CSUM\_TCP\_IPV6 和 CSUM\_UDP\_IPV6 的任意组合。

**`NGM_CHECKSUM_GETCONFIG`** (`getconfig`) 此控制消息获取作为 `struct ng_checksum_config` 返回的当前节点配置。

**`NGM_CHECKSUM_GET_STATS`** (`getstats`) 返回作为 `struct ng_checksum_stats` 的节点统计信息。

**`NGM_CHECKSUM_CLR_STATS`** (`clrstats`) 清除节点统计信息。

**`NGM_CHECKSUM_GETCLR_STATS`** (`getclrstats`) 此命令与 `NGM_CHECKSUM_GET_STATS` 相同，区别在于统计信息也会被原子性地清除。

## 关闭

此节点在收到 `NGM_SHUTDOWN` 控制消息时，或当所有钩子都已断开时关闭。

## 实例

ngctl(8) 脚本：

```sh
/usr/sbin/ngctl -f- <<-SEQ
	msg checksum-1: setdlt 1
	msg checksum-1: setconfig { csum_flags=0 csum_offload=6 }
SEQ
```

将数据链路类型设置为 `DLT_EN10MB`（以太网），不设置额外的校验和标志，并请求硬件计算 CSUM\_IP\_UDP|CSUM\_IP\_TCP。

## 参见

[netgraph(4)](/man/man4/netgraph.4.md), [ng\_patch(4)](/man/man4/ng_patch.4.md), ngctl(8)

## 历史

`checksum` 节点类型实现于 FreeBSD 10.2，并首次提交于 FreeBSD 12.0。

## 作者

Dmitry Vagin <daemon.hammer@ya.ru>.


---

# 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/ng_checksum.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.