From patchwork Tue Jan 28 14:33:34 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Will Newton X-Patchwork-Id: 23795 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-oa0-f69.google.com (mail-oa0-f69.google.com [209.85.219.69]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id 09D5D202B2 for ; Tue, 28 Jan 2014 14:33:45 +0000 (UTC) Received: by mail-oa0-f69.google.com with SMTP id h16sf1538296oag.0 for ; Tue, 28 Jan 2014 06:33:45 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:delivered-to:from:to:cc:subject :date:message-id:in-reply-to:references:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :list-post:list-help:list-archive:list-unsubscribe; bh=LdzXKi46E6SO5barnoRWc8Pr/+r6pRejeS2FUJssbm8=; b=IJ+xlm0XMlPgzj0rV/61hM4FYwLT1t3ZJ+L39eWRjY3VHQtEXEjjhvMxWnsSGbhc8d cQY4TxSFSLRWds56Bxt7QlxzgiqdHYV+GlCYOnuZV0w1NjJUTls3IqkVgMr3H7NlLmWY Jm154K8Rs5uC4ULbr04gb1/b8b7abuCcJdWfGIVA8YgDwWTUBBFtjNByCDZmzBFRTsx1 P+SYtRP77/uEIORb7fPfMNHfjvdObbQxk8cuurUTgYrpdISdicg0VjXJkdd2S0RQLs/t 7MYSy5KqPoOJCErx2PdqMCxMT94XxyRXixrnskcSkxCvZnS24INBPUcom4N1L7pe1zwV QBEg== X-Gm-Message-State: ALoCoQnsaKaCphK90R1GLgx3LMPsQ9uED16y4a3oV+4Dzf7Fec6Kpzh/9OX0bl7enMFiWezxtgzk X-Received: by 10.182.66.73 with SMTP id d9mr641320obt.8.1390919625172; Tue, 28 Jan 2014 06:33:45 -0800 (PST) MIME-Version: 1.0 X-BeenThere: patchwork-forward@linaro.org Received: by 10.140.95.119 with SMTP id h110ls2005020qge.54.gmail; Tue, 28 Jan 2014 06:33:45 -0800 (PST) X-Received: by 10.52.189.33 with SMTP id gf1mr1165365vdc.26.1390919625075; Tue, 28 Jan 2014 06:33:45 -0800 (PST) Received: from mail-ve0-f177.google.com (mail-ve0-f177.google.com [209.85.128.177]) by mx.google.com with ESMTPS id sg4si665920vdc.92.2014.01.28.06.33.45 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Tue, 28 Jan 2014 06:33:45 -0800 (PST) Received-SPF: neutral (google.com: 209.85.128.177 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) client-ip=209.85.128.177; Received: by mail-ve0-f177.google.com with SMTP id jz11so286181veb.8 for ; Tue, 28 Jan 2014 06:33:45 -0800 (PST) X-Received: by 10.52.106.107 with SMTP id gt11mr1154339vdb.7.1390919625004; Tue, 28 Jan 2014 06:33:45 -0800 (PST) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patches@linaro.org Received: by 10.220.174.196 with SMTP id u4csp34866vcz; Tue, 28 Jan 2014 06:33:44 -0800 (PST) X-Received: by 10.152.27.133 with SMTP id t5mr2538lag.66.1390919623758; Tue, 28 Jan 2014 06:33:43 -0800 (PST) Received: from mail-la0-f41.google.com (mail-la0-f41.google.com [209.85.215.41]) by mx.google.com with ESMTPS id my6si7037882lbb.67.2014.01.28.06.33.43 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Tue, 28 Jan 2014 06:33:43 -0800 (PST) Received-SPF: neutral (google.com: 209.85.215.41 is neither permitted nor denied by best guess record for domain of will.newton@linaro.org) client-ip=209.85.215.41; Received: by mail-la0-f41.google.com with SMTP id mc6so408256lab.14 for ; Tue, 28 Jan 2014 06:33:43 -0800 (PST) X-Received: by 10.152.9.65 with SMTP id x1mr1278442laa.6.1390919623011; Tue, 28 Jan 2014 06:33:43 -0800 (PST) Received: from localhost.localdomain (cpc6-seac21-2-0-cust453.7-2.cable.virginm.net. [82.1.113.198]) by mx.google.com with ESMTPSA id bo10sm16883708lbb.16.2014.01.28.06.33.41 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Jan 2014 06:33:42 -0800 (PST) From: Will Newton To: libc-alpha@sourceware.org Cc: patches@linaro.org Subject: [PATCH 2/2] manual/probes.texi: Add documentation of setjmp/longjmp probes Date: Tue, 28 Jan 2014 14:33:34 +0000 Message-Id: <1390919614-30727-2-git-send-email-will.newton@linaro.org> X-Mailer: git-send-email 1.8.1.4 In-Reply-To: <1390919614-30727-1-git-send-email-will.newton@linaro.org> References: <1390919614-30727-1-git-send-email-will.newton@linaro.org> X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: will.newton@linaro.org X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 209.85.128.177 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Precedence: list Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org List-ID: X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Add some documentation of the setjmp, longjmp and longjmp_target Systemtap probe points. ChangeLog: 2014-01-28 Will Newton * manual/probes.texi (Internal Probes): Add documentation of setjmp and longjmp probes. --- manual/probes.texi | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/manual/probes.texi b/manual/probes.texi index 25d06e5..f825850 100644 --- a/manual/probes.texi +++ b/manual/probes.texi @@ -17,6 +17,7 @@ arguments. @menu * Memory Allocation Probes:: Probes in the memory allocation subsystem * Mathematical Function Probes:: Probes in mathematical functions +* setjmp and longjmp Probes:: Probes in setjmp and longjmp @end menu @node Memory Allocation Probes @@ -368,3 +369,37 @@ results in multiple precision computation with precision 32. Argument @var{$arg1} is the input to the function, @var{$arg2} is the error bound of @var{$arg1} and @var{$arg3} is the computed result. @end deftp + +@node setjmp and longjmp Probes +@section setjmp and longjmp Probes + +These probes can be used to notify the debugger of a call to @code{setjmp}, +@code{sigsetjmp} or @code{longjmp}. + +@deftp Probe setjmp (void *@var{$arg1}, int @var{$arg2}, void *@var{$arg3}) +This probe is hit whenever @code{setjmp} or @code{sigsetjmp} is called. +Argument @var{$arg1} is a pointer to the @code{jmp_buf} passed as the first +argument of @code{setjmp} or @code{sigsetjmp}, @var{$arg2} is the second +argument of @code{sigsetjmp} or zero if this is a call to @code{setjmp} +and @var{$arg3} is a pointer to the return address that will be stored +in the @code{jmp_buf}. +@end deftp + +@deftp Probe longjmp (void *@var{$arg1}, int @var{$arg2}, void *@var{$arg3}) +This probe is hit whenever @code{longjmp} is called. Argument @var{$arg1} +is a pointer to the @code{jmp_buf} passed as the first argument of +@code{longjmp}, @var{$arg2} is the return value passed as the second +argument of @code{longjmp} and @var{$arg3} is a pointer to the return +address @code{longjmp} will return to. +@end deftp + +@deftp Probe longjmp_target (void *@var{$arg1}, int @var{$arg2}, void *@var{$arg3}) +This probe is hit whenever @code{longjmp} is called. Argument @var{$arg1} +is a pointer to the @code{jmp_buf} passed as the first argument of +@code{longjmp}, @var{$arg2} is the return value passed as the second +argument of @code{longjmp} and @var{$arg3} is a pointer to the return +address @code{longjmp} will return to. + +This probe is implemented on some architectures. It is not clear how it +differs from the @code{longjmp} probe and it is not used by gdb. +@end deftp