From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id iKvqNofRZWcWcCUAWB0awg (envelope-from ) for ; Fri, 20 Dec 2024 15:20:23 -0500 Authentication-Results: simark.ca; dkim=pass (2048-bit key; secure) header.d=adacore.com header.i=@adacore.com header.a=rsa-sha256 header.s=google header.b=MqxvkjZx; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id DD7461E097; Fri, 20 Dec 2024 15:20:23 -0500 (EST) X-Spam-Checker-Version: SpamAssassin 4.0.0 (2022-12-13) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-5.4 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED autolearn=unavailable autolearn_force=no version=4.0.0 Received: from server2.sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 8CBD61E091 for ; Fri, 20 Dec 2024 15:20:23 -0500 (EST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 425563858C53 for ; Fri, 20 Dec 2024 20:20:23 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 425563858C53 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, secure) header.d=adacore.com header.i=@adacore.com header.a=rsa-sha256 header.s=google header.b=MqxvkjZx Received: from mail-io1-xd2d.google.com (mail-io1-xd2d.google.com [IPv6:2607:f8b0:4864:20::d2d]) by sourceware.org (Postfix) with ESMTPS id 4E7DA3858D26 for ; Fri, 20 Dec 2024 20:19:48 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 4E7DA3858D26 Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=adacore.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=adacore.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 4E7DA3858D26 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2607:f8b0:4864:20::d2d ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1734725988; cv=none; b=X4yzOM0QUosYrexksKOO1m6TETDW/5+Mqb7Twqwi/Hr/ZrltIyRK6LT/Nmf2R88qN0l3IDLBBH0DB70Qfo1o+zhkH1QUxI65jmSlbZY4j3lpbZy1kyV2cqgaafnImSI6CvBEHfIKFbjwohhLC3leUisKQSM+cYT9tq3ol2d/des= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1734725988; c=relaxed/simple; bh=VDcLF6w9R2JHjZQmv4u4lYOnrBeIUh26oTwMznHu3Ic=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=bJst3r2477Vh5dy8rlHIqtngzeTjCBoW6+DMr50BHNW+Bxy241f5UmzR8aFT/wLKnOTv00/qbjss3hZ1HNZbkA/FxaEGwn7UxC8h+2cW+mvVBV534jEqmSVVn/fxIqRzBmgZnUo0dI/lFAbKH8POh9D+iZ0Mf4S9B6LMRufvKu4= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4E7DA3858D26 Received: by mail-io1-xd2d.google.com with SMTP id ca18e2360f4ac-844e6d1283aso117000239f.1 for ; Fri, 20 Dec 2024 12:19:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=adacore.com; s=google; t=1734725987; x=1735330787; darn=sourceware.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=+dpxrH3MA7XLotkNlXoRFFZ/LilkTHqOWvIHxqYt6es=; b=MqxvkjZxV9m7PCBsKYLATSz5GcoZvgvj94H2/HrvP6P1ZXaj1IyO77jIzdFA0+fB6G Pm4cIq9l1KEzjZVw8z15VtsEmcpb4v0iUvQtSKgAMzDoOe7CLSxLQrUhMexGWw0iUSdu JUcOQ2IB0JC6FF1x5RIU9yA1nRbzplUKX4fcO97H3k6GJ5aQvYP8J+VSSCvqC6xg1B13 dv7OGp5oCoB63HdomDFXsd1dS4T+kFyVUqP7lLppKgpsa9DR4na3p5xcil6bn6TNS6iL T4vu8G4vS/AgXBj+NxXx2HPezIM/UCVD8en0gapvLPZ52Wd2PhLpIDwFXfuUcsWu0gp3 08hw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1734725987; x=1735330787; 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=+dpxrH3MA7XLotkNlXoRFFZ/LilkTHqOWvIHxqYt6es=; b=t8bFCVraKXoJygxghYXuWZyYKp4VRZwO7Sc/zwDdzvtevJ3OfoJK4odOte8h5gaWNg +mt13vTkbldhqHgchKuaRu/8trVdQMuiOurJfP3d8XpDNtn2QEmrRjNgA1jV9Hill34/ VFbO/3jHU8AMywGAcwjweg7cRaU5Diqb0OD+1dn9W6vnc4HOVLF9r/H+QaA13Oqoh3f/ RX/xuhYUkQebfa9A6uUtoJOhVIuQ3niY+rWp6XbGGn08Tr8KRZ9W5UG1afhfCWHj4wlq F56sRTJeeWlRumuNEWiuNf9JyKUo09SqjFGRC8jK5uvmPHtXxwjJFam8Vf15rwVhQ2vS KNfA== X-Gm-Message-State: AOJu0YzapIbrEKVpgmaiA1w9FpZ22EvZaO1R0mr4p/zPWqvAATBZeHTO cC2CdYiQemv1eSTKXOIkJ572oaEhoxjiLqU2oJBOxK2qxQn90/KcsFvh2YvYbxdsV7CSw5evpq8 = X-Gm-Gg: ASbGnctCw0VkCYaixQJNo2Pl2XbKpiKPPvUORo97icaam6PbEYjAGWZhhtVDWI7GxUT wIX9Y7FY2q80F3BcgiYcfDv6jojAZebwXh9UG5459ukTyv0jtCzq1ntopt1+CrPz+IfKeDlkLzU t7ARdWMPqiFCHrs2Pal8vW387bMQx5Bscp34/ojpSd6KhENEp88zGoscR63hpsoiRWoSheeKV/8 8UPMlfKgykpjYCrSfgHYdVInh5ZeSecQYdCHFL2PIfx01s3pkQczZPn5Qx15801s6NgB4oCBUd1 8/X5QdpJaFCu43H7Au8Q2p8= X-Google-Smtp-Source: AGHT+IGIlrqQM8sErCt7LVavn9u/UkpQpAcmHkYewV5LUZQxVZkl0uVWY4lZczEJhMju82Ij9Am0Cw== X-Received: by 2002:a05:6602:198:b0:82c:ec0f:a081 with SMTP id ca18e2360f4ac-8498871161amr676702339f.4.1734725987578; Fri, 20 Dec 2024 12:19:47 -0800 (PST) Received: from localhost.localdomain (97-122-113-155.hlrn.qwest.net. [97.122.113.155]) by smtp.gmail.com with ESMTPSA id 8926c6da1cb9f-4e68bf4f394sm994933173.25.2024.12.20.12.19.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Dec 2024 12:19:47 -0800 (PST) From: Tom Tromey To: gdb-patches@sourceware.org Cc: Tom Tromey Subject: [PATCH] Clarify documentation of signal numbers Date: Fri, 20 Dec 2024 13:19:40 -0700 Message-ID: <20241220201940.3235367-1-tromey@adacore.com> X-Mailer: git-send-email 2.47.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces~public-inbox=simark.ca@sourceware.org A user was confused by the meaning of signal numbers in the gdb CLI. For instance, when using "signal 3", exactly which signal is delivered? Is it always 3, or is it always SIGQUIT? This patch attempts to clarify the documentation here. Let me know what you think. I'm not sure this is phrased in the clearest way possible. --- gdb/doc/gdb.texinfo | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 7b6000abbea..28a29edbd7c 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -6882,6 +6882,17 @@ fatal so it can carry out the purpose of the interrupt: to kill the program. program. You can tell @value{GDBN} in advance what to do for each kind of signal. +When specifying a signal by number, @value{GDBN} translates the number +to the target platform according to the corresponding signal name. +For example, @value{GDBN} always treats signal 1 as @code{SIGHUP}. +So, when specifying @samp{1} as a signal, @value{GDBN} will translate +this to the target's @code{SIGHUP}, whatever that might be. + +Numbers may only be used for signals 1 through 15. Where POSIX +specifies a signal's number, @value{GDBN} uses the same value. +Additionally, @value{GDBN} uses 7 for @code{SIGEMT}, 10 for +@code{SIGBUS}, and 12 for @code{SIGSYS}. + @cindex handling signals Normally, @value{GDBN} is set up to let the non-erroneous signals like @code{SIGALRM} be silently passed to your program -- 2.47.0