2007-05-31 Markus Deuling <deuling@de.ibm.com>
[deliverable/binutils-gdb.git] / gdb / gdbarch.h
CommitLineData
59233f88
AC
1/* *INDENT-OFF* */ /* THIS FILE IS GENERATED */
2
adf40b2e 3/* Dynamic architecture support for GDB, the GNU debugger.
79d45cd4 4
424163ea
DJ
5 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006
6 Free Software Foundation, Inc.
c906108c 7
c5aa993b 8 This file is part of GDB.
c906108c 9
c5aa993b
JM
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 2 of the License, or
13 (at your option) any later version.
c906108c 14
c5aa993b
JM
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
c906108c 19
c5aa993b
JM
20 You should have received a copy of the GNU General Public License
21 along with this program; if not, write to the Free Software
197e01b6
EZ
22 Foundation, Inc., 51 Franklin Street, Fifth Floor,
23 Boston, MA 02110-1301, USA. */
c906108c 24
104c1213
JM
25/* This file was created with the aid of ``gdbarch.sh''.
26
52204a0b 27 The Bourne shell script ``gdbarch.sh'' creates the files
104c1213
JM
28 ``new-gdbarch.c'' and ``new-gdbarch.h and then compares them
29 against the existing ``gdbarch.[hc]''. Any differences found
30 being reported.
31
32 If editing this file, please also run gdbarch.sh and merge any
52204a0b 33 changes into that script. Conversely, when making sweeping changes
104c1213
JM
34 to this file, modifying gdbarch.sh and using its output may prove
35 easier. */
adf40b2e 36
c906108c
SS
37#ifndef GDBARCH_H
38#define GDBARCH_H
39
da3331ec
AC
40struct floatformat;
41struct ui_file;
cce74817
JM
42struct frame_info;
43struct value;
b6af0555 44struct objfile;
1c772458 45struct obj_section;
a2cf933a 46struct minimal_symbol;
049ee0e4 47struct regcache;
b59ff9d5 48struct reggroup;
6ce6d90f 49struct regset;
a89aa300 50struct disassemble_info;
e2d0e7eb 51struct target_ops;
030f20e1 52struct obstack;
8181d85f 53struct bp_target_info;
424163ea 54struct target_desc;
0f71a2f6 55
0f71a2f6
JM
56extern struct gdbarch *current_gdbarch;
57
0f71a2f6
JM
58
59/* The following are pre-initialized by GDBARCH. */
60
104c1213 61extern const struct bfd_arch_info * gdbarch_bfd_arch_info (struct gdbarch *gdbarch);
0f71a2f6 62/* set_gdbarch_bfd_arch_info() - not applicable - pre-initialized. */
5010d38b 63#if !defined (GDB_TM_FILE) && defined (TARGET_ARCHITECTURE)
83905903
AC
64#error "Non multi-arch definition of TARGET_ARCHITECTURE"
65#endif
c25083af 66#if !defined (TARGET_ARCHITECTURE)
0f71a2f6
JM
67#define TARGET_ARCHITECTURE (gdbarch_bfd_arch_info (current_gdbarch))
68#endif
0f71a2f6 69
104c1213 70extern int gdbarch_byte_order (struct gdbarch *gdbarch);
0f71a2f6 71/* set_gdbarch_byte_order() - not applicable - pre-initialized. */
0f71a2f6 72
4be87837
DJ
73extern enum gdb_osabi gdbarch_osabi (struct gdbarch *gdbarch);
74/* set_gdbarch_osabi() - not applicable - pre-initialized. */
4be87837 75
424163ea
DJ
76extern const struct target_desc * gdbarch_target_desc (struct gdbarch *gdbarch);
77/* set_gdbarch_target_desc() - not applicable - pre-initialized. */
78
0f71a2f6 79
99e7bb18 80/* The following are initialized by the target dependent code. */
0f71a2f6 81
66b43ecb
AC
82/* Number of bits in a char or unsigned char for the target machine.
83 Just like CHAR_BIT in <limits.h> but describes the target machine.
57010b1c 84 v:TARGET_CHAR_BIT:int:char_bit::::8 * sizeof (char):8::0:
66b43ecb
AC
85
86 Number of bits in a short or unsigned short for the target machine. */
c4093a6a 87
104c1213
JM
88extern int gdbarch_short_bit (struct gdbarch *gdbarch);
89extern void set_gdbarch_short_bit (struct gdbarch *gdbarch, int short_bit);
5010d38b 90#if !defined (GDB_TM_FILE) && defined (TARGET_SHORT_BIT)
83905903
AC
91#error "Non multi-arch definition of TARGET_SHORT_BIT"
92#endif
c25083af 93#if !defined (TARGET_SHORT_BIT)
0f71a2f6
JM
94#define TARGET_SHORT_BIT (gdbarch_short_bit (current_gdbarch))
95#endif
0f71a2f6 96
66b43ecb
AC
97/* Number of bits in an int or unsigned int for the target machine. */
98
104c1213
JM
99extern int gdbarch_int_bit (struct gdbarch *gdbarch);
100extern void set_gdbarch_int_bit (struct gdbarch *gdbarch, int int_bit);
5010d38b 101#if !defined (GDB_TM_FILE) && defined (TARGET_INT_BIT)
83905903
AC
102#error "Non multi-arch definition of TARGET_INT_BIT"
103#endif
c25083af 104#if !defined (TARGET_INT_BIT)
0f71a2f6
JM
105#define TARGET_INT_BIT (gdbarch_int_bit (current_gdbarch))
106#endif
0f71a2f6 107
66b43ecb
AC
108/* Number of bits in a long or unsigned long for the target machine. */
109
104c1213
JM
110extern int gdbarch_long_bit (struct gdbarch *gdbarch);
111extern void set_gdbarch_long_bit (struct gdbarch *gdbarch, int long_bit);
5010d38b 112#if !defined (GDB_TM_FILE) && defined (TARGET_LONG_BIT)
83905903
AC
113#error "Non multi-arch definition of TARGET_LONG_BIT"
114#endif
c25083af 115#if !defined (TARGET_LONG_BIT)
0f71a2f6
JM
116#define TARGET_LONG_BIT (gdbarch_long_bit (current_gdbarch))
117#endif
0f71a2f6 118
66b43ecb
AC
119/* Number of bits in a long long or unsigned long long for the target
120 machine. */
121
104c1213
JM
122extern int gdbarch_long_long_bit (struct gdbarch *gdbarch);
123extern void set_gdbarch_long_long_bit (struct gdbarch *gdbarch, int long_long_bit);
5010d38b 124#if !defined (GDB_TM_FILE) && defined (TARGET_LONG_LONG_BIT)
83905903
AC
125#error "Non multi-arch definition of TARGET_LONG_LONG_BIT"
126#endif
c25083af 127#if !defined (TARGET_LONG_LONG_BIT)
0f71a2f6
JM
128#define TARGET_LONG_LONG_BIT (gdbarch_long_long_bit (current_gdbarch))
129#endif
0f71a2f6 130
456fcf94
AC
131/* The ABI default bit-size and format for "float", "double", and "long
132 double". These bit/format pairs should eventually be combined into
8da61cc4
DJ
133 a single object. For the moment, just initialize them as a pair.
134 Each format describes both the big and little endian layouts (if
135 useful). */
66b43ecb 136
104c1213
JM
137extern int gdbarch_float_bit (struct gdbarch *gdbarch);
138extern void set_gdbarch_float_bit (struct gdbarch *gdbarch, int float_bit);
5010d38b 139#if !defined (GDB_TM_FILE) && defined (TARGET_FLOAT_BIT)
83905903
AC
140#error "Non multi-arch definition of TARGET_FLOAT_BIT"
141#endif
c25083af 142#if !defined (TARGET_FLOAT_BIT)
0f71a2f6
JM
143#define TARGET_FLOAT_BIT (gdbarch_float_bit (current_gdbarch))
144#endif
0f71a2f6 145
8da61cc4
DJ
146extern const struct floatformat ** gdbarch_float_format (struct gdbarch *gdbarch);
147extern void set_gdbarch_float_format (struct gdbarch *gdbarch, const struct floatformat ** float_format);
5010d38b 148#if !defined (GDB_TM_FILE) && defined (TARGET_FLOAT_FORMAT)
456fcf94
AC
149#error "Non multi-arch definition of TARGET_FLOAT_FORMAT"
150#endif
151#if !defined (TARGET_FLOAT_FORMAT)
152#define TARGET_FLOAT_FORMAT (gdbarch_float_format (current_gdbarch))
153#endif
66b43ecb 154
104c1213
JM
155extern int gdbarch_double_bit (struct gdbarch *gdbarch);
156extern void set_gdbarch_double_bit (struct gdbarch *gdbarch, int double_bit);
5010d38b 157#if !defined (GDB_TM_FILE) && defined (TARGET_DOUBLE_BIT)
83905903
AC
158#error "Non multi-arch definition of TARGET_DOUBLE_BIT"
159#endif
c25083af 160#if !defined (TARGET_DOUBLE_BIT)
0f71a2f6
JM
161#define TARGET_DOUBLE_BIT (gdbarch_double_bit (current_gdbarch))
162#endif
0f71a2f6 163
8da61cc4
DJ
164extern const struct floatformat ** gdbarch_double_format (struct gdbarch *gdbarch);
165extern void set_gdbarch_double_format (struct gdbarch *gdbarch, const struct floatformat ** double_format);
5010d38b 166#if !defined (GDB_TM_FILE) && defined (TARGET_DOUBLE_FORMAT)
456fcf94
AC
167#error "Non multi-arch definition of TARGET_DOUBLE_FORMAT"
168#endif
169#if !defined (TARGET_DOUBLE_FORMAT)
170#define TARGET_DOUBLE_FORMAT (gdbarch_double_format (current_gdbarch))
171#endif
66b43ecb 172
104c1213
JM
173extern int gdbarch_long_double_bit (struct gdbarch *gdbarch);
174extern void set_gdbarch_long_double_bit (struct gdbarch *gdbarch, int long_double_bit);
5010d38b 175#if !defined (GDB_TM_FILE) && defined (TARGET_LONG_DOUBLE_BIT)
83905903
AC
176#error "Non multi-arch definition of TARGET_LONG_DOUBLE_BIT"
177#endif
c25083af 178#if !defined (TARGET_LONG_DOUBLE_BIT)
0f71a2f6
JM
179#define TARGET_LONG_DOUBLE_BIT (gdbarch_long_double_bit (current_gdbarch))
180#endif
0f71a2f6 181
8da61cc4
DJ
182extern const struct floatformat ** gdbarch_long_double_format (struct gdbarch *gdbarch);
183extern void set_gdbarch_long_double_format (struct gdbarch *gdbarch, const struct floatformat ** long_double_format);
5010d38b 184#if !defined (GDB_TM_FILE) && defined (TARGET_LONG_DOUBLE_FORMAT)
456fcf94
AC
185#error "Non multi-arch definition of TARGET_LONG_DOUBLE_FORMAT"
186#endif
187#if !defined (TARGET_LONG_DOUBLE_FORMAT)
188#define TARGET_LONG_DOUBLE_FORMAT (gdbarch_long_double_format (current_gdbarch))
189#endif
190
52204a0b
DT
191/* For most targets, a pointer on the target and its representation as an
192 address in GDB have the same size and "look the same". For such a
193 target, you need only set TARGET_PTR_BIT / ptr_bit and TARGET_ADDR_BIT
194 / addr_bit will be set from it.
195
196 If TARGET_PTR_BIT and TARGET_ADDR_BIT are different, you'll probably
197 also need to set POINTER_TO_ADDRESS and ADDRESS_TO_POINTER as well.
198
199 ptr_bit is the size of a pointer on the target */
66b43ecb 200
66b43ecb
AC
201extern int gdbarch_ptr_bit (struct gdbarch *gdbarch);
202extern void set_gdbarch_ptr_bit (struct gdbarch *gdbarch, int ptr_bit);
5010d38b 203#if !defined (GDB_TM_FILE) && defined (TARGET_PTR_BIT)
83905903
AC
204#error "Non multi-arch definition of TARGET_PTR_BIT"
205#endif
c25083af 206#if !defined (TARGET_PTR_BIT)
66b43ecb
AC
207#define TARGET_PTR_BIT (gdbarch_ptr_bit (current_gdbarch))
208#endif
66b43ecb 209
52204a0b
DT
210/* addr_bit is the size of a target address as represented in gdb */
211
52204a0b
DT
212extern int gdbarch_addr_bit (struct gdbarch *gdbarch);
213extern void set_gdbarch_addr_bit (struct gdbarch *gdbarch, int addr_bit);
5010d38b 214#if !defined (GDB_TM_FILE) && defined (TARGET_ADDR_BIT)
83905903
AC
215#error "Non multi-arch definition of TARGET_ADDR_BIT"
216#endif
c25083af 217#if !defined (TARGET_ADDR_BIT)
52204a0b
DT
218#define TARGET_ADDR_BIT (gdbarch_addr_bit (current_gdbarch))
219#endif
52204a0b 220
66b43ecb
AC
221/* Number of bits in a BFD_VMA for the target object file format. */
222
66b43ecb
AC
223extern int gdbarch_bfd_vma_bit (struct gdbarch *gdbarch);
224extern void set_gdbarch_bfd_vma_bit (struct gdbarch *gdbarch, int bfd_vma_bit);
5010d38b 225#if !defined (GDB_TM_FILE) && defined (TARGET_BFD_VMA_BIT)
83905903
AC
226#error "Non multi-arch definition of TARGET_BFD_VMA_BIT"
227#endif
c25083af 228#if !defined (TARGET_BFD_VMA_BIT)
66b43ecb
AC
229#define TARGET_BFD_VMA_BIT (gdbarch_bfd_vma_bit (current_gdbarch))
230#endif
66b43ecb 231
4e409299
JB
232/* One if `char' acts like `signed char', zero if `unsigned char'. */
233
4e409299
JB
234extern int gdbarch_char_signed (struct gdbarch *gdbarch);
235extern void set_gdbarch_char_signed (struct gdbarch *gdbarch, int char_signed);
4e409299 236
cde9ea48
AC
237#if defined (TARGET_READ_PC)
238/* Legacy for systems yet to multi-arch TARGET_READ_PC */
239#if !defined (TARGET_READ_PC_P)
240#define TARGET_READ_PC_P() (1)
241#endif
242#endif
243
cde9ea48 244extern int gdbarch_read_pc_p (struct gdbarch *gdbarch);
5010d38b 245#if !defined (GDB_TM_FILE) && defined (TARGET_READ_PC_P)
cde9ea48
AC
246#error "Non multi-arch definition of TARGET_READ_PC"
247#endif
bceabdd8 248#if !defined (TARGET_READ_PC_P)
cde9ea48
AC
249#define TARGET_READ_PC_P() (gdbarch_read_pc_p (current_gdbarch))
250#endif
251
39f77062
KB
252typedef CORE_ADDR (gdbarch_read_pc_ftype) (ptid_t ptid);
253extern CORE_ADDR gdbarch_read_pc (struct gdbarch *gdbarch, ptid_t ptid);
104c1213 254extern void set_gdbarch_read_pc (struct gdbarch *gdbarch, gdbarch_read_pc_ftype *read_pc);
5010d38b 255#if !defined (GDB_TM_FILE) && defined (TARGET_READ_PC)
83905903
AC
256#error "Non multi-arch definition of TARGET_READ_PC"
257#endif
c25083af 258#if !defined (TARGET_READ_PC)
39f77062 259#define TARGET_READ_PC(ptid) (gdbarch_read_pc (current_gdbarch, ptid))
0f71a2f6 260#endif
0f71a2f6 261
39f77062
KB
262typedef void (gdbarch_write_pc_ftype) (CORE_ADDR val, ptid_t ptid);
263extern void gdbarch_write_pc (struct gdbarch *gdbarch, CORE_ADDR val, ptid_t ptid);
104c1213 264extern void set_gdbarch_write_pc (struct gdbarch *gdbarch, gdbarch_write_pc_ftype *write_pc);
5010d38b 265#if !defined (GDB_TM_FILE) && defined (TARGET_WRITE_PC)
83905903
AC
266#error "Non multi-arch definition of TARGET_WRITE_PC"
267#endif
c25083af 268#if !defined (TARGET_WRITE_PC)
39f77062 269#define TARGET_WRITE_PC(val, ptid) (gdbarch_write_pc (current_gdbarch, val, ptid))
0f71a2f6 270#endif
0f71a2f6 271
39d4ef09
AC
272/* Function for getting target's idea of a frame pointer. FIXME: GDB's
273 whole scheme for dealing with "frames" and "frame pointers" needs a
274 serious shakedown. */
275
39d4ef09
AC
276typedef void (gdbarch_virtual_frame_pointer_ftype) (CORE_ADDR pc, int *frame_regnum, LONGEST *frame_offset);
277extern void gdbarch_virtual_frame_pointer (struct gdbarch *gdbarch, CORE_ADDR pc, int *frame_regnum, LONGEST *frame_offset);
278extern void set_gdbarch_virtual_frame_pointer (struct gdbarch *gdbarch, gdbarch_virtual_frame_pointer_ftype *virtual_frame_pointer);
5010d38b 279#if !defined (GDB_TM_FILE) && defined (TARGET_VIRTUAL_FRAME_POINTER)
39d4ef09
AC
280#error "Non multi-arch definition of TARGET_VIRTUAL_FRAME_POINTER"
281#endif
c25083af 282#if !defined (TARGET_VIRTUAL_FRAME_POINTER)
39d4ef09
AC
283#define TARGET_VIRTUAL_FRAME_POINTER(pc, frame_regnum, frame_offset) (gdbarch_virtual_frame_pointer (current_gdbarch, pc, frame_regnum, frame_offset))
284#endif
39d4ef09 285
d8124050 286extern int gdbarch_pseudo_register_read_p (struct gdbarch *gdbarch);
61a0eb5b 287
b60c417a
AC
288typedef void (gdbarch_pseudo_register_read_ftype) (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum, gdb_byte *buf);
289extern void gdbarch_pseudo_register_read (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum, gdb_byte *buf);
d8124050 290extern void set_gdbarch_pseudo_register_read (struct gdbarch *gdbarch, gdbarch_pseudo_register_read_ftype *pseudo_register_read);
61a0eb5b 291
d8124050 292extern int gdbarch_pseudo_register_write_p (struct gdbarch *gdbarch);
61a0eb5b 293
b60c417a
AC
294typedef void (gdbarch_pseudo_register_write_ftype) (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum, const gdb_byte *buf);
295extern void gdbarch_pseudo_register_write (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum, const gdb_byte *buf);
d8124050 296extern void set_gdbarch_pseudo_register_write (struct gdbarch *gdbarch, gdbarch_pseudo_register_write_ftype *pseudo_register_write);
61a0eb5b 297
104c1213
JM
298extern int gdbarch_num_regs (struct gdbarch *gdbarch);
299extern void set_gdbarch_num_regs (struct gdbarch *gdbarch, int num_regs);
0f71a2f6 300
34620563
AC
301/* This macro gives the number of pseudo-registers that live in the
302 register namespace but do not get fetched or stored on the target.
303 These pseudo-registers may be aliases for other registers,
304 combinations of other registers, or they may be computed by GDB. */
305
0aba1244
EZ
306extern int gdbarch_num_pseudo_regs (struct gdbarch *gdbarch);
307extern void set_gdbarch_num_pseudo_regs (struct gdbarch *gdbarch, int num_pseudo_regs);
0aba1244 308
c2169756
AC
309/* GDB's standard (or well known) register numbers. These can map onto
310 a real register or a pseudo (computed) register or not be defined at
a9e5fdc2
AC
311 all (-1).
312 SP_REGNUM will hopefully be replaced by UNWIND_SP. */
1200cd6e 313
104c1213
JM
314extern int gdbarch_sp_regnum (struct gdbarch *gdbarch);
315extern void set_gdbarch_sp_regnum (struct gdbarch *gdbarch, int sp_regnum);
5010d38b 316#if !defined (GDB_TM_FILE) && defined (SP_REGNUM)
83905903
AC
317#error "Non multi-arch definition of SP_REGNUM"
318#endif
c25083af 319#if !defined (SP_REGNUM)
0f71a2f6
JM
320#define SP_REGNUM (gdbarch_sp_regnum (current_gdbarch))
321#endif
0f71a2f6 322
104c1213
JM
323extern int gdbarch_pc_regnum (struct gdbarch *gdbarch);
324extern void set_gdbarch_pc_regnum (struct gdbarch *gdbarch, int pc_regnum);
5010d38b 325#if !defined (GDB_TM_FILE) && defined (PC_REGNUM)
83905903
AC
326#error "Non multi-arch definition of PC_REGNUM"
327#endif
c25083af 328#if !defined (PC_REGNUM)
0f71a2f6
JM
329#define PC_REGNUM (gdbarch_pc_regnum (current_gdbarch))
330#endif
0f71a2f6 331
c2169756
AC
332extern int gdbarch_ps_regnum (struct gdbarch *gdbarch);
333extern void set_gdbarch_ps_regnum (struct gdbarch *gdbarch, int ps_regnum);
5010d38b 334#if !defined (GDB_TM_FILE) && defined (PS_REGNUM)
c2169756
AC
335#error "Non multi-arch definition of PS_REGNUM"
336#endif
c25083af 337#if !defined (PS_REGNUM)
c2169756
AC
338#define PS_REGNUM (gdbarch_ps_regnum (current_gdbarch))
339#endif
c2169756 340
60054393
MS
341extern int gdbarch_fp0_regnum (struct gdbarch *gdbarch);
342extern void set_gdbarch_fp0_regnum (struct gdbarch *gdbarch, int fp0_regnum);
5010d38b 343#if !defined (GDB_TM_FILE) && defined (FP0_REGNUM)
83905903
AC
344#error "Non multi-arch definition of FP0_REGNUM"
345#endif
c25083af 346#if !defined (FP0_REGNUM)
60054393
MS
347#define FP0_REGNUM (gdbarch_fp0_regnum (current_gdbarch))
348#endif
60054393 349
88c72b7d
AC
350/* Convert stab register number (from `r' declaration) to a gdb REGNUM. */
351
88c72b7d
AC
352typedef int (gdbarch_stab_reg_to_regnum_ftype) (int stab_regnr);
353extern int gdbarch_stab_reg_to_regnum (struct gdbarch *gdbarch, int stab_regnr);
354extern void set_gdbarch_stab_reg_to_regnum (struct gdbarch *gdbarch, gdbarch_stab_reg_to_regnum_ftype *stab_reg_to_regnum);
5010d38b 355#if !defined (GDB_TM_FILE) && defined (STAB_REG_TO_REGNUM)
83905903
AC
356#error "Non multi-arch definition of STAB_REG_TO_REGNUM"
357#endif
c25083af 358#if !defined (STAB_REG_TO_REGNUM)
88c72b7d
AC
359#define STAB_REG_TO_REGNUM(stab_regnr) (gdbarch_stab_reg_to_regnum (current_gdbarch, stab_regnr))
360#endif
88c72b7d
AC
361
362/* Provide a default mapping from a ecoff register number to a gdb REGNUM. */
363
88c72b7d
AC
364typedef int (gdbarch_ecoff_reg_to_regnum_ftype) (int ecoff_regnr);
365extern int gdbarch_ecoff_reg_to_regnum (struct gdbarch *gdbarch, int ecoff_regnr);
366extern void set_gdbarch_ecoff_reg_to_regnum (struct gdbarch *gdbarch, gdbarch_ecoff_reg_to_regnum_ftype *ecoff_reg_to_regnum);
5010d38b 367#if !defined (GDB_TM_FILE) && defined (ECOFF_REG_TO_REGNUM)
83905903
AC
368#error "Non multi-arch definition of ECOFF_REG_TO_REGNUM"
369#endif
c25083af 370#if !defined (ECOFF_REG_TO_REGNUM)
88c72b7d
AC
371#define ECOFF_REG_TO_REGNUM(ecoff_regnr) (gdbarch_ecoff_reg_to_regnum (current_gdbarch, ecoff_regnr))
372#endif
88c72b7d
AC
373
374/* Provide a default mapping from a DWARF register number to a gdb REGNUM. */
375
88c72b7d
AC
376typedef int (gdbarch_dwarf_reg_to_regnum_ftype) (int dwarf_regnr);
377extern int gdbarch_dwarf_reg_to_regnum (struct gdbarch *gdbarch, int dwarf_regnr);
378extern void set_gdbarch_dwarf_reg_to_regnum (struct gdbarch *gdbarch, gdbarch_dwarf_reg_to_regnum_ftype *dwarf_reg_to_regnum);
5010d38b 379#if !defined (GDB_TM_FILE) && defined (DWARF_REG_TO_REGNUM)
83905903
AC
380#error "Non multi-arch definition of DWARF_REG_TO_REGNUM"
381#endif
c25083af 382#if !defined (DWARF_REG_TO_REGNUM)
88c72b7d
AC
383#define DWARF_REG_TO_REGNUM(dwarf_regnr) (gdbarch_dwarf_reg_to_regnum (current_gdbarch, dwarf_regnr))
384#endif
88c72b7d 385
77949794 386/* Convert from an sdb register number to an internal gdb register number. */
88c72b7d 387
88c72b7d
AC
388typedef int (gdbarch_sdb_reg_to_regnum_ftype) (int sdb_regnr);
389extern int gdbarch_sdb_reg_to_regnum (struct gdbarch *gdbarch, int sdb_regnr);
390extern void set_gdbarch_sdb_reg_to_regnum (struct gdbarch *gdbarch, gdbarch_sdb_reg_to_regnum_ftype *sdb_reg_to_regnum);
5010d38b 391#if !defined (GDB_TM_FILE) && defined (SDB_REG_TO_REGNUM)
83905903
AC
392#error "Non multi-arch definition of SDB_REG_TO_REGNUM"
393#endif
c25083af 394#if !defined (SDB_REG_TO_REGNUM)
88c72b7d
AC
395#define SDB_REG_TO_REGNUM(sdb_regnr) (gdbarch_sdb_reg_to_regnum (current_gdbarch, sdb_regnr))
396#endif
88c72b7d 397
88c72b7d
AC
398typedef int (gdbarch_dwarf2_reg_to_regnum_ftype) (int dwarf2_regnr);
399extern int gdbarch_dwarf2_reg_to_regnum (struct gdbarch *gdbarch, int dwarf2_regnr);
400extern void set_gdbarch_dwarf2_reg_to_regnum (struct gdbarch *gdbarch, gdbarch_dwarf2_reg_to_regnum_ftype *dwarf2_reg_to_regnum);
5010d38b 401#if !defined (GDB_TM_FILE) && defined (DWARF2_REG_TO_REGNUM)
83905903
AC
402#error "Non multi-arch definition of DWARF2_REG_TO_REGNUM"
403#endif
c25083af 404#if !defined (DWARF2_REG_TO_REGNUM)
88c72b7d
AC
405#define DWARF2_REG_TO_REGNUM(dwarf2_regnr) (gdbarch_dwarf2_reg_to_regnum (current_gdbarch, dwarf2_regnr))
406#endif
88c72b7d 407
fa88f677
AC
408typedef const char * (gdbarch_register_name_ftype) (int regnr);
409extern const char * gdbarch_register_name (struct gdbarch *gdbarch, int regnr);
104c1213 410extern void set_gdbarch_register_name (struct gdbarch *gdbarch, gdbarch_register_name_ftype *register_name);
5010d38b 411#if !defined (GDB_TM_FILE) && defined (REGISTER_NAME)
83905903
AC
412#error "Non multi-arch definition of REGISTER_NAME"
413#endif
c25083af 414#if !defined (REGISTER_NAME)
0f71a2f6
JM
415#define REGISTER_NAME(regnr) (gdbarch_register_name (current_gdbarch, regnr))
416#endif
0f71a2f6 417
7b9ee6a8
DJ
418/* Return the type of a register specified by the architecture. Only
419 the register cache should call this function directly; others should
420 use "register_type". */
9c04cab7
AC
421
422extern int gdbarch_register_type_p (struct gdbarch *gdbarch);
423
424typedef struct type * (gdbarch_register_type_ftype) (struct gdbarch *gdbarch, int reg_nr);
425extern struct type * gdbarch_register_type (struct gdbarch *gdbarch, int reg_nr);
426extern void set_gdbarch_register_type (struct gdbarch *gdbarch, gdbarch_register_type_ftype *register_type);
427
f3be58bc
AC
428/* See gdbint.texinfo, and PUSH_DUMMY_CALL. */
429
430extern int gdbarch_unwind_dummy_id_p (struct gdbarch *gdbarch);
431
432typedef struct frame_id (gdbarch_unwind_dummy_id_ftype) (struct gdbarch *gdbarch, struct frame_info *info);
433extern struct frame_id gdbarch_unwind_dummy_id (struct gdbarch *gdbarch, struct frame_info *info);
434extern void set_gdbarch_unwind_dummy_id (struct gdbarch *gdbarch, gdbarch_unwind_dummy_id_ftype *unwind_dummy_id);
435
f3be58bc
AC
436/* Implement UNWIND_DUMMY_ID and PUSH_DUMMY_CALL, then delete
437 DEPRECATED_FP_REGNUM. */
438
f3be58bc
AC
439extern int gdbarch_deprecated_fp_regnum (struct gdbarch *gdbarch);
440extern void set_gdbarch_deprecated_fp_regnum (struct gdbarch *gdbarch, int deprecated_fp_regnum);
5010d38b 441#if !defined (GDB_TM_FILE) && defined (DEPRECATED_FP_REGNUM)
f3be58bc
AC
442#error "Non multi-arch definition of DEPRECATED_FP_REGNUM"
443#endif
444#if !defined (DEPRECATED_FP_REGNUM)
445#define DEPRECATED_FP_REGNUM (gdbarch_deprecated_fp_regnum (current_gdbarch))
446#endif
447
a86c5fc9 448/* See gdbint.texinfo. See infcall.c. */
b8de8283
AC
449
450extern int gdbarch_push_dummy_call_p (struct gdbarch *gdbarch);
451
7d9b040b
RC
452typedef CORE_ADDR (gdbarch_push_dummy_call_ftype) (struct gdbarch *gdbarch, struct value *function, struct regcache *regcache, CORE_ADDR bp_addr, int nargs, struct value **args, CORE_ADDR sp, int struct_return, CORE_ADDR struct_addr);
453extern CORE_ADDR gdbarch_push_dummy_call (struct gdbarch *gdbarch, struct value *function, struct regcache *regcache, CORE_ADDR bp_addr, int nargs, struct value **args, CORE_ADDR sp, int struct_return, CORE_ADDR struct_addr);
b8de8283
AC
454extern void set_gdbarch_push_dummy_call (struct gdbarch *gdbarch, gdbarch_push_dummy_call_ftype *push_dummy_call);
455
b8de8283
AC
456/* DEPRECATED_REGISTER_SIZE can be deleted. */
457
458extern int gdbarch_deprecated_register_size (struct gdbarch *gdbarch);
459extern void set_gdbarch_deprecated_register_size (struct gdbarch *gdbarch, int deprecated_register_size);
5010d38b 460#if !defined (GDB_TM_FILE) && defined (DEPRECATED_REGISTER_SIZE)
b8de8283
AC
461#error "Non multi-arch definition of DEPRECATED_REGISTER_SIZE"
462#endif
463#if !defined (DEPRECATED_REGISTER_SIZE)
464#define DEPRECATED_REGISTER_SIZE (gdbarch_deprecated_register_size (current_gdbarch))
465#endif
466
b8de8283
AC
467extern int gdbarch_call_dummy_location (struct gdbarch *gdbarch);
468extern void set_gdbarch_call_dummy_location (struct gdbarch *gdbarch, int call_dummy_location);
b8de8283 469
b8de8283
AC
470extern int gdbarch_push_dummy_code_p (struct gdbarch *gdbarch);
471
472typedef CORE_ADDR (gdbarch_push_dummy_code_ftype) (struct gdbarch *gdbarch, CORE_ADDR sp, CORE_ADDR funaddr, int using_gcc, struct value **args, int nargs, struct type *value_type, CORE_ADDR *real_pc, CORE_ADDR *bp_addr);
473extern CORE_ADDR gdbarch_push_dummy_code (struct gdbarch *gdbarch, CORE_ADDR sp, CORE_ADDR funaddr, int using_gcc, struct value **args, int nargs, struct type *value_type, CORE_ADDR *real_pc, CORE_ADDR *bp_addr);
474extern void set_gdbarch_push_dummy_code (struct gdbarch *gdbarch, gdbarch_push_dummy_code_ftype *push_dummy_code);
475
0ab7a791
AC
476typedef void (gdbarch_print_registers_info_ftype) (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, int regnum, int all);
477extern void gdbarch_print_registers_info (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, int regnum, int all);
478extern void set_gdbarch_print_registers_info (struct gdbarch *gdbarch, gdbarch_print_registers_info_ftype *print_registers_info);
479
23e3a7ac
AC
480extern int gdbarch_print_float_info_p (struct gdbarch *gdbarch);
481
482typedef void (gdbarch_print_float_info_ftype) (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, const char *args);
483extern void gdbarch_print_float_info (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, const char *args);
5e74b15c 484extern void set_gdbarch_print_float_info (struct gdbarch *gdbarch, gdbarch_print_float_info_ftype *print_float_info);
5e74b15c 485
e76f1f2e
AC
486extern int gdbarch_print_vector_info_p (struct gdbarch *gdbarch);
487
488typedef void (gdbarch_print_vector_info_ftype) (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, const char *args);
489extern void gdbarch_print_vector_info (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, const char *args);
490extern void set_gdbarch_print_vector_info (struct gdbarch *gdbarch, gdbarch_print_vector_info_ftype *print_vector_info);
491
7c7651b2
AC
492/* MAP a GDB RAW register number onto a simulator register number. See
493 also include/...-sim.h. */
494
7c7651b2
AC
495typedef int (gdbarch_register_sim_regno_ftype) (int reg_nr);
496extern int gdbarch_register_sim_regno (struct gdbarch *gdbarch, int reg_nr);
497extern void set_gdbarch_register_sim_regno (struct gdbarch *gdbarch, gdbarch_register_sim_regno_ftype *register_sim_regno);
5010d38b 498#if !defined (GDB_TM_FILE) && defined (REGISTER_SIM_REGNO)
83905903
AC
499#error "Non multi-arch definition of REGISTER_SIM_REGNO"
500#endif
c25083af 501#if !defined (REGISTER_SIM_REGNO)
7c7651b2
AC
502#define REGISTER_SIM_REGNO(reg_nr) (gdbarch_register_sim_regno (current_gdbarch, reg_nr))
503#endif
7c7651b2 504
2649061d
AC
505#if defined (REGISTER_BYTES_OK)
506/* Legacy for systems yet to multi-arch REGISTER_BYTES_OK */
eee30e78 507#if !defined (REGISTER_BYTES_OK_P)
2649061d
AC
508#define REGISTER_BYTES_OK_P() (1)
509#endif
eee30e78 510#endif
2649061d 511
2649061d 512extern int gdbarch_register_bytes_ok_p (struct gdbarch *gdbarch);
5010d38b 513#if !defined (GDB_TM_FILE) && defined (REGISTER_BYTES_OK_P)
83905903
AC
514#error "Non multi-arch definition of REGISTER_BYTES_OK"
515#endif
bceabdd8 516#if !defined (REGISTER_BYTES_OK_P)
2649061d
AC
517#define REGISTER_BYTES_OK_P() (gdbarch_register_bytes_ok_p (current_gdbarch))
518#endif
519
2649061d
AC
520typedef int (gdbarch_register_bytes_ok_ftype) (long nr_bytes);
521extern int gdbarch_register_bytes_ok (struct gdbarch *gdbarch, long nr_bytes);
522extern void set_gdbarch_register_bytes_ok (struct gdbarch *gdbarch, gdbarch_register_bytes_ok_ftype *register_bytes_ok);
5010d38b 523#if !defined (GDB_TM_FILE) && defined (REGISTER_BYTES_OK)
83905903
AC
524#error "Non multi-arch definition of REGISTER_BYTES_OK"
525#endif
c25083af 526#if !defined (REGISTER_BYTES_OK)
2649061d
AC
527#define REGISTER_BYTES_OK(nr_bytes) (gdbarch_register_bytes_ok (current_gdbarch, nr_bytes))
528#endif
2649061d 529
01fb7433
AC
530typedef int (gdbarch_cannot_fetch_register_ftype) (int regnum);
531extern int gdbarch_cannot_fetch_register (struct gdbarch *gdbarch, int regnum);
532extern void set_gdbarch_cannot_fetch_register (struct gdbarch *gdbarch, gdbarch_cannot_fetch_register_ftype *cannot_fetch_register);
01fb7433 533
01fb7433
AC
534typedef int (gdbarch_cannot_store_register_ftype) (int regnum);
535extern int gdbarch_cannot_store_register (struct gdbarch *gdbarch, int regnum);
536extern void set_gdbarch_cannot_store_register (struct gdbarch *gdbarch, gdbarch_cannot_store_register_ftype *cannot_store_register);
01fb7433 537
9df628e0
RE
538/* setjmp/longjmp support. */
539
540#if defined (GET_LONGJMP_TARGET)
541/* Legacy for systems yet to multi-arch GET_LONGJMP_TARGET */
542#if !defined (GET_LONGJMP_TARGET_P)
543#define GET_LONGJMP_TARGET_P() (1)
544#endif
545#endif
546
9df628e0 547extern int gdbarch_get_longjmp_target_p (struct gdbarch *gdbarch);
5010d38b 548#if !defined (GDB_TM_FILE) && defined (GET_LONGJMP_TARGET_P)
9df628e0
RE
549#error "Non multi-arch definition of GET_LONGJMP_TARGET"
550#endif
bceabdd8 551#if !defined (GET_LONGJMP_TARGET_P)
b8de8283 552#define GET_LONGJMP_TARGET_P() (gdbarch_get_longjmp_target_p (current_gdbarch))
0f71a2f6 553#endif
0f71a2f6 554
b8de8283
AC
555typedef int (gdbarch_get_longjmp_target_ftype) (CORE_ADDR *pc);
556extern int gdbarch_get_longjmp_target (struct gdbarch *gdbarch, CORE_ADDR *pc);
557extern void set_gdbarch_get_longjmp_target (struct gdbarch *gdbarch, gdbarch_get_longjmp_target_ftype *get_longjmp_target);
5010d38b 558#if !defined (GDB_TM_FILE) && defined (GET_LONGJMP_TARGET)
b8de8283 559#error "Non multi-arch definition of GET_LONGJMP_TARGET"
83905903 560#endif
b8de8283
AC
561#if !defined (GET_LONGJMP_TARGET)
562#define GET_LONGJMP_TARGET(pc) (gdbarch_get_longjmp_target (current_gdbarch, pc))
0f71a2f6 563#endif
0f71a2f6 564
104c1213
JM
565extern int gdbarch_believe_pcc_promotion (struct gdbarch *gdbarch);
566extern void set_gdbarch_believe_pcc_promotion (struct gdbarch *gdbarch, int believe_pcc_promotion);
5010d38b 567#if !defined (GDB_TM_FILE) && defined (BELIEVE_PCC_PROMOTION)
83905903
AC
568#error "Non multi-arch definition of BELIEVE_PCC_PROMOTION"
569#endif
c25083af 570#if !defined (BELIEVE_PCC_PROMOTION)
0f71a2f6
JM
571#define BELIEVE_PCC_PROMOTION (gdbarch_believe_pcc_promotion (current_gdbarch))
572#endif
0f71a2f6 573
ff2e87ac
AC
574typedef int (gdbarch_convert_register_p_ftype) (int regnum, struct type *type);
575extern int gdbarch_convert_register_p (struct gdbarch *gdbarch, int regnum, struct type *type);
13d01224 576extern void set_gdbarch_convert_register_p (struct gdbarch *gdbarch, gdbarch_convert_register_p_ftype *convert_register_p);
5010d38b 577#if !defined (GDB_TM_FILE) && defined (CONVERT_REGISTER_P)
13d01224
AC
578#error "Non multi-arch definition of CONVERT_REGISTER_P"
579#endif
c25083af 580#if !defined (CONVERT_REGISTER_P)
ff2e87ac 581#define CONVERT_REGISTER_P(regnum, type) (gdbarch_convert_register_p (current_gdbarch, regnum, type))
13d01224 582#endif
13d01224 583
b60c417a
AC
584typedef void (gdbarch_register_to_value_ftype) (struct frame_info *frame, int regnum, struct type *type, gdb_byte *buf);
585extern void gdbarch_register_to_value (struct gdbarch *gdbarch, struct frame_info *frame, int regnum, struct type *type, gdb_byte *buf);
13d01224 586extern void set_gdbarch_register_to_value (struct gdbarch *gdbarch, gdbarch_register_to_value_ftype *register_to_value);
5010d38b 587#if !defined (GDB_TM_FILE) && defined (REGISTER_TO_VALUE)
13d01224
AC
588#error "Non multi-arch definition of REGISTER_TO_VALUE"
589#endif
c25083af 590#if !defined (REGISTER_TO_VALUE)
ff2e87ac 591#define REGISTER_TO_VALUE(frame, regnum, type, buf) (gdbarch_register_to_value (current_gdbarch, frame, regnum, type, buf))
13d01224 592#endif
13d01224 593
b60c417a
AC
594typedef void (gdbarch_value_to_register_ftype) (struct frame_info *frame, int regnum, struct type *type, const gdb_byte *buf);
595extern void gdbarch_value_to_register (struct gdbarch *gdbarch, struct frame_info *frame, int regnum, struct type *type, const gdb_byte *buf);
13d01224 596extern void set_gdbarch_value_to_register (struct gdbarch *gdbarch, gdbarch_value_to_register_ftype *value_to_register);
5010d38b 597#if !defined (GDB_TM_FILE) && defined (VALUE_TO_REGISTER)
13d01224
AC
598#error "Non multi-arch definition of VALUE_TO_REGISTER"
599#endif
c25083af 600#if !defined (VALUE_TO_REGISTER)
ff2e87ac 601#define VALUE_TO_REGISTER(frame, regnum, type, buf) (gdbarch_value_to_register (current_gdbarch, frame, regnum, type, buf))
13d01224 602#endif
13d01224 603
9acbedc0
UW
604/* Construct a value representing the contents of register REGNUM in
605 frame FRAME, interpreted as type TYPE. The routine needs to
606 allocate and return a struct value with all value attributes
607 (but not the value contents) filled in. */
608
609typedef struct value * (gdbarch_value_from_register_ftype) (struct type *type, int regnum, struct frame_info *frame);
610extern struct value * gdbarch_value_from_register (struct gdbarch *gdbarch, struct type *type, int regnum, struct frame_info *frame);
611extern void set_gdbarch_value_from_register (struct gdbarch *gdbarch, gdbarch_value_from_register_ftype *value_from_register);
612
b60c417a
AC
613typedef CORE_ADDR (gdbarch_pointer_to_address_ftype) (struct type *type, const gdb_byte *buf);
614extern CORE_ADDR gdbarch_pointer_to_address (struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf);
4478b372 615extern void set_gdbarch_pointer_to_address (struct gdbarch *gdbarch, gdbarch_pointer_to_address_ftype *pointer_to_address);
5010d38b 616#if !defined (GDB_TM_FILE) && defined (POINTER_TO_ADDRESS)
83905903
AC
617#error "Non multi-arch definition of POINTER_TO_ADDRESS"
618#endif
c25083af 619#if !defined (POINTER_TO_ADDRESS)
4478b372
JB
620#define POINTER_TO_ADDRESS(type, buf) (gdbarch_pointer_to_address (current_gdbarch, type, buf))
621#endif
33489c5b 622
b60c417a
AC
623typedef void (gdbarch_address_to_pointer_ftype) (struct type *type, gdb_byte *buf, CORE_ADDR addr);
624extern void gdbarch_address_to_pointer (struct gdbarch *gdbarch, struct type *type, gdb_byte *buf, CORE_ADDR addr);
4478b372 625extern void set_gdbarch_address_to_pointer (struct gdbarch *gdbarch, gdbarch_address_to_pointer_ftype *address_to_pointer);
5010d38b 626#if !defined (GDB_TM_FILE) && defined (ADDRESS_TO_POINTER)
83905903
AC
627#error "Non multi-arch definition of ADDRESS_TO_POINTER"
628#endif
c25083af 629#if !defined (ADDRESS_TO_POINTER)
4478b372
JB
630#define ADDRESS_TO_POINTER(type, buf, addr) (gdbarch_address_to_pointer (current_gdbarch, type, buf, addr))
631#endif
33489c5b 632
fc0c74b1 633extern int gdbarch_integer_to_address_p (struct gdbarch *gdbarch);
fc0c74b1 634
fc1a4b47
AC
635typedef CORE_ADDR (gdbarch_integer_to_address_ftype) (struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf);
636extern CORE_ADDR gdbarch_integer_to_address (struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf);
fc0c74b1 637extern void set_gdbarch_integer_to_address (struct gdbarch *gdbarch, gdbarch_integer_to_address_ftype *integer_to_address);
fc0c74b1 638
92ad9cd9
AC
639/* It has been suggested that this, well actually its predecessor,
640 should take the type/value of the function to be called and not the
750eb019
AC
641 return type. This is left as an exercise for the reader.
642 NOTE: cagney/2004-06-13: The function stack.c:return_command uses
643 the predicate with default hack to avoid calling STORE_RETURN_VALUE
644 (via legacy_return_value), when a small struct is involved. */
92ad9cd9
AC
645
646extern int gdbarch_return_value_p (struct gdbarch *gdbarch);
647
b60c417a
AC
648typedef enum return_value_convention (gdbarch_return_value_ftype) (struct gdbarch *gdbarch, struct type *valtype, struct regcache *regcache, gdb_byte *readbuf, const gdb_byte *writebuf);
649extern enum return_value_convention gdbarch_return_value (struct gdbarch *gdbarch, struct type *valtype, struct regcache *regcache, gdb_byte *readbuf, const gdb_byte *writebuf);
92ad9cd9
AC
650extern void set_gdbarch_return_value (struct gdbarch *gdbarch, gdbarch_return_value_ftype *return_value);
651
b5622e8d
AC
652/* The deprecated methods EXTRACT_RETURN_VALUE, STORE_RETURN_VALUE,
653 DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS and
654 DEPRECATED_USE_STRUCT_CONVENTION have all been folded into
655 RETURN_VALUE. */
92ad9cd9 656
b60c417a
AC
657typedef void (gdbarch_extract_return_value_ftype) (struct type *type, struct regcache *regcache, gdb_byte *valbuf);
658extern void gdbarch_extract_return_value (struct gdbarch *gdbarch, struct type *type, struct regcache *regcache, gdb_byte *valbuf);
ebba8386 659extern void set_gdbarch_extract_return_value (struct gdbarch *gdbarch, gdbarch_extract_return_value_ftype *extract_return_value);
5010d38b 660#if !defined (GDB_TM_FILE) && defined (EXTRACT_RETURN_VALUE)
ebba8386
AC
661#error "Non multi-arch definition of EXTRACT_RETURN_VALUE"
662#endif
c25083af 663#if !defined (EXTRACT_RETURN_VALUE)
ebba8386
AC
664#define EXTRACT_RETURN_VALUE(type, regcache, valbuf) (gdbarch_extract_return_value (current_gdbarch, type, regcache, valbuf))
665#endif
ebba8386 666
b60c417a
AC
667typedef void (gdbarch_store_return_value_ftype) (struct type *type, struct regcache *regcache, const gdb_byte *valbuf);
668extern void gdbarch_store_return_value (struct gdbarch *gdbarch, struct type *type, struct regcache *regcache, const gdb_byte *valbuf);
104c1213 669extern void set_gdbarch_store_return_value (struct gdbarch *gdbarch, gdbarch_store_return_value_ftype *store_return_value);
5010d38b 670#if !defined (GDB_TM_FILE) && defined (STORE_RETURN_VALUE)
83905903
AC
671#error "Non multi-arch definition of STORE_RETURN_VALUE"
672#endif
c25083af 673#if !defined (STORE_RETURN_VALUE)
ebba8386
AC
674#define STORE_RETURN_VALUE(type, regcache, valbuf) (gdbarch_store_return_value (current_gdbarch, type, regcache, valbuf))
675#endif
ebba8386 676
b5622e8d
AC
677typedef int (gdbarch_deprecated_use_struct_convention_ftype) (int gcc_p, struct type *value_type);
678extern int gdbarch_deprecated_use_struct_convention (struct gdbarch *gdbarch, int gcc_p, struct type *value_type);
679extern void set_gdbarch_deprecated_use_struct_convention (struct gdbarch *gdbarch, gdbarch_deprecated_use_struct_convention_ftype *deprecated_use_struct_convention);
5010d38b 680#if !defined (GDB_TM_FILE) && defined (DEPRECATED_USE_STRUCT_CONVENTION)
b5622e8d 681#error "Non multi-arch definition of DEPRECATED_USE_STRUCT_CONVENTION"
92ad9cd9 682#endif
b5622e8d
AC
683#if !defined (DEPRECATED_USE_STRUCT_CONVENTION)
684#define DEPRECATED_USE_STRUCT_CONVENTION(gcc_p, value_type) (gdbarch_deprecated_use_struct_convention (current_gdbarch, gcc_p, value_type))
92ad9cd9
AC
685#endif
686
74055713
AC
687/* As of 2004-01-17 only the 32-bit SPARC ABI has been identified as an
688 ABI suitable for the implementation of a robust extract
689 struct-convention return-value address method (the sparc saves the
690 address in the callers frame). All the other cases so far examined,
691 the DEPRECATED_EXTRACT_STRUCT_VALUE implementation has been
692 erreneous - the code was incorrectly assuming that the return-value
693 address, stored in a register, was preserved across the entire
694 function call.
695 For the moment retain DEPRECATED_EXTRACT_STRUCT_VALUE as a marker of
696 the ABIs that are still to be analyzed - perhaps this should simply
697 be deleted. The commented out extract_returned_value_address method
698 is provided as a starting point for the 32-bit SPARC. It, or
699 something like it, along with changes to both infcmd.c and stack.c
700 will be needed for that case to work. NB: It is passed the callers
701 frame since it is only after the callee has returned that this
702 function is used.
57010b1c 703 M::CORE_ADDR:extract_returned_value_address:struct frame_info *caller_frame:caller_frame */
74055713
AC
704
705#if defined (DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS)
706/* Legacy for systems yet to multi-arch DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS */
707#if !defined (DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS_P)
708#define DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS_P() (1)
049ee0e4
AC
709#endif
710#endif
711
74055713 712extern int gdbarch_deprecated_extract_struct_value_address_p (struct gdbarch *gdbarch);
5010d38b 713#if !defined (GDB_TM_FILE) && defined (DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS_P)
74055713 714#error "Non multi-arch definition of DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS"
049ee0e4 715#endif
bceabdd8 716#if !defined (DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS_P)
74055713 717#define DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS_P() (gdbarch_deprecated_extract_struct_value_address_p (current_gdbarch))
049ee0e4
AC
718#endif
719
74055713
AC
720typedef CORE_ADDR (gdbarch_deprecated_extract_struct_value_address_ftype) (struct regcache *regcache);
721extern CORE_ADDR gdbarch_deprecated_extract_struct_value_address (struct gdbarch *gdbarch, struct regcache *regcache);
722extern void set_gdbarch_deprecated_extract_struct_value_address (struct gdbarch *gdbarch, gdbarch_deprecated_extract_struct_value_address_ftype *deprecated_extract_struct_value_address);
5010d38b 723#if !defined (GDB_TM_FILE) && defined (DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS)
74055713 724#error "Non multi-arch definition of DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS"
049ee0e4 725#endif
74055713
AC
726#if !defined (DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS)
727#define DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS(regcache) (gdbarch_deprecated_extract_struct_value_address (current_gdbarch, regcache))
049ee0e4 728#endif
049ee0e4 729
104c1213
JM
730typedef CORE_ADDR (gdbarch_skip_prologue_ftype) (CORE_ADDR ip);
731extern CORE_ADDR gdbarch_skip_prologue (struct gdbarch *gdbarch, CORE_ADDR ip);
732extern void set_gdbarch_skip_prologue (struct gdbarch *gdbarch, gdbarch_skip_prologue_ftype *skip_prologue);
5010d38b 733#if !defined (GDB_TM_FILE) && defined (SKIP_PROLOGUE)
83905903
AC
734#error "Non multi-arch definition of SKIP_PROLOGUE"
735#endif
c25083af 736#if !defined (SKIP_PROLOGUE)
0f71a2f6
JM
737#define SKIP_PROLOGUE(ip) (gdbarch_skip_prologue (current_gdbarch, ip))
738#endif
0f71a2f6 739
104c1213
JM
740typedef int (gdbarch_inner_than_ftype) (CORE_ADDR lhs, CORE_ADDR rhs);
741extern int gdbarch_inner_than (struct gdbarch *gdbarch, CORE_ADDR lhs, CORE_ADDR rhs);
742extern void set_gdbarch_inner_than (struct gdbarch *gdbarch, gdbarch_inner_than_ftype *inner_than);
5010d38b 743#if !defined (GDB_TM_FILE) && defined (INNER_THAN)
83905903
AC
744#error "Non multi-arch definition of INNER_THAN"
745#endif
c25083af 746#if !defined (INNER_THAN)
0f71a2f6
JM
747#define INNER_THAN(lhs, rhs) (gdbarch_inner_than (current_gdbarch, lhs, rhs))
748#endif
0f71a2f6 749
fc1a4b47
AC
750typedef const gdb_byte * (gdbarch_breakpoint_from_pc_ftype) (CORE_ADDR *pcptr, int *lenptr);
751extern const gdb_byte * gdbarch_breakpoint_from_pc (struct gdbarch *gdbarch, CORE_ADDR *pcptr, int *lenptr);
104c1213 752extern void set_gdbarch_breakpoint_from_pc (struct gdbarch *gdbarch, gdbarch_breakpoint_from_pc_ftype *breakpoint_from_pc);
5010d38b 753#if !defined (GDB_TM_FILE) && defined (BREAKPOINT_FROM_PC)
83905903
AC
754#error "Non multi-arch definition of BREAKPOINT_FROM_PC"
755#endif
c25083af 756#if !defined (BREAKPOINT_FROM_PC)
0f71a2f6
JM
757#define BREAKPOINT_FROM_PC(pcptr, lenptr) (gdbarch_breakpoint_from_pc (current_gdbarch, pcptr, lenptr))
758#endif
33489c5b 759
a1131521
KB
760extern int gdbarch_adjust_breakpoint_address_p (struct gdbarch *gdbarch);
761
762typedef CORE_ADDR (gdbarch_adjust_breakpoint_address_ftype) (struct gdbarch *gdbarch, CORE_ADDR bpaddr);
763extern CORE_ADDR gdbarch_adjust_breakpoint_address (struct gdbarch *gdbarch, CORE_ADDR bpaddr);
764extern void set_gdbarch_adjust_breakpoint_address (struct gdbarch *gdbarch, gdbarch_adjust_breakpoint_address_ftype *adjust_breakpoint_address);
765
8181d85f
DJ
766typedef int (gdbarch_memory_insert_breakpoint_ftype) (struct bp_target_info *bp_tgt);
767extern int gdbarch_memory_insert_breakpoint (struct gdbarch *gdbarch, struct bp_target_info *bp_tgt);
917317f4 768extern void set_gdbarch_memory_insert_breakpoint (struct gdbarch *gdbarch, gdbarch_memory_insert_breakpoint_ftype *memory_insert_breakpoint);
5010d38b 769#if !defined (GDB_TM_FILE) && defined (MEMORY_INSERT_BREAKPOINT)
83905903
AC
770#error "Non multi-arch definition of MEMORY_INSERT_BREAKPOINT"
771#endif
c25083af 772#if !defined (MEMORY_INSERT_BREAKPOINT)
8181d85f 773#define MEMORY_INSERT_BREAKPOINT(bp_tgt) (gdbarch_memory_insert_breakpoint (current_gdbarch, bp_tgt))
917317f4 774#endif
33489c5b 775
8181d85f
DJ
776typedef int (gdbarch_memory_remove_breakpoint_ftype) (struct bp_target_info *bp_tgt);
777extern int gdbarch_memory_remove_breakpoint (struct gdbarch *gdbarch, struct bp_target_info *bp_tgt);
917317f4 778extern void set_gdbarch_memory_remove_breakpoint (struct gdbarch *gdbarch, gdbarch_memory_remove_breakpoint_ftype *memory_remove_breakpoint);
5010d38b 779#if !defined (GDB_TM_FILE) && defined (MEMORY_REMOVE_BREAKPOINT)
83905903
AC
780#error "Non multi-arch definition of MEMORY_REMOVE_BREAKPOINT"
781#endif
c25083af 782#if !defined (MEMORY_REMOVE_BREAKPOINT)
8181d85f 783#define MEMORY_REMOVE_BREAKPOINT(bp_tgt) (gdbarch_memory_remove_breakpoint (current_gdbarch, bp_tgt))
917317f4 784#endif
917317f4 785
104c1213
JM
786extern CORE_ADDR gdbarch_decr_pc_after_break (struct gdbarch *gdbarch);
787extern void set_gdbarch_decr_pc_after_break (struct gdbarch *gdbarch, CORE_ADDR decr_pc_after_break);
5010d38b 788#if !defined (GDB_TM_FILE) && defined (DECR_PC_AFTER_BREAK)
83905903
AC
789#error "Non multi-arch definition of DECR_PC_AFTER_BREAK"
790#endif
c25083af 791#if !defined (DECR_PC_AFTER_BREAK)
0f71a2f6
JM
792#define DECR_PC_AFTER_BREAK (gdbarch_decr_pc_after_break (current_gdbarch))
793#endif
0f71a2f6 794
782263ab
AC
795/* A function can be addressed by either it's "pointer" (possibly a
796 descriptor address) or "entry point" (first executable instruction).
797 The method "convert_from_func_ptr_addr" converting the former to the
798 latter. DEPRECATED_FUNCTION_START_OFFSET is being used to implement
799 a simplified subset of that functionality - the function's address
800 corresponds to the "function pointer" and the function's start
801 corresponds to the "function entry point" - and hence is redundant. */
802
803extern CORE_ADDR gdbarch_deprecated_function_start_offset (struct gdbarch *gdbarch);
804extern void set_gdbarch_deprecated_function_start_offset (struct gdbarch *gdbarch, CORE_ADDR deprecated_function_start_offset);
5010d38b 805#if !defined (GDB_TM_FILE) && defined (DEPRECATED_FUNCTION_START_OFFSET)
782263ab
AC
806#error "Non multi-arch definition of DEPRECATED_FUNCTION_START_OFFSET"
807#endif
808#if !defined (DEPRECATED_FUNCTION_START_OFFSET)
809#define DEPRECATED_FUNCTION_START_OFFSET (gdbarch_deprecated_function_start_offset (current_gdbarch))
0f71a2f6 810#endif
0f71a2f6 811
123dc839
DJ
812/* Return the remote protocol register number associated with this
813 register. Normally the identity mapping. */
814
815typedef int (gdbarch_remote_register_number_ftype) (struct gdbarch *gdbarch, int regno);
816extern int gdbarch_remote_register_number (struct gdbarch *gdbarch, int regno);
817extern void set_gdbarch_remote_register_number (struct gdbarch *gdbarch, gdbarch_remote_register_number_ftype *remote_register_number);
818
b2756930
KB
819/* Fetch the target specific address used to represent a load module. */
820
821#if defined (FETCH_TLS_LOAD_MODULE_ADDRESS)
822/* Legacy for systems yet to multi-arch FETCH_TLS_LOAD_MODULE_ADDRESS */
823#if !defined (FETCH_TLS_LOAD_MODULE_ADDRESS_P)
824#define FETCH_TLS_LOAD_MODULE_ADDRESS_P() (1)
825#endif
826#endif
827
828extern int gdbarch_fetch_tls_load_module_address_p (struct gdbarch *gdbarch);
829#if !defined (GDB_TM_FILE) && defined (FETCH_TLS_LOAD_MODULE_ADDRESS_P)
830#error "Non multi-arch definition of FETCH_TLS_LOAD_MODULE_ADDRESS"
831#endif
832#if !defined (FETCH_TLS_LOAD_MODULE_ADDRESS_P)
833#define FETCH_TLS_LOAD_MODULE_ADDRESS_P() (gdbarch_fetch_tls_load_module_address_p (current_gdbarch))
834#endif
835
836typedef CORE_ADDR (gdbarch_fetch_tls_load_module_address_ftype) (struct objfile *objfile);
837extern CORE_ADDR gdbarch_fetch_tls_load_module_address (struct gdbarch *gdbarch, struct objfile *objfile);
838extern void set_gdbarch_fetch_tls_load_module_address (struct gdbarch *gdbarch, gdbarch_fetch_tls_load_module_address_ftype *fetch_tls_load_module_address);
839#if !defined (GDB_TM_FILE) && defined (FETCH_TLS_LOAD_MODULE_ADDRESS)
840#error "Non multi-arch definition of FETCH_TLS_LOAD_MODULE_ADDRESS"
841#endif
842#if !defined (FETCH_TLS_LOAD_MODULE_ADDRESS)
843#define FETCH_TLS_LOAD_MODULE_ADDRESS(objfile) (gdbarch_fetch_tls_load_module_address (current_gdbarch, objfile))
844#endif
845
104c1213
JM
846extern CORE_ADDR gdbarch_frame_args_skip (struct gdbarch *gdbarch);
847extern void set_gdbarch_frame_args_skip (struct gdbarch *gdbarch, CORE_ADDR frame_args_skip);
5010d38b 848#if !defined (GDB_TM_FILE) && defined (FRAME_ARGS_SKIP)
83905903
AC
849#error "Non multi-arch definition of FRAME_ARGS_SKIP"
850#endif
c25083af 851#if !defined (FRAME_ARGS_SKIP)
0f71a2f6
JM
852#define FRAME_ARGS_SKIP (gdbarch_frame_args_skip (current_gdbarch))
853#endif
0f71a2f6 854
12cc2063
AC
855extern int gdbarch_unwind_pc_p (struct gdbarch *gdbarch);
856
857typedef CORE_ADDR (gdbarch_unwind_pc_ftype) (struct gdbarch *gdbarch, struct frame_info *next_frame);
858extern CORE_ADDR gdbarch_unwind_pc (struct gdbarch *gdbarch, struct frame_info *next_frame);
859extern void set_gdbarch_unwind_pc (struct gdbarch *gdbarch, gdbarch_unwind_pc_ftype *unwind_pc);
860
a9e5fdc2
AC
861extern int gdbarch_unwind_sp_p (struct gdbarch *gdbarch);
862
863typedef CORE_ADDR (gdbarch_unwind_sp_ftype) (struct gdbarch *gdbarch, struct frame_info *next_frame);
864extern CORE_ADDR gdbarch_unwind_sp (struct gdbarch *gdbarch, struct frame_info *next_frame);
865extern void set_gdbarch_unwind_sp (struct gdbarch *gdbarch, gdbarch_unwind_sp_ftype *unwind_sp);
866
42efa47a
AC
867/* DEPRECATED_FRAME_LOCALS_ADDRESS as been replaced by the per-frame
868 frame-base. Enable frame-base before frame-unwind. */
869
983a287a
AC
870#if defined (FRAME_NUM_ARGS)
871/* Legacy for systems yet to multi-arch FRAME_NUM_ARGS */
872#if !defined (FRAME_NUM_ARGS_P)
873#define FRAME_NUM_ARGS_P() (1)
874#endif
875#endif
876
983a287a 877extern int gdbarch_frame_num_args_p (struct gdbarch *gdbarch);
5010d38b 878#if !defined (GDB_TM_FILE) && defined (FRAME_NUM_ARGS_P)
983a287a
AC
879#error "Non multi-arch definition of FRAME_NUM_ARGS"
880#endif
bceabdd8 881#if !defined (FRAME_NUM_ARGS_P)
983a287a
AC
882#define FRAME_NUM_ARGS_P() (gdbarch_frame_num_args_p (current_gdbarch))
883#endif
884
104c1213
JM
885typedef int (gdbarch_frame_num_args_ftype) (struct frame_info *frame);
886extern int gdbarch_frame_num_args (struct gdbarch *gdbarch, struct frame_info *frame);
887extern void set_gdbarch_frame_num_args (struct gdbarch *gdbarch, gdbarch_frame_num_args_ftype *frame_num_args);
5010d38b 888#if !defined (GDB_TM_FILE) && defined (FRAME_NUM_ARGS)
83905903
AC
889#error "Non multi-arch definition of FRAME_NUM_ARGS"
890#endif
c25083af 891#if !defined (FRAME_NUM_ARGS)
0f71a2f6
JM
892#define FRAME_NUM_ARGS(frame) (gdbarch_frame_num_args (current_gdbarch, frame))
893#endif
0f71a2f6 894
f27dd7fd
AC
895/* DEPRECATED_STACK_ALIGN has been replaced by an initial aligning call
896 to frame_align and the requirement that methods such as
897 push_dummy_call and frame_red_zone_size maintain correct stack/frame
898 alignment. */
899
900#if defined (DEPRECATED_STACK_ALIGN)
901/* Legacy for systems yet to multi-arch DEPRECATED_STACK_ALIGN */
902#if !defined (DEPRECATED_STACK_ALIGN_P)
903#define DEPRECATED_STACK_ALIGN_P() (1)
2ada493a 904#endif
eee30e78 905#endif
2ada493a 906
f27dd7fd 907extern int gdbarch_deprecated_stack_align_p (struct gdbarch *gdbarch);
5010d38b 908#if !defined (GDB_TM_FILE) && defined (DEPRECATED_STACK_ALIGN_P)
f27dd7fd 909#error "Non multi-arch definition of DEPRECATED_STACK_ALIGN"
83905903 910#endif
bceabdd8 911#if !defined (DEPRECATED_STACK_ALIGN_P)
f27dd7fd 912#define DEPRECATED_STACK_ALIGN_P() (gdbarch_deprecated_stack_align_p (current_gdbarch))
2ada493a
AC
913#endif
914
f27dd7fd
AC
915typedef CORE_ADDR (gdbarch_deprecated_stack_align_ftype) (CORE_ADDR sp);
916extern CORE_ADDR gdbarch_deprecated_stack_align (struct gdbarch *gdbarch, CORE_ADDR sp);
917extern void set_gdbarch_deprecated_stack_align (struct gdbarch *gdbarch, gdbarch_deprecated_stack_align_ftype *deprecated_stack_align);
5010d38b 918#if !defined (GDB_TM_FILE) && defined (DEPRECATED_STACK_ALIGN)
f27dd7fd 919#error "Non multi-arch definition of DEPRECATED_STACK_ALIGN"
83905903 920#endif
f27dd7fd
AC
921#if !defined (DEPRECATED_STACK_ALIGN)
922#define DEPRECATED_STACK_ALIGN(sp) (gdbarch_deprecated_stack_align (current_gdbarch, sp))
2ada493a
AC
923#endif
924
dc604539
AC
925extern int gdbarch_frame_align_p (struct gdbarch *gdbarch);
926
927typedef CORE_ADDR (gdbarch_frame_align_ftype) (struct gdbarch *gdbarch, CORE_ADDR address);
928extern CORE_ADDR gdbarch_frame_align (struct gdbarch *gdbarch, CORE_ADDR address);
929extern void set_gdbarch_frame_align (struct gdbarch *gdbarch, gdbarch_frame_align_ftype *frame_align);
930
192cb3d4
MK
931/* DEPRECATED_REG_STRUCT_HAS_ADDR has been replaced by
932 stabs_argument_has_addr. */
933
88d89dbb
MK
934#if defined (DEPRECATED_REG_STRUCT_HAS_ADDR)
935/* Legacy for systems yet to multi-arch DEPRECATED_REG_STRUCT_HAS_ADDR */
936#if !defined (DEPRECATED_REG_STRUCT_HAS_ADDR_P)
937#define DEPRECATED_REG_STRUCT_HAS_ADDR_P() (1)
d03e67c9 938#endif
eee30e78 939#endif
d03e67c9 940
88d89dbb 941extern int gdbarch_deprecated_reg_struct_has_addr_p (struct gdbarch *gdbarch);
5010d38b 942#if !defined (GDB_TM_FILE) && defined (DEPRECATED_REG_STRUCT_HAS_ADDR_P)
88d89dbb 943#error "Non multi-arch definition of DEPRECATED_REG_STRUCT_HAS_ADDR"
83905903 944#endif
bceabdd8 945#if !defined (DEPRECATED_REG_STRUCT_HAS_ADDR_P)
88d89dbb 946#define DEPRECATED_REG_STRUCT_HAS_ADDR_P() (gdbarch_deprecated_reg_struct_has_addr_p (current_gdbarch))
d03e67c9
AC
947#endif
948
88d89dbb
MK
949typedef int (gdbarch_deprecated_reg_struct_has_addr_ftype) (int gcc_p, struct type *type);
950extern int gdbarch_deprecated_reg_struct_has_addr (struct gdbarch *gdbarch, int gcc_p, struct type *type);
951extern void set_gdbarch_deprecated_reg_struct_has_addr (struct gdbarch *gdbarch, gdbarch_deprecated_reg_struct_has_addr_ftype *deprecated_reg_struct_has_addr);
5010d38b 952#if !defined (GDB_TM_FILE) && defined (DEPRECATED_REG_STRUCT_HAS_ADDR)
88d89dbb 953#error "Non multi-arch definition of DEPRECATED_REG_STRUCT_HAS_ADDR"
83905903 954#endif
88d89dbb
MK
955#if !defined (DEPRECATED_REG_STRUCT_HAS_ADDR)
956#define DEPRECATED_REG_STRUCT_HAS_ADDR(gcc_p, type) (gdbarch_deprecated_reg_struct_has_addr (current_gdbarch, gcc_p, type))
d03e67c9
AC
957#endif
958
192cb3d4
MK
959typedef int (gdbarch_stabs_argument_has_addr_ftype) (struct gdbarch *gdbarch, struct type *type);
960extern int gdbarch_stabs_argument_has_addr (struct gdbarch *gdbarch, struct type *type);
961extern void set_gdbarch_stabs_argument_has_addr (struct gdbarch *gdbarch, gdbarch_stabs_argument_has_addr_ftype *stabs_argument_has_addr);
962
8b148df9
AC
963extern int gdbarch_frame_red_zone_size (struct gdbarch *gdbarch);
964extern void set_gdbarch_frame_red_zone_size (struct gdbarch *gdbarch, int frame_red_zone_size);
5010d38b 965#if !defined (GDB_TM_FILE) && defined (FRAME_RED_ZONE_SIZE)
8b148df9
AC
966#error "Non multi-arch definition of FRAME_RED_ZONE_SIZE"
967#endif
968#if !defined (FRAME_RED_ZONE_SIZE)
969#define FRAME_RED_ZONE_SIZE (gdbarch_frame_red_zone_size (current_gdbarch))
970#endif
971
e2d0e7eb
AC
972typedef CORE_ADDR (gdbarch_convert_from_func_ptr_addr_ftype) (struct gdbarch *gdbarch, CORE_ADDR addr, struct target_ops *targ);
973extern CORE_ADDR gdbarch_convert_from_func_ptr_addr (struct gdbarch *gdbarch, CORE_ADDR addr, struct target_ops *targ);
f517ea4e 974extern void set_gdbarch_convert_from_func_ptr_addr (struct gdbarch *gdbarch, gdbarch_convert_from_func_ptr_addr_ftype *convert_from_func_ptr_addr);
f517ea4e 975
875e1767
AC
976/* On some machines there are bits in addresses which are not really
977 part of the address, but are used by the kernel, the hardware, etc.
978 for special purposes. ADDR_BITS_REMOVE takes out any such bits so
979 we get a "real" address such as one would find in a symbol table.
980 This is used only for addresses of instructions, and even then I'm
981 not sure it's used in all contexts. It exists to deal with there
982 being a few stray bits in the PC which would mislead us, not as some
983 sort of generic thing to handle alignment or segmentation (it's
984 possible it should be in TARGET_READ_PC instead). */
985
875e1767
AC
986typedef CORE_ADDR (gdbarch_addr_bits_remove_ftype) (CORE_ADDR addr);
987extern CORE_ADDR gdbarch_addr_bits_remove (struct gdbarch *gdbarch, CORE_ADDR addr);
988extern void set_gdbarch_addr_bits_remove (struct gdbarch *gdbarch, gdbarch_addr_bits_remove_ftype *addr_bits_remove);
5010d38b 989#if !defined (GDB_TM_FILE) && defined (ADDR_BITS_REMOVE)
83905903
AC
990#error "Non multi-arch definition of ADDR_BITS_REMOVE"
991#endif
c25083af 992#if !defined (ADDR_BITS_REMOVE)
875e1767
AC
993#define ADDR_BITS_REMOVE(addr) (gdbarch_addr_bits_remove (current_gdbarch, addr))
994#endif
875e1767 995
2e092625 996/* It is not at all clear why SMASH_TEXT_ADDRESS is not folded into
181c1381
RE
997 ADDR_BITS_REMOVE. */
998
181c1381
RE
999typedef CORE_ADDR (gdbarch_smash_text_address_ftype) (CORE_ADDR addr);
1000extern CORE_ADDR gdbarch_smash_text_address (struct gdbarch *gdbarch, CORE_ADDR addr);
1001extern void set_gdbarch_smash_text_address (struct gdbarch *gdbarch, gdbarch_smash_text_address_ftype *smash_text_address);
5010d38b 1002#if !defined (GDB_TM_FILE) && defined (SMASH_TEXT_ADDRESS)
181c1381
RE
1003#error "Non multi-arch definition of SMASH_TEXT_ADDRESS"
1004#endif
c25083af 1005#if !defined (SMASH_TEXT_ADDRESS)
181c1381
RE
1006#define SMASH_TEXT_ADDRESS(addr) (gdbarch_smash_text_address (current_gdbarch, addr))
1007#endif
181c1381 1008
e6590a1b
UW
1009/* FIXME/cagney/2001-01-18: This should be split in two. A target method that
1010 indicates if the target needs software single step. An ISA method to
1011 implement it.
64c4637f 1012
e6590a1b
UW
1013 FIXME/cagney/2001-01-18: This should be replaced with something that inserts
1014 breakpoints using the breakpoint system instead of blatting memory directly
1015 (as with rs6000).
64c4637f 1016
e6590a1b
UW
1017 FIXME/cagney/2001-01-18: The logic is backwards. It should be asking if the
1018 target can single step. If not, then implement single step using breakpoints.
1019
1020 A return value of 1 means that the software_single_step breakpoints
1021 were inserted; 0 means they were not. */
64c4637f
AC
1022
1023#if defined (SOFTWARE_SINGLE_STEP)
1024/* Legacy for systems yet to multi-arch SOFTWARE_SINGLE_STEP */
1025#if !defined (SOFTWARE_SINGLE_STEP_P)
1026#define SOFTWARE_SINGLE_STEP_P() (1)
1027#endif
1028#endif
1029
64c4637f 1030extern int gdbarch_software_single_step_p (struct gdbarch *gdbarch);
5010d38b 1031#if !defined (GDB_TM_FILE) && defined (SOFTWARE_SINGLE_STEP_P)
83905903
AC
1032#error "Non multi-arch definition of SOFTWARE_SINGLE_STEP"
1033#endif
bceabdd8 1034#if !defined (SOFTWARE_SINGLE_STEP_P)
64c4637f
AC
1035#define SOFTWARE_SINGLE_STEP_P() (gdbarch_software_single_step_p (current_gdbarch))
1036#endif
1037
e0cd558a
UW
1038typedef int (gdbarch_software_single_step_ftype) (struct regcache *regcache);
1039extern int gdbarch_software_single_step (struct gdbarch *gdbarch, struct regcache *regcache);
64c4637f 1040extern void set_gdbarch_software_single_step (struct gdbarch *gdbarch, gdbarch_software_single_step_ftype *software_single_step);
5010d38b 1041#if !defined (GDB_TM_FILE) && defined (SOFTWARE_SINGLE_STEP)
83905903
AC
1042#error "Non multi-arch definition of SOFTWARE_SINGLE_STEP"
1043#endif
c25083af 1044#if !defined (SOFTWARE_SINGLE_STEP)
e0cd558a 1045#define SOFTWARE_SINGLE_STEP(regcache) (gdbarch_software_single_step (current_gdbarch, regcache))
64c4637f 1046#endif
64c4637f 1047
3352ef37
AC
1048/* Return non-zero if the processor is executing a delay slot and a
1049 further single-step is needed before the instruction finishes. */
1050
1051extern int gdbarch_single_step_through_delay_p (struct gdbarch *gdbarch);
1052
1053typedef int (gdbarch_single_step_through_delay_ftype) (struct gdbarch *gdbarch, struct frame_info *frame);
1054extern int gdbarch_single_step_through_delay (struct gdbarch *gdbarch, struct frame_info *frame);
1055extern void set_gdbarch_single_step_through_delay (struct gdbarch *gdbarch, gdbarch_single_step_through_delay_ftype *single_step_through_delay);
1056
f6c40618 1057/* FIXME: cagney/2003-08-28: Need to find a better way of selecting the
b2fa5097 1058 disassembler. Perhaps objdump can handle it? */
f6c40618 1059
a89aa300
AC
1060typedef int (gdbarch_print_insn_ftype) (bfd_vma vma, struct disassemble_info *info);
1061extern int gdbarch_print_insn (struct gdbarch *gdbarch, bfd_vma vma, struct disassemble_info *info);
2bf0cb65 1062extern void set_gdbarch_print_insn (struct gdbarch *gdbarch, gdbarch_print_insn_ftype *print_insn);
5010d38b 1063#if !defined (GDB_TM_FILE) && defined (TARGET_PRINT_INSN)
2bf0cb65
EZ
1064#error "Non multi-arch definition of TARGET_PRINT_INSN"
1065#endif
c25083af 1066#if !defined (TARGET_PRINT_INSN)
2bf0cb65
EZ
1067#define TARGET_PRINT_INSN(vma, info) (gdbarch_print_insn (current_gdbarch, vma, info))
1068#endif
2bf0cb65 1069
bdcd319a
CV
1070typedef CORE_ADDR (gdbarch_skip_trampoline_code_ftype) (CORE_ADDR pc);
1071extern CORE_ADDR gdbarch_skip_trampoline_code (struct gdbarch *gdbarch, CORE_ADDR pc);
1072extern void set_gdbarch_skip_trampoline_code (struct gdbarch *gdbarch, gdbarch_skip_trampoline_code_ftype *skip_trampoline_code);
5010d38b 1073#if !defined (GDB_TM_FILE) && defined (SKIP_TRAMPOLINE_CODE)
bdcd319a
CV
1074#error "Non multi-arch definition of SKIP_TRAMPOLINE_CODE"
1075#endif
c25083af 1076#if !defined (SKIP_TRAMPOLINE_CODE)
bdcd319a
CV
1077#define SKIP_TRAMPOLINE_CODE(pc) (gdbarch_skip_trampoline_code (current_gdbarch, pc))
1078#endif
bdcd319a 1079
dea0c52f
MK
1080/* If IN_SOLIB_DYNSYM_RESOLVE_CODE returns true, and SKIP_SOLIB_RESOLVER
1081 evaluates non-zero, this is the address where the debugger will place
1082 a step-resume breakpoint to get us past the dynamic linker. */
1083
4c8c40e6 1084typedef CORE_ADDR (gdbarch_skip_solib_resolver_ftype) (struct gdbarch *gdbarch, CORE_ADDR pc);
dea0c52f
MK
1085extern CORE_ADDR gdbarch_skip_solib_resolver (struct gdbarch *gdbarch, CORE_ADDR pc);
1086extern void set_gdbarch_skip_solib_resolver (struct gdbarch *gdbarch, gdbarch_skip_solib_resolver_ftype *skip_solib_resolver);
dea0c52f 1087
d50355b6
MS
1088/* Some systems also have trampoline code for returning from shared libs. */
1089
d50355b6
MS
1090typedef int (gdbarch_in_solib_return_trampoline_ftype) (CORE_ADDR pc, char *name);
1091extern int gdbarch_in_solib_return_trampoline (struct gdbarch *gdbarch, CORE_ADDR pc, char *name);
1092extern void set_gdbarch_in_solib_return_trampoline (struct gdbarch *gdbarch, gdbarch_in_solib_return_trampoline_ftype *in_solib_return_trampoline);
5010d38b 1093#if !defined (GDB_TM_FILE) && defined (IN_SOLIB_RETURN_TRAMPOLINE)
d50355b6
MS
1094#error "Non multi-arch definition of IN_SOLIB_RETURN_TRAMPOLINE"
1095#endif
c25083af 1096#if !defined (IN_SOLIB_RETURN_TRAMPOLINE)
d50355b6
MS
1097#define IN_SOLIB_RETURN_TRAMPOLINE(pc, name) (gdbarch_in_solib_return_trampoline (current_gdbarch, pc, name))
1098#endif
d50355b6 1099
c12260ac
CV
1100/* A target might have problems with watchpoints as soon as the stack
1101 frame of the current function has been destroyed. This mostly happens
1102 as the first action in a funtion's epilogue. in_function_epilogue_p()
1103 is defined to return a non-zero value if either the given addr is one
1104 instruction after the stack destroying instruction up to the trailing
1105 return instruction or if we can figure out that the stack frame has
1106 already been invalidated regardless of the value of addr. Targets
1107 which don't suffer from that problem could just let this functionality
1108 untouched. */
1109
1110typedef int (gdbarch_in_function_epilogue_p_ftype) (struct gdbarch *gdbarch, CORE_ADDR addr);
1111extern int gdbarch_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR addr);
1112extern void set_gdbarch_in_function_epilogue_p (struct gdbarch *gdbarch, gdbarch_in_function_epilogue_p_ftype *in_function_epilogue_p);
1113
552c04a7
TT
1114/* Given a vector of command-line arguments, return a newly allocated
1115 string which, when passed to the create_inferior function, will be
1116 parsed (on Unix systems, by the shell) to yield the same vector.
1117 This function should call error() if the argument vector is not
1118 representable for this target or if this target does not support
1119 command-line arguments.
1120 ARGC is the number of elements in the vector.
1121 ARGV is an array of strings, one per argument. */
1122
1123typedef char * (gdbarch_construct_inferior_arguments_ftype) (struct gdbarch *gdbarch, int argc, char **argv);
1124extern char * gdbarch_construct_inferior_arguments (struct gdbarch *gdbarch, int argc, char **argv);
1125extern void set_gdbarch_construct_inferior_arguments (struct gdbarch *gdbarch, gdbarch_construct_inferior_arguments_ftype *construct_inferior_arguments);
1126
a2cf933a
EZ
1127typedef void (gdbarch_elf_make_msymbol_special_ftype) (asymbol *sym, struct minimal_symbol *msym);
1128extern void gdbarch_elf_make_msymbol_special (struct gdbarch *gdbarch, asymbol *sym, struct minimal_symbol *msym);
1129extern void set_gdbarch_elf_make_msymbol_special (struct gdbarch *gdbarch, gdbarch_elf_make_msymbol_special_ftype *elf_make_msymbol_special);
5010d38b 1130#if !defined (GDB_TM_FILE) && defined (ELF_MAKE_MSYMBOL_SPECIAL)
a2cf933a
EZ
1131#error "Non multi-arch definition of ELF_MAKE_MSYMBOL_SPECIAL"
1132#endif
c25083af 1133#if !defined (ELF_MAKE_MSYMBOL_SPECIAL)
a2cf933a
EZ
1134#define ELF_MAKE_MSYMBOL_SPECIAL(sym, msym) (gdbarch_elf_make_msymbol_special (current_gdbarch, sym, msym))
1135#endif
a2cf933a 1136
a2cf933a
EZ
1137typedef void (gdbarch_coff_make_msymbol_special_ftype) (int val, struct minimal_symbol *msym);
1138extern void gdbarch_coff_make_msymbol_special (struct gdbarch *gdbarch, int val, struct minimal_symbol *msym);
1139extern void set_gdbarch_coff_make_msymbol_special (struct gdbarch *gdbarch, gdbarch_coff_make_msymbol_special_ftype *coff_make_msymbol_special);
5010d38b 1140#if !defined (GDB_TM_FILE) && defined (COFF_MAKE_MSYMBOL_SPECIAL)
a2cf933a
EZ
1141#error "Non multi-arch definition of COFF_MAKE_MSYMBOL_SPECIAL"
1142#endif
c25083af 1143#if !defined (COFF_MAKE_MSYMBOL_SPECIAL)
a2cf933a
EZ
1144#define COFF_MAKE_MSYMBOL_SPECIAL(val, msym) (gdbarch_coff_make_msymbol_special (current_gdbarch, val, msym))
1145#endif
a2cf933a 1146
5720643c
JB
1147extern const char * gdbarch_name_of_malloc (struct gdbarch *gdbarch);
1148extern void set_gdbarch_name_of_malloc (struct gdbarch *gdbarch, const char * name_of_malloc);
5010d38b 1149#if !defined (GDB_TM_FILE) && defined (NAME_OF_MALLOC)
5720643c
JB
1150#error "Non multi-arch definition of NAME_OF_MALLOC"
1151#endif
c25083af 1152#if !defined (NAME_OF_MALLOC)
5720643c
JB
1153#define NAME_OF_MALLOC (gdbarch_name_of_malloc (current_gdbarch))
1154#endif
5720643c 1155
c4ed33b9
AC
1156extern int gdbarch_cannot_step_breakpoint (struct gdbarch *gdbarch);
1157extern void set_gdbarch_cannot_step_breakpoint (struct gdbarch *gdbarch, int cannot_step_breakpoint);
5010d38b 1158#if !defined (GDB_TM_FILE) && defined (CANNOT_STEP_BREAKPOINT)
c4ed33b9
AC
1159#error "Non multi-arch definition of CANNOT_STEP_BREAKPOINT"
1160#endif
c25083af 1161#if !defined (CANNOT_STEP_BREAKPOINT)
c4ed33b9
AC
1162#define CANNOT_STEP_BREAKPOINT (gdbarch_cannot_step_breakpoint (current_gdbarch))
1163#endif
c4ed33b9 1164
f74fa174
MM
1165extern int gdbarch_have_nonsteppable_watchpoint (struct gdbarch *gdbarch);
1166extern void set_gdbarch_have_nonsteppable_watchpoint (struct gdbarch *gdbarch, int have_nonsteppable_watchpoint);
5010d38b 1167#if !defined (GDB_TM_FILE) && defined (HAVE_NONSTEPPABLE_WATCHPOINT)
f74fa174
MM
1168#error "Non multi-arch definition of HAVE_NONSTEPPABLE_WATCHPOINT"
1169#endif
c25083af 1170#if !defined (HAVE_NONSTEPPABLE_WATCHPOINT)
f74fa174
MM
1171#define HAVE_NONSTEPPABLE_WATCHPOINT (gdbarch_have_nonsteppable_watchpoint (current_gdbarch))
1172#endif
f74fa174 1173
8b2dbe47
KB
1174#if defined (ADDRESS_CLASS_TYPE_FLAGS)
1175/* Legacy for systems yet to multi-arch ADDRESS_CLASS_TYPE_FLAGS */
1176#if !defined (ADDRESS_CLASS_TYPE_FLAGS_P)
1177#define ADDRESS_CLASS_TYPE_FLAGS_P() (1)
1178#endif
1179#endif
1180
8b2dbe47 1181extern int gdbarch_address_class_type_flags_p (struct gdbarch *gdbarch);
5010d38b 1182#if !defined (GDB_TM_FILE) && defined (ADDRESS_CLASS_TYPE_FLAGS_P)
8b2dbe47
KB
1183#error "Non multi-arch definition of ADDRESS_CLASS_TYPE_FLAGS"
1184#endif
bceabdd8 1185#if !defined (ADDRESS_CLASS_TYPE_FLAGS_P)
8b2dbe47
KB
1186#define ADDRESS_CLASS_TYPE_FLAGS_P() (gdbarch_address_class_type_flags_p (current_gdbarch))
1187#endif
1188
8b2dbe47
KB
1189typedef int (gdbarch_address_class_type_flags_ftype) (int byte_size, int dwarf2_addr_class);
1190extern int gdbarch_address_class_type_flags (struct gdbarch *gdbarch, int byte_size, int dwarf2_addr_class);
1191extern void set_gdbarch_address_class_type_flags (struct gdbarch *gdbarch, gdbarch_address_class_type_flags_ftype *address_class_type_flags);
5010d38b 1192#if !defined (GDB_TM_FILE) && defined (ADDRESS_CLASS_TYPE_FLAGS)
8b2dbe47
KB
1193#error "Non multi-arch definition of ADDRESS_CLASS_TYPE_FLAGS"
1194#endif
c25083af 1195#if !defined (ADDRESS_CLASS_TYPE_FLAGS)
8b2dbe47
KB
1196#define ADDRESS_CLASS_TYPE_FLAGS(byte_size, dwarf2_addr_class) (gdbarch_address_class_type_flags (current_gdbarch, byte_size, dwarf2_addr_class))
1197#endif
8b2dbe47 1198
8b2dbe47 1199extern int gdbarch_address_class_type_flags_to_name_p (struct gdbarch *gdbarch);
8b2dbe47 1200
321432c0
KB
1201typedef const char * (gdbarch_address_class_type_flags_to_name_ftype) (struct gdbarch *gdbarch, int type_flags);
1202extern const char * gdbarch_address_class_type_flags_to_name (struct gdbarch *gdbarch, int type_flags);
8b2dbe47 1203extern void set_gdbarch_address_class_type_flags_to_name (struct gdbarch *gdbarch, gdbarch_address_class_type_flags_to_name_ftype *address_class_type_flags_to_name);
8b2dbe47
KB
1204
1205extern int gdbarch_address_class_name_to_type_flags_p (struct gdbarch *gdbarch);
8b2dbe47 1206
321432c0
KB
1207typedef int (gdbarch_address_class_name_to_type_flags_ftype) (struct gdbarch *gdbarch, const char *name, int *type_flags_ptr);
1208extern int gdbarch_address_class_name_to_type_flags (struct gdbarch *gdbarch, const char *name, int *type_flags_ptr);
8b2dbe47 1209extern void set_gdbarch_address_class_name_to_type_flags (struct gdbarch *gdbarch, gdbarch_address_class_name_to_type_flags_ftype *address_class_name_to_type_flags);
8b2dbe47 1210
b59ff9d5
AC
1211/* Is a register in a group */
1212
1213typedef int (gdbarch_register_reggroup_p_ftype) (struct gdbarch *gdbarch, int regnum, struct reggroup *reggroup);
1214extern int gdbarch_register_reggroup_p (struct gdbarch *gdbarch, int regnum, struct reggroup *reggroup);
1215extern void set_gdbarch_register_reggroup_p (struct gdbarch *gdbarch, gdbarch_register_reggroup_p_ftype *register_reggroup_p);
1216
2e092625 1217/* Fetch the pointer to the ith function argument. */
143985b7
AF
1218
1219#if defined (FETCH_POINTER_ARGUMENT)
1220/* Legacy for systems yet to multi-arch FETCH_POINTER_ARGUMENT */
1221#if !defined (FETCH_POINTER_ARGUMENT_P)
1222#define FETCH_POINTER_ARGUMENT_P() (1)
1223#endif
1224#endif
1225
143985b7 1226extern int gdbarch_fetch_pointer_argument_p (struct gdbarch *gdbarch);
5010d38b 1227#if !defined (GDB_TM_FILE) && defined (FETCH_POINTER_ARGUMENT_P)
143985b7
AF
1228#error "Non multi-arch definition of FETCH_POINTER_ARGUMENT"
1229#endif
bceabdd8 1230#if !defined (FETCH_POINTER_ARGUMENT_P)
143985b7
AF
1231#define FETCH_POINTER_ARGUMENT_P() (gdbarch_fetch_pointer_argument_p (current_gdbarch))
1232#endif
1233
143985b7
AF
1234typedef CORE_ADDR (gdbarch_fetch_pointer_argument_ftype) (struct frame_info *frame, int argi, struct type *type);
1235extern CORE_ADDR gdbarch_fetch_pointer_argument (struct gdbarch *gdbarch, struct frame_info *frame, int argi, struct type *type);
1236extern void set_gdbarch_fetch_pointer_argument (struct gdbarch *gdbarch, gdbarch_fetch_pointer_argument_ftype *fetch_pointer_argument);
5010d38b 1237#if !defined (GDB_TM_FILE) && defined (FETCH_POINTER_ARGUMENT)
143985b7
AF
1238#error "Non multi-arch definition of FETCH_POINTER_ARGUMENT"
1239#endif
1240#if !defined (FETCH_POINTER_ARGUMENT)
1241#define FETCH_POINTER_ARGUMENT(frame, argi, type) (gdbarch_fetch_pointer_argument (current_gdbarch, frame, argi, type))
1242#endif
1243
6ce6d90f
MK
1244/* Return the appropriate register set for a core file section with
1245 name SECT_NAME and size SECT_SIZE. */
1246
1247extern int gdbarch_regset_from_core_section_p (struct gdbarch *gdbarch);
1248
1249typedef const struct regset * (gdbarch_regset_from_core_section_ftype) (struct gdbarch *gdbarch, const char *sect_name, size_t sect_size);
1250extern const struct regset * gdbarch_regset_from_core_section (struct gdbarch *gdbarch, const char *sect_name, size_t sect_size);
1251extern void set_gdbarch_regset_from_core_section (struct gdbarch *gdbarch, gdbarch_regset_from_core_section_ftype *regset_from_core_section);
1252
0d5de010
DJ
1253/* If the elements of C++ vtables are in-place function descriptors rather
1254 than normal function pointers (which may point to code or a descriptor),
1255 set this to one. */
1256
1257extern int gdbarch_vtable_function_descriptors (struct gdbarch *gdbarch);
1258extern void set_gdbarch_vtable_function_descriptors (struct gdbarch *gdbarch, int vtable_function_descriptors);
1259
1260/* Set if the least significant bit of the delta is used instead of the least
1261 significant bit of the pfn for pointers to virtual member functions. */
1262
1263extern int gdbarch_vbit_in_delta (struct gdbarch *gdbarch);
1264extern void set_gdbarch_vbit_in_delta (struct gdbarch *gdbarch, int vbit_in_delta);
1265
6d350bb5
UW
1266/* Advance PC to next instruction in order to skip a permanent breakpoint. */
1267
1268extern int gdbarch_skip_permanent_breakpoint_p (struct gdbarch *gdbarch);
1269
1270typedef void (gdbarch_skip_permanent_breakpoint_ftype) (struct regcache *regcache);
1271extern void gdbarch_skip_permanent_breakpoint (struct gdbarch *gdbarch, struct regcache *regcache);
1272extern void set_gdbarch_skip_permanent_breakpoint (struct gdbarch *gdbarch, gdbarch_skip_permanent_breakpoint_ftype *skip_permanent_breakpoint);
1273
1c772458
UW
1274/* Refresh overlay mapped state for section OSECT. */
1275
1276extern int gdbarch_overlay_update_p (struct gdbarch *gdbarch);
1277
1278typedef void (gdbarch_overlay_update_ftype) (struct obj_section *osect);
1279extern void gdbarch_overlay_update (struct gdbarch *gdbarch, struct obj_section *osect);
1280extern void set_gdbarch_overlay_update (struct gdbarch *gdbarch, gdbarch_overlay_update_ftype *overlay_update);
1281
104c1213 1282extern struct gdbarch_tdep *gdbarch_tdep (struct gdbarch *gdbarch);
0f71a2f6
JM
1283
1284
1285/* Mechanism for co-ordinating the selection of a specific
1286 architecture.
1287
1288 GDB targets (*-tdep.c) can register an interest in a specific
1289 architecture. Other GDB components can register a need to maintain
1290 per-architecture data.
1291
1292 The mechanisms below ensures that there is only a loose connection
1293 between the set-architecture command and the various GDB
99e7bb18 1294 components. Each component can independently register their need
0f71a2f6
JM
1295 to maintain architecture specific data with gdbarch.
1296
1297 Pragmatics:
1298
1299 Previously, a single TARGET_ARCHITECTURE_HOOK was provided. It
1300 didn't scale.
1301
1302 The more traditional mega-struct containing architecture specific
1303 data for all the various GDB components was also considered. Since
99e7bb18 1304 GDB is built from a variable number of (fairly independent)
0f71a2f6
JM
1305 components it was determined that the global aproach was not
1306 applicable. */
1307
1308
1309/* Register a new architectural family with GDB.
1310
1311 Register support for the specified ARCHITECTURE with GDB. When
1312 gdbarch determines that the specified architecture has been
1313 selected, the corresponding INIT function is called.
1314
1315 --
1316
1317 The INIT function takes two parameters: INFO which contains the
1318 information available to gdbarch about the (possibly new)
1319 architecture; ARCHES which is a list of the previously created
1320 ``struct gdbarch'' for this architecture.
1321
0f79675b 1322 The INFO parameter is, as far as possible, be pre-initialized with
7a107747 1323 information obtained from INFO.ABFD or the global defaults.
0f79675b
AC
1324
1325 The ARCHES parameter is a linked list (sorted most recently used)
1326 of all the previously created architures for this architecture
1327 family. The (possibly NULL) ARCHES->gdbarch can used to access
1328 values from the previously selected architecture for this
1329 architecture family. The global ``current_gdbarch'' shall not be
1330 used.
0f71a2f6
JM
1331
1332 The INIT function shall return any of: NULL - indicating that it
ec3d358c 1333 doesn't recognize the selected architecture; an existing ``struct
0f71a2f6
JM
1334 gdbarch'' from the ARCHES list - indicating that the new
1335 architecture is just a synonym for an earlier architecture (see
1336 gdbarch_list_lookup_by_info()); a newly created ``struct gdbarch''
4b9b3959
AC
1337 - that describes the selected architecture (see gdbarch_alloc()).
1338
1339 The DUMP_TDEP function shall print out all target specific values.
1340 Care should be taken to ensure that the function works in both the
1341 multi-arch and non- multi-arch cases. */
0f71a2f6 1342
adf40b2e
JM
1343struct gdbarch_list
1344{
1345 struct gdbarch *gdbarch;
1346 struct gdbarch_list *next;
1347};
0f71a2f6 1348
adf40b2e
JM
1349struct gdbarch_info
1350{
adf40b2e
JM
1351 /* Use default: NULL (ZERO). */
1352 const struct bfd_arch_info *bfd_arch_info;
0f71a2f6 1353
428721aa 1354 /* Use default: BFD_ENDIAN_UNKNOWN (NB: is not ZERO). */
adf40b2e 1355 int byte_order;
0f71a2f6 1356
adf40b2e
JM
1357 /* Use default: NULL (ZERO). */
1358 bfd *abfd;
0f71a2f6 1359
adf40b2e
JM
1360 /* Use default: NULL (ZERO). */
1361 struct gdbarch_tdep_info *tdep_info;
4be87837
DJ
1362
1363 /* Use default: GDB_OSABI_UNINITIALIZED (-1). */
1364 enum gdb_osabi osabi;
424163ea
DJ
1365
1366 /* Use default: NULL (ZERO). */
1367 const struct target_desc *target_desc;
adf40b2e 1368};
0f71a2f6 1369
104c1213 1370typedef struct gdbarch *(gdbarch_init_ftype) (struct gdbarch_info info, struct gdbarch_list *arches);
4b9b3959 1371typedef void (gdbarch_dump_tdep_ftype) (struct gdbarch *gdbarch, struct ui_file *file);
0f71a2f6 1372
4b9b3959 1373/* DEPRECATED - use gdbarch_register() */
104c1213 1374extern void register_gdbarch_init (enum bfd_architecture architecture, gdbarch_init_ftype *);
0f71a2f6 1375
4b9b3959
AC
1376extern void gdbarch_register (enum bfd_architecture architecture,
1377 gdbarch_init_ftype *,
1378 gdbarch_dump_tdep_ftype *);
1379
0f71a2f6 1380
b4a20239
AC
1381/* Return a freshly allocated, NULL terminated, array of the valid
1382 architecture names. Since architectures are registered during the
1383 _initialize phase this function only returns useful information
1384 once initialization has been completed. */
1385
1386extern const char **gdbarch_printable_names (void);
1387
1388
0f71a2f6
JM
1389/* Helper function. Search the list of ARCHES for a GDBARCH that
1390 matches the information provided by INFO. */
1391
424163ea 1392extern struct gdbarch_list *gdbarch_list_lookup_by_info (struct gdbarch_list *arches, const struct gdbarch_info *info);
0f71a2f6
JM
1393
1394
1395/* Helper function. Create a preliminary ``struct gdbarch''. Perform
424163ea 1396 basic initialization using values obtained from the INFO and TDEP
0f71a2f6
JM
1397 parameters. set_gdbarch_*() functions are called to complete the
1398 initialization of the object. */
1399
104c1213 1400extern struct gdbarch *gdbarch_alloc (const struct gdbarch_info *info, struct gdbarch_tdep *tdep);
0f71a2f6
JM
1401
1402
4b9b3959
AC
1403/* Helper function. Free a partially-constructed ``struct gdbarch''.
1404 It is assumed that the caller freeds the ``struct
1405 gdbarch_tdep''. */
1406
058f20d5
JB
1407extern void gdbarch_free (struct gdbarch *);
1408
1409
aebd7893
AC
1410/* Helper function. Allocate memory from the ``struct gdbarch''
1411 obstack. The memory is freed when the corresponding architecture
1412 is also freed. */
1413
1414extern void *gdbarch_obstack_zalloc (struct gdbarch *gdbarch, long size);
1415#define GDBARCH_OBSTACK_CALLOC(GDBARCH, NR, TYPE) ((TYPE *) gdbarch_obstack_zalloc ((GDBARCH), (NR) * sizeof (TYPE)))
1416#define GDBARCH_OBSTACK_ZALLOC(GDBARCH, TYPE) ((TYPE *) gdbarch_obstack_zalloc ((GDBARCH), sizeof (TYPE)))
1417
1418
b732d07d 1419/* Helper function. Force an update of the current architecture.
0f71a2f6 1420
b732d07d
AC
1421 The actual architecture selected is determined by INFO, ``(gdb) set
1422 architecture'' et.al., the existing architecture and BFD's default
1423 architecture. INFO should be initialized to zero and then selected
1424 fields should be updated.
0f71a2f6 1425
16f33e29
AC
1426 Returns non-zero if the update succeeds */
1427
1428extern int gdbarch_update_p (struct gdbarch_info info);
0f71a2f6
JM
1429
1430
ebdba546
AC
1431/* Helper function. Find an architecture matching info.
1432
1433 INFO should be initialized using gdbarch_info_init, relevant fields
1434 set, and then finished using gdbarch_info_fill.
1435
1436 Returns the corresponding architecture, or NULL if no matching
1437 architecture was found. "current_gdbarch" is not updated. */
1438
1439extern struct gdbarch *gdbarch_find_by_info (struct gdbarch_info info);
1440
1441
1442/* Helper function. Set the global "current_gdbarch" to "gdbarch".
1443
1444 FIXME: kettenis/20031124: Of the functions that follow, only
1445 gdbarch_from_bfd is supposed to survive. The others will
1446 dissappear since in the future GDB will (hopefully) be truly
1447 multi-arch. However, for now we're still stuck with the concept of
1448 a single active architecture. */
1449
1450extern void deprecated_current_gdbarch_select_hack (struct gdbarch *gdbarch);
1451
0f71a2f6
JM
1452
1453/* Register per-architecture data-pointer.
1454
1455 Reserve space for a per-architecture data-pointer. An identifier
1456 for the reserved data-pointer is returned. That identifer should
95160752 1457 be saved in a local static variable.
0f71a2f6 1458
fcc1c85c
AC
1459 Memory for the per-architecture data shall be allocated using
1460 gdbarch_obstack_zalloc. That memory will be deleted when the
1461 corresponding architecture object is deleted.
0f71a2f6 1462
95160752
AC
1463 When a previously created architecture is re-selected, the
1464 per-architecture data-pointer for that previous architecture is
76860b5f 1465 restored. INIT() is not re-called.
0f71a2f6
JM
1466
1467 Multiple registrarants for any architecture are allowed (and
1468 strongly encouraged). */
1469
95160752 1470struct gdbarch_data;
0f71a2f6 1471
030f20e1
AC
1472typedef void *(gdbarch_data_pre_init_ftype) (struct obstack *obstack);
1473extern struct gdbarch_data *gdbarch_data_register_pre_init (gdbarch_data_pre_init_ftype *init);
1474typedef void *(gdbarch_data_post_init_ftype) (struct gdbarch *gdbarch);
1475extern struct gdbarch_data *gdbarch_data_register_post_init (gdbarch_data_post_init_ftype *init);
1476extern void deprecated_set_gdbarch_data (struct gdbarch *gdbarch,
1477 struct gdbarch_data *data,
1478 void *pointer);
0f71a2f6 1479
451fbdda 1480extern void *gdbarch_data (struct gdbarch *gdbarch, struct gdbarch_data *);
0f71a2f6
JM
1481
1482
a8cf2722 1483
0f71a2f6
JM
1484/* Register per-architecture memory region.
1485
1486 Provide a memory-region swap mechanism. Per-architecture memory
1487 region are created. These memory regions are swapped whenever the
1488 architecture is changed. For a new architecture, the memory region
1489 is initialized with zero (0) and the INIT function is called.
1490
1491 Memory regions are swapped / initialized in the order that they are
1492 registered. NULL DATA and/or INIT values can be specified.
1493
030f20e1 1494 New code should use gdbarch_data_register_*(). */
0f71a2f6 1495
104c1213 1496typedef void (gdbarch_swap_ftype) (void);
046a4708
AC
1497extern void deprecated_register_gdbarch_swap (void *data, unsigned long size, gdbarch_swap_ftype *init);
1498#define DEPRECATED_REGISTER_GDBARCH_SWAP(VAR) deprecated_register_gdbarch_swap (&(VAR), sizeof ((VAR)), NULL)
0f71a2f6
JM
1499
1500
1501
99e7bb18 1502/* Set the dynamic target-system-dependent parameters (architecture,
c906108c
SS
1503 byte-order, ...) using information found in the BFD */
1504
104c1213 1505extern void set_gdbarch_from_file (bfd *);
c906108c
SS
1506
1507
e514a9d6
JM
1508/* Initialize the current architecture to the "first" one we find on
1509 our list. */
1510
1511extern void initialize_current_architecture (void);
1512
c906108c 1513/* gdbarch trace variable */
adf40b2e 1514extern int gdbarch_debug;
c906108c 1515
4b9b3959 1516extern void gdbarch_dump (struct gdbarch *gdbarch, struct ui_file *file);
0f71a2f6 1517
c906108c 1518#endif
This page took 0.654298 seconds and 4 git commands to generate.