[deliverable/binutils-gdb.git] / sim / common / cgen-sim.h

/* Simulator header for Cpu tools GENerated simulators.
   Copyright (C) 1996, 1997 Free Software Foundation, Inc.
   Contributed by Cygnus Support.

This file is part of GDB, the GNU debugger.

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
the Free Software Foundation; either version 2, or (at your option)
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */

#ifndef CGEN_SIM_H
#define CGEN_SIM_H

#define PC (STATE_CPU_CPU (current_state, 0)->pc)

/* Execution state.  */
enum exec_state {
  EXEC_STATE_RUNNING, EXEC_STATE_EXITED,
  EXEC_STATE_STOPPED, EXEC_STATE_SIGNALLED
};

/* Signals we use.  */
enum sim_signal_type {
  SIM_SIGNONE,
  SIM_SIGILL,    /* illegal insn */
  SIM_SIGTRAP,
  SIM_SIGALIGN,  /* misaligned memory access */
  SIM_SIGACCESS, /* tried to read/write memory that's not readable/writable */
  SIM_SIGXCPU    /* cpu limit exceeded */
};

void engine_halt PARAMS ((struct _sim_cpu *, enum exec_state, int));
void engine_signal PARAMS ((struct _sim_cpu *, enum sim_signal_type));
\f
/* Instruction field support macros.  */

#define EXTRACT_SIGNED(val, total, start, length) \
(((((val) >> ((total) - ((start) + (length)))) & ((1 << (length)) - 1)) \
  ^ (1 << ((length) - 1))) \
 - (1 << ((length) - 1)))

#define EXTRACT_UNSIGNED(val, total, start, length) \
(((val) >> ((total) - ((start) + (length)))) & ((1 << (length)) - 1))

/* Compute number of longs required to hold N bits.  */
#define HOST_LONGS_FOR_BITS(n) \
  (((n) + sizeof (long) * 8 - 1) / sizeof (long) * 8)
\f
/* Decode,extract,semantics.  */

typedef void (EXTRACT_FN) PARAMS ((SIM_CPU *, PCADDR, insn_t, struct argbuf *));
/*typedef CIA (SEMANTIC_FN) PARAMS ((SEM_ARG));*/
typedef PCADDR (SEMANTIC_FN) PARAMS ((SIM_CPU *, struct argbuf *));
#if 0 /* wip */
typedef void (EXTRACT_CACHE_FN) PARAMS ((SIM_CPU *, PCADDR, insn_t, struct argbuf *));
#endif
typedef PCADDR (SEMANTIC_CACHE_FN) PARAMS ((SIM_CPU *, struct scache *));

typedef struct {
  /* Using cgen_insn_type requires <cpu>-opc.h.  */
  int /*enum cgen_insn_type*/ insn_type;
  const struct cgen_insn *opcode;
  /* FIXME: Perhaps rename these to normal/fast versions to associate them
     with the normal/fast args to genmloop.sh.  */
  EXTRACT_FN *extract;
  SEMANTIC_FN *semantic;
#if 0 /* wip */
  EXTRACT_CACHE_FN *extract_fast;
#endif
  SEMANTIC_CACHE_FN *semantic_fast;
#if defined (USE_SEM_SWITCH) && defined (__GNUC__)
  void *semantic_lab;
#endif
} DECODE;

/* FIXME: length parm to decode() is currently unneeded.  */
extern DECODE *decode PARAMS ((insn_t /*, int*/));
\f
/* Simulator state.  */

#if WITH_SCACHE
#include "cgen-scache.h"
#endif

/* ??? Do we *need* to pass state to the semantic routines?  */
extern SIM_DESC current_state;

/* FIXME: Until sim_open creates one.  */
extern struct sim_state sim_global_state;

/* Simulator state.  */

/* Main state struct.
   CGEN_STATE contains addition state information not present in
   sim_state_base.  */

typedef struct cgen_state {
  /* argv, env */
  char **argv;
#define STATE_ARGV(s) ((s)->cgen_state.argv)
  char **envp;
#define STATE_ENVP(s) ((s)->cgen_state.envp)
} CGEN_STATE;

/* Additional per-cpu data.  */

typedef struct {
  /* Simulator's execution cache.  */
#if WITH_SCACHE
  CPU_SCACHE scache;
#endif /* WITH_SCACHE */

  enum exec_state exec_state;
#define CPU_EXEC_STATE(cpu) ((cpu)->cgen_cpu.exec_state)

  int halt_sigrc;
#define CPU_HALT_SIGRC(cpu) ((cpu)->cgen_cpu.halt_sigrc)

  jmp_buf halt_jmp_buf;
#define CPU_HALT_JMP_BUF(cpu) ((cpu)->cgen_cpu.halt_jmp_buf)

  CPU_DATA cpu;
#define CPU_CPU(c) (& (c)->cgen_cpu.cpu)
  CPU_PROFILE profile_state;
#define CPU_PROFILE_STATE(cpu) (& (cpu)->cgen_cpu.profile_state)
} CGEN_CPU;
\f
/* Various utilities.  */

int engine_stop (SIM_DESC);
void engine_run (SIM_DESC, int, int);
void engine_resume (SIM_DESC, int, int);
void engine_halt (SIM_CPU *, enum exec_state, int);
void engine_signal (SIM_CPU *, enum sim_signal_type);

int sim_signal_to_host (int);

void
sim_disassemble_insn (const struct cgen_insn *, const struct argbuf *,
		      PCADDR, char *);

#endif /* CGEN_SIM_H */
Commit	Line	Data
b9c8cd10 DE	1	/* Simulator header for Cpu tools GENerated simulators.
	2	Copyright (C) 1996, 1997 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_SIM_H
	22	#define CGEN_SIM_H
	23
	24	#define PC (STATE_CPU_CPU (current_state, 0)->pc)
	25
	26	/* Execution state. */
	27	enum exec_state {
	28	EXEC_STATE_RUNNING, EXEC_STATE_EXITED,
	29	EXEC_STATE_STOPPED, EXEC_STATE_SIGNALLED
	30	};
	31
	32	/* Signals we use. */
	33	enum sim_signal_type {
	34	SIM_SIGNONE,
	35	SIM_SIGILL, /* illegal insn */
	36	SIM_SIGTRAP,
	37	SIM_SIGALIGN, /* misaligned memory access */
	38	SIM_SIGACCESS, /* tried to read/write memory that's not readable/writable */
	39	SIM_SIGXCPU /* cpu limit exceeded */
	40	};
	41
	42	void engine_halt PARAMS ((struct _sim_cpu *, enum exec_state, int));
	43	void engine_signal PARAMS ((struct _sim_cpu *, enum sim_signal_type));
	44	\f
2c8f0de6 DE	45	/* Instruction field support macros. */
	46
	47	#define EXTRACT_SIGNED(val, total, start, length) \
	48	(((((val) >> ((total) - ((start) + (length)))) & ((1 << (length)) - 1)) \
	49	^ (1 << ((length) - 1))) \
	50	- (1 << ((length) - 1)))
	51
	52	#define EXTRACT_UNSIGNED(val, total, start, length) \
	53	(((val) >> ((total) - ((start) + (length)))) & ((1 << (length)) - 1))
	54
	55	/* Compute number of longs required to hold N bits. */
	56	#define HOST_LONGS_FOR_BITS(n) \
	57	(((n) + sizeof (long) * 8 - 1) / sizeof (long) * 8)
	58	\f
b9c8cd10 DE	59	/* Decode,extract,semantics. */
	60
	61	typedef void (EXTRACT_FN) PARAMS ((SIM_CPU , PCADDR, insn_t, struct argbuf ));
	62	/typedef CIA (SEMANTIC_FN) PARAMS ((SEM_ARG));/
	63	typedef PCADDR (SEMANTIC_FN) PARAMS ((SIM_CPU , struct argbuf ));
	64	#if 0 /* wip */
	65	typedef void (EXTRACT_CACHE_FN) PARAMS ((SIM_CPU , PCADDR, insn_t, struct argbuf ));
	66	#endif
	67	typedef PCADDR (SEMANTIC_CACHE_FN) PARAMS ((SIM_CPU , struct scache ));
	68
	69	typedef struct {
	70	/* Using cgen_insn_type requires <cpu>-opc.h. */
	71	int /enum cgen_insn_type/ insn_type;
	72	const struct cgen_insn *opcode;
	73	/* FIXME: Perhaps rename these to normal/fast versions to associate them
	74	with the normal/fast args to genmloop.sh. */
	75	EXTRACT_FN *extract;
	76	SEMANTIC_FN *semantic;
	77	#if 0 /* wip */
	78	EXTRACT_CACHE_FN *extract_fast;
	79	#endif
	80	SEMANTIC_CACHE_FN *semantic_fast;
	81	#if defined (USE_SEM_SWITCH) && defined (__GNUC__)
	82	void *semantic_lab;
	83	#endif
	84	} DECODE;
	85
	86	/* FIXME: length parm to decode() is currently unneeded. */
	87	extern DECODE decode PARAMS ((insn_t /, int*/));
	88	\f
	89	/* Simulator state. */
	90
	91	#if WITH_SCACHE
	92	#include "cgen-scache.h"
	93	#endif
	94
	95	/* ??? Do we need to pass state to the semantic routines? */
	96	extern SIM_DESC current_state;
	97
	98	/* FIXME: Until sim_open creates one. */
	99	extern struct sim_state sim_global_state;
	100
	101	/* Simulator state. */
	102
	103	/* Main state struct.
	104	CGEN_STATE contains addition state information not present in
	105	sim_state_base. */
	106
	107	typedef struct cgen_state {
	108	/* argv, env */
	109	char **argv;
	110	#define STATE_ARGV(s) ((s)->cgen_state.argv)
	111	char **envp;
	112	#define STATE_ENVP(s) ((s)->cgen_state.envp)
	113	} CGEN_STATE;
	114
	115	/* Additional per-cpu data. */
	116
	117	typedef struct {
	118	/* Simulator's execution cache. */
	119	#if WITH_SCACHE
	120	CPU_SCACHE scache;
	121	#endif /* WITH_SCACHE */
	122
123	enum exec_state exec_state;
124	#define CPU_EXEC_STATE(cpu) ((cpu)->cgen_cpu.exec_state)
125
126	int halt_sigrc;
127	#define CPU_HALT_SIGRC(cpu) ((cpu)->cgen_cpu.halt_sigrc)
128
129	jmp_buf halt_jmp_buf;
130	#define CPU_HALT_JMP_BUF(cpu) ((cpu)->cgen_cpu.halt_jmp_buf)
131
132	CPU_DATA cpu;
133	#define CPU_CPU(c) (& (c)->cgen_cpu.cpu)
134	CPU_PROFILE profile_state;
135	#define CPU_PROFILE_STATE(cpu) (& (cpu)->cgen_cpu.profile_state)
136	} CGEN_CPU;
137	\f
138	/* Various utilities. */
139
140	int engine_stop (SIM_DESC);
141	void engine_run (SIM_DESC, int, int);
142	void engine_resume (SIM_DESC, int, int);
143	void engine_halt (SIM_CPU *, enum exec_state, int);
144	void engine_signal (SIM_CPU *, enum sim_signal_type);
145
146	int sim_signal_to_host (int);
147
148	void
149	sim_disassemble_insn (const struct cgen_insn , const struct argbuf ,
150	PCADDR, char *);
151
152	#endif /* CGEN_SIM_H */