sim/common/run-sim.h

   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.  */
  29 int sim_target_parse_command_line PARAMS ((int, char **));
  30
  31   /* Display a list of target specific switches supported by this
  32      target.  */
  33 void 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
  43 void 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
  52 void 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
  63 int 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
  73 void 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
  82 void 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
  91 void sim_kill PARAMS ((SIM_DESC sd));
  92
  93 #endif