| /* Module support. |
| Copyright (C) 1996, 1997 Free Software Foundation, Inc. |
| Contributed by Cygnus Support. |
| |
| This file is part of GDB, the GNU debugger. |
| |
| 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 |
| the Free Software Foundation; either version 2, or (at your option) |
| any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License along |
| with this program; if not, write to the Free Software Foundation, Inc., |
| 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ |
| |
| /* This file is intended to be included by sim-base.h. */ |
| |
| #ifndef SIM_MODULES_H |
| #define SIM_MODULES_H |
| |
| /* Modules are addons to the simulator that perform a specific function |
| (e.g. tracing, profiling, memory subsystem, etc.). Some modules are |
| builtin, and others are added at configure time. The intent is to |
| provide a uniform framework for all of the pieces that make up the |
| simulator. |
| |
| TODO: Add facilities for saving/restoring state to/from a file. */ |
| |
| |
| /* Various function types. */ |
| |
| typedef SIM_RC (MODULE_INSTALL_FN) (SIM_DESC); |
| typedef SIM_RC (MODULE_INIT_FN) (SIM_DESC); |
| typedef SIM_RC (MODULE_RESUME_FN) (SIM_DESC); |
| typedef SIM_RC (MODULE_SUSPEND_FN) (SIM_DESC); |
| typedef void (MODULE_UNINSTALL_FN) (SIM_DESC); |
| typedef void (MODULE_INFO_FN) (SIM_DESC, int); |
| |
| |
| /* Lists of installed handlers. */ |
| |
| typedef struct module_init_list { |
| struct module_init_list *next; |
| MODULE_INIT_FN *fn; |
| } MODULE_INIT_LIST; |
| |
| typedef struct module_resume_list { |
| struct module_resume_list *next; |
| MODULE_RESUME_FN *fn; |
| } MODULE_RESUME_LIST; |
| |
| typedef struct module_suspend_list { |
| struct module_suspend_list *next; |
| MODULE_SUSPEND_FN *fn; |
| } MODULE_SUSPEND_LIST; |
| |
| typedef struct module_uninstall_list { |
| struct module_uninstall_list *next; |
| MODULE_UNINSTALL_FN *fn; |
| } MODULE_UNINSTALL_LIST; |
| |
| typedef struct module_info_list { |
| struct module_info_list *next; |
| MODULE_INFO_FN *fn; |
| } MODULE_INFO_LIST; |
| |
| |
| /* Functions to register module with various handler lists */ |
| |
| SIM_RC sim_module_install (SIM_DESC); |
| void sim_module_uninstall (SIM_DESC); |
| void sim_module_add_init_fn (SIM_DESC sd, MODULE_INIT_FN fn); |
| void sim_module_add_resume_fn (SIM_DESC sd, MODULE_RESUME_FN fn); |
| void sim_module_add_suspend_fn (SIM_DESC sd, MODULE_SUSPEND_FN fn); |
| void sim_module_add_uninstall_fn (SIM_DESC sd, MODULE_UNINSTALL_FN fn); |
| void sim_module_add_info_fn (SIM_DESC sd, MODULE_INFO_FN fn); |
| |
| |
| /* Initialize installed modules before argument processing. |
| Called by sim_open. */ |
| SIM_RC sim_pre_argv_init (SIM_DESC sd, const char *myname); |
| |
| /* Initialize installed modules after argument processing. |
| Called by sim_open. */ |
| SIM_RC sim_post_argv_init (SIM_DESC sd); |
| |
| /* Re-initialize the module. Called by sim_create_inferior. */ |
| SIM_RC sim_module_init (SIM_DESC sd); |
| |
| /* Suspend/resume modules. Called by sim_run or sim_resume */ |
| SIM_RC sim_module_suspend (SIM_DESC sd); |
| SIM_RC sim_module_resume (SIM_DESC sd); |
| |
| /* Report general information on module */ |
| void sim_module_info (SIM_DESC sd, int verbose); |
| |
| |
| /* Module private data */ |
| |
| struct module_list { |
| |
| /* List of installed module `init' handlers */ |
| MODULE_INIT_LIST *init_list; |
| |
| /* List of installed module `uninstall' handlers. */ |
| MODULE_UNINSTALL_LIST *uninstall_list; |
| |
| /* List of installed module `resume' handlers. */ |
| MODULE_RESUME_LIST *resume_list; |
| |
| /* List of installed module `suspend' handlers. */ |
| MODULE_SUSPEND_LIST *suspend_list; |
| |
| /* List of installed module `info' handlers. */ |
| MODULE_INFO_LIST *info_list; |
| |
| }; |
| |
| |
| #endif /* SIM_MODULES_H */ |