1 /* Definitions for dealing with stack frames, for GDB, the GNU debugger.
2 Copyright (C) 1986, 1989 Free Software Foundation, Inc.
4 This file is part of GDB.
6 GDB is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 1, or (at your option)
11 GDB is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GDB; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
20 #if !defined (FRAME_H)
25 * FRAME is the type of the identifier of a specific stack frame. It
26 * is a pointer to the frame cache item corresponding to this frame.
27 * Please note that frame id's are *not* constant over calls to the
28 * inferior. Use frame addresses, which are.
30 * FRAME_ADDR is the type of the address of a specific frame. I
31 * cannot imagine a case in which this would not be CORE_ADDR, so
32 * maybe it's silly to give it it's own type. Life's rough.
34 * FRAME_FP is a macro which converts from a frame identifier into a
37 * FRAME_INFO_ID is a macro which "converts" from a frame info pointer
38 * to a frame id. This is here in case I or someone else decides to
39 * change the FRAME type again.
41 * This file and blockframe.c are the only places which are allowed to
42 * use the equivalence between FRAME and struct frame_info *. EXCEPTION:
43 * value.h uses CORE_ADDR instead of FRAME_ADDR because the compiler
44 * will accept that in the absense of this file.
46 typedef struct frame_info
*FRAME
;
47 typedef CORE_ADDR FRAME_ADDR
;
48 #define FRAME_FP(fr) ((fr)->frame)
49 #define FRAME_INFO_ID(f) (f)
52 * Caching structure for stack frames. This is also the structure
53 * used for extended info about stack frames. May add more to this
54 * structure as it becomes necessary.
56 * Note that the first entry in the cache will always refer to the
57 * innermost executing frame. This value should be set (is it?
58 * Check) in something like normal_stop.
62 /* Nominal address of the frame described. */
64 /* Address at which execution is occurring in this frame.
65 For the innermost frame, it's the current pc.
66 For other frames, it is a pc saved in the next frame. */
68 /* The frame called by the frame we are describing, or 0.
69 This may be set even if there isn't a frame called by the one
70 we are describing (.->next == 0); in that case it is simply the
71 bottom of this frame */
72 FRAME_ADDR next_frame
;
73 /* Anything extra for this structure that may have been defined
74 in the machine depedent files. */
75 #ifdef EXTRA_FRAME_INFO
78 /* Pointers to the next and previous frame_info's in this stack. */
82 /* Describe the saved registers of a frame. */
84 struct frame_saved_regs
86 /* For each register, address of where it was saved on entry to the frame,
87 or zero if it was not saved on entry to this frame. */
88 CORE_ADDR regs
[NUM_REGS
];
91 /* The stack frame that the user has specified for commands to act on.
92 Note that one cannot assume this is the address of valid data. */
94 extern FRAME selected_frame
;
96 extern struct frame_info
*get_frame_info ();
97 extern struct frame_info
*get_prev_frame_info ();
99 extern FRAME
create_new_frame ();
100 extern void flush_cached_frames ();
102 extern void get_frame_saved_regs ();
104 extern void set_current_frame ();
105 extern FRAME
get_prev_frame ();
106 extern FRAME
get_current_frame ();
107 extern FRAME
get_next_frame ();
109 extern struct block
*get_frame_block ();
110 extern struct block
*get_current_block ();
111 extern struct block
*get_selected_block ();
112 extern struct symbol
*get_frame_function ();
113 extern CORE_ADDR
get_frame_pc ();
114 extern CORE_ADDR
get_pc_function_start ();
115 struct block
*block_for_pc ();
117 int frameless_look_for_prologue ();
119 void print_frame_args ();
122 extern FRAME
find_relative_frame ();
123 extern void print_selected_frame ();
124 extern void print_sel_frame ();
125 extern void select_frame ();
126 extern void record_selected_frame ();
128 #endif /* frame.h not already included. */
This page took 0.031399 seconds and 4 git commands to generate.