From patchwork Thu Feb 2 11:52:25 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Burgess X-Patchwork-Id: 64145 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 86DDB3858431 for ; Thu, 2 Feb 2023 11:52:54 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 86DDB3858431 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1675338774; bh=EwifQjOPrv9GEQfv9yG7sKLgewN6T65E/Yai8X9h4eg=; h=To:Cc:Subject:Date:List-Id:List-Unsubscribe:List-Archive: List-Post:List-Help:List-Subscribe:From:Reply-To:From; b=aluOoGZEKayALG0mMv/G2CFxJBLk7f4P/yH43M/KG31jx6Oq61c2jZLQDEBZOqFrq kk21gMEhQbenh10HzvFRc1TohbvcCRcJ9WVr5R7ESbIm81sZssWn5wiAX7Cojzibgh c4YF5FXH5jOczXtQT5RZiWf49/PsOti5Veqvvx6g= X-Original-To: gdb-patches@sourceware.org Delivered-To: gdb-patches@sourceware.org Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id 141013858C60 for ; Thu, 2 Feb 2023 11:52:31 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 141013858C60 Received: from mail-qk1-f200.google.com (mail-qk1-f200.google.com [209.85.222.200]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_128_GCM_SHA256) id us-mta-487-Npe_bwRdMEKsHOoAN0Ym8A-1; Thu, 02 Feb 2023 06:52:29 -0500 X-MC-Unique: Npe_bwRdMEKsHOoAN0Ym8A-1 Received: by mail-qk1-f200.google.com with SMTP id h13-20020a05620a244d00b006fb713618b8so1210042qkn.0 for ; Thu, 02 Feb 2023 03:52:29 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=EwifQjOPrv9GEQfv9yG7sKLgewN6T65E/Yai8X9h4eg=; b=shOgIQi70NaMykiF1tNJO8lCGy7vTIVc/T3bhc7uIXVubfg/AcI0i5s/ValcmKPmvA T+BY5xzk639GRwy220i3gynWOiL9LiR5DHS35C8DhJ1Zvkoy9O3iC+9Ofm5scljqV+bM 6HRIbISBo/dVspAuMITrwtgNf4hF0wtLuu0nvUXrrnyXtwwIPiHDLowwNPIuP7lW5fDH M7giVtqKJdWm3XJhDoI1PtzZoxZCejJi6a/IkmiragV6ludaZCYfl2/HyQZM6axH6zHM 46RMKLkbiFbQeRd2WLtoAQIZlpwCbgjcirMr6xp6uBfQHVl3BlLGJVDocBldNFjlRLSH uhvw== X-Gm-Message-State: AO0yUKVIT4nenqEImhn/f2N9Dfo/UPqOee+gs3FFf8s3j+/lTN9dnPg/ 4OJZY0Hbi+pnqLpPcB77EvnyiUT81A1DEFgPXAypQMImYP/mIGe0sPULQnYcXt7mvYqbk2EOovn D9k0aDQvrXduOxeuRQmFHk/7DuLMwcam57DoQsG7DzQcF96+ONlATo7zQb0yY8722amLsFqvwgw == X-Received: by 2002:ac8:59cc:0:b0:3b9:b1ea:2d0f with SMTP id f12-20020ac859cc000000b003b9b1ea2d0fmr10900203qtf.34.1675338749094; Thu, 02 Feb 2023 03:52:29 -0800 (PST) X-Google-Smtp-Source: AK7set/gAQPo/zToW8MHL/nah60u2lPjUERHa3vXX3dP/nBuKWuAONu9L/M4diAbJqLOTgIZZhAPJg== X-Received: by 2002:ac8:59cc:0:b0:3b9:b1ea:2d0f with SMTP id f12-20020ac859cc000000b003b9b1ea2d0fmr10900179qtf.34.1675338748780; Thu, 02 Feb 2023 03:52:28 -0800 (PST) Received: from localhost (95.72.115.87.dyn.plus.net. [87.115.72.95]) by smtp.gmail.com with ESMTPSA id d9-20020a05620a140900b0071c9eea2056sm9815294qkj.14.2023.02.02.03.52.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 02 Feb 2023 03:52:28 -0800 (PST) To: gdb-patches@sourceware.org Cc: Andrew Burgess Subject: [PATCH] gdb/doc: extend the documentation for the 'handle' command Date: Thu, 2 Feb 2023 11:52:25 +0000 Message-Id: X-Mailer: git-send-email 2.25.4 MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-Spam-Status: No, score=-11.8 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Andrew Burgess via Gdb-patches From: Andrew Burgess Reply-To: Andrew Burgess Errors-To: gdb-patches-bounces+patchwork=sourceware.org@sourceware.org Sender: "Gdb-patches" The documentation for the 'handle' command does not cover all of the features of the command, and in one case, is just wrong. The user can specify 'all' as signal name, the documentation implies that this will change the behaviour of all signals, in reality, this changes all signals except SIGINT and SIGTRAP (the signals used by GDB). I've updated the docs to list this limitation. The 'handle' command also allows the user to specify multiple signals for a single command, e.g. 'handle SIGFPE SIGILL nostop pass print', however the documentation doesn't describe this, so I've updated the docs to describe this feature. --- gdb/doc/gdb.texinfo | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) base-commit: cded17bfca35566fa4d36e9ec06fa071bd7dab17 diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 03033c7f9e3..30b699f3d31 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -6760,13 +6760,14 @@ for details about this command. @kindex handle -@item handle @var{signal} @r{[}@var{keywords}@dots{}@r{]} -Change the way @value{GDBN} handles signal @var{signal}. The @var{signal} -can be the number of a signal or its name (with or without the -@samp{SIG} at the beginning); a list of signal numbers of the form -@samp{@var{low}-@var{high}}; or the word @samp{all}, meaning all the -known signals. Optional arguments @var{keywords}, described below, -say what change to make. +@item handle @var{signal} @r{[} @var{signal} @dots{} @r{]} @r{[}@var{keywords}@dots{}@r{]} +Change the way @value{GDBN} handles each @var{signal}. Each +@var{signal} can be the number of a signal or its name (with or +without the @samp{SIG} at the beginning); a list of signal numbers of +the form @samp{@var{low}-@var{high}}; or the word @samp{all}, meaning +all the known signals, except @code{SIGINT} and @code{SIGTRAP}, which +are used by @value{GDBN}. Optional argument @var{keywords}, described +below, say what changes to make to all of the specified signals. @end table @c @group