From owner-svn-src-all@FreeBSD.ORG Mon Mar 9 04:00:47 2015 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 40E04F15; Mon, 9 Mar 2015 04:00:47 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 12393689; Mon, 9 Mar 2015 04:00:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t2940kbs051488; Mon, 9 Mar 2015 04:00:46 GMT (envelope-from markj@FreeBSD.org) Received: (from markj@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t2940kYc051487; Mon, 9 Mar 2015 04:00:46 GMT (envelope-from markj@FreeBSD.org) Message-Id: <201503090400.t2940kYc051487@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: markj set sender to markj@FreeBSD.org using -f From: Mark Johnston Date: Mon, 9 Mar 2015 04:00:46 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r279802 - head/share/man/man9 X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 09 Mar 2015 04:00:47 -0000 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