[deliverable/binutils-gdb.git] / gdb / riscv-tdep.h

/* Target-dependent header for the RISC-V architecture, for GDB, the
   GNU Debugger.

   Copyright (C) 2018 Free Software Foundation, Inc.

   This file is part of GDB.

   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/>.  */

#ifndef RISCV_TDEP_H
#define RISCV_TDEP_H

/* RiscV register numbers.  */
enum
{
  RISCV_ZERO_REGNUM = 0,	/* Read-only register, always 0.  */
  RISCV_RA_REGNUM = 1,		/* Return Address.  */
  RISCV_SP_REGNUM = 2,		/* Stack Pointer.  */
  RISCV_GP_REGNUM = 3,		/* Global Pointer.  */
  RISCV_TP_REGNUM = 4,		/* Thread Pointer.  */
  RISCV_FP_REGNUM = 8,		/* Frame Pointer.  */
  RISCV_A0_REGNUM = 10,		/* First argument.  */
  RISCV_A1_REGNUM = 11,		/* Second argument.  */
  RISCV_PC_REGNUM = 32,		/* Program Counter.  */

  RISCV_NUM_INTEGER_REGS = 32,

  RISCV_FIRST_FP_REGNUM = 33,	/* First Floating Point Register */
  RISCV_FA0_REGNUM = 43,
  RISCV_FA1_REGNUM = RISCV_FA0_REGNUM + 1,
  RISCV_LAST_FP_REGNUM = 64,	/* Last Floating Point Register */

  RISCV_FIRST_CSR_REGNUM = 65,  /* First CSR */
#define DECLARE_CSR(name, num) \
  RISCV_ ## num ## _REGNUM = RISCV_FIRST_CSR_REGNUM + num,
#include "opcode/riscv-opc.h"
#undef DECLARE_CSR
  RISCV_LAST_CSR_REGNUM = 4160,
  RISCV_CSR_LEGACY_MISA_REGNUM = 0xf10 + RISCV_FIRST_CSR_REGNUM,

  RISCV_PRIV_REGNUM = 4161,

  RISCV_LAST_REGNUM = RISCV_PRIV_REGNUM
};

/* RISC-V specific per-architecture information.  */
struct gdbarch_tdep
{
  union
  {
    /* Provide access to the whole ABI in one value.  */
    unsigned value;

    struct
    {
      /* Encode the base machine length following the same rules as in the
	 MISA register.  */
      unsigned base_len : 2;

      /* Encode which floating point ABI is in use following the same rules
	 as the ELF e_flags field.  */
      unsigned float_abi : 2;
    } fields;
  } abi;

  /* Only the least significant 26 bits are (possibly) valid, and indicate
     features that are supported on the target.  These could be cached from
     the target, or read from the executable when available.  */
  unsigned core_features;

  /* ISA-specific data types.  */
  struct type *riscv_fpreg_d_type;
  struct type *riscv_fpreg_q_type;
};

/* Return the width in bytes of the general purpose registers for GDBARCH.  */
extern int riscv_isa_xlen (struct gdbarch *gdbarch);

/* Single step based on where the current instruction will take us.  */
extern std::vector<CORE_ADDR> riscv_software_single_step
  (struct regcache *regcache);

#endif /* RISCV_TDEP_H */
Commit	Line	Data
06ab9219 TT	1	/* Target-dependent header for the RISC-V architecture, for GDB, the
06ab9219 TT	2	GNU Debugger.
dbbb1059 AB	3
	4	Copyright (C) 2018 Free Software Foundation, Inc.
	5
dbbb1059 AB	6	This file is part of GDB.
	7
	8	This program is free software; you can redistribute it and/or modify
	9	it under the terms of the GNU General Public License as published by
	10	the Free Software Foundation; either version 3 of the License, or
	11	(at your option) any later version.
	12
	13	This program is distributed in the hope that it will be useful,
	14	but WITHOUT ANY WARRANTY; without even the implied warranty of
	15	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	16	GNU General Public License for more details.
	17
	18	You should have received a copy of the GNU General Public License
	19	along with this program. If not, see <http://www.gnu.org/licenses/>. */
	20
	21	#ifndef RISCV_TDEP_H
	22	#define RISCV_TDEP_H
	23
	24	/* RiscV register numbers. */
	25	enum
	26	{
	27	RISCV_ZERO_REGNUM = 0, /* Read-only register, always 0. */
	28	RISCV_RA_REGNUM = 1, /* Return Address. */
	29	RISCV_SP_REGNUM = 2, /* Stack Pointer. */
	30	RISCV_GP_REGNUM = 3, /* Global Pointer. */
	31	RISCV_TP_REGNUM = 4, /* Thread Pointer. */
	32	RISCV_FP_REGNUM = 8, /* Frame Pointer. */
	33	RISCV_A0_REGNUM = 10, /* First argument. */
	34	RISCV_A1_REGNUM = 11, /* Second argument. */
	35	RISCV_PC_REGNUM = 32, /* Program Counter. */
	36
78a3b0fa AB	37	RISCV_NUM_INTEGER_REGS = 32,
78a3b0fa AB	38
dbbb1059 AB	39	RISCV_FIRST_FP_REGNUM = 33, /* First Floating Point Register */
	40	RISCV_FA0_REGNUM = 43,
	41	RISCV_FA1_REGNUM = RISCV_FA0_REGNUM + 1,
	42	RISCV_LAST_FP_REGNUM = 64, /* Last Floating Point Register */
	43
	44	RISCV_FIRST_CSR_REGNUM = 65, /* First CSR */
06ab9219 TT	45	#define DECLARE_CSR(name, num) \
06ab9219 TT	46	RISCV_ ## num ## _REGNUM = RISCV_FIRST_CSR_REGNUM + num,
dbbb1059 AB	47	#include "opcode/riscv-opc.h"
	48	#undef DECLARE_CSR
	49	RISCV_LAST_CSR_REGNUM = 4160,
ce73f310	50	RISCV_CSR_LEGACY_MISA_REGNUM = 0xf10 + RISCV_FIRST_CSR_REGNUM,
dbbb1059 AB	51
	52	RISCV_PRIV_REGNUM = 4161,
	53
	54	RISCV_LAST_REGNUM = RISCV_PRIV_REGNUM
	55	};
	56
	57	/* RISC-V specific per-architecture information. */
	58	struct gdbarch_tdep
	59	{
	60	union
	61	{
	62	/* Provide access to the whole ABI in one value. */
	63	unsigned value;
	64
	65	struct
	66	{
	67	/* Encode the base machine length following the same rules as in the
	68	MISA register. */
	69	unsigned base_len : 2;
	70
	71	/* Encode which floating point ABI is in use following the same rules
	72	as the ELF e_flags field. */
	73	unsigned float_abi : 2;
	74	} fields;
	75	} abi;
	76
	77	/* Only the least significant 26 bits are (possibly) valid, and indicate
	78	features that are supported on the target. These could be cached from
	79	the target, or read from the executable when available. */
	80	unsigned core_features;
270b9329 JW	81
	82	/* ISA-specific data types. */
	83	struct type *riscv_fpreg_d_type;
	84	struct type *riscv_fpreg_q_type;
dbbb1059 AB	85	};
dbbb1059 AB	86
411baa47 JW	87	/* Return the width in bytes of the general purpose registers for GDBARCH. */
	88	extern int riscv_isa_xlen (struct gdbarch *gdbarch);
	89
5c720ed8	90	/* Single step based on where the current instruction will take us. */
06ab9219 TT	91	extern std::vector<CORE_ADDR> riscv_software_single_step
06ab9219 TT	92	(struct regcache *regcache);
5c720ed8	93
dbbb1059	94	#endif /* RISCV_TDEP_H */