Debugging with GDB (September 2007)

Chapter 5: Stopping and Continuing 39

clear function

clear filename :function

Delete any breakpoints set at entry to the function function.

clear linenum

clear filename :linenum

Delete any breakpoints set at or within the co de of the spe ciﬁed line.

delete [breakpoints] [range...]

Delete the breakpoints, watchpoints, or catchpoints of the breakpoint ranges

speciﬁed as arguments. If no argument is sp e ciﬁed, delete all breakpoints (GDB

asks conﬁrmation, unless you have set confirm off). You can abbreviate this

command as d.

5.1.4 Disabling breakpoints

Rather than deleting a breakpoint, watchpoint, or catchpoint, you might prefer to disable

it. This makes the breakpoint inoperative as if it had been deleted, but remembers the

information on the breakp oint so that you can enable it again later.

You disable and enable breakpoints, watchpoints, and catchpoints with the enable and

disable commands, optionally specifying one or more breakpoint numbers as arguments.

Use info break or info watch to print a list of breakpoints, watchpoints, and catchpoints

if you do not know which numbers to use.

A breakp oint, watchpoint, or catchpoint can have any of four diﬀerent states of enable-

ment:

• Enabled. The breakpoint stops your program. A breakpoint set with the break com-

mand starts out in this state.

• Disabled. The breakpoint has no eﬀect on your program.

• Enabled once. The breakpoint stops your program, but then becomes disabled.

• Enabled for deletion. The breakpoint stops your program, but immediately after it

does so it is deleted permanently. A breakpoint set with the tbreak command starts

out in this state.

You can use the following commands to enable or disable breakpoints, watchp oints, and

catchpoints:

disable [breakpoints] [range...]

Disable the speciﬁed breakpoints—or all breakpoints, if none are listed. A

disabled breakpoint has no eﬀ ect 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 disable as dis.

enable [breakpoints] [range...]

Enable the speciﬁed breakpoints (or all deﬁned breakpoints). They become

eﬀective once again in stopping your program.

enable [breakpoints] once range...

Enable the speciﬁed breakpoints temporarily. GDB disables any of these break-

points immediately after stopping your program.