1/* This file defines the part of the interface between the standalone
2   simaulator program - run - and simulator library - libsim.a - that
3   is not used by GDB.  The GDB part is described in include/remote-sim.h.
4
5   Copyright 2002, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
6
7   This file is part of GDB.
8
9   This program is free software; you can redistribute it and/or modify
10   it under the terms of the GNU General Public License as published by
11   the Free Software Foundation; either version 3 of the License, or
12   (at your option) any later version.
13
14   This program is distributed in the hope that it will be useful,
15   but WITHOUT ANY WARRANTY; without even the implied warranty of
16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17   GNU General Public License for more details.
18
19   You should have received a copy of the GNU General Public License
20   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
21
22#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