Date: Mon, 9 Mar 2015 04:00:46 +0000 (UTC) From: Mark Johnston <markj@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r279802 - head/share/man/man9 Message-ID: <201503090400.t2940kYc051487@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: markj Date: Mon Mar 9 04:00:46 2015 New Revision: 279802 URL: https://svnweb.freebsd.org/changeset/base/279802 Log: Don't specify a function name in the example SDT(9) probe. As with the module component, it is a bug that the SDT(9) KPI allows one to specify the function component of an SDT probe. Currently, the module component is filled in automatically if left unset; this is not yet true for the function component, but will be addressed by some ongoing work. MFC after: 3 days Modified: head/share/man/man9/SDT.9 Modified: head/share/man/man9/SDT.9 ============================================================================== --- head/share/man/man9/SDT.9 Mon Mar 9 03:50:53 2015 (r279801) +++ head/share/man/man9/SDT.9 Mon Mar 9 04:00:46 2015 (r279802) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd September 18, 2014 +.Dd March 8, 2015 .Dt SDT 9 .Os .Sh NAME @@ -196,13 +196,13 @@ They are meant to be added to executable code in which they are called. .Sh EXAMPLES The following probe definition will create a DTrace probe called -.Ql icmp::unreach:pkt-receive , +.Ql icmp:::receive-unreachable , which would hypothetically be triggered when the kernel receives an ICMP packet of type Destination Unreachable: .Bd -literal -offset indent SDT_PROVIDER_DECLARE(icmp); -SDT_PROBE_DEFINE1(icmp, , unreach, pkt__receive, +SDT_PROBE_DEFINE1(icmp, , , receive__unreachable, "struct icmp *"); .Ed @@ -286,10 +286,10 @@ This manual page was written by .Sh BUGS The .Nm -macros allow the module name of a probe to be specified as part of a probe -definition. -However, the DTrace framework uses the module name of probes to determine -which probes should be destroyed when a kernel module is unloaded, so the module +macros allow the module and function names of a probe to be specified as part of +a probe definition. +The DTrace framework uses the module name of probes to determine which probes +should be destroyed when a kernel module is unloaded, so the module name of a probe should match the name of the module in which its defined. .Nm will set the module name properly if it is left unspecified in the probe
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201503090400.t2940kYc051487>