espressif/binutils-gdb
1
0
Fork 0
mirror of https://github.com/espressif/binutils-gdb.git synced 2025-08-06 14:49:38 +08:00
Code Issues Packages Projects Releases Wiki Activity

gdb/doc/

Browse Source 
* gdbint.texinfo (Defining Other Architecture Features): Clarify *pcptr
	encoding for gdbarch_breakpoint_from_pc, bp_addr for
	gdbarch_push_dummy_call and bp_addr for gdbarch_push_dummy_code.
This commit is contained in:
Jan Kratochvil
2012-09-13 17:35:35 +00:00
parent aa0fbdd82c
commit 121c73f33a
2 changed files with 18 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
gdb/doc/ChangeLog
View File

@ -1,3 +1,10 @@
2012-09-13 Jan Kratochvil <jan.kratochvil@redhat.com>
Eli Zaretskii <eliz@gnu.org>
* gdbint.texinfo (Defining Other Architecture Features): Clarify *pcptr
encoding for gdbarch_breakpoint_from_pc, bp_addr for
gdbarch_push_dummy_call and bp_addr for gdbarch_push_dummy_code.
2012-08-27 Jan Kratochvil <jan.kratochvil@redhat.com> 2012-08-27 Jan Kratochvil <jan.kratochvil@redhat.com>
* gdb.texinfo (objfile-gdb.py file): New paragraph for .exe stripping. * gdb.texinfo (objfile-gdb.py file): New paragraph for .exe stripping.

17
gdb/doc/gdbint.texinfo
View File

@ -4532,8 +4532,11 @@ contents and size of a breakpoint instruction. It returns a pointer to
a static 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 length of the string to @code{*@var{lenptr}}, and adjusts the program
counter (if necessary) to point to the actual memory location where the counter (if necessary) to point to the actual memory location where the
breakpoint should be inserted. May return @code{NULL} to indicate that breakpoint should be inserted. On input, the program counter
software breakpoints are not supported. (@code{*@var{pcptr}} is the encoded inferior's PC register. If software
breakpoints are supported, the function sets this argument to the PC's
plain address. If software breakpoints are not supported, the function
returns NULL instead of the encoded breakpoint instruction.
Although it is common to use a trap instruction for a breakpoint, it's 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 not required; for instance, the bit pattern could be an invalid
@ -4813,7 +4816,7 @@ instead of value.
@anchor{gdbarch_push_dummy_call} Define this to push the dummy frame's call to @anchor{gdbarch_push_dummy_call} Define this to push the dummy frame's call to
the inferior function onto the stack. In addition to pushing @var{nargs}, the the inferior function onto the stack. In addition to pushing @var{nargs}, the
code should push @var{struct_addr} (when @var{struct_return} is non-zero), and code should push @var{struct_addr} (when @var{struct_return} is non-zero), and
the return address (@var{bp_addr}). the return address (@var{bp_addr}, in inferior's PC register encoding).
@var{function} is a pointer to a @code{struct value}; on architectures that use @var{function} is a pointer to a @code{struct value}; on architectures that use
function descriptors, this contains the function descriptor value. function descriptors, this contains the function descriptor value.
@ -4827,12 +4830,14 @@ instruction sequence (including space for a breakpoint) to which the
called function should return. called function should return.
Set @var{bp_addr} to the address at which the breakpoint instruction Set @var{bp_addr} to the address at which the breakpoint instruction
should be inserted, @var{real_pc} to the resume address when starting should be inserted (in inferior's PC register encoding), @var{real_pc} to the
the call sequence, and return the updated inner-most stack address. resume address when starting the call sequence, and return the updated
inner-most stack address.
By default, the stack is grown sufficient to hold a frame-aligned By default, the stack is grown sufficient to hold a frame-aligned
(@pxref{frame_align}) breakpoint, @var{bp_addr} is set to the address (@pxref{frame_align}) breakpoint, @var{bp_addr} is set to the address
reserved for that breakpoint, and @var{real_pc} set to @var{funaddr}. reserved for that breakpoint (in inferior's PC register encoding), and
@var{real_pc} set to @var{funaddr}.
This method replaces @w{@code{gdbarch_call_dummy_location (@var{gdbarch})}}. This method replaces @w{@code{gdbarch_call_dummy_location (@var{gdbarch})}}.