mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-12-09 04:21:49 +08:00
213516ef31
This commit is the result of running the gdb/copyright.py script, which automated the update of the copyright year range for all source files managed by the GDB project to be updated to include year 2023.
166 lines
5.4 KiB
C
166 lines
5.4 KiB
C
/* CPU support.
|
|
Copyright (C) 1998-2023 Free Software Foundation, Inc.
|
|
Contributed by Cygnus Solutions.
|
|
|
|
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 3 of the License, 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, see <http://www.gnu.org/licenses/>. */
|
|
|
|
/* This file is intended to be included by sim-base.h.
|
|
|
|
This file provides an interface between the simulator framework and
|
|
the selected cpu. */
|
|
|
|
#ifndef SIM_CPU_H
|
|
#define SIM_CPU_H
|
|
|
|
/* Type of function to return an insn name. */
|
|
typedef const char * (CPU_INSN_NAME_FN) (sim_cpu *, int);
|
|
|
|
#ifdef CGEN_ARCH
|
|
# include "cgen-cpu.h"
|
|
#endif
|
|
|
|
/* Types for register access functions.
|
|
These routines implement the sim_{fetch,store}_register interface. */
|
|
typedef int (CPUREG_FETCH_FN) (sim_cpu *, int, void *, int);
|
|
typedef int (CPUREG_STORE_FN) (sim_cpu *, int, const void *, int);
|
|
|
|
/* Types for PC access functions.
|
|
Some simulators require a functional interface to access the program
|
|
counter [a macro is insufficient as the PC is kept in a cpu-specific part
|
|
of the sim_cpu struct]. */
|
|
typedef sim_cia (PC_FETCH_FN) (sim_cpu *);
|
|
typedef void (PC_STORE_FN) (sim_cpu *, sim_cia);
|
|
|
|
/* Pseudo baseclass for each cpu. */
|
|
|
|
struct _sim_cpu {
|
|
/* Backlink to main state struct. */
|
|
SIM_DESC state;
|
|
#define CPU_STATE(cpu) ((cpu)->state)
|
|
|
|
/* Processor index within the SD_DESC */
|
|
int index;
|
|
#define CPU_INDEX(cpu) ((cpu)->index)
|
|
|
|
/* The name of the cpu. */
|
|
const char *name;
|
|
#define CPU_NAME(cpu) ((cpu)->name)
|
|
|
|
/* Options specific to this cpu. */
|
|
struct option_list *options;
|
|
#define CPU_OPTIONS(cpu) ((cpu)->options)
|
|
|
|
/* Processor specific core data */
|
|
sim_cpu_core core;
|
|
#define CPU_CORE(cpu) (& (cpu)->core)
|
|
|
|
/* Number of instructions (used to iterate over CPU_INSN_NAME). */
|
|
unsigned int max_insns;
|
|
#define CPU_MAX_INSNS(cpu) ((cpu)->max_insns)
|
|
|
|
/* Function to return the name of an insn. */
|
|
CPU_INSN_NAME_FN *insn_name;
|
|
#define CPU_INSN_NAME(cpu) ((cpu)->insn_name)
|
|
|
|
/* Trace data. See sim-trace.h. */
|
|
TRACE_DATA trace_data;
|
|
#define CPU_TRACE_DATA(cpu) (& (cpu)->trace_data)
|
|
|
|
/* Maximum number of debuggable entities.
|
|
This debugging is not intended for normal use.
|
|
It is only enabled when the simulator is configured with --with-debug
|
|
which shouldn't normally be specified. */
|
|
#ifndef MAX_DEBUG_VALUES
|
|
#define MAX_DEBUG_VALUES 4
|
|
#endif
|
|
|
|
/* Boolean array of specified debugging flags. */
|
|
char debug_flags[MAX_DEBUG_VALUES];
|
|
#define CPU_DEBUG_FLAGS(cpu) ((cpu)->debug_flags)
|
|
/* Standard values. */
|
|
#define DEBUG_INSN_IDX 0
|
|
#define DEBUG_NEXT_IDX 2 /* simulator specific debug bits begin here */
|
|
|
|
/* Debugging output goes to this or stderr if NULL.
|
|
We can't store `stderr' here as stderr goes through a callback. */
|
|
FILE *debug_file;
|
|
#define CPU_DEBUG_FILE(cpu) ((cpu)->debug_file)
|
|
|
|
/* Profile data. See sim-profile.h. */
|
|
PROFILE_DATA profile_data;
|
|
#define CPU_PROFILE_DATA(cpu) (& (cpu)->profile_data)
|
|
|
|
/* Machine tables for this cpu. See sim-model.h. */
|
|
const SIM_MACH *mach;
|
|
#define CPU_MACH(cpu) ((cpu)->mach)
|
|
/* The selected model. */
|
|
const SIM_MODEL *model;
|
|
#define CPU_MODEL(cpu) ((cpu)->model)
|
|
/* Model data (profiling state, etc.). */
|
|
void *model_data;
|
|
#define CPU_MODEL_DATA(cpu) ((cpu)->model_data)
|
|
|
|
/* Routines to fetch/store registers. */
|
|
CPUREG_FETCH_FN *reg_fetch;
|
|
#define CPU_REG_FETCH(c) ((c)->reg_fetch)
|
|
CPUREG_STORE_FN *reg_store;
|
|
#define CPU_REG_STORE(c) ((c)->reg_store)
|
|
PC_FETCH_FN *pc_fetch;
|
|
#define CPU_PC_FETCH(c) ((c)->pc_fetch)
|
|
PC_STORE_FN *pc_store;
|
|
#define CPU_PC_STORE(c) ((c)->pc_store)
|
|
|
|
#ifdef CGEN_ARCH
|
|
/* Static parts of cgen. */
|
|
CGEN_CPU cgen_cpu;
|
|
#define CPU_CGEN_CPU(cpu) ((cpu)->cgen_cpu)
|
|
#endif
|
|
|
|
/* Pointer for sim target to store arbitrary cpu data. Normally the
|
|
target should define a struct and use it here. */
|
|
void *arch_data;
|
|
#define CPU_ARCH_DATA(cpu) ((cpu)->arch_data)
|
|
};
|
|
|
|
/* Create all cpus. */
|
|
extern SIM_RC sim_cpu_alloc_all_extra (SIM_DESC, int, size_t);
|
|
#define sim_cpu_alloc_all(state, ncpus) sim_cpu_alloc_all_extra (state, ncpus, 0)
|
|
/* Create a cpu. */
|
|
extern sim_cpu *sim_cpu_alloc_extra (SIM_DESC, size_t);
|
|
#define sim_cpu_alloc(sd) sim_cpu_alloc_extra (sd, 0)
|
|
/* Release resources held by all cpus. */
|
|
extern void sim_cpu_free_all (SIM_DESC);
|
|
/* Release resources held by a cpu. */
|
|
extern void sim_cpu_free (sim_cpu *);
|
|
|
|
/* Return a pointer to the cpu data for CPU_NAME, or NULL if not found. */
|
|
extern sim_cpu *sim_cpu_lookup (SIM_DESC, const char *);
|
|
|
|
/* Return prefix to use in cpu specific messages. */
|
|
extern const char *sim_cpu_msg_prefix (sim_cpu *);
|
|
/* Cover fn to sim_io_eprintf. */
|
|
extern void sim_io_eprintf_cpu (sim_cpu *, const char *, ...)
|
|
ATTRIBUTE_PRINTF (2, 3);
|
|
|
|
/* Get/set a pc value. */
|
|
#define CPU_PC_GET(cpu) ((* CPU_PC_FETCH (cpu)) (cpu))
|
|
#define CPU_PC_SET(cpu,newval) ((* CPU_PC_STORE (cpu)) ((cpu), (newval)))
|
|
/* External interface to accessing the pc. */
|
|
sim_cia sim_pc_get (sim_cpu *);
|
|
void sim_pc_set (sim_cpu *, sim_cia);
|
|
|
|
#endif /* SIM_CPU_H */
|