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
_______________________________________________
svn-src-head@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-head
To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org"
