X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Fdummy-frame.h;h=1d43510947131f1868874c6290b168cff707b271;hb=fcf23d5b654b0fc05e99c445ebd471221a290cf4;hp=f6469c278662088c07a8b2d2f3420d25dcc583a1;hpb=a9762ec78a53fbe9209fe1654db42df0cd328d50;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/dummy-frame.h b/gdb/dummy-frame.h index f6469c2786..1d43510947 100644 --- a/gdb/dummy-frame.h +++ b/gdb/dummy-frame.h @@ -1,6 +1,6 @@ /* Code dealing with dummy stack frames, for GDB, the GNU debugger. - Copyright (C) 2002, 2004, 2007 Free Software Foundation, Inc. + Copyright (C) 2002-2020 Free Software Foundation, Inc. This file is part of GDB. @@ -20,30 +20,64 @@ #if !defined (DUMMY_FRAME_H) #define DUMMY_FRAME_H 1 -struct frame_info; -struct regcache; +#include "frame.h" + +struct infcall_suspend_state; struct frame_unwind; -struct frame_id; +class thread_info; /* Push the information needed to identify, and unwind from, a dummy frame onto the dummy frame stack. */ -/* NOTE: cagney/2004-08-02: This interface will eventually need to be - parameterized with the caller's thread - that will allow per-thread - dummy-frame stacks and, hence, per-thread inferior function - calls. */ - /* NOTE: cagney/2004-08-02: In the case of ABIs using push_dummy_code containing more than one instruction, this interface many need to be expanded so that it knowns the lower/upper extent of the dummy frame's code. */ -extern void dummy_frame_push (struct regcache *regcache, - const struct frame_id *dummy_id); +extern void dummy_frame_push (infcall_suspend_state *caller_state, + const frame_id *dummy_id, + thread_info *thread); + +/* Pop the dummy frame DUMMY_ID, restoring program state to that before the + frame was created. + On return reinit_frame_cache has been called. + 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 + 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. */ + +extern void dummy_frame_pop (frame_id dummy_id, thread_info *thread); + +extern void dummy_frame_discard (frame_id dummy_id, thread_info *thread); /* If the PC falls in a dummy frame, return a dummy frame unwinder. */ -extern const struct frame_unwind *const dummy_frame_unwind; +extern const struct frame_unwind dummy_frame_unwind; + +/* Destructor for dummy_frame. DATA is supplied by registrant. + REGISTERS_VALID is 1 for dummy_frame_pop, 0 for dummy_frame_discard. */ +typedef void (dummy_frame_dtor_ftype) (void *data, int registers_valid); + +/* Call DTOR with DTOR_DATA when DUMMY_ID frame of thread THREAD gets + discarded. Dummy frame with DUMMY_ID must exist. Multiple + destructors may be registered, they will be called in the reverse + order of registrations (LIFO). */ +extern void register_dummy_frame_dtor (frame_id dummy_id, + thread_info *thread, + dummy_frame_dtor_ftype *dtor, + void *dtor_data); + +/* Return 1 if there exists any dummy frame with any of its registered + destructors equal to both DTOR and DTOR_DATA. Return 0 otherwise. */ +extern int find_dummy_frame_dtor (dummy_frame_dtor_ftype *dtor, + void *dtor_data); + +/* Default implementation of gdbarch_dummy_id. Generate a dummy frame_id + for THIS_FRAME assuming that the frame is a dummy frame. */ + +extern struct frame_id default_dummy_id (struct gdbarch *gdbarch, + struct frame_info *this_frame); #endif /* !defined (DUMMY_FRAME_H) */