aboutsummaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorJan Kratochvil <jan.kratochvil@redhat.com>2008-11-26 05:26:40 +0000
committerJan Kratochvil <jan.kratochvil@redhat.com>2008-11-26 05:26:40 +0000
commita655d4241122ccebd491f8149759ab926766cb0c (patch)
tree34c22bfa86e83cdaf62f2c97172db323f424182e /gdb
parentfc9b693caa73cacf0db23d3bea3812389ea862bd (diff)
downloadgdb-a655d4241122ccebd491f8149759ab926766cb0c.zip
gdb-a655d4241122ccebd491f8149759ab926766cb0c.tar.gz
gdb-a655d4241122ccebd491f8149759ab926766cb0c.tar.bz2
* gdbint.texinfo (Target Conditionals): Extend the
gdbarch_breakpoint_from_pc description.
Diffstat (limited to 'gdb')
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdbint.texinfo11
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})