<html lang="en">
<head>
<title>Disabling - 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="up" href="Breakpoints.html#Breakpoints" title="Breakpoints">
<link rel="prev" href="Delete-Breaks.html#Delete-Breaks" title="Delete Breaks">
<link rel="next" href="Conditions.html#Conditions" title="Conditions">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1988-2019 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>
</head>
<body>
<div class="node">
<a name="Disabling"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Conditions.html#Conditions">Conditions</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Delete-Breaks.html#Delete-Breaks">Delete Breaks</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Breakpoints.html#Breakpoints">Breakpoints</a>
<hr>
</div>

<h4 class="subsection">5.1.5 Disabling Breakpoints</h4>

<p><a name="index-enable_002fdisable-a-breakpoint-317"></a>Rather than deleting a breakpoint, watchpoint, or catchpoint, you might
prefer to <dfn>disable</dfn> it.  This makes the breakpoint inoperative as if
it had been deleted, but remembers the information on the breakpoint so
that you can <dfn>enable</dfn> it again later.

   <p>You disable and enable breakpoints, watchpoints, and catchpoints with
the <code>enable</code> and <code>disable</code> commands, optionally specifying
one or more breakpoint numbers as arguments.  Use <code>info break</code> to
print a list of all breakpoints, watchpoints, and catchpoints if you
do not know which numbers to use.

   <p>Disabling and enabling a breakpoint that has multiple locations
affects all of its locations.

   <p>A breakpoint, watchpoint, or catchpoint can have any of several
different states of enablement:

     <ul>
<li>Enabled.  The breakpoint stops your program.  A breakpoint set
with the <code>break</code> command starts out in this state. 
<li>Disabled.  The breakpoint has no effect on your program. 
<li>Enabled once.  The breakpoint stops your program, but then becomes
disabled. 
<li>Enabled for a count.  The breakpoint stops your program for the next
N times, then becomes disabled. 
<li>Enabled for deletion.  The breakpoint stops your program, but
immediately after it does so it is deleted permanently.  A breakpoint
set with the <code>tbreak</code> command starts out in this state. 
</ul>

   <p>You can use the following commands to enable or disable breakpoints,
watchpoints, and catchpoints:

     
<a name="index-disable-318"></a>
<a name="index-dis-_0040r_007b_0028_0040code_007bdisable_007d_0029_007d-319"></a>
<dl><dt><code>disable </code><span class="roman">[</span><code>breakpoints</code><span class="roman">]</span> <span class="roman">[</span><var>list</var><code>...</code><span class="roman">]</span><dd>Disable the specified breakpoints&mdash;or all breakpoints, if none are
listed.  A disabled breakpoint has no effect but is not forgotten.  All
options such as ignore-counts, conditions and commands are remembered in
case the breakpoint is enabled again later.  You may abbreviate
<code>disable</code> as <code>dis</code>.

     <p><a name="index-enable-320"></a><br><dt><code>enable </code><span class="roman">[</span><code>breakpoints</code><span class="roman">]</span> <span class="roman">[</span><var>list</var><code>...</code><span class="roman">]</span><dd>Enable the specified breakpoints (or all defined breakpoints).  They
become effective once again in stopping your program.

     <br><dt><code>enable </code><span class="roman">[</span><code>breakpoints</code><span class="roman">]</span><code> once </code><var>list</var><code>...</code><dd>Enable the specified breakpoints temporarily.  <span class="sc">gdb</span> disables any
of these breakpoints immediately after stopping your program.

     <br><dt><code>enable </code><span class="roman">[</span><code>breakpoints</code><span class="roman">]</span><code> count </code><var>count</var> <var>list</var><code>...</code><dd>Enable the specified breakpoints temporarily.  <span class="sc">gdb</span> records
<var>count</var> with each of the specified breakpoints, and decrements a
breakpoint's count when it is hit.  When any count reaches 0,
<span class="sc">gdb</span> disables that breakpoint.  If a breakpoint has an ignore
count (see <a href="Conditions.html#Conditions">Break Conditions</a>), that will be
decremented to 0 before <var>count</var> is affected.

     <br><dt><code>enable </code><span class="roman">[</span><code>breakpoints</code><span class="roman">]</span><code> delete </code><var>list</var><code>...</code><dd>Enable the specified breakpoints to work once, then die.  <span class="sc">gdb</span>
deletes any of these breakpoints as soon as your program stops there. 
Breakpoints set by the <code>tbreak</code> command start out in this state. 
</dl>

<!-- FIXME: I think the following ``Except for [...] @code{tbreak}'' is -->
<!-- confusing: tbreak is also initially enabled. -->
   <p>Except for a breakpoint set with <code>tbreak</code> (see <a href="Set-Breaks.html#Set-Breaks">Setting Breakpoints</a>), breakpoints that you set are initially enabled;
subsequently, they become disabled or enabled only when you use one of
the commands above.  (The command <code>until</code> can set and delete a
breakpoint of its own, but it does not change the state of your other
breakpoints; see <a href="Continuing-and-Stepping.html#Continuing-and-Stepping">Continuing and Stepping</a>.)

   </body></html>