From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 21657 invoked by alias); 20 Feb 2002 12:18:10 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 21550 invoked from network); 20 Feb 2002 12:18:06 -0000 Received: from unknown (HELO cerbere.u-strasbg.fr) (130.79.112.7) by sources.redhat.com with SMTP; 20 Feb 2002 12:18:06 -0000 Received: from laocoon (laocoon.u-strasbg.fr [130.79.112.72]) by cerbere.u-strasbg.fr (8.9.3/8.8.7) with ESMTP id NAA21786 for ; Wed, 20 Feb 2002 13:18:04 +0100 Message-Id: <4.2.0.58.20020220131638.00a484d0@ics.u-strasbg.fr> X-Sender: muller@ics.u-strasbg.fr X-Mailer: QUALCOMM Windows Eudora Pro Version 4.2.0.58 Date: Wed, 20 Feb 2002 04:18:00 -0000 To: gdb-patches@sources.redhat.com From: Pierre Muller Subject: [RFC] document Cygwin native specific commands Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" X-SW-Source: 2002-02/txt/msg00528.txt.bz2 Here is a third version of my patch to document Cygwin native specific commands. 2002-02-19 Pierre Muller * gdb.texinfo: Document Cygwin native specific commands. Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.90 diff -u -r1.90 gdb.texinfo --- gdb.texinfo 2002/02/15 19:06:33 1.90 +++ gdb.texinfo 2002/02/20 12:16:02 @@ -10487,6 +10487,7 @@ * HP-UX:: HP-UX * SVR4 Process Information:: SVR4 process information * DJGPP Native:: Features specific to the DJGPP port +* Cygwin Native:: Features specific to the Cygwin port @end menu @node HP-UX @@ -10683,6 +10684,92 @@ mapped 1:1, i.e.@: the physical and linear addresses are identical. This command is supported only with some DPMI servers. +@end table + +@node Cygwin Native +@subsection Features for Debugging MS Windows PE executables +@cindex MS Windows debugging +@cindex native Cygwin debugging +@cindex Cygwin-specific commands + +@value{GDBN} supports native debugging of MS Windows programs, and +defines a few commands specific to the Cygwin port. This +subsection describes those commands. + +@table @code +@kindex info w32 +@item info w32 +This is a prefix of MS Windows specific commands which print +information about the target system and important OS structures. + +@item info w32 selector +This command displays information returned by +the Win32 API @code{GetThreadSelectorEntry} function. +It takes an optional argument that is evaluated to +a long value to give the information about this given selector. +Without argument, this command displays information +about the the six segment registers. + +@kindex info dll +@item info dll +This is a Cygwin specific alias of info shared. + +@kindex dll-symbols +@item dll-symbols +This command loads symbols from a dll similarly to +add-sym command but without the need to specify a base address. + +@kindex set new-console +@item set new-console @var{mode} +If @var{mode} is @code{on} the debuggee will +be started in a new console on next start. +If @var{mode} is @code{off}i, the debuggee will +be started in the same console as the debugger. + +@kindex show new-console +@item show new-console +Displays whether a new console is used +when the debuggee is started. + +@kindex set new-group +@item set new-group @var{mode} +This boolean value controls whether the debuggee should +start a new group or stay in the same group as the debugger. +This affects the way the Windows OS handles +Ctrl-C. + +@kindex show new-group +@item show new-group +Displays current value of new-group boolean. + +@kindex set debugevents +@item set debugevents +This boolean value adds debug output concerning events seen by the debugger. + +@kindex set debugexec +@item set debugexec +This boolean value adds debug output concerning execute events +seen by the debugger. + +@kindex set debugexceptions +@item set debugexceptions +This boolean value adds debug ouptut concerning exception events +seen by the debugger. + +@kindex set debugmemory +@item set debugmemory +This boolean value adds debug ouptut concerning memory events +seen by the debugger. + +@kindex set shell +@item set shell +This boolean values specifies whether the debuggee is called +via a shell or directly (default value is on). + +@kindex show shell +@item show shell +Displays if the debuggee will be started with a shell. + @end table @node Embedded OS Pierre Muller Institut Charles Sadron 6,rue Boussingault F 67083 STRASBOURG CEDEX (France) mailto:muller@ics.u-strasbg.fr Phone : (33)-3-88-41-40-07 Fax : (33)-3-88-41-40-99