mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-11-26 19:44:11 +08:00
add some comments
This commit is contained in:
Doug Evans
parent
badb1b5196
commit
d4df1e3023
263
sim/common/cgen-engine.h
Normal file
263
sim/common/cgen-engine.h
Normal file
@ -0,0 +1,263 @@
|
||||
/* Simulator header for the cgen engine.
|
||||
Copyright (C) 1998 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. */
|
||||
|
||||
/* This file must be included after eng.h has been included
|
||||
as it specifies the configuration of the engine. */
|
||||
|
||||
#ifndef CGEN_ENGINE_H
|
||||
#define CGEN_ENGINE_H
|
||||
|
||||
/* Execution support. */
|
||||
|
||||
#if WITH_SCACHE
|
||||
|
||||
/* instruction address
|
||||
??? This was intended to be a struct of two elements in the WITH_SCACHE_PBB
|
||||
case. The first element is the PCADDR, the second element is the SCACHE *.
|
||||
Haven't found the time yet to make this work, but it is a nicer approach
|
||||
than the current br_cache stuff. */
|
||||
typedef PCADDR IADDR;
|
||||
/* current instruction address */
|
||||
typedef PCADDR CIA;
|
||||
/* argument to semantic functions */
|
||||
typedef SCACHE *SEM_ARG;
|
||||
/* semantic code's version of pc */
|
||||
#if WITH_SCACHE_PBB
|
||||
typedef SCACHE *SEM_PC;
|
||||
#else
|
||||
typedef PCADDR SEM_PC;
|
||||
#endif
|
||||
|
||||
#else /* ! WITH_SCACHE */
|
||||
|
||||
/* instruction address */
|
||||
typedef PCADDR IADDR;
|
||||
/* current instruction address */
|
||||
typedef PCADDR CIA;
|
||||
/* argument to semantic functions */
|
||||
typedef ARGBUF *SEM_ARG;
|
||||
/* semantic code's version of pc */
|
||||
typedef PCADDR SEM_PC;
|
||||
|
||||
#endif /* ! WITH_SCACHE */
|
||||
|
||||
/* Semantic functions come in six versions on two axes:
|
||||
fast/full-featured, and using one of the simple/scache/compilation engines.
|
||||
A full featured simulator is always provided. --enable-sim-fast includes
|
||||
support for fast execution by duplicating the semantic code but leaving
|
||||
out all features like tracing and profiling.
|
||||
Using the scache is selected with --enable-sim-scache. */
|
||||
/* FIXME: --enable-sim-fast not implemented yet. */
|
||||
/* FIXME: undecided how to handle WITH_SCACHE_PBB. */
|
||||
|
||||
/* Types of the machine generated extract and semantic fns. */
|
||||
typedef void (EXTRACT_FN) (SIM_CPU *, PCADDR, insn_t, ARGBUF *);
|
||||
#ifdef HAVE_PARALLEL_EXEC
|
||||
typedef SEM_PC (SEMANTIC_FN) (SIM_CPU *, SEM_ARG, PAREXEC *);
|
||||
#else
|
||||
typedef SEM_PC (SEMANTIC_FN) (SIM_CPU *, SEM_ARG);
|
||||
#endif
|
||||
|
||||
union sem {
|
||||
#if ! WITH_SEM_SWITCH_FULL
|
||||
SEMANTIC_FN *sem_full;
|
||||
#endif
|
||||
#if ! WITH_SEM_SWITCH_FAST
|
||||
SEMANTIC_FN *sem_fast;
|
||||
#endif
|
||||
#if WITH_SEM_SWITCH_FULL || WITH_SEM_SWITCH_FAST
|
||||
#ifdef __GNUC__
|
||||
void *sem_case;
|
||||
#else
|
||||
int sem_case;
|
||||
#endif
|
||||
#endif
|
||||
};
|
||||
|
||||
/* Set the appropriate semantic handler in ABUF. */
|
||||
|
||||
#if WITH_SEM_SWITCH_FULL
|
||||
#ifdef __GNUC__
|
||||
#define SEM_SET_FULL_CODE(abuf, idesc) \
|
||||
do { (abuf)->semantic.sem_case = (idesc)->sem_full_lab; } while (0)
|
||||
#else
|
||||
#define SEM_SET_FULL_CODE(abuf, idesc) \
|
||||
do { (abuf)->semantic.sem_case = (idesc)->num; } while (0)
|
||||
#endif
|
||||
#else
|
||||
#define SEM_SET_FULL_CODE(abuf, idesc) \
|
||||
do { (abuf)->semantic.sem_full = (idesc)->sem_full; } while (0)
|
||||
#endif
|
||||
|
||||
#if WITH_SEM_SWITCH_FAST
|
||||
#ifdef __GNUC__
|
||||
#define SEM_SET_FAST_CODE(abuf, idesc) \
|
||||
do { (abuf)->semantic.sem_case = (idesc)->sem_fast_lab; } while (0)
|
||||
#else
|
||||
#define SEM_SET_FAST_CODE(abuf, idesc) \
|
||||
do { (abuf)->semantic.sem_case = (idesc)->num; } while (0)
|
||||
#endif
|
||||
#else
|
||||
#define SEM_SET_FAST_CODE(abuf, idesc) \
|
||||
do { (abuf)->semantic.sem_fast = (idesc)->sem_fast; } while (0)
|
||||
#endif
|
||||
|
||||
#define SEM_SET_CODE(abuf, idesc, fast_p) \
|
||||
do { \
|
||||
if (fast_p) \
|
||||
SEM_SET_FAST_CODE ((abuf), (idesc)); \
|
||||
else \
|
||||
SEM_SET_FULL_CODE ((abuf), (idesc)); \
|
||||
} while (0)
|
||||
|
||||
#define IDESC_CTI_P(idesc) \
|
||||
((CGEN_ATTR_BOOLS (CGEN_INSN_ATTRS ((idesc)->opcode)) \
|
||||
& (CGEN_ATTR_MASK (CGEN_INSN_COND_CTI) \
|
||||
| CGEN_ATTR_MASK (CGEN_INSN_UNCOND_CTI))) \
|
||||
!= 0)
|
||||
#define IDESC_SKIP_P(idesc) \
|
||||
((CGEN_ATTR_BOOLS (CGEN_INSN_ATTRS ((idesc)->opcode)) \
|
||||
& CGEN_ATTR_MASK (CGEN_INSN_SKIP_CTI)) \
|
||||
!= 0)
|
||||
|
||||
/* Engine support. */
|
||||
|
||||
/* These are used so that we can compile two copies of the semantic code,
|
||||
one with full feature support and one without that runs fast(er). */
|
||||
/* FIXME: Eventually delete extraction if not using scache. */
|
||||
#define EX_FN_NAME(cpu,fn) XCONCAT3 (cpu,_ex_,fn)
|
||||
#define SEM_FN_NAME(cpu,fn) XCONCAT3 (cpu,_sem_,fn)
|
||||
#define SEMF_FN_NAME(cpu,fn) XCONCAT3 (cpu,_semf_,fn)
|
||||
|
||||
#if WITH_SCACHE
|
||||
|
||||
#define CIA_ADDR(cia) (cia)
|
||||
|
||||
/* semantics.c support */
|
||||
#define SEM_ARGBUF(sem_arg) (& (sem_arg) -> argbuf)
|
||||
#define SEM_INSN(sem_arg) shouldnt_be_used
|
||||
#define SEM_NEXT_VPC(sc, len) ((sc) + 1)
|
||||
|
||||
#if WITH_SCACHE_PBB
|
||||
|
||||
/* Update the instruction counter. */
|
||||
#define PBB_UPDATE_INSN_COUNT(cpu,sc) \
|
||||
(CPU_INSN_COUNT (cpu) += SEM_ARGBUF (sc) -> fields.chain.insn_count)
|
||||
|
||||
/* Value for br_addr_ptr indicating branch wasn't taken. */
|
||||
#define SEM_BRANCH_UNTAKEN ((SEM_PC *) 0)
|
||||
/* Value for br_addr_ptr indicating branch was taken to uncacheable
|
||||
address (e.g. j reg). */
|
||||
#define SEM_BRANCH_UNCACHEABLE ((SEM_PC *) 1)
|
||||
|
||||
/* ??? Only necessary if SEM_BRANCH_VIA_CACHE will be used,
|
||||
but for simplicity it's done this way. */
|
||||
#define SEM_BRANCH_INIT_EXTRACT(abuf) \
|
||||
do { (abuf)->fields.cti.addr_cache = 0; } while (0)
|
||||
|
||||
/* Do not append a `;' to invocations of this.
|
||||
npc,npc_ptr are for communication between the cti insn and cti-chain. */
|
||||
#define SEM_BRANCH_INIT \
|
||||
PCADDR npc = 0; /* assign a value for -Wall */ \
|
||||
SEM_PC *npc_ptr = SEM_BRANCH_UNTAKEN;
|
||||
/* SEM_IN_SWITCH is defined at the top of the mainloop.c files
|
||||
generated by genmloop.sh. It exists so generated semantic code needn't
|
||||
care whether it's being put in a switch or in a function. */
|
||||
#ifdef SEM_IN_SWITCH
|
||||
/* Do not append a `;' to invocations of this.
|
||||
??? Unnecessary here, but for consistency with ..._INIT. */
|
||||
#define SEM_BRANCH_FINI \
|
||||
{ \
|
||||
pbb_br_npc = npc; \
|
||||
pbb_br_npc_ptr = npc_ptr; \
|
||||
}
|
||||
#else /* 1 semantic function per instruction */
|
||||
/* Do not append a `;' to invocations of this.
|
||||
??? Unnecessary here, but for consistency with ..._INIT. */
|
||||
#define SEM_BRANCH_FINI \
|
||||
{ \
|
||||
CPU_PBB_BR_NPC (current_cpu) = npc; \
|
||||
CPU_PBB_BR_NPC_PTR (current_cpu) = npc_ptr; \
|
||||
}
|
||||
#endif
|
||||
|
||||
/* Return address of cached branch address value. */
|
||||
#define SEM_BRANCH_ADDR_CACHE(sem_arg) \
|
||||
(& SEM_ARGBUF (sem_arg)->fields.cti.addr_cache)
|
||||
#define SEM_BRANCH_VIA_CACHE(cpu, sc, newval, pcvar, cachevarptr) \
|
||||
do { \
|
||||
npc = (newval); \
|
||||
npc_ptr = (cachevarptr); \
|
||||
} while (0)
|
||||
#define SEM_BRANCH_VIA_ADDR(cpu, sc, newval, pcvar) \
|
||||
do { \
|
||||
npc = (newval); \
|
||||
npc_ptr = SEM_BRANCH_UNCACHEABLE; \
|
||||
} while (0)
|
||||
|
||||
#else /* ! WITH_SCACHE_PBB */
|
||||
|
||||
#define SEM_BRANCH_INIT
|
||||
#define SEM_BRANCH_FINI
|
||||
|
||||
#define SEM_BRANCH_ADDR_CACHE(sem_arg) shouldnt_be_used
|
||||
#define SEM_BRANCH_VIA_CACHE(cpu, sc, newval, pcvar, cachevar) \
|
||||
do { \
|
||||
(pcvar) = (newval); \
|
||||
} while (0)
|
||||
#define SEM_BRANCH_VIA_ADDR(cpu, sc, newval, pcvar) \
|
||||
do { \
|
||||
(pcvar) = (newval); \
|
||||
} while (0)
|
||||
|
||||
#endif /* ! WITH_SCACHE_PBB */
|
||||
|
||||
/* Return address a branch insn will branch to.
|
||||
This is only used during tracing. */
|
||||
#define SEM_NEW_PC_ADDR(new_pc) (new_pc)
|
||||
|
||||
#else /* ! WITH_SCACHE */
|
||||
|
||||
#define CIA_ADDR(cia) (cia)
|
||||
|
||||
/* semantics.c support */
|
||||
#define SEM_ARGBUF(sem_arg) (sem_arg)
|
||||
#define SEM_INSN(sem_arg) (SEM_ARGBUF (sem_arg) -> insn)
|
||||
/* FIXME:wip */
|
||||
#define SEM_NEXT_VPC(abuf, len) ((abuf) -> addr + (abuf) -> length)
|
||||
|
||||
#define SEM_BRANCH_INIT
|
||||
#define SEM_BRANCH_FINI
|
||||
|
||||
#define SEM_BRANCH_ADDR_CACHE(sem_arg) shouldnt_be_used
|
||||
#define SEM_BRANCH_VIA_CACHE(cpu, abuf, newval, pcvar, cachevar) \
|
||||
do { \
|
||||
(pcvar) = (newval); \
|
||||
} while (0)
|
||||
#define SEM_BRANCH_VIA_ADDR(cpu, abuf, newval, pcvar) \
|
||||
do { \
|
||||
(pcvar) = (newval); \
|
||||
} while (0)
|
||||
|
||||
#define SEM_NEW_PC_ADDR(new_pc) (new_pc)
|
||||
|
||||
#endif /* ! WITH_SCACHE */
|
||||
|
||||
#endif /* CGEN_ENGINE_H */
|
||||
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue
Block a user