summaryrefslogtreecommitdiffstats
path: root/share
diff options
context:
space:
mode:
authormarkj <markj@FreeBSD.org>2015-03-09 04:00:46 +0000
committermarkj <markj@FreeBSD.org>2015-03-09 04:00:46 +0000
commit586e7e21a80507ccef9ebce490d8713192eddd40 (patch)
treec80bf8c456de25b4a1131366a17a4b5fcbc0a43b /share
parent25e41e0131227176ba3e292de17004267793257b (diff)
downloadFreeBSD-src-586e7e21a80507ccef9ebce490d8713192eddd40.zip
FreeBSD-src-586e7e21a80507ccef9ebce490d8713192eddd40.tar.gz
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
Diffstat (limited to 'share')
-rw-r--r--share/man/man9/SDT.914
1 files changed, 7 insertions, 7 deletions
diff --git a/share/man/man9/SDT.9 b/share/man/man9/SDT.9
index c65b824..9016b42 100644
--- a/share/man/man9/SDT.9
+++ b/share/man/man9/SDT.9
@@ -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 and can be used to instrument the
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
OpenPOWER on IntegriCloud