From edbf28ce4cce654eeb0e88782aee11d6e8529978 Mon Sep 17 00:00:00 2001 From: John Gilmore Date: Thu, 14 Nov 1991 00:57:48 +0000 Subject: Add rudiments on frames. --- gdb/doc/gdbint.texinfo | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) (limited to 'gdb/doc') diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index 3713879..a7ce163 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -746,7 +746,7 @@ interruption must be on the cleanup chain before you call these functions, since they might never return to your code (they @samp{longjmp} instead). -@node Wrapping, , Cleanups, Top +@node Wrapping, Frames, Cleanups, Top @chapter Wrapping Output Lines Output that goes through @code{printf_filtered} or @code{fputs_filtered} or @@ -771,6 +771,32 @@ unfiltered (``@code{printf}'') output. Symbol reading routines that print warnings are a good example. +@node Frames, , Cleanups, Top +@chapter Frames + +A frame is a construct that GDB uses to keep track of calling and called +functions. + +FRAME_FP in the machine description has no meaning to the machine-independent +part of GDB, except that it is used when setting up a new frame from +scratch, as follows: + +@example + create_new_frame (read_register (FP_REGNUM), read_pc ())); +@end example + +Other than that, all the meaning imparted to FP_REGNUM is imparted by +the machine-dependent code. So, FP_REGNUM can have any value that +is convenient for the code that creates new frames. (create_new_frame +calls INIT_EXTRA_FRAME_INFO if it is defined; that is where you should +use the FP_REGNUM value, if your frames are nonstandard.) + +FRAME_CHAIN: + +Given a GDB frame, determine the address of the calling function's frame. +This will be used to create a new GDB frame struct, and then +INIT_EXTRA_FRAME_INFO and INIT_FRAME_PC will be called for the new frame. + @contents @bye -- cgit v1.1