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

# dtrace\_udp.4

`dtrace_udp` — 用于跟踪与 UDP 协议相关事件的 DTrace provider

## 名称

`dtrace_udp`

## 概要

`Fn udp:::receive pktinfo_t * csinfo_t * ipinfo_t * udpsinfo_t * \ "udpinfo_t *" Fn udp:::send pktinfo_t * csinfo_t * ipinfo_t * udpsinfo_t * \ "udpinfo_t *"`

## 描述

DTrace `udp` provider 允许用户跟踪 [udp(4)](/man/man4/udp.4.md) 协议实现中的事件。`Fn udp:::send` 探针在内核准备传输 UDP 数据包时触发，`Fn udp:::receive` 探针在内核收到 UDP 数据包时触发，但若 UDP 头不完整、目标端口为 0、长度字段无效或校验和错误则不会触发。这些探针的参数可用于获取相应数据包 IP 和 UDP 头的详细信息。

## 参数

`pktinfo_t` 参数目前未实现，仅为与本 provider 的其他实现兼容而保留。其字段为：

**`uintptr_t pkt_addr`** 始终设为 0。

`csinfo_t` 参数目前未实现，仅为与本 provider 的其他实现兼容而保留。其字段为：

**`uintptr_t cs_addr`** 始终设为 0。

**`uint64_t cs_cid`** 指向该数据包对应的 `struct inpcb` 的指针，或为 `NULL`。

**`pid_t cs_pid`** 始终设为 0。

`ipinfo_t` 参数包含 IPv4 和 IPv6 数据包共有的 IP 字段。其字段为：

**`uint8_t ip_ver`** 数据包的 IP 版本，IPv4 数据包为 4，IPv6 数据包为 6。

**`uint32_t ip_plength`** IP 负载大小。不包括 IP 头或 IPv6 选项头的大小。

**`string ip_saddr`** IP 源地址。

**`string ip_daddr`** IP 目标地址。

`udpsinfo_t` 参数包含与该数据包关联的 UDP 连接状态。其字段为：

**`uintptr_t udps_addr`** 指向包含关联 socket IP 状态的 `struct inpcb` 的指针。

**`uint16_t udps_lport`** 本地 UDP 端口。

**`uint16_t udps_rport`** 远程 UDP 端口。

**`string udps_laddr`** 本地 IPv4 或 IPv6 地址。

**`string udps_raddr`** 远程 IPv4 或 IPv6 地址。

`udpinfo_t` 参数是数据包的原始 UDP 头，所有字段均为主机字节序。其字段为：

**`uint16_t udp_sport`** 源 UDP 端口。

**`uint16_t udp_dport`** 目标 UDP 端口。

**`uint16_t udp_length`** UDP 头和负载的长度，以字节为单位。

**`uint16_t udp_checksum`** UDP 头和负载的校验和，若未计算校验和则为 0。

**`struct udphdr *udp_hdr`** 指向原始 UDP 头的指针。

## 文件

**`/usr/lib/dtrace/udp.d`** `udp` provider 的 DTrace 类型和转换器定义。

## 实例

以下脚本按目标端口统计已传输的数据包：

```sh
udp:::send
{
        @num[args[4]->udp_dport] = count();
}
```

此脚本将打印内核发送或接收的每个 UDP 数据包的部分详细信息：

```sh
#pragma D option quiet
#pragma D option switchrate=10Hz
dtrace:::BEGIN
{
        printf(" %10s %36s    %-36s %6sn", "DELTA(us)", "SOURCE",
            "DEST", "BYTES");
        last = timestamp;
}
udp:::send
{
        this->elapsed = (timestamp - last) / 1000;
        self->dest = strjoin(strjoin(args[2]->ip_daddr, ":"),
             lltostr(args[4]->udp_dport));
        printf(" %10d %30s:%-5d -> %-36s %6dn", this->elapsed,
            args[2]->ip_saddr, args[4]->udp_sport,
            self->dest, args[4]->udp_length);
        last = timestamp;
}
udp:::receive
{
        this->elapsed = (timestamp - last) / 1000;
        self->dest = strjoin(strjoin(args[2]->ip_saddr, ":"),
             lltostr(args[4]->udp_sport));
        printf(" %10d %30s:%-5d <- %-36s %6dn", this->elapsed,
            args[2]->ip_daddr, args[4]->udp_dport,
            self->dest, args[4]->udp_length);
        last = timestamp;
}
```

## 兼容性

该 provider 与 Solaris 中的 `udp` provider 兼容。

## 参见

[dtrace(1)](/man/man1/dtrace.1.md), [dtrace\_ip(4)](/man/man4/dtrace_ip.4.md), [dtrace\_sctp(4)](/man/man4/dtrace_sctp.4.md), [dtrace\_tcp(4)](/man/man4/dtrace_tcp.4.md), [dtrace\_udplite(4)](/man/man4/dtrace_udplite.4.md), [udp(4)](/man/man4/udp.4.md), [SDT(9)](https://github.com/FreeBSD-Ask/freebsd-man-sc/tree/main/man9/sdt.9.md)

## 历史

`udp` provider 首次出现于 FreeBSD 10.0。

## 作者

本手册页由 Mark Johnston <markj@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/dtrace_udp.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.