From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id 6bAmIr/Y+GkpGRMAWB0awg (envelope-from ) for ; Mon, 04 May 2026 13:34:55 -0400 Received: by simark.ca (Postfix, from userid 112) id 88D111E067; Mon, 04 May 2026 13:34:55 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-2.3 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED autolearn=ham autolearn_force=no version=4.0.1 Received: from vm01.sourceware.org (vm01.sourceware.org [38.145.34.32]) (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 DA73C1E067 for ; Mon, 04 May 2026 13:34:54 -0400 (EDT) Received: from vm01.sourceware.org (localhost [127.0.0.1]) by sourceware.org (Postfix) with ESMTP id 616744BAD17B for ; Mon, 4 May 2026 17:34:54 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 616744BAD17B Received: from mail-wm1-f54.google.com (mail-wm1-f54.google.com [209.85.128.54]) by sourceware.org (Postfix) with ESMTPS id 393194BAE7CC for ; Mon, 4 May 2026 17:33:55 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 393194BAE7CC Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=palves.net Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 393194BAE7CC Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=209.85.128.54 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1777916035; cv=none; b=Cf8vx7JkSi2DzyL5rEE1R7ufHhXry6cfgDy1KOMn9gmPSzrZrtdQ0F6dsiVf3OP8t7+UY/YUqspHk8DxSxjyaASqNNTcaQN25jalqSPFMw5x0/q47RdV39tetpXzvIwEZCrdJjiMWeopsq2+Z1/eDLJY5x7H5TS70r0/OE/xwbE= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1777916035; c=relaxed/simple; bh=efRAnjR/ielKhQp49EZkaWH2UdzLvcQQc/YpM9RyXp0=; h=From:To:Subject:Date:Message-ID:MIME-Version; b=NiaiGzc7AyrREzhlY3Usm2gvd0EvRQJArJil8u/bYtrkdp+4PkhvhYfxdtK1pfIUnjYyKBn1X4Gh3X9tN+rSXx6XYPIQ1NkICRKHp1u+lwaEGZluVA9KPTviLN5SYDJZdXT73mVzuzJBCuFzJgU9Fowud/jwK5yFSZwYpLmKnK0= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 393194BAE7CC Received: by mail-wm1-f54.google.com with SMTP id 5b1f17b1804b1-4891f625344so46316135e9.0 for ; Mon, 04 May 2026 10:33:55 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777916034; x=1778520834; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=sHiXK0itzbGHwd0fwJ4XvXoWcaa99WP2OmhzCe+XhLY=; b=kbcHgpYxaIPXNZ2SP9HNwDhX4xs05oW53caNN4sj+uCwbK1+jbOGgERxC+4PYhdbD4 CAb93MHs/nHyWuypy2GB16dtkuYLrFsi8uIPe52VxB6lvPZUmlSQwaI6UcijtE1OlSmX B1L99dsDtGsqRmeczfmDk1navMvJ+4n71jEIEXoOtgQ+0te0SA6P48tfNDmSn1AdrNYh 88YdFqSlcQm8kZ76H6WbZ9XoHm4M7BmbvFcvAp/8iF75X/syIsAsy046nT4w2tZZ+Vxq fpmEvZffYvZ3NWPmizrFsX5OW8s8arg5mbYJxYAhIuKcpXhau8q2u5QRTTZ6XcT+0vJe Q/hA== X-Gm-Message-State: AOJu0Ywed6SlKH+h0RNJmzUxacmF8o/A1p8iiR8jIw2oz6jc0naEZ3QY WpFQkUfem1cjjIR1PjeDdwa8vWY1WZcMc3+ZoKVGazpFDcL3Z8vyCkdb44zI3w== X-Gm-Gg: AeBDies+J5UVFABqj+2QIcu4VQK5HyK0w+Fpu4gkM1G01h57CXf1lY2OfW9O3sRGnMe suM7jfmIkKcbFAnVozkqBgMdTmEuNTQsbbeElp+r2cJBu1V0Wsn8C9KM5rBk8k1jFIJ0ghLxLfP MulW/tvaixgNz0sBUMF5Zbd48O+4cq45zGgd5SI5HdlTaXHW+EmLmaGgj0IWn7zd/VKj/WMmTwQ x008YXT9ViFmjVWaXHekBeu3hKiINJ4noieAPQ0T+0E4zhjHarOF/BV+M1m3aJNsDB5DSbJEJHW cCxK1cNbsKNmLLE388sqErAkp+dkK5VZispME56xFYd0u+pFapVic/bel5LxWSvjDxAZfpPPy7P KRQRDdZLvlpOIqMBLVe1/CNeLhe9NQA9XE2GOpSabiptq3lUj8bnsdNc4KneX2af3kB9hKF0T7A RoeTVNpf8mG3Q4BbWO0XH3NwHOLs0luFZA X-Received: by 2002:a05:600c:a10f:b0:48a:534a:eed8 with SMTP id 5b1f17b1804b1-48d1422bb48mr5456465e9.1.1777916033656; Mon, 04 May 2026 10:33:53 -0700 (PDT) Received: from localhost ([2001:8a0:facb:a800:f625:f0b7:9de7:360b]) by smtp.gmail.com with UTF8SMTPSA id 5b1f17b1804b1-48a8fefc638sm84831805e9.35.2026.05.04.10.33.52 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 04 May 2026 10:33:53 -0700 (PDT) From: Pedro Alves To: gdb-patches@sourceware.org Subject: [PATCH 2/3] gdb manual: Cygwin => Windows Date: Mon, 4 May 2026 18:33:41 +0100 Message-ID: <20260504173344.1278735-3-pedro@palves.net> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20260504173344.1278735-1-pedro@palves.net> References: <20260504173344.1278735-1-pedro@palves.net> 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 The Windows-specific commands are all documented in a section called "Cygwin native", even though the information there also applies to native/MinGW GDB. This is most probably because GDB first had a Cygwin port before it had a MinGW port, eons ago, and nobody updated the manual. This patch fixes it. Change-Id: Id9788fe2a2c36f4482bd701478f4105df79513bc commit-id:ebc5fee2 --- gdb/doc/gdb.texinfo | 50 +++++++++++++++++++++++++++------------------ 1 file changed, 30 insertions(+), 20 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index ab0216ff477..29d959e68f7 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -25473,7 +25473,7 @@ configurations. * BSD libkvm Interface:: Debugging BSD kernel memory images * Process Information:: Process information * DJGPP Native:: Features specific to the DJGPP port -* Cygwin Native:: Features specific to the Cygwin port +* Windows Native:: Features specific to the Windows port * Hurd Native:: Features specific to @sc{gnu} Hurd * Darwin:: Features specific to Darwin * FreeBSD:: Features specific to FreeBSD @@ -25886,10 +25886,11 @@ counts of various errors encountered so far. @end table -@node Cygwin Native +@node Windows Native @subsection Features for Debugging MS Windows PE Executables @cindex MS Windows debugging @cindex native Cygwin debugging +@cindex Windows-specific commands @cindex Cygwin-specific commands @value{GDBN} supports native debugging of MS Windows programs, including @@ -25904,10 +25905,13 @@ supports @kbd{C-@key{BREAK}} as an alternative interrupt key sequence, which can be used to interrupt the debuggee even if it ignores @kbd{C-c}. -There are various additional Cygwin-specific commands, described in +There are various additional Windows-specific commands, described in this section. Working with DLLs that have no debugging symbols is described in @ref{Non-debug DLL Symbols}. +The following commands are available in all native Windows +configurations, including Cygwin: + @table @code @kindex info w32 @item info w32 @@ -25956,23 +25960,6 @@ automatically, @code{0} will cause a dialog box with ``OK'' and terminate the crashing process (OK) or debug it (Cancel). @end itemize -@kindex set cygwin-exceptions -@cindex debugging the Cygwin DLL -@cindex Cygwin DLL, debugging -@item set cygwin-exceptions @var{mode} -If @var{mode} is @code{on}, @value{GDBN} will break on exceptions that -happen inside the Cygwin DLL. If @var{mode} is @code{off}, -@value{GDBN} will delay recognition of exceptions, and may ignore some -exceptions which seem to be caused by internal Cygwin DLL -``bookkeeping''. This option is meant primarily for debugging the -Cygwin DLL itself; the default value is @code{off} to avoid annoying -@value{GDBN} users with false @code{SIGSEGV} signals. - -@kindex show cygwin-exceptions -@item show cygwin-exceptions -Displays whether @value{GDBN} will break on exceptions that happen -inside the Cygwin DLL itself. - @kindex set new-console @item set new-console @var{mode} If @var{mode} is @code{on} the debuggee will @@ -26019,6 +26006,29 @@ debuggee seen by the debugger. This boolean value adds debug output concerning debuggee memory reads and writes by the debugger. +@end table + +@sp 1 +In addition, the following commands are available on Cygwin: + +@table @code +@kindex set cygwin-exceptions +@cindex debugging the Cygwin DLL +@cindex Cygwin DLL, debugging +@item set cygwin-exceptions @var{mode} +If @var{mode} is @code{on}, @value{GDBN} will break on exceptions that +happen inside the Cygwin DLL. If @var{mode} is @code{off}, +@value{GDBN} will delay recognition of exceptions, and may ignore some +exceptions which seem to be caused by internal Cygwin DLL +``bookkeeping''. This option is meant primarily for debugging the +Cygwin DLL itself; the default value is @code{off} to avoid annoying +@value{GDBN} users with false @code{SIGSEGV} signals. + +@kindex show cygwin-exceptions +@item show cygwin-exceptions +Displays whether @value{GDBN} will break on exceptions that happen +inside the Cygwin DLL itself. + @kindex set shell @item set shell This boolean values specifies whether the debuggee is called -- 2.53.0