darkkirb/old-cross-binutils
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

gdb/doc: Update 'frame' command documentation.

Browse source 
The documentation for the 'frame' command has gotten a little out of
date, it still mentions architecturally specific details that are no
longer relevant.

This commit removes the old details that no longer apply, and tries to
expand the existing text a little to make the usage clearer for some
cases.

gdb/doc/ChangeLog:

	* gdb.texinfo (Selection): Update documentation for 'frame'
	command.
This commit is contained in:
Andrew Burgess 2015-07-08 15:02:32 +01:00
parent ef3f321b39
commit 7c7f93f6e5
2 changed files with 10 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
gdb/doc/ChangeLog
View file

@ -1,3 +1,8 @@
2015-07-08 Andrew Burgess <andrew.burgess@embecosm.com>
* gdb.texinfo (Selection): Update documentation for 'frame'
command.
2015-07-02 Markus Metzger <markus.t.metzger@intel.com> 2015-07-02 Markus Metzger <markus.t.metzger@intel.com>
* gdb.texinfo (Maintenance Commands): Document "maint btrace" * gdb.texinfo (Maintenance Commands): Document "maint btrace"

18
gdb/doc/gdb.texinfo
View file

@ -7320,22 +7320,14 @@ Select frame number @var{n}. Recall that frame zero is the innermost
innermost one, and so on. The highest-numbered frame is the one for innermost one, and so on. The highest-numbered frame is the one for
@code{main}. @code{main}.
@item frame @var{addr} @item frame @var{stack-addr} [ @var{pc-addr} ]
@itemx f @var{addr} @itemx f @var{stack-addr} [ @var{pc-addr} ]
Select the frame at address @var{addr}. This is useful mainly if the Select the frame at address @var{stack-addr}. This is useful mainly if the
chaining of stack frames has been damaged by a bug, making it chaining of stack frames has been damaged by a bug, making it
impossible for @value{GDBN} to assign numbers properly to all frames. In impossible for @value{GDBN} to assign numbers properly to all frames. In
addition, this can be useful when your program has multiple stacks and addition, this can be useful when your program has multiple stacks and
switches between them. switches between them. The optional @var{pc-addr} can also be given to
specify the value of PC for the stack frame.
On the SPARC architecture, @code{frame} needs two addresses to
select an arbitrary frame: a frame pointer and a stack pointer.
On the @acronym{MIPS} and Alpha architecture, it needs two addresses: a stack
pointer and a program counter.
On the 29k architecture, it needs three addresses: a register stack
pointer, a program counter, and a memory stack pointer.
@kindex up @kindex up
@item up @var{n} @item up @var{n}