Changeset View
Changeset View
Standalone View
Standalone View
head/share/man/man4/dtrace_udp.4
Show All 18 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd April 18, 2015 | .Dd July 20, 2018 | ||||
.Dt DTRACE_UDP 4 | .Dt DTRACE_UDP 4 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm dtrace_udp | .Nm dtrace_udp | ||||
.Nd a DTrace provider for tracing events related to the UDP protocol | .Nd a DTrace provider for tracing events related to the UDP protocol | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Fn udp:::receive "pktinfo_t *" "csinfo_t *" "ipinfo_t *" "udpsinfo_t *" \ | .Fn udp:::receive "pktinfo_t *" "csinfo_t *" "ipinfo_t *" "udpsinfo_t *" \ | ||||
"udpinfo_t *" | "udpinfo_t *" | ||||
.Fn udp:::send "pktinfo_t *" "csinfo_t *" "ipinfo_t *" "udpsinfo_t *" \ | .Fn udp:::send "pktinfo_t *" "csinfo_t *" "ipinfo_t *" "udpsinfo_t *" \ | ||||
"udpinfo_t *" | "udpinfo_t *" | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The DTrace | The DTrace | ||||
.Nm udp | .Nm udp | ||||
provider allows users to trace events in the | provider allows users to trace events in the | ||||
.Xr udp 4 | .Xr udp 4 | ||||
protocol implementation. | protocol implementation. | ||||
The | The | ||||
.Fn udp:::send | .Fn udp:::send | ||||
probe fires whenever the kernel prepares to transmit a UDP packet, and the | probe fires whenever the kernel prepares to transmit a UDP packet, and the | ||||
.Fn udp:::receive | .Fn udp:::receive | ||||
probe fires whenever the kernel receives a UDP packet. | probe fires whenever the kernel receives a UDP packet, unless | ||||
the UDP header is incomplete, | |||||
the destination port is 0, | |||||
the length field is invalid, | |||||
or the checksum is wrong. | |||||
The arguments to these probes can be used to obtain detailed information about | The arguments to these probes can be used to obtain detailed information about | ||||
the IP and UDP headers of the corresponding packet. | the IP and UDP headers of the corresponding packet. | ||||
.Sh ARGUMENTS | .Sh ARGUMENTS | ||||
The | The | ||||
.Vt pktinfo_t | .Vt pktinfo_t | ||||
argument is currently unimplemented and is included for compatibility with other | argument is currently unimplemented and is included for compatibility with other | ||||
implementations of this provider. | implementations of this provider. | ||||
Its fields are: | Its fields are: | ||||
▲ Show 20 Lines • Show All 143 Lines • Show Last 20 Lines |