From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 20881 invoked by alias); 26 Sep 2014 13:18:15 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 20872 invoked by uid 89); 26 Sep 2014 13:18:14 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-0.4 required=5.0 tests=AWL,BAYES_50,LIKELY_SPAM_BODY,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL autolearn=no version=3.3.2 X-HELO: mtaout22.012.net.il Received: from mtaout22.012.net.il (HELO mtaout22.012.net.il) (80.179.55.172) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Fri, 26 Sep 2014 13:18:13 +0000 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0NCI00B00F6M0N00@a-mtaout22.012.net.il> for gdb-patches@sourceware.org; Fri, 26 Sep 2014 16:18:10 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NCI00B0JFMA4R00@a-mtaout22.012.net.il>; Fri, 26 Sep 2014 16:18:10 +0300 (IDT) Date: Fri, 26 Sep 2014 13:18:00 -0000 From: Eli Zaretskii Subject: Re: [PATCH 8/9] Documentation for DTrace USDT probes. In-reply-to: <1411724905-31234-9-git-send-email-jose.marchesi@oracle.com> To: "Jose E. Marchesi" Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83oau2tt9w.fsf@gnu.org> References: <1411724905-31234-1-git-send-email-jose.marchesi@oracle.com> <1411724905-31234-9-git-send-email-jose.marchesi@oracle.com> X-IsSubscribed: yes X-SW-Source: 2014-09/txt/msg00786.txt.bz2 > From: "Jose E. Marchesi" > Date: Fri, 26 Sep 2014 11:48:24 +0200 > > gdb/doc: > > 2014-09-26 Jose E. Marchesi > > * gdb.texinfo (Static Probe Points): Add cindex `static probe > point, DTrace'. > (Static Probe Points): Modified to cover DTrace probes in addition > to SystemTap probes. No need to mention the name of the same node twice. > +@itemize @bullet > +@item @code{SystemTap} (@uref{http://sourceware.org/systemtap/}) > +@acronym{SDT} probes@footnote{See > @uref{http://sourceware.org/systemtap/wiki/AddingUserSpaceProbingToApps} > -for more information on how to add @code{SystemTap} @acronym{SDT} probes > -in your applications. > +for more information on how to add @code{SystemTap} @acronym{SDT} > +probes in your applications.}. @code{SystemTap} probes are usable > +from assembly, C and C@t{++} languages@footnote{See > +@uref{http://sourceware.org/systemtap/wiki/UserSpaceProbeImplementation} > +for a good reference on how the @acronym{SDT} probes are implemented.}. > +@item @code{DTrace} (@uref{http://oss.oracle.com/projects/DTrace}) > +@acronym{USDT} probes. @code{DTrace} probes are usable from C and > +C@t{++} languages. > +@end itemize Please leave an empty line before each @item. > +Some @code{SystemTap} probes have an associated semaphore variable; > +for instance, this happens automatically if you defined your probe > +using a DTrace-style @file{.d} file. If your probe has a semaphore, > +@value{GDBN} will automatically enable it when you specify a > +breakpoint using the @samp{-probe-stap} notation. But, if you put a > +breakpoint at a probe's location by some other method (e.g., > +@code{break file:line}), then @value{GDBN} will not automatically set > +the semaphore. @code{DTrace} probes do not support the notion of > +semaphores. The last sentence confused me: you first explain something that seems to imply semaphores are part of DTrace probes, but then say that they don't support semaphores. What am I missing? > +probe being handled. Some @code{DTrace} probes can be enabled or > +disabled, but @code{SystemTap} probes do not support these notions. Which "notions"? If you want to say they cannot be disabled, please say so explicitly. Thanks.