[thirdparty/binutils-gdb.git] / gdb / hppa-tdep.h

/* Target-dependent code for the HP PA-RISC architecture.

   Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
   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 HPPA_TDEP_H
#define HPPA_TDEP_H

struct trad_frame_saved_reg;
struct objfile;
struct so_list;

/* Register numbers of various important registers.  */

enum hppa_regnum
{
  HPPA_R0_REGNUM = 0,		/* Doesn't actually exist, used as base for
				   other r registers.  */
  HPPA_R1_REGNUM = 1,
  HPPA_FLAGS_REGNUM = 0,	/* Various status flags */
  HPPA_RP_REGNUM = 2,		/* return pointer */
  HPPA_FP_REGNUM = 3,		/* The ABI's frame pointer, when used */
  HPPA_DP_REGNUM = 27,
  HPPA_RET0_REGNUM = 28,
  HPPA_RET1_REGNUM = 29,
  HPPA_SP_REGNUM = 30,		/* Stack pointer.  */
  HPPA_R31_REGNUM = 31,
  HPPA_SAR_REGNUM = 32,		/* Shift Amount Register */
  HPPA_IPSW_REGNUM = 41,	/* Interrupt Processor Status Word */
  HPPA_PCOQ_HEAD_REGNUM = 33,	/* instruction offset queue head */
  HPPA_PCSQ_HEAD_REGNUM = 34,	/* instruction space queue head */
  HPPA_PCOQ_TAIL_REGNUM = 35,	/* instruction offset queue tail */
  HPPA_PCSQ_TAIL_REGNUM = 36,	/* instruction space queue tail */
  HPPA_EIEM_REGNUM = 37,	/* External Interrupt Enable Mask */
  HPPA_IIR_REGNUM = 38,		/* Interrupt Instruction Register */
  HPPA_ISR_REGNUM = 39,		/* Interrupt Space Register */
  HPPA_IOR_REGNUM = 40,		/* Interrupt Offset Register */
  HPPA_SR4_REGNUM = 43,		/* space register 4 */
  HPPA_RCR_REGNUM = 51,		/* Recover Counter (also known as cr0) */
  HPPA_PID0_REGNUM = 52,	/* Protection ID */
  HPPA_PID1_REGNUM = 53,	/* Protection ID */
  HPPA_PID2_REGNUM = 55,	/* Protection ID */
  HPPA_PID3_REGNUM = 56,	/* Protection ID */
  HPPA_CCR_REGNUM = 54,		/* Coprocessor Configuration Register */
  HPPA_TR0_REGNUM = 57,		/* Temporary Registers (cr24 -> cr31) */
  HPPA_CR26_REGNUM = 59,
  HPPA_CR27_REGNUM = 60,	/* Base register for thread-local
				   storage, cr27 */
  HPPA_FP0_REGNUM = 64,		/* First floating-point.  */
  HPPA_FP4_REGNUM = 72,
  HPPA64_FP4_REGNUM = 68,
  HPPA_FP31R_REGNUM = 127,	/* Last floating-point.  */

  HPPA_ARG0_REGNUM = 26,	/* The first argument of a callee.  */
  HPPA_ARG1_REGNUM = 25,	/* The second argument of a callee.  */
  HPPA_ARG2_REGNUM = 24,	/* The third argument of a callee.  */
  HPPA_ARG3_REGNUM = 23		/* The fourth argument of a callee.  */
};

/* Instruction size.  */
#define HPPA_INSN_SIZE 4

/* Target-dependent structure in gdbarch.  */
struct gdbarch_tdep
{
  /* The number of bytes in an address.  For now, this field is designed
     to allow us to differentiate hppa32 from hppa64 targets.  */
  int bytes_per_address;

  /* Is this an ELF target? This can be 64-bit HP-UX, or a 32/64-bit GNU/Linux
     system.  */
  int is_elf;

  /* Given a function address, try to find the global pointer for the 
     corresponding shared object.  */
  CORE_ADDR (*find_global_pointer) (struct gdbarch *, struct value *);

  /* For shared libraries, each call goes through a small piece of
     trampoline code in the ".plt", or equivalent, section.
     IN_SOLIB_CALL_TRAMPOLINE evaluates to nonzero if we are currently
     stopped in one of these.  */
  int (*in_solib_call_trampoline) (struct gdbarch *gdbarch,
				   CORE_ADDR pc, char *name);

  /* For targets that support multiple spaces, we may have additional stubs
     in the return path.  These stubs are internal to the ABI, and users are
     not interested in them.  If we detect that we are returning to a stub,
     adjust the pc to the real caller.  This improves the behavior of commands
     that traverse frames such as "up" and "finish".  */
  void (*unwind_adjust_stub) (struct frame_info *this_frame, CORE_ADDR base,
  			      struct trad_frame_saved_reg *saved_regs);

  /* These are solib-dependent methods.  They are really HPUX only, but
     we don't have a HPUX-specific tdep vector at the moment.  */
  CORE_ADDR (*solib_thread_start_addr) (struct so_list *so);
  CORE_ADDR (*solib_get_got_by_pc) (CORE_ADDR addr);
  CORE_ADDR (*solib_get_solib_by_pc) (CORE_ADDR addr);
  CORE_ADDR (*solib_get_text_base) (struct objfile *objfile);
};

/*
 * Unwind table and descriptor.
 */

struct unwind_table_entry
  {
    CORE_ADDR region_start;
    CORE_ADDR region_end;

    unsigned int Cannot_unwind:1;	/* 0 */
    unsigned int Millicode:1;	/* 1 */
    unsigned int Millicode_save_sr0:1;	/* 2 */
    unsigned int Region_description:2;	/* 3..4 */
    unsigned int reserved:1;	/* 5 */
    unsigned int Entry_SR:1;	/* 6 */
    unsigned int Entry_FR:4;	/* number saved *//* 7..10 */
    unsigned int Entry_GR:5;	/* number saved *//* 11..15 */
    unsigned int Args_stored:1;	/* 16 */
    unsigned int Variable_Frame:1;	/* 17 */
    unsigned int Separate_Package_Body:1;	/* 18 */
    unsigned int Frame_Extension_Millicode:1;	/* 19 */
    unsigned int Stack_Overflow_Check:1;	/* 20 */
    unsigned int Two_Instruction_SP_Increment:1;	/* 21 */
    unsigned int sr4export:1;	/* 22 */
    unsigned int cxx_info:1;	/* 23 */
    unsigned int cxx_try_catch:1;	/* 24 */
    unsigned int sched_entry_seq:1;	/* 25 */
    unsigned int reserved1:1;	/* 26 */
    unsigned int Save_SP:1;	/* 27 */
    unsigned int Save_RP:1;	/* 28 */
    unsigned int Save_MRP_in_frame:1;	/* 29 */
    unsigned int save_r19:1;	/* 30 */
    unsigned int Cleanup_defined:1;	/* 31 */

    unsigned int MPE_XL_interrupt_marker:1;	/* 0 */
    unsigned int HP_UX_interrupt_marker:1;	/* 1 */
    unsigned int Large_frame:1;	/* 2 */
    unsigned int alloca_frame:1;	/* 3 */
    unsigned int reserved2:1;	/* 4 */
    unsigned int Total_frame_size:27;	/* 5..31 */

    /* This is *NOT* part of an actual unwind_descriptor in an object
       file.  It is *ONLY* part of the "internalized" descriptors that
       we create from those in a file.  */

    struct
      {
	unsigned int stub_type:4;	/* 0..3 */
	unsigned int padding:28;	/* 4..31 */
      }
    stub_unwind;
  };

/* HP linkers also generate unwinds for various linker-generated stubs.
   GDB reads in the stubs from the $UNWIND_END$ subspace, then 
   "converts" them into normal unwind entries using some of the reserved
   fields to store the stub type.  */

/* The gaps represent linker stubs used in MPE and space for future
   expansion.  */
enum unwind_stub_types
  {
    LONG_BRANCH = 1,
    PARAMETER_RELOCATION = 2,
    EXPORT = 10,
    IMPORT = 11,
    IMPORT_SHLIB = 12,
  };

struct unwind_table_entry *find_unwind_entry (CORE_ADDR);

/* We use the objfile->obj_private pointer for two things:
 * 1.  An unwind table;
 *
 * 2.  A pointer to any associated shared library object.
 *
 * #defines are used to help refer to these objects.
 */

/* Info about the unwind table associated with an object file.
 * This is hung off of the "objfile->obj_private" pointer, and
 * is allocated in the objfile's psymbol obstack.  This allows
 * us to have unique unwind info for each executable and shared
 * library that we are debugging.
 */
struct hppa_unwind_info
  {
    struct unwind_table_entry *table;	/* Pointer to unwind info */
    struct unwind_table_entry *cache;	/* Pointer to last entry we found */
    int last;				/* Index of last entry */
  };

struct hppa_objfile_private
  {
    struct hppa_unwind_info *unwind_info;	/* a pointer */
    struct so_list *so_info;			/* a pointer  */
    CORE_ADDR dp;

    int dummy_call_sequence_reg;
    CORE_ADDR dummy_call_sequence_addr;
  };

extern const struct objfile_data *hppa_objfile_priv_data;

int hppa_get_field (unsigned word, int from, int to);
int hppa_extract_5_load (unsigned int);
unsigned hppa_extract_5R_store (unsigned int);
unsigned hppa_extract_5r_store (unsigned int);
int hppa_extract_17 (unsigned int);
int hppa_extract_21 (unsigned);
int hppa_extract_14 (unsigned);
CORE_ADDR hppa_symbol_address(const char *sym);

extern struct value *
  hppa_frame_prev_register_helper (struct frame_info *this_frame,
				   struct trad_frame_saved_reg *saved_regs,
				   int regnum);

extern CORE_ADDR hppa_read_pc (struct regcache *regcache);
extern void hppa_write_pc (struct regcache *regcache, CORE_ADDR pc);
extern CORE_ADDR hppa_unwind_pc (struct gdbarch *gdbarch,
				 struct frame_info *next_frame);

extern struct minimal_symbol *
  hppa_lookup_stub_minimal_symbol (const char *name,
                                   enum unwind_stub_types stub_type);

extern struct hppa_objfile_private * hppa_init_objfile_priv_data (struct objfile *objfile);

extern int hppa_in_solib_call_trampoline (struct gdbarch *gdbarch,
					  CORE_ADDR pc, char *name);
extern CORE_ADDR hppa_skip_trampoline_code (struct frame_info *, CORE_ADDR pc);

#endif  /* hppa-tdep.h */
Commit	Line	Data
a7aad9aa MK	1	/* Target-dependent code for the HP PA-RISC architecture.
a7aad9aa MK	2
7b6bb8da	3	Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
9b254dd1	4	Free Software Foundation, Inc.
3ff7cf9e JB	5
	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
a9762ec7	10	the Free Software Foundation; either version 3 of the License, or
3ff7cf9e JB	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
a9762ec7	19	along with this program. If not, see <http://www.gnu.org/licenses/>. */
3ff7cf9e JB	20
	21	#ifndef HPPA_TDEP_H
	22	#define HPPA_TDEP_H
	23
f626a069	24	struct trad_frame_saved_reg;
acf86d54 RC	25	struct objfile;
acf86d54 RC	26	struct so_list;
f626a069	27
7157eed4	28	/* Register numbers of various important registers. */
34f75cc1	29
c481d1ca MK	30	enum hppa_regnum
c481d1ca MK	31	{
34f75cc1 RC	32	HPPA_R0_REGNUM = 0, /* Doesn't actually exist, used as base for
34f75cc1 RC	33	other r registers. */
c481d1ca	34	HPPA_R1_REGNUM = 1,
34f75cc1 RC	35	HPPA_FLAGS_REGNUM = 0, /* Various status flags */
	36	HPPA_RP_REGNUM = 2, /* return pointer */
	37	HPPA_FP_REGNUM = 3, /* The ABI's frame pointer, when used */
38ca4e0c MK	38	HPPA_DP_REGNUM = 27,
	39	HPPA_RET0_REGNUM = 28,
	40	HPPA_RET1_REGNUM = 29,
34f75cc1	41	HPPA_SP_REGNUM = 30, /* Stack pointer. */
8d1b517b	42	HPPA_R31_REGNUM = 31,
34f75cc1 RC	43	HPPA_SAR_REGNUM = 32, /* Shift Amount Register */
	44	HPPA_IPSW_REGNUM = 41, /* Interrupt Processor Status Word */
	45	HPPA_PCOQ_HEAD_REGNUM = 33, /* instruction offset queue head */
	46	HPPA_PCSQ_HEAD_REGNUM = 34, /* instruction space queue head */
	47	HPPA_PCOQ_TAIL_REGNUM = 35, /* instruction offset queue tail */
	48	HPPA_PCSQ_TAIL_REGNUM = 36, /* instruction space queue tail */
	49	HPPA_EIEM_REGNUM = 37, /* External Interrupt Enable Mask */
	50	HPPA_IIR_REGNUM = 38, /* Interrupt Instruction Register */
	51	HPPA_ISR_REGNUM = 39, /* Interrupt Space Register */
	52	HPPA_IOR_REGNUM = 40, /* Interrupt Offset Register */
	53	HPPA_SR4_REGNUM = 43, /* space register 4 */
	54	HPPA_RCR_REGNUM = 51, /* Recover Counter (also known as cr0) */
	55	HPPA_PID0_REGNUM = 52, /* Protection ID */
	56	HPPA_PID1_REGNUM = 53, /* Protection ID */
	57	HPPA_PID2_REGNUM = 55, /* Protection ID */
	58	HPPA_PID3_REGNUM = 56, /* Protection ID */
	59	HPPA_CCR_REGNUM = 54, /* Coprocessor Configuration Register */
	60	HPPA_TR0_REGNUM = 57, /* Temporary Registers (cr24 -> cr31) */
d037d088	61	HPPA_CR26_REGNUM = 59,
1777feb0 MS	62	HPPA_CR27_REGNUM = 60, /* Base register for thread-local
1777feb0 MS	63	storage, cr27 */
34f75cc1 RC	64	HPPA_FP0_REGNUM = 64, /* First floating-point. */
34f75cc1 RC	65	HPPA_FP4_REGNUM = 72,
38ca4e0c	66	HPPA64_FP4_REGNUM = 68,
20776c7d	67	HPPA_FP31R_REGNUM = 127, /* Last floating-point. */
34f75cc1	68
1777feb0 MS	69	HPPA_ARG0_REGNUM = 26, /* The first argument of a callee. */
	70	HPPA_ARG1_REGNUM = 25, /* The second argument of a callee. */
	71	HPPA_ARG2_REGNUM = 24, /* The third argument of a callee. */
	72	HPPA_ARG3_REGNUM = 23 /* The fourth argument of a callee. */
34f75cc1 RC	73	};
34f75cc1 RC	74
d275c051 MK	75	/* Instruction size. */
	76	#define HPPA_INSN_SIZE 4
	77
3ff7cf9e JB	78	/* Target-dependent structure in gdbarch. */
	79	struct gdbarch_tdep
	80	{
	81	/* The number of bytes in an address. For now, this field is designed
	82	to allow us to differentiate hppa32 from hppa64 targets. */
	83	int bytes_per_address;
fdd72f95 RC	84
	85	/* Is this an ELF target? This can be 64-bit HP-UX, or a 32/64-bit GNU/Linux
	86	system. */
	87	int is_elf;
d49771ef RC	88
	89	/* Given a function address, try to find the global pointer for the
	90	corresponding shared object. */
e38c262f	91	CORE_ADDR (find_global_pointer) (struct gdbarch , struct value *);
84674fe1 AC	92
	93	/* For shared libraries, each call goes through a small piece of
	94	trampoline code in the ".plt", or equivalent, section.
	95	IN_SOLIB_CALL_TRAMPOLINE evaluates to nonzero if we are currently
	96	stopped in one of these. */
e17a4113 UW	97	int (in_solib_call_trampoline) (struct gdbarch gdbarch,
e17a4113 UW	98	CORE_ADDR pc, char *name);
f77a2124 RC	99
	100	/* For targets that support multiple spaces, we may have additional stubs
	101	in the return path. These stubs are internal to the ABI, and users are
	102	not interested in them. If we detect that we are returning to a stub,
	103	adjust the pc to the real caller. This improves the behavior of commands
	104	that traverse frames such as "up" and "finish". */
227e86ad	105	void (unwind_adjust_stub) (struct frame_info this_frame, CORE_ADDR base,
f77a2124 RC	106	struct trad_frame_saved_reg *saved_regs);
f77a2124 RC	107
acf86d54 RC	108	/* These are solib-dependent methods. They are really HPUX only, but
	109	we don't have a HPUX-specific tdep vector at the moment. */
	110	CORE_ADDR (solib_thread_start_addr) (struct so_list so);
	111	CORE_ADDR (*solib_get_got_by_pc) (CORE_ADDR addr);
	112	CORE_ADDR (*solib_get_solib_by_pc) (CORE_ADDR addr);
	113	CORE_ADDR (solib_get_text_base) (struct objfile objfile);
3ff7cf9e JB	114	};
3ff7cf9e JB	115
7c46b9fb RC	116	/*
	117	* Unwind table and descriptor.
	118	*/
	119
	120	struct unwind_table_entry
	121	{
	122	CORE_ADDR region_start;
	123	CORE_ADDR region_end;
	124
	125	unsigned int Cannot_unwind:1; /* 0 */
	126	unsigned int Millicode:1; /* 1 */
	127	unsigned int Millicode_save_sr0:1; /* 2 */
	128	unsigned int Region_description:2; /* 3..4 */
6fcecea0	129	unsigned int reserved:1; /* 5 */
7c46b9fb RC	130	unsigned int Entry_SR:1; /* 6 */
	131	unsigned int Entry_FR:4; /* number saved // 7..10 */
	132	unsigned int Entry_GR:5; /* number saved // 11..15 */
	133	unsigned int Args_stored:1; /* 16 */
	134	unsigned int Variable_Frame:1; /* 17 */
	135	unsigned int Separate_Package_Body:1; /* 18 */
	136	unsigned int Frame_Extension_Millicode:1; /* 19 */
	137	unsigned int Stack_Overflow_Check:1; /* 20 */
	138	unsigned int Two_Instruction_SP_Increment:1; /* 21 */
6fcecea0	139	unsigned int sr4export:1; /* 22 */
7c46b9fb RC	140	unsigned int cxx_info:1; /* 23 */
	141	unsigned int cxx_try_catch:1; /* 24 */
	142	unsigned int sched_entry_seq:1; /* 25 */
6fcecea0	143	unsigned int reserved1:1; /* 26 */
7c46b9fb RC	144	unsigned int Save_SP:1; /* 27 */
	145	unsigned int Save_RP:1; /* 28 */
	146	unsigned int Save_MRP_in_frame:1; /* 29 */
6fcecea0	147	unsigned int save_r19:1; /* 30 */
7c46b9fb RC	148	unsigned int Cleanup_defined:1; /* 31 */
	149
	150	unsigned int MPE_XL_interrupt_marker:1; /* 0 */
	151	unsigned int HP_UX_interrupt_marker:1; /* 1 */
	152	unsigned int Large_frame:1; /* 2 */
6fcecea0 RC	153	unsigned int alloca_frame:1; /* 3 */
6fcecea0 RC	154	unsigned int reserved2:1; /* 4 */
7c46b9fb RC	155	unsigned int Total_frame_size:27; /* 5..31 */
	156
	157	/* This is NOT part of an actual unwind_descriptor in an object
	158	file. It is ONLY part of the "internalized" descriptors that
1777feb0 MS	159	we create from those in a file. */
1777feb0 MS	160
7c46b9fb RC	161	struct
	162	{
	163	unsigned int stub_type:4; /* 0..3 */
	164	unsigned int padding:28; /* 4..31 */
	165	}
	166	stub_unwind;
	167	};
	168
	169	/* HP linkers also generate unwinds for various linker-generated stubs.
	170	GDB reads in the stubs from the $UNWIND_END$ subspace, then
	171	"converts" them into normal unwind entries using some of the reserved
	172	fields to store the stub type. */
	173
	174	/* The gaps represent linker stubs used in MPE and space for future
	175	expansion. */
	176	enum unwind_stub_types
	177	{
	178	LONG_BRANCH = 1,
	179	PARAMETER_RELOCATION = 2,
	180	EXPORT = 10,
	181	IMPORT = 11,
	182	IMPORT_SHLIB = 12,
	183	};
	184
abc485a1 RC	185	struct unwind_table_entry *find_unwind_entry (CORE_ADDR);
abc485a1 RC	186
7c46b9fb RC	187	/* We use the objfile->obj_private pointer for two things:
	188	* 1. An unwind table;
	189	*
	190	* 2. A pointer to any associated shared library object.
	191	*
	192	* #defines are used to help refer to these objects.
	193	*/
	194
	195	/* Info about the unwind table associated with an object file.
	196	* This is hung off of the "objfile->obj_private" pointer, and
	197	* is allocated in the objfile's psymbol obstack. This allows
	198	* us to have unique unwind info for each executable and shared
	199	* library that we are debugging.
	200	*/
	201	struct hppa_unwind_info
	202	{
	203	struct unwind_table_entry table; / Pointer to unwind info */
	204	struct unwind_table_entry cache; / Pointer to last entry we found */
1777feb0	205	int last; /* Index of last entry */
7c46b9fb RC	206	};
	207
	208	struct hppa_objfile_private
	209	{
	210	struct hppa_unwind_info unwind_info; / a pointer */
1777feb0	211	struct so_list so_info; / a pointer */
7c46b9fb	212	CORE_ADDR dp;
77d18ded RC	213
	214	int dummy_call_sequence_reg;
	215	CORE_ADDR dummy_call_sequence_addr;
7c46b9fb RC	216	};
	217
	218	extern const struct objfile_data *hppa_objfile_priv_data;
	219
abc485a1 RC	220	int hppa_get_field (unsigned word, int from, int to);
	221	int hppa_extract_5_load (unsigned int);
	222	unsigned hppa_extract_5R_store (unsigned int);
	223	unsigned hppa_extract_5r_store (unsigned int);
	224	int hppa_extract_17 (unsigned int);
	225	int hppa_extract_21 (unsigned);
	226	int hppa_extract_14 (unsigned);
3388d7ff	227	CORE_ADDR hppa_symbol_address(const char *sym);
abc485a1	228
227e86ad JB	229	extern struct value *
227e86ad JB	230	hppa_frame_prev_register_helper (struct frame_info *this_frame,
a7aad9aa	231	struct trad_frame_saved_reg *saved_regs,
227e86ad	232	int regnum);
0da28f8a	233
61a1198a UW	234	extern CORE_ADDR hppa_read_pc (struct regcache *regcache);
61a1198a UW	235	extern void hppa_write_pc (struct regcache *regcache, CORE_ADDR pc);
cc72850f MK	236	extern CORE_ADDR hppa_unwind_pc (struct gdbarch *gdbarch,
	237	struct frame_info *next_frame);
	238
ff644745 JB	239	extern struct minimal_symbol *
	240	hppa_lookup_stub_minimal_symbol (const char *name,
	241	enum unwind_stub_types stub_type);
	242
2021ad3a	243	extern struct hppa_objfile_private * hppa_init_objfile_priv_data (struct objfile *objfile);
77d18ded	244
e17a4113 UW	245	extern int hppa_in_solib_call_trampoline (struct gdbarch *gdbarch,
e17a4113 UW	246	CORE_ADDR pc, char *name);
52f729a7	247	extern CORE_ADDR hppa_skip_trampoline_code (struct frame_info *, CORE_ADDR pc);
34f55018 MK	248
34f55018 MK	249	#endif /* hppa-tdep.h */