/* Code dealing with dummy stack frames, for GDB, the GNU debugger.
|
/* Code dealing with dummy stack frames, for GDB, the GNU debugger.
|
|
|
Copyright (C) 2002, 2004, 2007, 2008, 2009, 2010
|
Copyright (C) 2002, 2004, 2007, 2008, 2009, 2010
|
Free Software Foundation, Inc.
|
Free Software Foundation, Inc.
|
|
|
This file is part of GDB.
|
This file is part of GDB.
|
|
|
This program is free software; you can redistribute it and/or modify
|
This program is free software; you can redistribute it and/or modify
|
it under the terms of the GNU General Public License as published by
|
it under the terms of the GNU General Public License as published by
|
the Free Software Foundation; either version 3 of the License, or
|
the Free Software Foundation; either version 3 of the License, or
|
(at your option) any later version.
|
(at your option) any later version.
|
|
|
This program is distributed in the hope that it will be useful,
|
This program is distributed in the hope that it will be useful,
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
GNU General Public License for more details.
|
GNU General Public License for more details.
|
|
|
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU General Public License
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
|
#if !defined (DUMMY_FRAME_H)
|
#if !defined (DUMMY_FRAME_H)
|
#define DUMMY_FRAME_H 1
|
#define DUMMY_FRAME_H 1
|
|
|
#include "frame.h"
|
#include "frame.h"
|
|
|
struct inferior_thread_state;
|
struct inferior_thread_state;
|
struct frame_unwind;
|
struct frame_unwind;
|
|
|
/* Push the information needed to identify, and unwind from, a dummy
|
/* Push the information needed to identify, and unwind from, a dummy
|
frame onto the dummy frame stack. */
|
frame onto the dummy frame stack. */
|
|
|
/* NOTE: cagney/2004-08-02: This interface will eventually need to be
|
/* NOTE: cagney/2004-08-02: This interface will eventually need to be
|
parameterized with the caller's thread - that will allow per-thread
|
parameterized with the caller's thread - that will allow per-thread
|
dummy-frame stacks and, hence, per-thread inferior function
|
dummy-frame stacks and, hence, per-thread inferior function
|
calls. */
|
calls. */
|
|
|
/* NOTE: cagney/2004-08-02: In the case of ABIs using push_dummy_code
|
/* NOTE: cagney/2004-08-02: In the case of ABIs using push_dummy_code
|
containing more than one instruction, this interface many need to
|
containing more than one instruction, this interface many need to
|
be expanded so that it knowns the lower/upper extent of the dummy
|
be expanded so that it knowns the lower/upper extent of the dummy
|
frame's code. */
|
frame's code. */
|
|
|
extern void dummy_frame_push (struct inferior_thread_state *caller_state,
|
extern void dummy_frame_push (struct inferior_thread_state *caller_state,
|
const struct frame_id *dummy_id);
|
const struct frame_id *dummy_id);
|
|
|
/* Pop the dummy frame DUMMY_ID, restoring program state to that before the
|
/* Pop the dummy frame DUMMY_ID, restoring program state to that before the
|
frame was created.
|
frame was created.
|
On return reinit_frame_cache has been called.
|
On return reinit_frame_cache has been called.
|
If the frame isn't found, flag an internal error.
|
If the frame isn't found, flag an internal error.
|
|
|
NOTE: This can only pop the one frame, even if it is in the middle of the
|
NOTE: This can only pop the one frame, even if it is in the middle of the
|
stack, because the other frames may be for different threads, and there's
|
stack, because the other frames may be for different threads, and there's
|
currently no way to tell which stack frame is for which thread. */
|
currently no way to tell which stack frame is for which thread. */
|
|
|
extern void dummy_frame_pop (struct frame_id dummy_id);
|
extern void dummy_frame_pop (struct frame_id dummy_id);
|
|
|
/* If the PC falls in a dummy frame, return a dummy frame
|
/* If the PC falls in a dummy frame, return a dummy frame
|
unwinder. */
|
unwinder. */
|
|
|
extern const struct frame_unwind *const dummy_frame_unwind;
|
extern const struct frame_unwind *const dummy_frame_unwind;
|
|
|
#endif /* !defined (DUMMY_FRAME_H) */
|
#endif /* !defined (DUMMY_FRAME_H) */
|
|
|
