sim/common/cgen-defs.h

   1 /* General Cpu tools GENerated simulator support.
   2    Copyright (C) 1996, 1997, 1998, 1999 Free Software Foundation, Inc.
   3    Contributed by Cygnus Support.
   4
   5 This file is part of GDB, the GNU debugger.
   6
   7 This program is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2, or (at your option)
  10 any later version.
  11
  12 This program is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License along
  18 with this program; if not, write to the Free Software Foundation, Inc.,
  19 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  20
  21 #ifndef CGEN_DEFS_H
  22 #define CGEN_DEFS_H
  23
  24 /* Compute number of longs required to hold N bits.  */
  25 #define HOST_LONGS_FOR_BITS(n) \
  26   (((n) + sizeof (long) * 8 - 1) / sizeof (long) * 8)
  27 \f
  28 /* Forward decls.  Defined in the machine generated files.  */
  29
  30 /* This holds the contents of the extracted insn.
  31    There are a few common entries (e.g. pc address), and then one big
  32    union with an entry for each of the instruction formats.  */
  33 typedef struct argbuf ARGBUF;
  34
  35 /* ARGBUF accessors.  */
  36 #define ARGBUF_ADDR(abuf) ((abuf)->addr)
  37 #define ARGBUF_IDESC(abuf) ((abuf)->idesc)
  38 #define ARGBUF_TRACE_P(abuf) ((abuf)->trace_p)
  39 #define ARGBUF_PROFILE_P(abuf) ((abuf)->profile_p)
  40
  41 /* This is one ARGBUF plus whatever else is needed for WITH_SCACHE support.
  42    At present there is nothing else, but it also provides a level of
  43    abstraction.  */
  44 typedef struct scache SCACHE;
  45
  46 /* This is a union with one entry for each instruction format.
  47    Each entry contains all of the non-constant inputs of the instruction
  48    in the case of read-before-exec support, or all outputs of the instruction
  49    in the case of write-after-exec support.  */
  50 typedef struct parexec PAREXEC;
  51
  52 /* An "Instruction DESCriptor".
  53    This is the main handle on an instruction for the simulator.  */
  54 typedef struct idesc IDESC;
  55 \f
  56 /* Engine support.
  57    ??? This is here because it's needed before eng.h (built by genmloop.sh)
  58    which is needed before cgen-engine.h and cpu.h.
  59    ??? This depends on a cpu family specific type, IADDR, but no machine
  60    generated headers will have been included yet.  sim/common currently
  61    requires the typedef of sim_cia in sim-main.h between the inclusion of
  62    sim-basics.h and sim-base.h so this is no different.  */
  63
  64 /* SEM_ARG is intended to hide whether or not the scache is in use from the
  65    semantic routines.  In reality for the with-extraction case it is always
  66    an SCACHE * even when not using the SCACHE since there's no current win to
  67    making it something else ("not using the SCACHE" is like having a cache
  68    size of 1).
  69    The without-extraction case still uses an ARGBUF:
  70    - consistency with scache version
  71    - still need to record which operands are written
  72      This wouldn't be needed if modeling was done in the semantic routines
  73      but this isn't as general as handling it outside of the semantic routines.
  74      For example Shade allows calling user-supplied code before/after each
  75      instruction and this is something that is being planned.
  76    ??? There is still some clumsiness in how much of ARGBUF to use.  */
  77 typedef SCACHE *SEM_ARG;
  78
  79 /* instruction address
  80    ??? This was intended to be a struct of two elements in the WITH_SCACHE_PBB
  81    case.  The first element is the IADDR, the second element is the SCACHE *.
  82    Haven't found the time yet to make this work, but it seemed a nicer approach
  83    than the current br_cache stuff.  */
  84 typedef IADDR PCADDR;
  85
  86 /* Current instruction address, used by common. */
  87 typedef IADDR CIA;
  88
  89 /* Semantic routines' version of the PC.  */
  90 #if WITH_SCACHE_PBB
  91 typedef SCACHE *SEM_PC;
  92 #else
  93 typedef IADDR SEM_PC;
  94 #endif
  95 \f
  96 /* Virtual insn support.  */
  97
  98 /* Opcode table for virtual insns (only used by the simulator).  */
  99 extern const CGEN_INSN cgen_virtual_insn_table[];
 100
 101 /* -ve of indices of virtual insns in cgen_virtual_insn_table.  */
 102 typedef enum {
 103   VIRTUAL_INSN_X_INVALID = 0,
 104   VIRTUAL_INSN_X_BEFORE = -1, VIRTUAL_INSN_X_AFTER = -2,
 105   VIRTUAL_INSN_X_BEGIN = -3,
 106   VIRTUAL_INSN_X_CHAIN= -4, VIRTUAL_INSN_X_CTI_CHAIN = -5
 107 } CGEN_INSN_VIRTUAL_TYPE;
 108
 109 /* Return non-zero if OPCODE is a virtual insn.  */
 110 #define CGEN_INSN_VIRTUAL_P(insn) \
 111   CGEN_INSN_ATTR_VALUE ((insn), CGEN_INSN_VIRTUAL)
 112 \f
 113 /* GNU C's "computed goto" facility is used to speed things up where
 114    possible.  These macros provide a portable way to use them.
 115    Nesting of these switch statements is done by providing an extra argument
 116    that distinguishes them.  `N' can be a number or symbol.
 117    Variable `labels_##N' must be initialized with the labels of each case.  */
 118
 119 #ifdef __GNUC__
 120 #define SWITCH(N, X) goto *X;
 121 #define CASE(N, X) case_##N##_##X
 122 #define BREAK(N) goto end_switch_##N
 123 #define DEFAULT(N) default_##N
 124 #define ENDSWITCH(N) end_switch_##N:
 125 #else
 126 #define SWITCH(N, X) switch (X)
 127 #define CASE(N, X) case X /* FIXME: old sem-switch had (@arch@_,X) here */
 128 #define BREAK(N) break
 129 #define DEFAULT(N) default
 130 #define ENDSWITCH(N)
 131 #endif
 132 \f
 133 /* Simulator state.  */
 134
 135 /* Records simulator descriptor so utilities like @cpu@_dump_regs can be
 136    called from gdb.  */
 137 extern SIM_DESC current_state;
 138
 139 /* Simulator state.  */
 140
 141 /* CGEN_STATE contains additional state information not present in
 142    sim_state_base.  */
 143
 144 typedef struct cgen_state {
 145   /* FIXME: Moved to sim_state_base.  */
 146   /* argv, env */
 147   char **argv;
 148 #define STATE_ARGV(s) ((s) -> cgen_state.argv)
 149   /* FIXME: Move to sim_state_base.  */
 150   char **envp;
 151 #define STATE_ENVP(s) ((s) -> cgen_state.envp)
 152
 153   /* Non-zero if no tracing or profiling is selected.  */
 154   int run_fast_p;
 155 #define STATE_RUN_FAST_P(sd) ((sd) -> cgen_state.run_fast_p)
 156 } CGEN_STATE;
 157 \f
 158 /* Various utilities.  */
 159
 160 /* Called after sim_post_argv_init to do any cgen initialization.  */
 161 extern void cgen_init (SIM_DESC);
 162
 163 /* Return the name of an insn.  */
 164 extern CPU_INSN_NAME_FN cgen_insn_name;
 165
 166 /* Return the maximum number of extra bytes required for a sim_cpu struct.  */
 167 /* ??? Ok, yes, this is less pretty than it should be.  Give me a better
 168    language [or suggest a better way].  */
 169 extern int cgen_cpu_max_extra_bytes (void);
 170
 171 /* Called to process an invalid instruction.  */
 172 extern void sim_engine_invalid_insn (SIM_CPU *, IADDR);
 173
 174 #endif /* CGEN_DEFS_H */