2004-05-06 Randolph Chung <tausq@debian.org>
[platform/upstream/binutils.git] / gdb / hppa-tdep.h
1 /* Common target dependent code for GDB on HPPA systems.
2    Copyright 2003 Free Software Foundation, Inc.
3
4    This file is part of GDB.
5
6    This program is free software; you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation; either version 2 of the License, or
9    (at your option) any later version.
10
11    This program is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with this program; if not, write to the Free Software
18    Foundation, Inc., 59 Temple Place - Suite 330,
19    Boston, MA 02111-1307, USA.  */
20
21 #ifndef HPPA_TDEP_H
22 #define HPPA_TDEP_H
23
24 enum { HPPA_INSTRUCTION_SIZE = 4 };
25
26 /* Register numbers of various important registers.
27    Note that some of these values are "real" register numbers,
28    and correspond to the general registers of the machine,
29    and some are "phony" register numbers which are too large
30    to be actual register numbers as far as the user is concerned
31    but do serve to get the desired values when passed to read_register.  */
32
33 enum {
34   HPPA_R0_REGNUM = 0,           /* Doesn't actually exist, used as base for
35                                    other r registers.  */
36   HPPA_FLAGS_REGNUM = 0,        /* Various status flags */
37   HPPA_RP_REGNUM = 2,           /* return pointer */
38   HPPA_FP_REGNUM = 3,           /* The ABI's frame pointer, when used */
39   HPPA_SP_REGNUM = 30,          /* Stack pointer.  */
40   HPPA_SAR_REGNUM = 32,         /* Shift Amount Register */
41   HPPA_IPSW_REGNUM = 41,        /* Interrupt Processor Status Word */
42   HPPA_PCOQ_HEAD_REGNUM = 33,   /* instruction offset queue head */
43   HPPA_PCSQ_HEAD_REGNUM = 34,   /* instruction space queue head */
44   HPPA_PCOQ_TAIL_REGNUM = 35,   /* instruction offset queue tail */
45   HPPA_PCSQ_TAIL_REGNUM = 36,   /* instruction space queue tail */
46   HPPA_EIEM_REGNUM = 37,        /* External Interrupt Enable Mask */
47   HPPA_IIR_REGNUM = 38,         /* Interrupt Instruction Register */
48   HPPA_ISR_REGNUM = 39,         /* Interrupt Space Register */
49   HPPA_IOR_REGNUM = 40,         /* Interrupt Offset Register */
50   HPPA_SR4_REGNUM = 43,         /* space register 4 */
51   HPPA_RCR_REGNUM = 51,         /* Recover Counter (also known as cr0) */
52   HPPA_PID0_REGNUM = 52,        /* Protection ID */
53   HPPA_PID1_REGNUM = 53,        /* Protection ID */
54   HPPA_PID2_REGNUM = 55,        /* Protection ID */
55   HPPA_PID3_REGNUM = 56,        /* Protection ID */
56   HPPA_CCR_REGNUM = 54,         /* Coprocessor Configuration Register */
57   HPPA_TR0_REGNUM = 57,         /* Temporary Registers (cr24 -> cr31) */
58   HPPA_CR27_REGNUM = 60,        /* Base register for thread-local storage, cr27 */
59   HPPA_FP0_REGNUM = 64,         /* First floating-point.  */
60   HPPA_FP4_REGNUM = 72,
61
62   HPPA_ARG0_REGNUM = 26,        /* The first argument of a callee. */
63   HPPA_ARG1_REGNUM = 25,        /* The second argument of a callee. */
64   HPPA_ARG2_REGNUM = 24,        /* The third argument of a callee. */
65   HPPA_ARG3_REGNUM = 23         /* The fourth argument of a callee. */
66 };
67
68 /* Target-dependent structure in gdbarch.  */
69 struct gdbarch_tdep
70 {
71   /* The number of bytes in an address.  For now, this field is designed
72      to allow us to differentiate hppa32 from hppa64 targets.  */
73   int bytes_per_address;
74
75   /* Is this an ELF target? This can be 64-bit HP-UX, or a 32/64-bit GNU/Linux
76      system.  */
77   int is_elf;
78 };
79
80 /*
81  * Unwind table and descriptor.
82  */
83
84 struct unwind_table_entry
85   {
86     CORE_ADDR region_start;
87     CORE_ADDR region_end;
88
89     unsigned int Cannot_unwind:1;       /* 0 */
90     unsigned int Millicode:1;   /* 1 */
91     unsigned int Millicode_save_sr0:1;  /* 2 */
92     unsigned int Region_description:2;  /* 3..4 */
93     unsigned int reserved1:1;   /* 5 */
94     unsigned int Entry_SR:1;    /* 6 */
95     unsigned int Entry_FR:4;    /* number saved *//* 7..10 */
96     unsigned int Entry_GR:5;    /* number saved *//* 11..15 */
97     unsigned int Args_stored:1; /* 16 */
98     unsigned int Variable_Frame:1;      /* 17 */
99     unsigned int Separate_Package_Body:1;       /* 18 */
100     unsigned int Frame_Extension_Millicode:1;   /* 19 */
101     unsigned int Stack_Overflow_Check:1;        /* 20 */
102     unsigned int Two_Instruction_SP_Increment:1;        /* 21 */
103     unsigned int Ada_Region:1;  /* 22 */
104     unsigned int cxx_info:1;    /* 23 */
105     unsigned int cxx_try_catch:1;       /* 24 */
106     unsigned int sched_entry_seq:1;     /* 25 */
107     unsigned int reserved2:1;   /* 26 */
108     unsigned int Save_SP:1;     /* 27 */
109     unsigned int Save_RP:1;     /* 28 */
110     unsigned int Save_MRP_in_frame:1;   /* 29 */
111     unsigned int extn_ptr_defined:1;    /* 30 */
112     unsigned int Cleanup_defined:1;     /* 31 */
113
114     unsigned int MPE_XL_interrupt_marker:1;     /* 0 */
115     unsigned int HP_UX_interrupt_marker:1;      /* 1 */
116     unsigned int Large_frame:1; /* 2 */
117     unsigned int Pseudo_SP_Set:1;       /* 3 */
118     unsigned int reserved4:1;   /* 4 */
119     unsigned int Total_frame_size:27;   /* 5..31 */
120
121     /* This is *NOT* part of an actual unwind_descriptor in an object
122        file.  It is *ONLY* part of the "internalized" descriptors that
123        we create from those in a file.
124      */
125     struct
126       {
127         unsigned int stub_type:4;       /* 0..3 */
128         unsigned int padding:28;        /* 4..31 */
129       }
130     stub_unwind;
131   };
132
133 /* HP linkers also generate unwinds for various linker-generated stubs.
134    GDB reads in the stubs from the $UNWIND_END$ subspace, then 
135    "converts" them into normal unwind entries using some of the reserved
136    fields to store the stub type.  */
137
138 /* The gaps represent linker stubs used in MPE and space for future
139    expansion.  */
140 enum unwind_stub_types
141   {
142     LONG_BRANCH = 1,
143     PARAMETER_RELOCATION = 2,
144     EXPORT = 10,
145     IMPORT = 11,
146     IMPORT_SHLIB = 12,
147   };
148
149 struct unwind_table_entry *find_unwind_entry (CORE_ADDR);
150
151 /* We use the objfile->obj_private pointer for two things:
152  * 1.  An unwind table;
153  *
154  * 2.  A pointer to any associated shared library object.
155  *
156  * #defines are used to help refer to these objects.
157  */
158
159 /* Info about the unwind table associated with an object file.
160  * This is hung off of the "objfile->obj_private" pointer, and
161  * is allocated in the objfile's psymbol obstack.  This allows
162  * us to have unique unwind info for each executable and shared
163  * library that we are debugging.
164  */
165 struct hppa_unwind_info
166   {
167     struct unwind_table_entry *table;   /* Pointer to unwind info */
168     struct unwind_table_entry *cache;   /* Pointer to last entry we found */
169     int last;                   /* Index of last entry */
170   };
171
172 struct hppa_objfile_private
173   {
174     struct hppa_unwind_info *unwind_info;       /* a pointer */
175     struct so_list *so_info;    /* a pointer  */
176     CORE_ADDR dp;
177   };
178
179 extern const struct objfile_data *hppa_objfile_priv_data;
180
181 int hppa_get_field (unsigned word, int from, int to);
182 int hppa_extract_5_load (unsigned int);
183 unsigned hppa_extract_5R_store (unsigned int);
184 unsigned hppa_extract_5r_store (unsigned int);
185 int hppa_extract_17 (unsigned int);
186 int hppa_extract_21 (unsigned);
187 int hppa_extract_14 (unsigned);
188 int hppa_low_sign_extend (unsigned int, unsigned int);
189 int hppa_sign_extend (unsigned int, unsigned int);
190
191 #endif  /* HPPA_TDEP_H */