aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorJeff Johnston <jjohnstn@redhat.com>2004-10-08 15:34:31 +0000
committerJeff Johnston <jjohnstn@redhat.com>2004-10-08 15:34:31 +0000
commitac77d04f5dc5725af5b44f7b0a9b11af61c9d838 (patch)
tree58552524dace7c46660a8ddadda92221dd8b5c38 /gdb/doc
parenta3bb10891cc10b63dd4c7f406fa59c4c2f4e791b (diff)
downloadgdb-ac77d04f5dc5725af5b44f7b0a9b11af61c9d838.zip
gdb-ac77d04f5dc5725af5b44f7b0a9b11af61c9d838.tar.gz
gdb-ac77d04f5dc5725af5b44f7b0a9b11af61c9d838.tar.bz2
2004-10-08 Jeff Johnston <jjohnstn@redhat.com>
* gdbint.texinfo (target_stopped_data_address): Update to new prototype. (i386_stopped_data_address): Update prototype and description. (i386_stopped_by_watchpoint): New function and description.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog7
-rw-r--r--gdb/doc/gdbint.texinfo27
2 files changed, 26 insertions, 8 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 8307f25..6ddde87 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,10 @@
+2004-10-08 Jeff Johnston <jjohnstn@redhat.com>
+
+ * gdbint.texinfo (target_stopped_data_address): Update to
+ new prototype.
+ (i386_stopped_data_address): Update prototype and description.
+ (i386_stopped_by_watchpoint): New function and description.
+
2004-10-03 Paul N. Hilfinger <hilfinger@gnat.com>
* gdb.texinfo (Filenames): Add Ada suffixes.
diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo
index bff7d15..38532d3 100644
--- a/gdb/doc/gdbint.texinfo
+++ b/gdb/doc/gdbint.texinfo
@@ -476,9 +476,10 @@ no other code touches these values, the implementations of the above
two macros can use them for their internal purposes.
@findex target_stopped_data_address
-@item target_stopped_data_address ()
-If the inferior has some watchpoint that triggered, return the address
-associated with that watchpoint. Otherwise, return zero.
+@item target_stopped_data_address (@var{addr_p})
+If the inferior has some watchpoint that triggered, place the address
+associated with the watchpoint at the location pointed to by
+@var{addr_p} and return non-zero. Otherwise, return zero.
@findex HAVE_STEPPABLE_WATCHPOINT
@item HAVE_STEPPABLE_WATCHPOINT
@@ -598,15 +599,25 @@ less than 4, the number of debug registers available to x86
processors.
@findex i386_stopped_data_address
-@item i386_stopped_data_address (void)
-The macros @code{STOPPED_BY_WATCHPOINT} and
-@code{target_stopped_data_address} are set to call this function. The
-argument passed to @code{STOPPED_BY_WATCHPOINT} is ignored. This
+@item i386_stopped_data_address (@var{addr_p})
+The target function
+@code{target_stopped_data_address} is set to call this function.
+This
function examines the breakpoint condition bits in the DR6 Debug
Status register, as returned by the @code{I386_DR_LOW_GET_STATUS}
macro, and returns the address associated with the first bit that is
set in DR6.
+@findex i386_stopped_by_watchpoint
+@item i386_stopped_by_watchpoint (void)
+The macro @code{STOPPED_BY_WATCHPOINT}
+is set to call this function. The
+argument passed to @code{STOPPED_BY_WATCHPOINT} is ignored. This
+function examines the breakpoint condition bits in the DR6 Debug
+Status register, as returned by the @code{I386_DR_LOW_GET_STATUS}
+macro, and returns true if any bit is set. Otherwise, false is
+returned.
+
@findex i386_insert_watchpoint
@findex i386_remove_watchpoint
@item i386_insert_watchpoint (@var{addr}, @var{len}, @var{type})
@@ -654,7 +665,7 @@ register.
@item i386_stopped_by_hwbp (void)
This function returns non-zero if the inferior has some watchpoint or
hardware breakpoint that triggered. It works like
-@code{i386_stopped_data_address}, except that it doesn't return the
+@code{i386_stopped_data_address}, except that it doesn't record the
address whose watchpoint triggered.
@findex i386_cleanup_dregs