> 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_car.4.md). # ng\_car.4 `ng_car` — 承诺访问速率 netgraph 节点类型 ## 名称 `ng_car` ## 概要 `#include ` ## 描述 `car` 节点类型使用以下方法限制流经它的流量： * 单速率三色标记（如 RFC 2697 所述）， * 双速率三色标记（如 RFC 2698 所述）， * Cisco 使用的类 RED 速率限制算法， * 使用 RED 的流量整形。 ## 钩子 此节点类型支持以下钩子： **`upper`** 通向上层协议的钩子。 **`lower`** 通向下层协议的钩子。 从 `upper` 流向 `lower` 的流量视为**下游**流量。从 `lower` 流向 `upper` 的流量视为**上游**流量。 ## 操作模式 每个钩子可在以下模式之一中操作： **`NG_CAR_SINGLE_RATE`** 如 RFC 2697 所述的单速率三色标记。承诺突发数据包计为绿色，扩展突发数据包计为黄色，超出数据包计为红色。承诺突发以 CIR（承诺信息速率）速度补充。当它满时，扩展突发被补充。 **`NG_CAR_DOUBLE_RATE`** 如 RFC 2698 所述的双速率三色标记。承诺突发数据包计为绿色，峰值突发数据包计为黄色，超出数据包计为红色。承诺突发以 CIR 速度补充。同时峰值突发以 PIR（峰值信息速率）速度补充。 **`NG_CAR_RED`** 类似于 `NG_CAR_SINGLE_RATE`，但对扩展突发有不同理解。当正常突发超出且使用扩展突发时，数据包以等于已消耗扩展突发部分的概率计为红色。扩展突发先被补充。当它满时，承诺突发被补充。此行为类似于 RED 主动队列管理算法。此算法对 TCP 流量比 NG\_CAR\_SINGLE\_RATE 更温和。 **`NG_CAR_SHAPE`** 承诺突发数据包计为绿色，超出数据包由带 RED 管理的队列延迟并计为黄色。被队列丢弃的数据包计为红色。队列参数是硬编码的：长度 99 个数据包，min\_th 8 个数据包，max\_p 100%。流量整形对 TCP 流量比在带宽 × 延迟乘积小于 6-8 个 TCP 段的链路上进行速率限制更温和，但它消耗额外的系统资源用于队列处理。 默认情况下，所有信息速率以比特每秒为单位测量，突发以字节为单位测量。但当启用 NG\_CAR\_COUNT\_PACKETS 选项时，速率以包每秒为单位测量，突发以包为单位。 ## 控制消息 此节点类型支持通用控制消息和以下特定消息。 ```sh struct ng_car_hookconf { uint64_t cbs; /* 承诺突发大小（字节） */ uint64_t ebs; /* 超出/峰值突发大小（字节） */ uint64_t cir; /* 承诺信息速率（比特/秒） */ uint64_t pir; /* 峰值信息速率（比特/秒） */ uint8_t green_action; /* 绿色数据包的动作 */ uint8_t yellow_action; /* 黄色数据包的动作 */ uint8_t red_action; /* 红色数据包的动作 */ uint8_t mode; /* 单/双速率等 */ uint8_t opt; /* 色感知或色盲 */ }; /* 可能的动作（..._action） */ enum { NG_CAR_ACTION_FORWARD = 1, NG_CAR_ACTION_DROP, NG_CAR_ACTION_MARK }; /* 操作模式（mode） */ enum { NG_CAR_SINGLE_RATE = 0, NG_CAR_DOUBLE_RATE, NG_CAR_RED, NG_CAR_SHAPE }; /* 模式选项（opt 的位） */ #define NG_CAR_COLOR_AWARE 1 #define NG_CAR_COUNT_PACKETS 2 struct ng_car_bulkconf { struct ng_car_hookconf upstream; struct ng_car_hookconf downstream; }; ``` ```sh struct ng_car_hookstats { uint64_t passed_pkts; /* 通过的数据包计数器 */ uint64_t dropped_pkts; /* 丢弃的数据包计数器 */ uint64_t green_pkts; /* 绿色数据包计数器 */ uint64_t yellow_pkts; /* 黄色数据包计数器 */ uint64_t red_pkts; /* 红色数据包计数器 */ uint64_t errors; /* 操作错误计数器 */ }; struct ng_car_bulkstats { struct ng_car_hookstats upstream; struct ng_car_hookstats downstream; }; ``` **`NGM_CAR_SET_CONF`** (`setconf`) 将节点配置设置为 `struct ng_car_bulkconf` 中指定的值 **`NGM_CAR_GET_CONF`** (`getconf`) 返回当前节点配置，作为 `struct ng_car_bulkconf` **`NGM_CAR_GET_STATS`** (`getstats`) 返回节点统计信息，作为 `struct ng_car_bulkstats` **`NGM_CAR_CLR_STATS`** (`clrstats`) 清除节点统计信息。 **`NGM_CAR_GETCLR_STATS`** (`getclrstats`) 原子性地返回并清除节点统计信息。 ## 关闭 此节点在收到 `NGM_SHUTDOWN` 控制消息时，或当所有钩子都已断开时关闭。 ## 实例 将 fxp0 以太网接口上的传出数据速率限制为 20Mbit/s，传入数据包速率限制为 5000pps。 ```sh /usr/sbin/ngctl -f- <<-SEQ mkpeer fxp0: car lower lower name fxp0:lower fxp0_car connect fxp0: fxp0_car: upper upper msg fxp0_car: setconf { downstream={ cir=20000000 cbs=2500000 ebs=2500000 greenAction=1 yellowAction=1 redAction=2 mode=2 } upstream={ cir=5000 cbs=100 ebs=100 greenAction=1 yellowAction=1 redAction=2 mode=2 opt=2 } } SEQ ``` ## 参见 [netgraph(4)](/man/man4/netgraph.4.md), ngctl(8) > J. Heinanen, "A Single Rate Three Color Marker", RFC 2697. > J. Heinanen, "A Two Rate Three Color Marker", RFC 2698. ## 作者 Nuno Antunes Alexander Motin ## 缺陷 目前仅实现了 DROP 和 FORWARD 动作。 --- # 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_car.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.