1/* Code dealing with dummy stack frames, for GDB, the GNU debugger.
2
3   Copyright (C) 2002, 2004, 2007 Free Software Foundation, Inc.
4
5   This file is part of GDB.
6
7   This program is free software; you can redistribute it and/or modify
8   it under the terms of the GNU General Public License as published by
9   the Free Software Foundation; either version 3 of the License, or
10   (at your option) any later version.
11
12   This program is distributed in the hope that it will be useful,
13   but WITHOUT ANY WARRANTY; without even the implied warranty of
14   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15   GNU General Public License for more details.
16
17   You should have received a copy of the GNU General Public License
18   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
19
20#if !defined (DUMMY_FRAME_H)
21#define DUMMY_FRAME_H 1
22
23struct frame_info;
24struct regcache;
25struct frame_unwind;
26struct frame_id;
27
28/* Push the information needed to identify, and unwind from, a dummy
29   frame onto the dummy frame stack.  */
30
31/* NOTE: cagney/2004-08-02: This interface will eventually need to be
32   parameterized with the caller's thread - that will allow per-thread
33   dummy-frame stacks and, hence, per-thread inferior function
34   calls.  */
35
36/* NOTE: cagney/2004-08-02: In the case of ABIs using push_dummy_code
37   containing more than one instruction, this interface many need to
38   be expanded so that it knowns the lower/upper extent of the dummy
39   frame's code.  */
40
41extern void dummy_frame_push (struct regcache *regcache,
42			      const struct frame_id *dummy_id);
43
44/* If the PC falls in a dummy frame, return a dummy frame
45   unwinder.  */
46
47extern const struct frame_unwind *const dummy_frame_unwind;
48
49#endif /* !defined (DUMMY_FRAME_H)  */
50