DeBUG
with GDB
<< CONTENTS
>>
BREAK-POINT MAN PAGES
Break-point
break-point
Making program stop at
certain points.
COMMANDS LIST
activate
catch
clear
commands
activate
Activate a
breakpoint at line specified by argument.
awatch
Set a
watchpoint for an expression.
A watchpoint
stops execution of your program whenever the value of
an expression
is either read or written.
break
Set breakpoint
at specified line or function.
Argument may
be line number, function name, or "*" and an address.
If line number is
specified, break at start of code for that line.
If function is specified, break at the first source line (may not
be the first assembly instruction) for that function.
If an address is specified, break at that exact address.
With no arg, uses current execution address of selected stack frame.
This is useful for breaking on return to a stack frame.
Multiple breakpoints at one place are permitted, and useful if
conditional.
catch
Set catchpoints to catch events.
Raised signals may be caught:
catch
signal
- all signals
catch signal
<signame> - a particular signal
Raised exceptions may be caught:
catch
throw
- all exceptions, when thrown
catch throw
<exceptname> - a particular exception, when thrown
catch
catch
- all exceptions, when caught
catch catch
<exceptname> - a particular exception, when caught
Thread or process events may be caught:
catch
thread_start - any threads,
just after creation
catch
thread_exit - any
threads, just before expiration
catch
thread_join - any
threads, just after joins
Process events may be caught:
catch
start
- any processes, just after creatiion
catch
exit
- any processes, just before expirration
catch
fork
- calls to fork()
catch
vfork
- calls to vfork()
catch
exec
- calls to exec()
Dynamically-linked library events may be caught:
catch
load
- loads of any library
catch load
<libname> - loads of a particular
library
catch
unload
- unloads of any library
catch unload
<libname> - unloads of a particular library
The act of your program's execution stopping may also be caught:
catch stop
Memory leaks may be caught:
catch
leaks
- all leaks (with info leaks)
C++ exceptions may be caught:
catch
throw
- all exceptions, when thrown
catch
catch
- all exceptions, when caught
clear
Clear breakpoint at specified line or function.
Argument may be line number, function name, or "*" and an address.
If line number is specified, all breakpoints in that line are cleared.
If function is specified, breakpoints at beginning of function are
cleared.
If an address is specified, breakpoints at that address are cleared.
With no argument, clears all breakpoints in the line that the selected
frame
is executing in.
commands
Set commands to be executed when a breakpoint is hit.
Give breakpoint number as argument after "commands".
With no argument, the targeted breakpoint is the last one set.
The commands themselves follow starting on the next line.
Type a line containing "end" to indicate the end of them.
Give "silent" as the first line to make the breakpoint silent;
then no output is printed when it is hit, except what the commands
print.
condition
Specify breakpoint number N to break only if COND is true.
Usage is `condition N COND', where N is an integer and COND is an
expression to be evaluated whenever breakpoint N is reached.
delete
Delete some breakpoints or auto-display expressions.
Arguments are breakpoint numbers with spaces in between.
To delete all breakpoints, give no argument.
Also a prefix command for deletion of other GDB objects.
The "unset" command is also an
alias for "delete".
subcommands
delete breakpoints -- Delete some breakpoints or auto-display
expressions
delete display -- Cancel some expressions to be displayed when program
stops
delete tracepoints -- Delete specified tracepoints
display
Print value of expression EXP each time the program stops.
/FMT may be used before EXP as in the "print" command.
/FMT "i" or "s" or including a size-letter is allowed,
as in the "x" command, and then EXP is used to get the address to
examine
and examining is done as in the "x" command.
With no argument, display all currently requested auto-display
expressions.
Use "undisplay" to cancel display requests previously made.
disable
Disable some breakpoints.
Arguments are breakpoint numbers with spaces in between.
To disable all breakpoints, give no argument.
A disabled breakpoint is not forgotten, but has no effect until
reenabled.
List of disable subcommands:
disable breakpoints -- Disable some breakpoints
disable display -- Disable some expressions to be displayed when
program stops
disable tracepoints -- Disable specified tracepoints
Type "help disable" followed by disable subcommand name for full
documentation.
Command name abbreviations are allowed if unambiguous.
enable
Enable some breakpoints.
Give breakpoint numbers (separated by spaces) as arguments.
With no subcommand, breakpoints are enabled until you command otherwise.
This is used to cancel the effect of the "disable" command.
With a subcommand you can enable temporarily.
subcommands
enable delete -- Enable breakpoints and delete when hit
enable display -- Enable some expressions to be displayed when program
stops
enable once -- Enable breakpoints for one hit
enable tracepoints -- Enable specified tracepoints
hbreak
Set a hardware assisted breakpoint. Args like "break" command.
Like "break" except the breakpoint requires hardware support,
some target hardware may not have this support.
ignore
Set ignore-count of breakpoint number N to COUNT.
Usage is `ignore N COUNT'.
rbp
Set a breakpoint for all functions and associating a set of commands
for the breakpoints.
rbreak
Set a breakpoint for all functions matching REGEXP.
rdp
Delete breakpoints for all functions set by the rbp.
rwatch
Set a read watchpoint for an expression.
A watchpoint stops execution of your program whenever the value of
an expression is read.
suspend
Suspend a breakpoint at line specified by argument.
tbreak
Set a temporary breakpoint. Args like "break" command.
Like "break" except the breakpoint is only temporary,
so it will be deleted when hit. Equivalent to "break" followed
by using "enable delete" on the breakpoint number.
tcatch
Set temporary catchpoints to catch events.
Args like "catch" command.
Like "catch" except the catchpoint is only temporary,
so it will be deleted when hit. Equivalent to "catch" followed
by using "enable delete" on the catchpoint number.
thbreak
Set a temporary hardware assisted breakpoint. Args like "break" command.
Like "hbreak" except the breakpoint is only temporary,
so it will be deleted when hit.
txbreak
Set temporary breakpoint at procedure exit. Either there should
be no argument or the argument must be a depth.
watch
Set a watchpoint for an expression.
A watchpoint stops execution of your program whenever the value of
an expression changes.
xbp
Set a breakpoint at the exit of all functions.
xbreak
Set breakpoint at procedure exit.
Argument may be function name, or "*" and an address.
If function is specified, break at end of code for that function.
If an address is specified, break at the end of the function that
contains
that exact address.
With no arg, uses current execution address of selected stack frame.
This is useful for breaking on return to a stack frame.
Multiple breakpoints at one place are permitted, and useful if
conditional.
xdp
Delete breakpoints for all functions set by the xbp.
MAN BREAK-POINT
Muthukumar Kandasamy <
[email protected]>