diff options
| author | Jan Kratochvil <jan.kratochvil@redhat.com> | 2008-11-26 05:26:40 +0000 |
|---|---|---|
| committer | Jan Kratochvil <jan.kratochvil@redhat.com> | 2008-11-26 05:26:40 +0000 |
| commit | a655d4241122ccebd491f8149759ab926766cb0c (patch) | |
| tree | 34c22bfa86e83cdaf62f2c97172db323f424182e | |
| parent | fc9b693caa73cacf0db23d3bea3812389ea862bd (diff) | |
| download | gdb-a655d4241122ccebd491f8149759ab926766cb0c.zip gdb-a655d4241122ccebd491f8149759ab926766cb0c.tar.gz gdb-a655d4241122ccebd491f8149759ab926766cb0c.tar.bz2 | |
* gdbint.texinfo (Target Conditionals): Extend the
gdbarch_breakpoint_from_pc description.
| -rw-r--r-- | gdb/doc/ChangeLog | 5 | ||||
| -rw-r--r-- | gdb/doc/gdbint.texinfo | 11 |
2 files changed, 14 insertions, 2 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 74d7fca..350831b 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2008-11-25 Jan Kratochvil <jan.kratochvil@redhat.com> + + * gdbint.texinfo (Target Conditionals): Extend the + gdbarch_breakpoint_from_pc description. + 2008-11-22 Vladimir Prus <vladimir@codesourcery.com> * gdb.texinfo (M68K Features): Fix typo. diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index 9caff8f..88dd7f9 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -3430,16 +3430,23 @@ favor of @code{gdbarch_breakpoint_from_pc}. @findex gdbarch_breakpoint_from_pc @anchor{gdbarch_breakpoint_from_pc} Use the program counter to determine the contents and size of a breakpoint instruction. It returns a pointer to -a string of bytes that encode a breakpoint instruction, stores the +a static string of bytes that encode a breakpoint instruction, stores the length of the string to @code{*@var{lenptr}}, and adjusts the program counter (if necessary) to point to the actual memory location where the -breakpoint should be inserted. +breakpoint should be inserted. May return @code{NULL} to indicate that +software breakpoints are not supported. Although it is common to use a trap instruction for a breakpoint, it's not required; for instance, the bit pattern could be an invalid instruction. The breakpoint must be no longer than the shortest instruction of the architecture. +Provided breakpoint bytes can be also used by @code{bp_loc_is_permanent} to +detect permanent breakpoints. @code{gdbarch_breakpoint_from_pc} should return +an unchanged memory copy if it was called for a location with permanent +breakpoint as some architectures use breakpoint instructions containing +arbitrary parameter value. + Replaces all the other @var{BREAKPOINT} macros. @item int gdbarch_memory_insert_breakpoint (@var{gdbarch}, @var{bp_tgt}) |