1145171Sdas/* This file defines the part of the interface between the standalone
2145171Sdas   simaulator program - run - and simulator library - libsim.a - that
3145171Sdas   is not used by GDB.  The GDB part is described in include/remote-sim.h.
4145171Sdas
5145171Sdas   Copyright 2002, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
6145171Sdas
7145171Sdas   This file is part of GDB.
8145171Sdas
9145171Sdas   This program is free software; you can redistribute it and/or modify
10145171Sdas   it under the terms of the GNU General Public License as published by
11145171Sdas   the Free Software Foundation; either version 3 of the License, or
12145171Sdas   (at your option) any later version.
13145171Sdas
14145171Sdas   This program is distributed in the hope that it will be useful,
15145171Sdas   but WITHOUT ANY WARRANTY; without even the implied warranty of
16145171Sdas   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17192760Sattilio   GNU General Public License for more details.
18145171Sdas
19145171Sdas   You should have received a copy of the GNU General Public License
20145171Sdas   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
21217108Skib
22217108Skib#ifndef RUN_SIM_H
23#define RUN_SIM_H
24
25#ifdef SIM_TARGET_SWITCHES
26  /* Parse the command line, extracting any target specific switches
27     before the generic simulator code gets a chance to complain
28     about them.  Returns the adjusted value of argc.  */
29int sim_target_parse_command_line PARAMS ((int, char **));
30
31  /* Display a list of target specific switches supported by this
32     target.  */
33void sim_target_display_usage PARAMS ((int help));
34
35#endif
36
37/* Provide simulator with a default (global) host_callback_struct.
38   THIS PROCEDURE IS DEPRECATED.
39   GDB and NRUN do not use this interface.
40   This procedure does not take a SIM_DESC argument as it is
41   used before sim_open. */
42
43void sim_set_callbacks PARAMS ((struct host_callback_struct *));
44
45
46/* Set the size of the simulator memory array.
47   THIS PROCEDURE IS DEPRECATED.
48   GDB and NRUN do not use this interface.
49   This procedure does not take a SIM_DESC argument as it is
50   used before sim_open. */
51
52void sim_size PARAMS ((int i));
53
54
55/* Single-step simulator with tracing enabled.
56   THIS PROCEDURE IS DEPRECATED.
57   THIS PROCEDURE IS EVEN MORE DEPRECATED THAN SIM_SET_TRACE
58   GDB and NRUN do not use this interface.
59   This procedure returns: ``0'' indicating that the simulator should
60   be continued using sim_trace() calls; ``1'' indicating that the
61   simulation has finished. */
62
63int sim_trace PARAMS ((SIM_DESC sd));
64
65
66/* Enable tracing.
67   THIS PROCEDURE IS DEPRECATED.
68   GDB and NRUN do not use this interface.
69   This procedure returns: ``0'' indicating that the simulator should
70   be continued using sim_trace() calls; ``1'' indicating that the
71   simulation has finished. */
72
73void sim_set_trace PARAMS ((void));
74
75
76/* Configure the size of the profile buffer.
77   THIS PROCEDURE IS DEPRECATED.
78   GDB and NRUN do not use this interface.
79   This procedure does not take a SIM_DESC argument as it is
80   used before sim_open. */
81
82void sim_set_profile_size PARAMS ((int n));
83
84
85/* Kill the running program.
86   THIS PROCEDURE IS DEPRECATED.
87   GDB and NRUN do not use this interface.
88   This procedure will be replaced as part of the introduction of
89   multi-cpu simulators. */
90
91void sim_kill PARAMS ((SIM_DESC sd));
92
93#endif
94