blob: 58135a82db5691c6dc32a0a30e2ce488efaa97c5 [file] [log] [blame]
<html lang="en">
<head>
<title>Stopping - Debugging with GDB</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Debugging with GDB">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Running.html#Running" title="Running">
<link rel="next" href="Reverse-Execution.html#Reverse-Execution" title="Reverse Execution">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being ``Free Software'' and ``Free Software Needs
Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below.
(a) The FSF's Back-Cover Text is: ``You are free to copy and modify
this GNU Manual. Buying copies from GNU Press supports the FSF in
developing GNU and promoting software freedom.''-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
<link rel="stylesheet" type="text/css" href="../cs.css">
</head>
<body>
<div class="node">
<a name="Stopping"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Reverse-Execution.html#Reverse-Execution">Reverse Execution</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Running.html#Running">Running</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
<hr>
</div>
<h2 class="chapter">5 Stopping and Continuing</h2>
<p>The principal purposes of using a debugger are so that you can stop your
program before it terminates; or so that, if your program runs into
trouble, you can investigate and find out why.
<p>Inside <span class="sc">gdb</span>, your program may stop for any of several reasons,
such as a signal, a breakpoint, or reaching a new line after a
<span class="sc">gdb</span> command such as <code>step</code>. You may then examine and
change variables, set new breakpoints or remove old ones, and then
continue execution. Usually, the messages shown by <span class="sc">gdb</span> provide
ample explanation of the status of your program&mdash;but you can also
explicitly request this information at any time.
<a name="index-info-program-198"></a>
<dl><dt><code>info program</code><dd>Display information about the status of your program: whether it is
running or not, what process it is, and why it stopped.
</dl>
<ul class="menu">
<li><a accesskey="1" href="Breakpoints.html#Breakpoints">Breakpoints</a>: Breakpoints, watchpoints, and catchpoints
<li><a accesskey="2" href="Continuing-and-Stepping.html#Continuing-and-Stepping">Continuing and Stepping</a>: Resuming execution
<li><a accesskey="3" href="Signals.html#Signals">Signals</a>: Signals
<li><a accesskey="4" href="Thread-Stops.html#Thread-Stops">Thread Stops</a>: Stopping and starting multi-thread programs
</ul>
</body></html>