/* Module support.
|
/* Module support.
|
Copyright (C) 1996, 1997, 2007, 2008, 2009, 2010
|
Copyright (C) 1996, 1997, 2007, 2008, 2009, 2010
|
Free Software Foundation, Inc.
|
Free Software Foundation, Inc.
|
Contributed by Cygnus Support.
|
Contributed by Cygnus Support.
|
|
|
This file is part of GDB, the GNU debugger.
|
This file is part of GDB, the GNU debugger.
|
|
|
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/>. */
|
|
|
/* This file is intended to be included by sim-base.h. */
|
/* This file is intended to be included by sim-base.h. */
|
|
|
#ifndef SIM_MODULES_H
|
#ifndef SIM_MODULES_H
|
#define SIM_MODULES_H
|
#define SIM_MODULES_H
|
|
|
/* Modules are addons to the simulator that perform a specific function
|
/* Modules are addons to the simulator that perform a specific function
|
(e.g. tracing, profiling, memory subsystem, etc.). Some modules are
|
(e.g. tracing, profiling, memory subsystem, etc.). Some modules are
|
builtin, and others are added at configure time. The intent is to
|
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
|
provide a uniform framework for all of the pieces that make up the
|
simulator.
|
simulator.
|
|
|
TODO: Add facilities for saving/restoring state to/from a file. */
|
TODO: Add facilities for saving/restoring state to/from a file. */
|
|
|
|
|
/* Various function types. */
|
/* Various function types. */
|
|
|
typedef SIM_RC (MODULE_INSTALL_FN) (SIM_DESC);
|
typedef SIM_RC (MODULE_INSTALL_FN) (SIM_DESC);
|
typedef SIM_RC (MODULE_INIT_FN) (SIM_DESC);
|
typedef SIM_RC (MODULE_INIT_FN) (SIM_DESC);
|
typedef SIM_RC (MODULE_RESUME_FN) (SIM_DESC);
|
typedef SIM_RC (MODULE_RESUME_FN) (SIM_DESC);
|
typedef SIM_RC (MODULE_SUSPEND_FN) (SIM_DESC);
|
typedef SIM_RC (MODULE_SUSPEND_FN) (SIM_DESC);
|
typedef void (MODULE_UNINSTALL_FN) (SIM_DESC);
|
typedef void (MODULE_UNINSTALL_FN) (SIM_DESC);
|
typedef void (MODULE_INFO_FN) (SIM_DESC, int);
|
typedef void (MODULE_INFO_FN) (SIM_DESC, int);
|
|
|
|
|
/* Lists of installed handlers. */
|
/* Lists of installed handlers. */
|
|
|
typedef struct module_init_list {
|
typedef struct module_init_list {
|
struct module_init_list *next;
|
struct module_init_list *next;
|
MODULE_INIT_FN *fn;
|
MODULE_INIT_FN *fn;
|
} MODULE_INIT_LIST;
|
} MODULE_INIT_LIST;
|
|
|
typedef struct module_resume_list {
|
typedef struct module_resume_list {
|
struct module_resume_list *next;
|
struct module_resume_list *next;
|
MODULE_RESUME_FN *fn;
|
MODULE_RESUME_FN *fn;
|
} MODULE_RESUME_LIST;
|
} MODULE_RESUME_LIST;
|
|
|
typedef struct module_suspend_list {
|
typedef struct module_suspend_list {
|
struct module_suspend_list *next;
|
struct module_suspend_list *next;
|
MODULE_SUSPEND_FN *fn;
|
MODULE_SUSPEND_FN *fn;
|
} MODULE_SUSPEND_LIST;
|
} MODULE_SUSPEND_LIST;
|
|
|
typedef struct module_uninstall_list {
|
typedef struct module_uninstall_list {
|
struct module_uninstall_list *next;
|
struct module_uninstall_list *next;
|
MODULE_UNINSTALL_FN *fn;
|
MODULE_UNINSTALL_FN *fn;
|
} MODULE_UNINSTALL_LIST;
|
} MODULE_UNINSTALL_LIST;
|
|
|
typedef struct module_info_list {
|
typedef struct module_info_list {
|
struct module_info_list *next;
|
struct module_info_list *next;
|
MODULE_INFO_FN *fn;
|
MODULE_INFO_FN *fn;
|
} MODULE_INFO_LIST;
|
} MODULE_INFO_LIST;
|
|
|
|
|
/* Functions to register module with various handler lists */
|
/* Functions to register module with various handler lists */
|
|
|
SIM_RC sim_module_install (SIM_DESC);
|
SIM_RC sim_module_install (SIM_DESC);
|
void sim_module_uninstall (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_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_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_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_uninstall_fn (SIM_DESC sd, MODULE_UNINSTALL_FN fn);
|
void sim_module_add_info_fn (SIM_DESC sd, MODULE_INFO_FN fn);
|
void sim_module_add_info_fn (SIM_DESC sd, MODULE_INFO_FN fn);
|
|
|
|
|
/* Initialize installed modules before argument processing.
|
/* Initialize installed modules before argument processing.
|
Called by sim_open. */
|
Called by sim_open. */
|
SIM_RC sim_pre_argv_init (SIM_DESC sd, const char *myname);
|
SIM_RC sim_pre_argv_init (SIM_DESC sd, const char *myname);
|
|
|
/* Initialize installed modules after argument processing.
|
/* Initialize installed modules after argument processing.
|
Called by sim_open. */
|
Called by sim_open. */
|
SIM_RC sim_post_argv_init (SIM_DESC sd);
|
SIM_RC sim_post_argv_init (SIM_DESC sd);
|
|
|
/* Re-initialize the module. Called by sim_create_inferior. */
|
/* Re-initialize the module. Called by sim_create_inferior. */
|
SIM_RC sim_module_init (SIM_DESC sd);
|
SIM_RC sim_module_init (SIM_DESC sd);
|
|
|
/* Suspend/resume modules. Called by sim_run or sim_resume */
|
/* Suspend/resume modules. Called by sim_run or sim_resume */
|
SIM_RC sim_module_suspend (SIM_DESC sd);
|
SIM_RC sim_module_suspend (SIM_DESC sd);
|
SIM_RC sim_module_resume (SIM_DESC sd);
|
SIM_RC sim_module_resume (SIM_DESC sd);
|
|
|
/* Report general information on module */
|
/* Report general information on module */
|
void sim_module_info (SIM_DESC sd, int verbose);
|
void sim_module_info (SIM_DESC sd, int verbose);
|
|
|
|
|
/* Module private data */
|
/* Module private data */
|
|
|
struct module_list {
|
struct module_list {
|
|
|
/* List of installed module `init' handlers */
|
/* List of installed module `init' handlers */
|
MODULE_INIT_LIST *init_list;
|
MODULE_INIT_LIST *init_list;
|
|
|
/* List of installed module `uninstall' handlers. */
|
/* List of installed module `uninstall' handlers. */
|
MODULE_UNINSTALL_LIST *uninstall_list;
|
MODULE_UNINSTALL_LIST *uninstall_list;
|
|
|
/* List of installed module `resume' handlers. */
|
/* List of installed module `resume' handlers. */
|
MODULE_RESUME_LIST *resume_list;
|
MODULE_RESUME_LIST *resume_list;
|
|
|
/* List of installed module `suspend' handlers. */
|
/* List of installed module `suspend' handlers. */
|
MODULE_SUSPEND_LIST *suspend_list;
|
MODULE_SUSPEND_LIST *suspend_list;
|
|
|
/* List of installed module `info' handlers. */
|
/* List of installed module `info' handlers. */
|
MODULE_INFO_LIST *info_list;
|
MODULE_INFO_LIST *info_list;
|
|
|
};
|
};
|
|
|
|
|
#endif /* SIM_MODULES_H */
|
#endif /* SIM_MODULES_H */
|
|
|
