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

# ng\_gif.4

`ng_gif` — 通用隧道接口 netgraph 节点类型

## 名称

`ng_gif`

## 概要

`#include <netgraph/ng_gif.h>`

## 描述

`ng_gif` netgraph 节点类型允许 [gif(4)](/man/man4/gif.4.md) 接口与 [netgraph(4)](/man/man4/netgraph.4.md) 网络子系统交互。一旦 `ng_gif` 模块加载到内核中，系统中的每个 [gif(4)](/man/man4/gif.4.md) 接口都会自动创建一个节点。每个节点会尝试以关联接口的名称为自己命名。只要接口本身存在，所有 `ng_gif` 节点都会持续存在。

该节点类型支持两个钩子：`lower` 和 `orphans`。钩子名 `divert` 可作为 `lower` 的别名使用，提供与 [ng\_ether(4)](/man/man4/ng_ether.4.md) 的兼容性。实际上这两个名称代表同一个钩子。

`lower` 钩子连接到原始 [gif(4)](/man/man4/gif.4.md) 设备。连接后，所有传入的数据包都会从该钩子分流出去。写入该钩子的数据会作为原始封装数据包由设备发送。`lower` 连接后，正常的发出数据包不受影响。

`orphans` 钩子等价于 `lower`，区别在于只有无法识别的数据包（否则会被丢弃）会被写入该钩子，而正常的传入流量不受影响。`orphans` 和 `lower` 在任何时候最多只能连接其中一个。

在所有情况下，帧都是带有地址族前缀的原始数据包。

当没有钩子连接时，数据包正常向上和向下流动。

## 钩子

本节点类型支持以下钩子：

**`lower`** 连接到下层设备链路层。

**`orphans`** 类似于 `lower`，但只接收无法识别的数据包。

## 控制消息

本节点类型仅支持通用控制消息。

## 实例

以下命令将 `gif0` 接口接收的所有无法识别的数据包以十六进制和 ASCII 形式解码后输出到标准输出：

```sh
nghook -a gif0: orphans
```

## 参见

[gif(4)](/man/man4/gif.4.md), [netgraph(4)](/man/man4/netgraph.4.md), [netintro(4)](/man/man4/netintro.4.md), [ifconfig(8)](/man/man8/ifconfig.8.md), ngctl(8), nghook(8)

## 作者

Brooks Davis <brooks@FreeBSD.org>


---

# 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_gif.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.