DeBUG  with GDB

                                                                                                            
<< CONTENTS >>

        BREAK-POINT MAN PAGES


            Break-point

                  
break-point
                     
Making program stop at certain points.

                   
COMMANDS LIST
                          activate
            awatch
            break
                         catch
                         clear
                         commands
           condition
           delete
           disable
           display 
           enable
           hbreak
           ignore
           rbp
           rbreak
           rdp
           rwatch
           suspend
           tbreak
           tcatch
           thbreak
           txbreak
           watch
           xbp
           xbreak
           xdp

            
               
                      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]>
   
Hosted by www.Geocities.ws

1