Index: doc/gdbint.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdbint.texinfo,v retrieving revision 1.221 diff -u -p -r1.221 gdbint.texinfo --- doc/gdbint.texinfo 24 Aug 2004 19:58:24 -0000 1.221 +++ doc/gdbint.texinfo 31 Aug 2004 15:36:30 -0000 @@ -476,9 +476,14 @@ no other code touches these values, the 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}) +Determine the data address associated with the current triggered hardware +watchpoint and store it at the location pointed to by @var{addr_p}. +If @var{addr_p} is NULL, return non-zero if the target has the capability +to determine a data +address associated with a triggered hardware watchpoint, otherwise return +zero. When @var{addr_p} is non-NULL, return non-zero if the data address +for the triggered watchpoint is determined successfully, otherwise, return zero. @findex HAVE_STEPPABLE_WATCHPOINT @item HAVE_STEPPABLE_WATCHPOINT @@ -598,15 +603,22 @@ less than 4, the number of debug registe 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 uses the same logic as @code{i386_stopped_data_address}. + @findex i386_insert_watchpoint @findex i386_remove_watchpoint @item i386_insert_watchpoint (@var{addr}, @var{len}, @var{type})