From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id WC6aDCwYfGebUgUAWB0awg (envelope-from ) for ; Mon, 06 Jan 2025 12:51:40 -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=dXG/sB/4; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 2F30D1E097; Mon, 6 Jan 2025 12:51:40 -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 A15F81E05C for ; Mon, 6 Jan 2025 12:51:39 -0500 (EST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 37A323858C42 for ; Mon, 6 Jan 2025 17:51:39 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 37A323858C42 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=dXG/sB/4 Received: from mail-io1-xd2a.google.com (mail-io1-xd2a.google.com [IPv6:2607:f8b0:4864:20::d2a]) by sourceware.org (Postfix) with ESMTPS id C01923858D21 for ; Mon, 6 Jan 2025 17:51:05 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org C01923858D21 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 C01923858D21 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2607:f8b0:4864:20::d2a ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1736185865; cv=none; b=V1DKJONQHY3CTItBD74y/VbFzdrSW06HDq7fqjzrZE7F6ZKSHxruxJJlbKVHCBJKhh5kFNdaJ8mPXRL7bpg5J/XKCoLCBEnT+A9GoyNEfshbSqBeAh5kQevzuCRM4n8ubDPalBeaI+TlUXFBGH7ob0I8tJSY64iYvdj6zek2gfQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1736185865; c=relaxed/simple; bh=d+23hfYb0yxenj3gZfy4UqHzpj10wQSeBHgYcDTMJ2k=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=qV9TqmGINsRwlRUa8Fkb3y47DH8NfgVffTjFGe0kVspY9a9B035fxgnWnUIpfch6wkuC2y1qn7w5Mql7dP3DUAkBLVBeYGwm1CI9Hvmvw1Ub53TOKaAdsP88pbs3xdbBQskOvEHOYyYomosIlPZQwJGpAOJozgXCRqz15MOdFnk= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C01923858D21 Received: by mail-io1-xd2a.google.com with SMTP id ca18e2360f4ac-844eb33827eso537829139f.2 for ; Mon, 06 Jan 2025 09:51:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=adacore.com; s=google; t=1736185864; x=1736790664; darn=sourceware.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=uqZXx7mFgkruf0I8FN3AUpIrVDrj/qwZQl/YpUtEkLM=; b=dXG/sB/4hmoom05utUMyJiGDyjGbww81TOs85g/tHLs2ukEmTudCxIvj657pZarFkB sUtCFvFlXBbQsLnXmfi9X3UC/9XRIHhn+CTqqIi7VD/eHev4DINSFWkj08vh4wDXNlP/ wZcXFxeOIw5yiScna4l63+fHdvL7Vk0NUAO45VyiI2rprVW91toMm/qsYIQ0ZdfNs+B/ r1SaoKlXQrhd8aLDRFHjD4JZoPElJySDIlCWwzRrDQcA4puQ8tr2T5thTNvoUu17MSGI wWC4mpx2g6tYrG77O9jl7xjR9IHQ+Lw08JSHnukIxCGvUo5JSTQD415K3yvD1GFhgQK3 oDnA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1736185864; x=1736790664; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=uqZXx7mFgkruf0I8FN3AUpIrVDrj/qwZQl/YpUtEkLM=; b=fz3fJQxcSZEvUiqd3LvuhCuTMXRESna6AbrU0KrRyc6cBwPpch0m15Ybvh2vbjl92o 3x3QhKrDkzEV3fhkup6pTlB3O63pRjeOa9vsxIjmBBYeoM0ufEAVVZPYJfy43cR0Uzkh V2T/iNSVWlZz+hu6gBg5c5CBuMb0uSDrl12mWBZkQF+mNh8ilPl2RsNSPkmsIg2UQWOe V6JaUz9wvB+lGuOTOZOzRx09E5NcrEradzQjCIronfsVPsq3wMbYWmELQpa+oF02DADt nKJvmVWBM1hc7kFFczPIO5ShdwpAa2cDu2DmKjTt94/pM2icVRlBsckiGQPHO0NSghYb VPug== X-Forwarded-Encrypted: i=1; AJvYcCVA+hVCjjwD+xsrI3JaMczUjLRhC6retFy4N39fncI9kJcKyrcRiU56uihBRPHuHeSEzepwysMTby/rbQ==@sourceware.org X-Gm-Message-State: AOJu0YyOJ8LXKeGAw2JRS4lmpQxujZGv2xB2fuD34GYumKCf8tf5XQvm OYKyV8GdtikXtSHeiY5FuQi2uAsVBBtdGraP4nC35ipuDyn5SD1qiUwbtirYBg== X-Gm-Gg: ASbGnct7PwQt/VVrbgmz00NXt7GAMIn6Zhu6DjN3cKG+VO38mV0+DgodtZidOooHHTr 8E9uw6YjEVSH+00VlKYDqdRAc0OxlPFTPftlUBkFvVG0gJPY4/zCbf6cYMkuhfrAJyVwqucOSOn VBYrCCQf5EktyEvoN4dAw0Fnt2iSoPQaUmjeqS+nwrou+u9tWzw58WgRUCuswZ+rrpmi/bZj0k4 MiJEUzhyF9bV8sWrQvRJOuTKWVQhqnyJjVLCyga+iWBHY7JEidcrrztFfE/erOl5SbfXWGctqCV moPjBg== X-Google-Smtp-Source: AGHT+IGHTqB8k0fcSE5UviOI+0gGtg3c9KwZhCSSy22zlWot3LGHB+ftdVAYPOZSbe6RAYctAvXFnw== X-Received: by 2002:a05:6602:1611:b0:844:c9b1:f08f with SMTP id ca18e2360f4ac-8499e4a8937mr6159417139f.3.1736185864130; Mon, 06 Jan 2025 09:51:04 -0800 (PST) Received: from murgatroyd (97-118-36-154.hlrn.qwest.net. [97.118.36.154]) by smtp.gmail.com with ESMTPSA id ca18e2360f4ac-8498d4253c0sm885093739f.0.2025.01.06.09.51.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 Jan 2025 09:51:03 -0800 (PST) From: Tom Tromey To: Eli Zaretskii Cc: Tom Tromey , gdb-patches@sourceware.org Subject: Re: [PATCH] Clarify documentation of signal numbers In-Reply-To: <867c7ta6j8.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 21 Dec 2024 08:34:19 +0200") References: <20241220201940.3235367-1-tromey@adacore.com> <867c7ta6j8.fsf@gnu.org> X-Attribution: Tom Date: Mon, 06 Jan 2025 10:51:02 -0700 Message-ID: <875xmr6dbt.fsf@tromey.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain 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 >>>>> "Eli" == Eli Zaretskii writes: Eli> It's clear enough, IMO. But I wonder whether we should simply have a Eli> table of POSIX signal numbers 1-15 and the corresponding names, as GDB Eli> converts them. Yeah, that makes sense. I think I thought making a nice-looking table would be harder than it is. Here's v2, let me know what you think. Tom commit a21d3cb9b0588ee324ba3b59b462aefa216c2e32 Author: Tom Tromey Date: Fri Dec 20 13:16:17 2024 -0700 Clarify documentation of signal numbers 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. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index c77ac7f30c2..5c16361610c 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -6884,6 +6884,34 @@ 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. @value{GDBN} uses +this mapping: + +@multitable {Number} {SIGTERM} +@headitem Number @tab Name +@item 1 @tab SIGHUP +@item 2 @tab SIGINT +@item 3 @tab SIGQUIT +@item 4 @tab SIGILL +@item 5 @tab SIGTRAP +@item 6 @tab SIGABRT +@item 7 @tab SIGEMT +@item 8 @tab SIGFPE +@item 9 @tab SIGKILL +@item 10 @tab SIGBUS +@item 11 @tab SIGSEGV +@item 12 @tab SIGSYS +@item 13 @tab SIGPIPE +@item 14 @tab SIGALRM +@item 15 @tab SIGTERM +@end multitable + @cindex handling signals Normally, @value{GDBN} is set up to let the non-erroneous signals like @code{SIGALRM} be silently passed to your program