diff options
| author | Jeff Johnston <jjohnstn@redhat.com> | 2004-02-26 23:21:23 +0000 |
|---|---|---|
| committer | Jeff Johnston <jjohnstn@redhat.com> | 2004-02-26 23:21:23 +0000 |
| commit | dd79a6cf0bf327cacd3a133cb9604bad20c9619b (patch) | |
| tree | ac58076877d8f992dea962ee40fd0a4cd3ed14da /gdb/doc | |
| parent | 9faa1d7f04e2666ab577960ca5bbe591e4abd629 (diff) | |
| download | gdb-dd79a6cf0bf327cacd3a133cb9604bad20c9619b.zip gdb-dd79a6cf0bf327cacd3a133cb9604bad20c9619b.tar.gz gdb-dd79a6cf0bf327cacd3a133cb9604bad20c9619b.tar.bz2 | |
2004-02-26 Jeff Johnston <jjohnstn@redhat.com>
* gdb.texinfo (breakpoints): Add information about the
new "set breakpoint pending" and "show breakpoint pending"
commands.
Diffstat (limited to 'gdb/doc')
| -rw-r--r-- | gdb/doc/ChangeLog | 6 | ||||
| -rw-r--r-- | gdb/doc/gdb.texinfo | 41 |
2 files changed, 40 insertions, 7 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index e08d7d9..47f6e7c 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,9 @@ +2004-02-26 Jeff Johnston <jjohnstn@redhat.com> + + * gdb.texinfo (breakpoints): Add information about the + new "set breakpoint pending" and "show breakpoint pending" + commands. + 2004-02-26 Andrew Cagney <cagney@redhat.com> * gdbint.texinfo (Coding): Document use of gdbarch_obstack_zalloc diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index d3a8c52..06b4aa1 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -2639,15 +2639,42 @@ the breakpoints are conditional, this is even useful (@pxref{Conditions, ,Break conditions}). @cindex pending breakpoints -If a specified breakpoint location cannot be found, @value{GDBN} will -prompt you -as to whether to make the breakpoint pending on a future shared -library load. This is useful for setting breakpoints at the start of your +If a specified breakpoint location cannot be found, it may be due to the fact +that the location is in a shared library that is yet to be loaded. In such +a case, you may want @value{GDBN} to create a special breakpoint (known as +a @dfn{pending breakpoint}) that +attempts to resolve itself in the future when an appropriate shared library +gets loaded. + +Pending breakpoints are useful to set at the start of your @value{GDBN} session for locations that you know will be dynamically loaded later by the program being debugged. When shared libraries are loaded, -a check is made to see if the load resoloves any pending breakpoint locations. -If a pending breakpoint location has been resolved, -a real breakpoint is created and the original pending breakpoint is removed. +a check is made to see if the load resolves any pending breakpoint locations. +If a pending breakpoint location gets resolved, +a regular breakpoint is created and the original pending breakpoint is removed. + +@value{GDBN} provides some additional commands for controlling pending +breakpoint support: + +@kindex set breakpoint pending +@kindex show breakpoint pending +@table @code +@item set breakpoint pending auto +This is the default behavior. When @value{GDBN} cannot find the breakpoint +location, it queries you whether a pending breakpoint should be created. + +@item set breakpoint pending on +This indicates that an unrecognized breakpoint location should automatically +result in a pending breakpoint being created. + +@item set breakpoint pending off +This indicates that pending breakpoints are not to be created. Any +unrecognized breakpoint location results in an error. This setting does +not affect any pending breakpoints previously created. + +@item show breakpoint pending +Show the current behavior setting for creating pending breakpoints. +@end table @cindex operations allowed on pending breakpoints Normal breakpoint operations apply to pending breakpoints as well. You may |