243 lines
12 KiB
HTML
243 lines
12 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<!-- This HTML file has been created by texi2html 1.51
|
|
from gdb.texinfo on 23 April 1998 -->
|
|
|
|
<TITLE>Debugging with GDB - Table of Contents</TITLE>
|
|
</HEAD>
|
|
<BODY>
|
|
<H1>Debugging with GDB</H1>
|
|
<H2>The GNU Source-Level Debugger</H2>
|
|
<H2>Fifth Edition, for GDB version </H2>
|
|
<H2>April 1998</H2>
|
|
<ADDRESS>Richard M. Stallman and Roland H. Pesch</ADDRESS>
|
|
<P>
|
|
<P><HR><P>
|
|
<UL>
|
|
<LI><A NAME="TOC1" HREF="gdb.html#SEC1">Summary of GDB</A>
|
|
<UL>
|
|
<LI><A NAME="TOC2" HREF="gdb.html#SEC2">Free software</A>
|
|
<LI><A NAME="TOC3" HREF="gdb.html#SEC3">Contributors to GDB</A>
|
|
</UL>
|
|
<LI><A NAME="TOC4" HREF="gdb.html#SEC4">A Sample GDB Session</A>
|
|
<LI><A NAME="TOC5" HREF="gdb.html#SEC5">Getting In and Out of GDB</A>
|
|
<UL>
|
|
<LI><A NAME="TOC6" HREF="gdb.html#SEC6">Invoking GDB</A>
|
|
<UL>
|
|
<LI><A NAME="TOC7" HREF="gdb.html#SEC7">Choosing files</A>
|
|
<LI><A NAME="TOC8" HREF="gdb.html#SEC8">Choosing modes</A>
|
|
</UL>
|
|
<LI><A NAME="TOC9" HREF="gdb.html#SEC9">Quitting GDB</A>
|
|
<LI><A NAME="TOC10" HREF="gdb.html#SEC10">Shell commands</A>
|
|
</UL>
|
|
<LI><A NAME="TOC11" HREF="gdb.html#SEC11">GDB Commands</A>
|
|
<UL>
|
|
<LI><A NAME="TOC12" HREF="gdb.html#SEC12">Command syntax</A>
|
|
<LI><A NAME="TOC13" HREF="gdb.html#SEC13">Command completion</A>
|
|
<LI><A NAME="TOC14" HREF="gdb.html#SEC14">Getting help</A>
|
|
</UL>
|
|
<LI><A NAME="TOC15" HREF="gdb.html#SEC15">Running Programs Under GDB</A>
|
|
<UL>
|
|
<LI><A NAME="TOC16" HREF="gdb.html#SEC16">Compiling for debugging</A>
|
|
<LI><A NAME="TOC17" HREF="gdb.html#SEC17">Starting your program</A>
|
|
<LI><A NAME="TOC18" HREF="gdb.html#SEC18">Your program's arguments</A>
|
|
<LI><A NAME="TOC19" HREF="gdb.html#SEC19">Your program's environment</A>
|
|
<LI><A NAME="TOC20" HREF="gdb.html#SEC20">Your program's working directory</A>
|
|
<LI><A NAME="TOC21" HREF="gdb.html#SEC21">Your program's input and output</A>
|
|
<LI><A NAME="TOC22" HREF="gdb.html#SEC22">Debugging an already-running process</A>
|
|
<LI><A NAME="TOC23" HREF="gdb.html#SEC23">Killing the child process</A>
|
|
<LI><A NAME="TOC24" HREF="gdb.html#SEC24">Additional process information</A>
|
|
<LI><A NAME="TOC25" HREF="gdb.html#SEC25">Debugging programs with multiple threads</A>
|
|
<LI><A NAME="TOC26" HREF="gdb.html#SEC26">Debugging programs with multiple processes</A>
|
|
</UL>
|
|
<LI><A NAME="TOC27" HREF="gdb.html#SEC27">Stopping and Continuing</A>
|
|
<UL>
|
|
<LI><A NAME="TOC28" HREF="gdb.html#SEC28">Breakpoints, watchpoints, and exceptions</A>
|
|
<UL>
|
|
<LI><A NAME="TOC29" HREF="gdb.html#SEC29">Setting breakpoints</A>
|
|
<LI><A NAME="TOC30" HREF="gdb.html#SEC30">Setting watchpoints</A>
|
|
<LI><A NAME="TOC31" HREF="gdb.html#SEC31">Breakpoints and exceptions</A>
|
|
<LI><A NAME="TOC32" HREF="gdb.html#SEC32">Deleting breakpoints</A>
|
|
<LI><A NAME="TOC33" HREF="gdb.html#SEC33">Disabling breakpoints</A>
|
|
<LI><A NAME="TOC34" HREF="gdb.html#SEC34">Break conditions</A>
|
|
<LI><A NAME="TOC35" HREF="gdb.html#SEC35">Breakpoint command lists</A>
|
|
<LI><A NAME="TOC36" HREF="gdb.html#SEC36">Breakpoint menus</A>
|
|
</UL>
|
|
<LI><A NAME="TOC37" HREF="gdb.html#SEC37">Continuing and stepping</A>
|
|
<LI><A NAME="TOC38" HREF="gdb.html#SEC38">Signals</A>
|
|
<LI><A NAME="TOC39" HREF="gdb.html#SEC39">Stopping and starting multi-thread programs</A>
|
|
</UL>
|
|
<LI><A NAME="TOC40" HREF="gdb.html#SEC40">Examining the Stack</A>
|
|
<UL>
|
|
<LI><A NAME="TOC41" HREF="gdb.html#SEC41">Stack frames</A>
|
|
<LI><A NAME="TOC42" HREF="gdb.html#SEC42">Backtraces</A>
|
|
<LI><A NAME="TOC43" HREF="gdb.html#SEC43">Selecting a frame</A>
|
|
<LI><A NAME="TOC44" HREF="gdb.html#SEC44">Information about a frame</A>
|
|
<LI><A NAME="TOC45" HREF="gdb.html#SEC45">MIPS machines and the function stack</A>
|
|
</UL>
|
|
<LI><A NAME="TOC46" HREF="gdb.html#SEC46">Examining Source Files</A>
|
|
<UL>
|
|
<LI><A NAME="TOC47" HREF="gdb.html#SEC47">Printing source lines</A>
|
|
<LI><A NAME="TOC48" HREF="gdb.html#SEC48">Searching source files</A>
|
|
<LI><A NAME="TOC49" HREF="gdb.html#SEC49">Specifying source directories</A>
|
|
<LI><A NAME="TOC50" HREF="gdb.html#SEC50">Source and machine code</A>
|
|
</UL>
|
|
<LI><A NAME="TOC51" HREF="gdb.html#SEC51">Examining Data</A>
|
|
<UL>
|
|
<LI><A NAME="TOC52" HREF="gdb.html#SEC52">Expressions</A>
|
|
<LI><A NAME="TOC53" HREF="gdb.html#SEC53">Program variables</A>
|
|
<LI><A NAME="TOC54" HREF="gdb.html#SEC54">Artificial arrays</A>
|
|
<LI><A NAME="TOC55" HREF="gdb.html#SEC55">Output formats</A>
|
|
<LI><A NAME="TOC56" HREF="gdb.html#SEC56">Examining memory</A>
|
|
<LI><A NAME="TOC57" HREF="gdb.html#SEC57">Automatic display</A>
|
|
<LI><A NAME="TOC58" HREF="gdb.html#SEC58">Print settings</A>
|
|
<LI><A NAME="TOC59" HREF="gdb.html#SEC59">Value history</A>
|
|
<LI><A NAME="TOC60" HREF="gdb.html#SEC60">Convenience variables</A>
|
|
<LI><A NAME="TOC61" HREF="gdb.html#SEC61">Registers</A>
|
|
<LI><A NAME="TOC62" HREF="gdb.html#SEC62">Floating point hardware</A>
|
|
</UL>
|
|
<LI><A NAME="TOC63" HREF="gdb.html#SEC63">Using GDB with Different Languages</A>
|
|
<UL>
|
|
<LI><A NAME="TOC64" HREF="gdb.html#SEC64">Switching between source languages</A>
|
|
<UL>
|
|
<LI><A NAME="TOC65" HREF="gdb.html#SEC65">List of filename extensions and languages</A>
|
|
<LI><A NAME="TOC66" HREF="gdb.html#SEC66">Setting the working language</A>
|
|
<LI><A NAME="TOC67" HREF="gdb.html#SEC67">Having GDB infer the source language</A>
|
|
</UL>
|
|
<LI><A NAME="TOC68" HREF="gdb.html#SEC68">Displaying the language</A>
|
|
<LI><A NAME="TOC69" HREF="gdb.html#SEC69">Type and range checking</A>
|
|
<UL>
|
|
<LI><A NAME="TOC70" HREF="gdb.html#SEC70">An overview of type checking</A>
|
|
<LI><A NAME="TOC71" HREF="gdb.html#SEC71">An overview of range checking</A>
|
|
</UL>
|
|
<LI><A NAME="TOC72" HREF="gdb.html#SEC72">Supported languages</A>
|
|
<UL>
|
|
<LI><A NAME="TOC73" HREF="gdb.html#SEC73">C and C++</A>
|
|
<UL>
|
|
<LI><A NAME="TOC74" HREF="gdb.html#SEC74">C and C++ operators</A>
|
|
<LI><A NAME="TOC75" HREF="gdb.html#SEC75">C and C++ constants</A>
|
|
<LI><A NAME="TOC76" HREF="gdb.html#SEC76">C++ expressions</A>
|
|
<LI><A NAME="TOC77" HREF="gdb.html#SEC77">C and C++ defaults</A>
|
|
<LI><A NAME="TOC78" HREF="gdb.html#SEC78">C and C++ type and range checks</A>
|
|
<LI><A NAME="TOC79" HREF="gdb.html#SEC79">GDB and C</A>
|
|
<LI><A NAME="TOC80" HREF="gdb.html#SEC80">GDB features for C++</A>
|
|
</UL>
|
|
<LI><A NAME="TOC81" HREF="gdb.html#SEC81">Modula-2</A>
|
|
<UL>
|
|
<LI><A NAME="TOC82" HREF="gdb.html#SEC82">Operators</A>
|
|
<LI><A NAME="TOC83" HREF="gdb.html#SEC83">Built-in functions and procedures</A>
|
|
<LI><A NAME="TOC84" HREF="gdb.html#SEC84">Constants</A>
|
|
<LI><A NAME="TOC85" HREF="gdb.html#SEC85">Modula-2 defaults</A>
|
|
<LI><A NAME="TOC86" HREF="gdb.html#SEC86">Deviations from standard Modula-2</A>
|
|
<LI><A NAME="TOC87" HREF="gdb.html#SEC87">Modula-2 type and range checks</A>
|
|
<LI><A NAME="TOC88" HREF="gdb.html#SEC88">The scope operators <CODE>::</CODE> and <CODE>.</CODE></A>
|
|
<LI><A NAME="TOC89" HREF="gdb.html#SEC89">GDB and Modula-2</A>
|
|
</UL>
|
|
</UL>
|
|
</UL>
|
|
<LI><A NAME="TOC90" HREF="gdb.html#SEC90">Examining the Symbol Table</A>
|
|
<LI><A NAME="TOC91" HREF="gdb.html#SEC91">Altering Execution</A>
|
|
<UL>
|
|
<LI><A NAME="TOC92" HREF="gdb.html#SEC92">Assignment to variables</A>
|
|
<LI><A NAME="TOC93" HREF="gdb.html#SEC93">Continuing at a different address</A>
|
|
<LI><A NAME="TOC94" HREF="gdb.html#SEC94">Giving your program a signal</A>
|
|
<LI><A NAME="TOC95" HREF="gdb.html#SEC95">Returning from a function</A>
|
|
<LI><A NAME="TOC96" HREF="gdb.html#SEC96">Calling program functions</A>
|
|
<LI><A NAME="TOC97" HREF="gdb.html#SEC97">Patching programs</A>
|
|
</UL>
|
|
<LI><A NAME="TOC98" HREF="gdb.html#SEC98">GDB Files</A>
|
|
<UL>
|
|
<LI><A NAME="TOC99" HREF="gdb.html#SEC99">Commands to specify files</A>
|
|
<LI><A NAME="TOC100" HREF="gdb.html#SEC100">Errors reading symbol files</A>
|
|
</UL>
|
|
<LI><A NAME="TOC101" HREF="gdb.html#SEC101">Specifying a Debugging Target</A>
|
|
<UL>
|
|
<LI><A NAME="TOC102" HREF="gdb.html#SEC102">Active targets</A>
|
|
<LI><A NAME="TOC103" HREF="gdb.html#SEC103">Commands for managing targets</A>
|
|
<LI><A NAME="TOC104" HREF="gdb.html#SEC104">Choosing target byte order</A>
|
|
<LI><A NAME="TOC105" HREF="gdb.html#SEC105">Remote debugging</A>
|
|
<UL>
|
|
<LI><A NAME="TOC106" HREF="gdb.html#SEC106">The GDB remote serial protocol</A>
|
|
<UL>
|
|
<LI><A NAME="TOC107" HREF="gdb.html#SEC107">What the stub can do for you</A>
|
|
<LI><A NAME="TOC108" HREF="gdb.html#SEC108">What you must do for the stub</A>
|
|
<LI><A NAME="TOC109" HREF="gdb.html#SEC109">Putting it all together</A>
|
|
<LI><A NAME="TOC110" HREF="gdb.html#SEC110">Communication protocol</A>
|
|
<LI><A NAME="TOC111" HREF="gdb.html#SEC111">Using the <CODE>gdbserver</CODE> program</A>
|
|
<LI><A NAME="TOC112" HREF="gdb.html#SEC112">Using the <CODE>gdbserve.nlm</CODE> program</A>
|
|
</UL>
|
|
<LI><A NAME="TOC113" HREF="gdb.html#SEC113">GDB with a remote i960 (Nindy)</A>
|
|
<UL>
|
|
<LI><A NAME="TOC114" HREF="gdb.html#SEC114">Startup with Nindy</A>
|
|
<LI><A NAME="TOC115" HREF="gdb.html#SEC115">Options for Nindy</A>
|
|
<LI><A NAME="TOC116" HREF="gdb.html#SEC116">Nindy reset command</A>
|
|
</UL>
|
|
<LI><A NAME="TOC117" HREF="gdb.html#SEC117">The UDI protocol for AMD29K</A>
|
|
<LI><A NAME="TOC118" HREF="gdb.html#SEC118">The EBMON protocol for AMD29K</A>
|
|
<UL>
|
|
<LI><A NAME="TOC119" HREF="gdb.html#SEC119">Communications setup</A>
|
|
<LI><A NAME="TOC120" HREF="gdb.html#SEC120">EB29K cross-debugging</A>
|
|
<LI><A NAME="TOC121" HREF="gdb.html#SEC121">Remote log</A>
|
|
</UL>
|
|
<LI><A NAME="TOC122" HREF="gdb.html#SEC122">GDB with a Tandem ST2000</A>
|
|
<LI><A NAME="TOC123" HREF="gdb.html#SEC123">GDB and VxWorks</A>
|
|
<UL>
|
|
<LI><A NAME="TOC124" HREF="gdb.html#SEC124">Connecting to VxWorks</A>
|
|
<LI><A NAME="TOC125" HREF="gdb.html#SEC125">VxWorks download</A>
|
|
<LI><A NAME="TOC126" HREF="gdb.html#SEC126">Running tasks</A>
|
|
</UL>
|
|
<LI><A NAME="TOC127" HREF="gdb.html#SEC127">GDB and Sparclet</A>
|
|
<UL>
|
|
<LI><A NAME="TOC128" HREF="gdb.html#SEC128">Setting file to debug</A>
|
|
<LI><A NAME="TOC129" HREF="gdb.html#SEC129">Connecting to Sparclet</A>
|
|
<LI><A NAME="TOC130" HREF="gdb.html#SEC130">Sparclet download</A>
|
|
<LI><A NAME="TOC131" HREF="gdb.html#SEC131">Running and debugging</A>
|
|
</UL>
|
|
<LI><A NAME="TOC132" HREF="gdb.html#SEC132">GDB and Hitachi microprocessors</A>
|
|
<UL>
|
|
<LI><A NAME="TOC133" HREF="gdb.html#SEC133">Connecting to Hitachi boards</A>
|
|
<LI><A NAME="TOC134" HREF="gdb.html#SEC134">Using the E7000 in-circuit emulator</A>
|
|
<LI><A NAME="TOC135" HREF="gdb.html#SEC135">Special GDB commands for Hitachi micros</A>
|
|
</UL>
|
|
<LI><A NAME="TOC136" HREF="gdb.html#SEC136">GDB and remote MIPS boards</A>
|
|
<LI><A NAME="TOC137" HREF="gdb.html#SEC137">Simulated CPU target</A>
|
|
</UL>
|
|
</UL>
|
|
<LI><A NAME="TOC138" HREF="gdb.html#SEC138">Controlling GDB</A>
|
|
<UL>
|
|
<LI><A NAME="TOC139" HREF="gdb.html#SEC139">Prompt</A>
|
|
<LI><A NAME="TOC140" HREF="gdb.html#SEC140">Command editing</A>
|
|
<LI><A NAME="TOC141" HREF="gdb.html#SEC141">Command history</A>
|
|
<LI><A NAME="TOC142" HREF="gdb.html#SEC142">Screen size</A>
|
|
<LI><A NAME="TOC143" HREF="gdb.html#SEC143">Numbers</A>
|
|
<LI><A NAME="TOC144" HREF="gdb.html#SEC144">Optional warnings and messages</A>
|
|
</UL>
|
|
<LI><A NAME="TOC145" HREF="gdb.html#SEC145">Canned Sequences of Commands</A>
|
|
<UL>
|
|
<LI><A NAME="TOC146" HREF="gdb.html#SEC146">User-defined commands</A>
|
|
<LI><A NAME="TOC147" HREF="gdb.html#SEC147">User-defined command hooks</A>
|
|
<LI><A NAME="TOC148" HREF="gdb.html#SEC148">Command files</A>
|
|
<LI><A NAME="TOC149" HREF="gdb.html#SEC149">Commands for controlled output</A>
|
|
</UL>
|
|
<LI><A NAME="TOC150" HREF="gdb.html#SEC150">Using GDB under GNU Emacs</A>
|
|
<LI><A NAME="TOC151" HREF="gdb.html#SEC151">Reporting Bugs in GDB</A>
|
|
<UL>
|
|
<LI><A NAME="TOC152" HREF="gdb.html#SEC152">Have you found a bug?</A>
|
|
<LI><A NAME="TOC153" HREF="gdb.html#SEC153">How to report bugs</A>
|
|
</UL>
|
|
<LI><A NAME="TOC154" HREF="gdb.html#SEC154">Formatting Documentation</A>
|
|
<LI><A NAME="TOC155" HREF="gdb.html#SEC155">Installing GDB</A>
|
|
<UL>
|
|
<LI><A NAME="TOC156" HREF="gdb.html#SEC156">Compiling GDB in another directory</A>
|
|
<LI><A NAME="TOC157" HREF="gdb.html#SEC157">Specifying names for hosts and targets</A>
|
|
<LI><A NAME="TOC158" HREF="gdb.html#SEC158"><CODE>configure</CODE> options</A>
|
|
</UL>
|
|
<LI><A NAME="TOC159" HREF="gdb.html#SEC159">Index</A>
|
|
</UL>
|
|
<P><HR><P>
|
|
This document was generated on 23 April 1998 using the
|
|
<A HREF="http://wwwcn.cern.ch/dci/texi2html/">texi2html</A>
|
|
translator version 1.51.</P>
|
|
</BODY>
|
|
</HTML>
|