From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id 0OGIBo1hZmeidSYAWB0awg (envelope-from ) for ; Sat, 21 Dec 2024 01:34:53 -0500 Authentication-Results: simark.ca; dkim=pass (2048-bit key; unprotected) header.d=gnu.org header.i=@gnu.org header.a=rsa-sha256 header.s=fencepost-gnu-org header.b=bH1nfyue; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 177E61E097; Sat, 21 Dec 2024 01:34:53 -0500 (EST) X-Spam-Checker-Version: SpamAssassin 4.0.0 (2022-12-13) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-6.4 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIMWL_WL_HIGH,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 9B8D91E05C for ; Sat, 21 Dec 2024 01:34:52 -0500 (EST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 45C0B3858404 for ; Sat, 21 Dec 2024 06:34:52 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 45C0B3858404 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=gnu.org header.i=@gnu.org header.a=rsa-sha256 header.s=fencepost-gnu-org header.b=bH1nfyue Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id E476F3858D3C for ; Sat, 21 Dec 2024 06:34:21 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org E476F3858D3C Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gnu.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gnu.org ARC-Filter: OpenARC Filter v1.0.0 sourceware.org E476F3858D3C Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2001:470:142:3::10 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1734762862; cv=none; b=U9m3ppZa2r6DGl0brAcM62Vcsn6UQcULmRvd0cWqsG8Gw12Xxd4XFqm9HyJSi6xs2Jl6Z+VkQpeTWsjocxF/ITJJTeH6T+N9tJRZqSakqpx7eqkDzFCQYLbqA+hyLC3E0eE6S9n3wCOEN0m8WRoEV6OnrhOibvhICM/54Irbkr8= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1734762862; c=relaxed/simple; bh=vPGllrLIE3nty6LiJDB9dITyjPbJRlbcb2lyRV63WD0=; h=DKIM-Signature:Date:Message-Id:From:To:Subject; b=P+Wwophd3qmeEpzexfsgMsmCWJbadYy7w6DI8mdydegcqTgu/ksrVuLkDxcOxRPzImbcQfJJ3A1cdS3psVLfz4YtfyugErzGx2hf+ivhxyEnb89EFTReOlLPi9uI0v9PaVyOdch8IIZa0mSzSClO6QtsPBv7uskHrsbniWhBkrs= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org E476F3858D3C Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tOt49-00027I-23; Sat, 21 Dec 2024 01:34:21 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=Dbo6cMTUQrqf2BdjxUFVsKx7TXR9miW+80C2D99R5mk=; b=bH1nfyueQGUt k9Ql5koxGIgYVxwHVuKY+1pklxVJVnZcaMJwZEuwxfWGl3Lmu2IcNKgpbyF7UXJyffvJ5WCyiI4kD TEZywLFABNFP/3IdpMYjf910qH2JwV9pI8BahkHoAIf436B1E+a7oPgISeohZGYG0smHjnjZXApNq qX0djlyO1+h6DZjFMWxwGX3mmsNAew9OAhgD/uSpxoXAg2gpQqoG2vyxCrrriFObiEdFktWriLlHK gRxsdDQjL+xqF8LHxCk1ImsxkqA0r1wTCPNM5Doduz1xFuU+bjQtXQ85iQ7X+wEp0nnEVvLA5IBWc r9dvZMikylrmoddiODrqqg==; Date: Sat, 21 Dec 2024 08:34:19 +0200 Message-Id: <867c7ta6j8.fsf@gnu.org> From: Eli Zaretskii To: Tom Tromey Cc: gdb-patches@sourceware.org In-Reply-To: <20241220201940.3235367-1-tromey@adacore.com> (message from Tom Tromey on Fri, 20 Dec 2024 13:19:40 -0700) Subject: Re: [PATCH] Clarify documentation of signal numbers References: <20241220201940.3235367-1-tromey@adacore.com> 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 > From: Tom Tromey > Cc: Tom Tromey > Date: Fri, 20 Dec 2024 13:19:40 -0700 > > 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. It's clear enough, IMO. But I wonder whether we should simply have a table of POSIX signal numbers 1-15 and the corresponding names, as GDB converts them. Then the examples you show (which describe just some of those conversions) will be unnecessary, and we only need to say that signals 1-15 are interpreted as POSIX says and as shown in the table. A table is IMO better because if someone uses GDB on a non-POSIX platform, they don't necessarily have easy access to header files on a POSIX platform to find out which signal is, say, signal 11. So the only way for them to know is to type (gdb) handle 11 stop and see what GDB shows in response, which is not always possible/convenient. Thanks.