* gdbarch.sh (make_corefile_notes): New architecture callback.
[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
f801e1e0
MS
5 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
6 2007, 2008, 2009 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
a9762ec7 12 the Free Software Foundation; either version 3 of the License, or
c5aa993b 13 (at your option) any later version.
de584861 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.
de584861 19
c5aa993b 20 You should have received a copy of the GNU General Public License
a9762ec7 21 along with this program. If not, see <http://www.gnu.org/licenses/>. */
c906108c 22
104c1213
JM
23/* This file was created with the aid of ``gdbarch.sh''.
24
52204a0b 25 The Bourne shell script ``gdbarch.sh'' creates the files
104c1213
JM
26 ``new-gdbarch.c'' and ``new-gdbarch.h and then compares them
27 against the existing ``gdbarch.[hc]''. Any differences found
28 being reported.
29
30 If editing this file, please also run gdbarch.sh and merge any
52204a0b 31 changes into that script. Conversely, when making sweeping changes
104c1213 32 to this file, modifying gdbarch.sh and using its output may prove
0963b4bd 33 easier. */
adf40b2e 34
c906108c
SS
35#ifndef GDBARCH_H
36#define GDBARCH_H
37
da3331ec
AC
38struct floatformat;
39struct ui_file;
cce74817
JM
40struct frame_info;
41struct value;
b6af0555 42struct objfile;
1c772458 43struct obj_section;
a2cf933a 44struct minimal_symbol;
049ee0e4 45struct regcache;
b59ff9d5 46struct reggroup;
6ce6d90f 47struct regset;
a89aa300 48struct disassemble_info;
e2d0e7eb 49struct target_ops;
030f20e1 50struct obstack;
8181d85f 51struct bp_target_info;
424163ea 52struct target_desc;
237fc4c9 53struct displaced_step_closure;
17ea7499 54struct core_regset_section;
a96d9b2e 55struct syscall;
175ff332 56struct agent_expr;
6710bf39 57struct axs_value;
0f71a2f6 58
6b614274
JB
59/* The architecture associated with the connection to the target.
60
61 The architecture vector provides some information that is really
62 a property of the target: The layout of certain packets, for instance;
63 or the solib_ops vector. Etc. To differentiate architecture accesses
64 to per-target properties from per-thread/per-frame/per-objfile properties,
65 accesses to per-target properties should be made through target_gdbarch.
66
67 Eventually, when support for multiple targets is implemented in
68 GDB, this global should be made target-specific. */
1cf3db46 69extern struct gdbarch *target_gdbarch;
0f71a2f6 70
0f71a2f6 71
0963b4bd 72/* The following are pre-initialized by GDBARCH. */
0f71a2f6 73
104c1213 74extern const struct bfd_arch_info * gdbarch_bfd_arch_info (struct gdbarch *gdbarch);
0963b4bd 75/* set_gdbarch_bfd_arch_info() - not applicable - pre-initialized. */
0f71a2f6 76
104c1213 77extern int gdbarch_byte_order (struct gdbarch *gdbarch);
0963b4bd 78/* set_gdbarch_byte_order() - not applicable - pre-initialized. */
0f71a2f6 79
9d4fde75 80extern int gdbarch_byte_order_for_code (struct gdbarch *gdbarch);
0963b4bd 81/* set_gdbarch_byte_order_for_code() - not applicable - pre-initialized. */
9d4fde75 82
4be87837 83extern enum gdb_osabi gdbarch_osabi (struct gdbarch *gdbarch);
0963b4bd 84/* set_gdbarch_osabi() - not applicable - pre-initialized. */
4be87837 85
424163ea 86extern const struct target_desc * gdbarch_target_desc (struct gdbarch *gdbarch);
0963b4bd 87/* set_gdbarch_target_desc() - not applicable - pre-initialized. */
424163ea 88
0f71a2f6 89
0963b4bd 90/* The following are initialized by the target dependent code. */
0f71a2f6 91
32c9a795
MD
92/* The bit byte-order has to do just with numbering of bits in debugging symbols
93 and such. Conceptually, it's quite separate from byte/word byte order. */
94
95extern int gdbarch_bits_big_endian (struct gdbarch *gdbarch);
96extern void set_gdbarch_bits_big_endian (struct gdbarch *gdbarch, int bits_big_endian);
97
66b43ecb
AC
98/* Number of bits in a char or unsigned char for the target machine.
99 Just like CHAR_BIT in <limits.h> but describes the target machine.
57010b1c 100 v:TARGET_CHAR_BIT:int:char_bit::::8 * sizeof (char):8::0:
66b43ecb
AC
101
102 Number of bits in a short or unsigned short for the target machine. */
c4093a6a 103
104c1213
JM
104extern int gdbarch_short_bit (struct gdbarch *gdbarch);
105extern void set_gdbarch_short_bit (struct gdbarch *gdbarch, int short_bit);
0f71a2f6 106
66b43ecb
AC
107/* Number of bits in an int or unsigned int for the target machine. */
108
104c1213
JM
109extern int gdbarch_int_bit (struct gdbarch *gdbarch);
110extern void set_gdbarch_int_bit (struct gdbarch *gdbarch, int int_bit);
0f71a2f6 111
66b43ecb
AC
112/* Number of bits in a long or unsigned long for the target machine. */
113
104c1213
JM
114extern int gdbarch_long_bit (struct gdbarch *gdbarch);
115extern void set_gdbarch_long_bit (struct gdbarch *gdbarch, int long_bit);
0f71a2f6 116
66b43ecb
AC
117/* Number of bits in a long long or unsigned long long for the target
118 machine. */
119
104c1213
JM
120extern int gdbarch_long_long_bit (struct gdbarch *gdbarch);
121extern void set_gdbarch_long_long_bit (struct gdbarch *gdbarch, int long_long_bit);
0f71a2f6 122
205c306f
DM
123/* Alignment of a long long or unsigned long long for the target
124 machine. */
125
126extern int gdbarch_long_long_align_bit (struct gdbarch *gdbarch);
127extern void set_gdbarch_long_long_align_bit (struct gdbarch *gdbarch, int long_long_align_bit);
128
f9e9243a
UW
129/* The ABI default bit-size and format for "half", "float", "double", and
130 "long double". These bit/format pairs should eventually be combined
131 into a single object. For the moment, just initialize them as a pair.
8da61cc4
DJ
132 Each format describes both the big and little endian layouts (if
133 useful). */
66b43ecb 134
f9e9243a
UW
135extern int gdbarch_half_bit (struct gdbarch *gdbarch);
136extern void set_gdbarch_half_bit (struct gdbarch *gdbarch, int half_bit);
137
138extern const struct floatformat ** gdbarch_half_format (struct gdbarch *gdbarch);
139extern void set_gdbarch_half_format (struct gdbarch *gdbarch, const struct floatformat ** half_format);
140
104c1213
JM
141extern int gdbarch_float_bit (struct gdbarch *gdbarch);
142extern void set_gdbarch_float_bit (struct gdbarch *gdbarch, int float_bit);
0f71a2f6 143
8da61cc4
DJ
144extern const struct floatformat ** gdbarch_float_format (struct gdbarch *gdbarch);
145extern void set_gdbarch_float_format (struct gdbarch *gdbarch, const struct floatformat ** float_format);
66b43ecb 146
104c1213
JM
147extern int gdbarch_double_bit (struct gdbarch *gdbarch);
148extern void set_gdbarch_double_bit (struct gdbarch *gdbarch, int double_bit);
0f71a2f6 149
8da61cc4
DJ
150extern const struct floatformat ** gdbarch_double_format (struct gdbarch *gdbarch);
151extern void set_gdbarch_double_format (struct gdbarch *gdbarch, const struct floatformat ** double_format);
66b43ecb 152
104c1213
JM
153extern int gdbarch_long_double_bit (struct gdbarch *gdbarch);
154extern void set_gdbarch_long_double_bit (struct gdbarch *gdbarch, int long_double_bit);
0f71a2f6 155
8da61cc4
DJ
156extern const struct floatformat ** gdbarch_long_double_format (struct gdbarch *gdbarch);
157extern void set_gdbarch_long_double_format (struct gdbarch *gdbarch, const struct floatformat ** long_double_format);
456fcf94 158
52204a0b
DT
159/* For most targets, a pointer on the target and its representation as an
160 address in GDB have the same size and "look the same". For such a
17a912b6 161 target, you need only set gdbarch_ptr_bit and gdbarch_addr_bit
52204a0b
DT
162 / addr_bit will be set from it.
163
17a912b6 164 If gdbarch_ptr_bit and gdbarch_addr_bit are different, you'll probably
8da614df
CV
165 also need to set gdbarch_dwarf2_addr_size, gdbarch_pointer_to_address and
166 gdbarch_address_to_pointer as well.
52204a0b
DT
167
168 ptr_bit is the size of a pointer on the target */
66b43ecb 169
66b43ecb
AC
170extern int gdbarch_ptr_bit (struct gdbarch *gdbarch);
171extern void set_gdbarch_ptr_bit (struct gdbarch *gdbarch, int ptr_bit);
66b43ecb 172
52204a0b
DT
173/* addr_bit is the size of a target address as represented in gdb */
174
52204a0b
DT
175extern int gdbarch_addr_bit (struct gdbarch *gdbarch);
176extern void set_gdbarch_addr_bit (struct gdbarch *gdbarch, int addr_bit);
66b43ecb 177
8da614df
CV
178/* dwarf2_addr_size is the target address size as used in the Dwarf debug
179 info. For .debug_frame FDEs, this is supposed to be the target address
180 size from the associated CU header, and which is equivalent to the
181 DWARF2_ADDR_SIZE as defined by the target specific GCC back-end.
182 Unfortunately there is no good way to determine this value. Therefore
183 dwarf2_addr_size simply defaults to the target pointer size.
184
185 dwarf2_addr_size is not used for .eh_frame FDEs, which are generally
186 defined using the target's pointer size so far.
187
188 Note that dwarf2_addr_size only needs to be redefined by a target if the
189 GCC back-end defines a DWARF2_ADDR_SIZE other than the target pointer size,
190 and if Dwarf versions < 4 need to be supported. */
191
192extern int gdbarch_dwarf2_addr_size (struct gdbarch *gdbarch);
193extern void set_gdbarch_dwarf2_addr_size (struct gdbarch *gdbarch, int dwarf2_addr_size);
194
4e409299
JB
195/* One if `char' acts like `signed char', zero if `unsigned char'. */
196
4e409299
JB
197extern int gdbarch_char_signed (struct gdbarch *gdbarch);
198extern void set_gdbarch_char_signed (struct gdbarch *gdbarch, int char_signed);
4e409299 199
cde9ea48 200extern int gdbarch_read_pc_p (struct gdbarch *gdbarch);
61a1198a
UW
201
202typedef CORE_ADDR (gdbarch_read_pc_ftype) (struct regcache *regcache);
203extern CORE_ADDR gdbarch_read_pc (struct gdbarch *gdbarch, struct regcache *regcache);
104c1213 204extern void set_gdbarch_read_pc (struct gdbarch *gdbarch, gdbarch_read_pc_ftype *read_pc);
61a1198a
UW
205
206extern int gdbarch_write_pc_p (struct gdbarch *gdbarch);
207
208typedef void (gdbarch_write_pc_ftype) (struct regcache *regcache, CORE_ADDR val);
209extern void gdbarch_write_pc (struct gdbarch *gdbarch, struct regcache *regcache, CORE_ADDR val);
104c1213 210extern void set_gdbarch_write_pc (struct gdbarch *gdbarch, gdbarch_write_pc_ftype *write_pc);
0f71a2f6 211
39d4ef09
AC
212/* Function for getting target's idea of a frame pointer. FIXME: GDB's
213 whole scheme for dealing with "frames" and "frame pointers" needs a
214 serious shakedown. */
215
a54fba4c 216typedef void (gdbarch_virtual_frame_pointer_ftype) (struct gdbarch *gdbarch, CORE_ADDR pc, int *frame_regnum, LONGEST *frame_offset);
39d4ef09
AC
217extern void gdbarch_virtual_frame_pointer (struct gdbarch *gdbarch, CORE_ADDR pc, int *frame_regnum, LONGEST *frame_offset);
218extern void set_gdbarch_virtual_frame_pointer (struct gdbarch *gdbarch, gdbarch_virtual_frame_pointer_ftype *virtual_frame_pointer);
39d4ef09 219
d8124050 220extern int gdbarch_pseudo_register_read_p (struct gdbarch *gdbarch);
61a0eb5b 221
05d1431c
PA
222typedef enum register_status (gdbarch_pseudo_register_read_ftype) (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum, gdb_byte *buf);
223extern enum register_status gdbarch_pseudo_register_read (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum, gdb_byte *buf);
d8124050 224extern void set_gdbarch_pseudo_register_read (struct gdbarch *gdbarch, gdbarch_pseudo_register_read_ftype *pseudo_register_read);
61a0eb5b 225
3543a589
TT
226/* Read a register into a new struct value. If the register is wholly
227 or partly unavailable, this should call mark_value_bytes_unavailable
228 as appropriate. If this is defined, then pseudo_register_read will
229 never be called. */
230
231extern int gdbarch_pseudo_register_read_value_p (struct gdbarch *gdbarch);
232
233typedef struct value * (gdbarch_pseudo_register_read_value_ftype) (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum);
234extern struct value * gdbarch_pseudo_register_read_value (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum);
235extern void set_gdbarch_pseudo_register_read_value (struct gdbarch *gdbarch, gdbarch_pseudo_register_read_value_ftype *pseudo_register_read_value);
236
d8124050 237extern int gdbarch_pseudo_register_write_p (struct gdbarch *gdbarch);
61a0eb5b 238
b60c417a
AC
239typedef void (gdbarch_pseudo_register_write_ftype) (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum, const gdb_byte *buf);
240extern void gdbarch_pseudo_register_write (struct gdbarch *gdbarch, struct regcache *regcache, int cookednum, const gdb_byte *buf);
d8124050 241extern void set_gdbarch_pseudo_register_write (struct gdbarch *gdbarch, gdbarch_pseudo_register_write_ftype *pseudo_register_write);
61a0eb5b 242
104c1213
JM
243extern int gdbarch_num_regs (struct gdbarch *gdbarch);
244extern void set_gdbarch_num_regs (struct gdbarch *gdbarch, int num_regs);
0f71a2f6 245
34620563
AC
246/* This macro gives the number of pseudo-registers that live in the
247 register namespace but do not get fetched or stored on the target.
248 These pseudo-registers may be aliases for other registers,
249 combinations of other registers, or they may be computed by GDB. */
250
0aba1244
EZ
251extern int gdbarch_num_pseudo_regs (struct gdbarch *gdbarch);
252extern void set_gdbarch_num_pseudo_regs (struct gdbarch *gdbarch, int num_pseudo_regs);
0aba1244 253
175ff332
HZ
254/* Assemble agent expression bytecode to collect pseudo-register REG.
255 Return -1 if something goes wrong, 0 otherwise. */
256
257extern int gdbarch_ax_pseudo_register_collect_p (struct gdbarch *gdbarch);
258
259typedef int (gdbarch_ax_pseudo_register_collect_ftype) (struct gdbarch *gdbarch, struct agent_expr *ax, int reg);
260extern int gdbarch_ax_pseudo_register_collect (struct gdbarch *gdbarch, struct agent_expr *ax, int reg);
261extern void set_gdbarch_ax_pseudo_register_collect (struct gdbarch *gdbarch, gdbarch_ax_pseudo_register_collect_ftype *ax_pseudo_register_collect);
262
263/* Assemble agent expression bytecode to push the value of pseudo-register
264 REG on the interpreter stack.
265 Return -1 if something goes wrong, 0 otherwise. */
266
267extern int gdbarch_ax_pseudo_register_push_stack_p (struct gdbarch *gdbarch);
268
269typedef int (gdbarch_ax_pseudo_register_push_stack_ftype) (struct gdbarch *gdbarch, struct agent_expr *ax, int reg);
270extern int gdbarch_ax_pseudo_register_push_stack (struct gdbarch *gdbarch, struct agent_expr *ax, int reg);
271extern void set_gdbarch_ax_pseudo_register_push_stack (struct gdbarch *gdbarch, gdbarch_ax_pseudo_register_push_stack_ftype *ax_pseudo_register_push_stack);
272
c2169756
AC
273/* GDB's standard (or well known) register numbers. These can map onto
274 a real register or a pseudo (computed) register or not be defined at
a9e5fdc2 275 all (-1).
3e8c568d 276 gdbarch_sp_regnum will hopefully be replaced by UNWIND_SP. */
1200cd6e 277
104c1213
JM
278extern int gdbarch_sp_regnum (struct gdbarch *gdbarch);
279extern void set_gdbarch_sp_regnum (struct gdbarch *gdbarch, int sp_regnum);
0f71a2f6 280
104c1213
JM
281extern int gdbarch_pc_regnum (struct gdbarch *gdbarch);
282extern void set_gdbarch_pc_regnum (struct gdbarch *gdbarch, int pc_regnum);
0f71a2f6 283
c2169756
AC
284extern int gdbarch_ps_regnum (struct gdbarch *gdbarch);
285extern void set_gdbarch_ps_regnum (struct gdbarch *gdbarch, int ps_regnum);
c2169756 286
60054393
MS
287extern int gdbarch_fp0_regnum (struct gdbarch *gdbarch);
288extern void set_gdbarch_fp0_regnum (struct gdbarch *gdbarch, int fp0_regnum);
60054393 289
88c72b7d
AC
290/* Convert stab register number (from `r' declaration) to a gdb REGNUM. */
291
d3f73121 292typedef int (gdbarch_stab_reg_to_regnum_ftype) (struct gdbarch *gdbarch, int stab_regnr);
88c72b7d
AC
293extern int gdbarch_stab_reg_to_regnum (struct gdbarch *gdbarch, int stab_regnr);
294extern void set_gdbarch_stab_reg_to_regnum (struct gdbarch *gdbarch, gdbarch_stab_reg_to_regnum_ftype *stab_reg_to_regnum);
88c72b7d
AC
295
296/* Provide a default mapping from a ecoff register number to a gdb REGNUM. */
297
d3f73121 298typedef int (gdbarch_ecoff_reg_to_regnum_ftype) (struct gdbarch *gdbarch, int ecoff_regnr);
88c72b7d
AC
299extern int gdbarch_ecoff_reg_to_regnum (struct gdbarch *gdbarch, int ecoff_regnr);
300extern void set_gdbarch_ecoff_reg_to_regnum (struct gdbarch *gdbarch, gdbarch_ecoff_reg_to_regnum_ftype *ecoff_reg_to_regnum);
88c72b7d 301
77949794 302/* Convert from an sdb register number to an internal gdb register number. */
88c72b7d 303
d3f73121 304typedef int (gdbarch_sdb_reg_to_regnum_ftype) (struct gdbarch *gdbarch, int sdb_regnr);
88c72b7d
AC
305extern int gdbarch_sdb_reg_to_regnum (struct gdbarch *gdbarch, int sdb_regnr);
306extern void set_gdbarch_sdb_reg_to_regnum (struct gdbarch *gdbarch, gdbarch_sdb_reg_to_regnum_ftype *sdb_reg_to_regnum);
88c72b7d 307
ba2b1c56
DJ
308/* Provide a default mapping from a DWARF2 register number to a gdb REGNUM. */
309
d3f73121 310typedef int (gdbarch_dwarf2_reg_to_regnum_ftype) (struct gdbarch *gdbarch, int dwarf2_regnr);
88c72b7d
AC
311extern int gdbarch_dwarf2_reg_to_regnum (struct gdbarch *gdbarch, int dwarf2_regnr);
312extern void set_gdbarch_dwarf2_reg_to_regnum (struct gdbarch *gdbarch, gdbarch_dwarf2_reg_to_regnum_ftype *dwarf2_reg_to_regnum);
88c72b7d 313
d93859e2 314typedef const char * (gdbarch_register_name_ftype) (struct gdbarch *gdbarch, int regnr);
fa88f677 315extern const char * gdbarch_register_name (struct gdbarch *gdbarch, int regnr);
104c1213 316extern void set_gdbarch_register_name (struct gdbarch *gdbarch, gdbarch_register_name_ftype *register_name);
0f71a2f6 317
7b9ee6a8
DJ
318/* Return the type of a register specified by the architecture. Only
319 the register cache should call this function directly; others should
320 use "register_type". */
9c04cab7
AC
321
322extern int gdbarch_register_type_p (struct gdbarch *gdbarch);
323
324typedef struct type * (gdbarch_register_type_ftype) (struct gdbarch *gdbarch, int reg_nr);
325extern struct type * gdbarch_register_type (struct gdbarch *gdbarch, int reg_nr);
326extern void set_gdbarch_register_type (struct gdbarch *gdbarch, gdbarch_register_type_ftype *register_type);
327
f3be58bc
AC
328/* See gdbint.texinfo, and PUSH_DUMMY_CALL. */
329
669fac23 330extern int gdbarch_dummy_id_p (struct gdbarch *gdbarch);
f3be58bc 331
669fac23
DJ
332typedef struct frame_id (gdbarch_dummy_id_ftype) (struct gdbarch *gdbarch, struct frame_info *this_frame);
333extern struct frame_id gdbarch_dummy_id (struct gdbarch *gdbarch, struct frame_info *this_frame);
334extern void set_gdbarch_dummy_id (struct gdbarch *gdbarch, gdbarch_dummy_id_ftype *dummy_id);
f3be58bc 335
669fac23 336/* Implement DUMMY_ID and PUSH_DUMMY_CALL, then delete
064f5156 337 deprecated_fp_regnum. */
f3be58bc 338
f3be58bc
AC
339extern int gdbarch_deprecated_fp_regnum (struct gdbarch *gdbarch);
340extern void set_gdbarch_deprecated_fp_regnum (struct gdbarch *gdbarch, int deprecated_fp_regnum);
f3be58bc 341
a86c5fc9 342/* See gdbint.texinfo. See infcall.c. */
b8de8283
AC
343
344extern int gdbarch_push_dummy_call_p (struct gdbarch *gdbarch);
345
7d9b040b
RC
346typedef 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);
347extern 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
348extern void set_gdbarch_push_dummy_call (struct gdbarch *gdbarch, gdbarch_push_dummy_call_ftype *push_dummy_call);
349
b8de8283
AC
350extern int gdbarch_call_dummy_location (struct gdbarch *gdbarch);
351extern void set_gdbarch_call_dummy_location (struct gdbarch *gdbarch, int call_dummy_location);
b8de8283 352
b8de8283
AC
353extern int gdbarch_push_dummy_code_p (struct gdbarch *gdbarch);
354
82585c72
UW
355typedef CORE_ADDR (gdbarch_push_dummy_code_ftype) (struct gdbarch *gdbarch, CORE_ADDR sp, CORE_ADDR funaddr, struct value **args, int nargs, struct type *value_type, CORE_ADDR *real_pc, CORE_ADDR *bp_addr, struct regcache *regcache);
356extern CORE_ADDR gdbarch_push_dummy_code (struct gdbarch *gdbarch, CORE_ADDR sp, CORE_ADDR funaddr, struct value **args, int nargs, struct type *value_type, CORE_ADDR *real_pc, CORE_ADDR *bp_addr, struct regcache *regcache);
b8de8283
AC
357extern void set_gdbarch_push_dummy_code (struct gdbarch *gdbarch, gdbarch_push_dummy_code_ftype *push_dummy_code);
358
0ab7a791
AC
359typedef void (gdbarch_print_registers_info_ftype) (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, int regnum, int all);
360extern void gdbarch_print_registers_info (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, int regnum, int all);
361extern void set_gdbarch_print_registers_info (struct gdbarch *gdbarch, gdbarch_print_registers_info_ftype *print_registers_info);
362
23e3a7ac
AC
363extern int gdbarch_print_float_info_p (struct gdbarch *gdbarch);
364
365typedef void (gdbarch_print_float_info_ftype) (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, const char *args);
366extern void gdbarch_print_float_info (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, const char *args);
5e74b15c 367extern void set_gdbarch_print_float_info (struct gdbarch *gdbarch, gdbarch_print_float_info_ftype *print_float_info);
5e74b15c 368
e76f1f2e
AC
369extern int gdbarch_print_vector_info_p (struct gdbarch *gdbarch);
370
371typedef void (gdbarch_print_vector_info_ftype) (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, const char *args);
372extern void gdbarch_print_vector_info (struct gdbarch *gdbarch, struct ui_file *file, struct frame_info *frame, const char *args);
373extern void set_gdbarch_print_vector_info (struct gdbarch *gdbarch, gdbarch_print_vector_info_ftype *print_vector_info);
374
7c7651b2
AC
375/* MAP a GDB RAW register number onto a simulator register number. See
376 also include/...-sim.h. */
377
e7faf938 378typedef int (gdbarch_register_sim_regno_ftype) (struct gdbarch *gdbarch, int reg_nr);
7c7651b2
AC
379extern int gdbarch_register_sim_regno (struct gdbarch *gdbarch, int reg_nr);
380extern void set_gdbarch_register_sim_regno (struct gdbarch *gdbarch, gdbarch_register_sim_regno_ftype *register_sim_regno);
7c7651b2 381
64a3914f 382typedef int (gdbarch_cannot_fetch_register_ftype) (struct gdbarch *gdbarch, int regnum);
01fb7433
AC
383extern int gdbarch_cannot_fetch_register (struct gdbarch *gdbarch, int regnum);
384extern void set_gdbarch_cannot_fetch_register (struct gdbarch *gdbarch, gdbarch_cannot_fetch_register_ftype *cannot_fetch_register);
01fb7433 385
64a3914f 386typedef int (gdbarch_cannot_store_register_ftype) (struct gdbarch *gdbarch, int regnum);
01fb7433
AC
387extern int gdbarch_cannot_store_register (struct gdbarch *gdbarch, int regnum);
388extern void set_gdbarch_cannot_store_register (struct gdbarch *gdbarch, gdbarch_cannot_store_register_ftype *cannot_store_register);
01fb7433 389
9df628e0
RE
390/* setjmp/longjmp support. */
391
9df628e0 392extern int gdbarch_get_longjmp_target_p (struct gdbarch *gdbarch);
0f71a2f6 393
60ade65d
UW
394typedef int (gdbarch_get_longjmp_target_ftype) (struct frame_info *frame, CORE_ADDR *pc);
395extern int gdbarch_get_longjmp_target (struct gdbarch *gdbarch, struct frame_info *frame, CORE_ADDR *pc);
b8de8283 396extern void set_gdbarch_get_longjmp_target (struct gdbarch *gdbarch, gdbarch_get_longjmp_target_ftype *get_longjmp_target);
0f71a2f6 397
104c1213
JM
398extern int gdbarch_believe_pcc_promotion (struct gdbarch *gdbarch);
399extern void set_gdbarch_believe_pcc_promotion (struct gdbarch *gdbarch, int believe_pcc_promotion);
0f71a2f6 400
0abe36f5 401typedef int (gdbarch_convert_register_p_ftype) (struct gdbarch *gdbarch, int regnum, struct type *type);
ff2e87ac 402extern int gdbarch_convert_register_p (struct gdbarch *gdbarch, int regnum, struct type *type);
13d01224 403extern void set_gdbarch_convert_register_p (struct gdbarch *gdbarch, gdbarch_convert_register_p_ftype *convert_register_p);
13d01224 404
8dccd430
PA
405typedef int (gdbarch_register_to_value_ftype) (struct frame_info *frame, int regnum, struct type *type, gdb_byte *buf, int *optimizedp, int *unavailablep);
406extern int gdbarch_register_to_value (struct gdbarch *gdbarch, struct frame_info *frame, int regnum, struct type *type, gdb_byte *buf, int *optimizedp, int *unavailablep);
13d01224 407extern void set_gdbarch_register_to_value (struct gdbarch *gdbarch, gdbarch_register_to_value_ftype *register_to_value);
13d01224 408
b60c417a
AC
409typedef void (gdbarch_value_to_register_ftype) (struct frame_info *frame, int regnum, struct type *type, const gdb_byte *buf);
410extern void gdbarch_value_to_register (struct gdbarch *gdbarch, struct frame_info *frame, int regnum, struct type *type, const gdb_byte *buf);
13d01224 411extern void set_gdbarch_value_to_register (struct gdbarch *gdbarch, gdbarch_value_to_register_ftype *value_to_register);
13d01224 412
9acbedc0
UW
413/* Construct a value representing the contents of register REGNUM in
414 frame FRAME, interpreted as type TYPE. The routine needs to
415 allocate and return a struct value with all value attributes
416 (but not the value contents) filled in. */
417
418typedef struct value * (gdbarch_value_from_register_ftype) (struct type *type, int regnum, struct frame_info *frame);
419extern struct value * gdbarch_value_from_register (struct gdbarch *gdbarch, struct type *type, int regnum, struct frame_info *frame);
420extern void set_gdbarch_value_from_register (struct gdbarch *gdbarch, gdbarch_value_from_register_ftype *value_from_register);
421
9898f801 422typedef CORE_ADDR (gdbarch_pointer_to_address_ftype) (struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf);
b60c417a 423extern CORE_ADDR gdbarch_pointer_to_address (struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf);
4478b372 424extern void set_gdbarch_pointer_to_address (struct gdbarch *gdbarch, gdbarch_pointer_to_address_ftype *pointer_to_address);
33489c5b 425
9898f801 426typedef void (gdbarch_address_to_pointer_ftype) (struct gdbarch *gdbarch, struct type *type, gdb_byte *buf, CORE_ADDR addr);
b60c417a 427extern void gdbarch_address_to_pointer (struct gdbarch *gdbarch, struct type *type, gdb_byte *buf, CORE_ADDR addr);
4478b372 428extern void set_gdbarch_address_to_pointer (struct gdbarch *gdbarch, gdbarch_address_to_pointer_ftype *address_to_pointer);
33489c5b 429
fc0c74b1 430extern int gdbarch_integer_to_address_p (struct gdbarch *gdbarch);
fc0c74b1 431
fc1a4b47
AC
432typedef CORE_ADDR (gdbarch_integer_to_address_ftype) (struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf);
433extern CORE_ADDR gdbarch_integer_to_address (struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf);
fc0c74b1 434extern void set_gdbarch_integer_to_address (struct gdbarch *gdbarch, gdbarch_integer_to_address_ftype *integer_to_address);
fc0c74b1 435
ea42b34a
JB
436/* Return the return-value convention that will be used by FUNCTYPE
437 to return a value of type VALTYPE. FUNCTYPE may be NULL in which
438 case the return convention is computed based only on VALTYPE.
439
440 If READBUF is not NULL, extract the return value and save it in this buffer.
441
442 If WRITEBUF is not NULL, it contains a return value which will be
443 stored into the appropriate register. This can be used when we want
444 to force the value returned by a function (see the "return" command
445 for instance). */
92ad9cd9
AC
446
447extern int gdbarch_return_value_p (struct gdbarch *gdbarch);
448
c055b101
CV
449typedef enum return_value_convention (gdbarch_return_value_ftype) (struct gdbarch *gdbarch, struct type *functype, struct type *valtype, struct regcache *regcache, gdb_byte *readbuf, const gdb_byte *writebuf);
450extern enum return_value_convention gdbarch_return_value (struct gdbarch *gdbarch, struct type *functype, struct type *valtype, struct regcache *regcache, gdb_byte *readbuf, const gdb_byte *writebuf);
92ad9cd9
AC
451extern void set_gdbarch_return_value (struct gdbarch *gdbarch, gdbarch_return_value_ftype *return_value);
452
6093d2eb 453typedef CORE_ADDR (gdbarch_skip_prologue_ftype) (struct gdbarch *gdbarch, CORE_ADDR ip);
104c1213
JM
454extern CORE_ADDR gdbarch_skip_prologue (struct gdbarch *gdbarch, CORE_ADDR ip);
455extern void set_gdbarch_skip_prologue (struct gdbarch *gdbarch, gdbarch_skip_prologue_ftype *skip_prologue);
0f71a2f6 456
4309257c
PM
457extern int gdbarch_skip_main_prologue_p (struct gdbarch *gdbarch);
458
459typedef CORE_ADDR (gdbarch_skip_main_prologue_ftype) (struct gdbarch *gdbarch, CORE_ADDR ip);
460extern CORE_ADDR gdbarch_skip_main_prologue (struct gdbarch *gdbarch, CORE_ADDR ip);
461extern void set_gdbarch_skip_main_prologue (struct gdbarch *gdbarch, gdbarch_skip_main_prologue_ftype *skip_main_prologue);
462
104c1213
JM
463typedef int (gdbarch_inner_than_ftype) (CORE_ADDR lhs, CORE_ADDR rhs);
464extern int gdbarch_inner_than (struct gdbarch *gdbarch, CORE_ADDR lhs, CORE_ADDR rhs);
465extern void set_gdbarch_inner_than (struct gdbarch *gdbarch, gdbarch_inner_than_ftype *inner_than);
0f71a2f6 466
67d57894 467typedef const gdb_byte * (gdbarch_breakpoint_from_pc_ftype) (struct gdbarch *gdbarch, CORE_ADDR *pcptr, int *lenptr);
fc1a4b47 468extern const gdb_byte * gdbarch_breakpoint_from_pc (struct gdbarch *gdbarch, CORE_ADDR *pcptr, int *lenptr);
104c1213 469extern void set_gdbarch_breakpoint_from_pc (struct gdbarch *gdbarch, gdbarch_breakpoint_from_pc_ftype *breakpoint_from_pc);
33489c5b 470
a1dcb23a
DJ
471/* Return the adjusted address and kind to use for Z0/Z1 packets.
472 KIND is usually the memory length of the breakpoint, but may have a
473 different target-specific meaning. */
474
475typedef void (gdbarch_remote_breakpoint_from_pc_ftype) (struct gdbarch *gdbarch, CORE_ADDR *pcptr, int *kindptr);
476extern void gdbarch_remote_breakpoint_from_pc (struct gdbarch *gdbarch, CORE_ADDR *pcptr, int *kindptr);
477extern void set_gdbarch_remote_breakpoint_from_pc (struct gdbarch *gdbarch, gdbarch_remote_breakpoint_from_pc_ftype *remote_breakpoint_from_pc);
478
a1131521
KB
479extern int gdbarch_adjust_breakpoint_address_p (struct gdbarch *gdbarch);
480
481typedef CORE_ADDR (gdbarch_adjust_breakpoint_address_ftype) (struct gdbarch *gdbarch, CORE_ADDR bpaddr);
482extern CORE_ADDR gdbarch_adjust_breakpoint_address (struct gdbarch *gdbarch, CORE_ADDR bpaddr);
483extern void set_gdbarch_adjust_breakpoint_address (struct gdbarch *gdbarch, gdbarch_adjust_breakpoint_address_ftype *adjust_breakpoint_address);
484
ae4b2284 485typedef int (gdbarch_memory_insert_breakpoint_ftype) (struct gdbarch *gdbarch, struct bp_target_info *bp_tgt);
8181d85f 486extern int gdbarch_memory_insert_breakpoint (struct gdbarch *gdbarch, struct bp_target_info *bp_tgt);
917317f4 487extern void set_gdbarch_memory_insert_breakpoint (struct gdbarch *gdbarch, gdbarch_memory_insert_breakpoint_ftype *memory_insert_breakpoint);
33489c5b 488
ae4b2284 489typedef int (gdbarch_memory_remove_breakpoint_ftype) (struct gdbarch *gdbarch, struct bp_target_info *bp_tgt);
8181d85f 490extern int gdbarch_memory_remove_breakpoint (struct gdbarch *gdbarch, struct bp_target_info *bp_tgt);
917317f4 491extern void set_gdbarch_memory_remove_breakpoint (struct gdbarch *gdbarch, gdbarch_memory_remove_breakpoint_ftype *memory_remove_breakpoint);
917317f4 492
104c1213
JM
493extern CORE_ADDR gdbarch_decr_pc_after_break (struct gdbarch *gdbarch);
494extern void set_gdbarch_decr_pc_after_break (struct gdbarch *gdbarch, CORE_ADDR decr_pc_after_break);
0f71a2f6 495
782263ab
AC
496/* A function can be addressed by either it's "pointer" (possibly a
497 descriptor address) or "entry point" (first executable instruction).
498 The method "convert_from_func_ptr_addr" converting the former to the
cbf3b44a 499 latter. gdbarch_deprecated_function_start_offset is being used to implement
782263ab
AC
500 a simplified subset of that functionality - the function's address
501 corresponds to the "function pointer" and the function's start
502 corresponds to the "function entry point" - and hence is redundant. */
503
504extern CORE_ADDR gdbarch_deprecated_function_start_offset (struct gdbarch *gdbarch);
505extern void set_gdbarch_deprecated_function_start_offset (struct gdbarch *gdbarch, CORE_ADDR deprecated_function_start_offset);
0f71a2f6 506
123dc839
DJ
507/* Return the remote protocol register number associated with this
508 register. Normally the identity mapping. */
509
510typedef int (gdbarch_remote_register_number_ftype) (struct gdbarch *gdbarch, int regno);
511extern int gdbarch_remote_register_number (struct gdbarch *gdbarch, int regno);
512extern void set_gdbarch_remote_register_number (struct gdbarch *gdbarch, gdbarch_remote_register_number_ftype *remote_register_number);
513
b2756930
KB
514/* Fetch the target specific address used to represent a load module. */
515
b2756930 516extern int gdbarch_fetch_tls_load_module_address_p (struct gdbarch *gdbarch);
b2756930
KB
517
518typedef CORE_ADDR (gdbarch_fetch_tls_load_module_address_ftype) (struct objfile *objfile);
519extern CORE_ADDR gdbarch_fetch_tls_load_module_address (struct gdbarch *gdbarch, struct objfile *objfile);
520extern void set_gdbarch_fetch_tls_load_module_address (struct gdbarch *gdbarch, gdbarch_fetch_tls_load_module_address_ftype *fetch_tls_load_module_address);
b2756930 521
104c1213
JM
522extern CORE_ADDR gdbarch_frame_args_skip (struct gdbarch *gdbarch);
523extern void set_gdbarch_frame_args_skip (struct gdbarch *gdbarch, CORE_ADDR frame_args_skip);
0f71a2f6 524
12cc2063
AC
525extern int gdbarch_unwind_pc_p (struct gdbarch *gdbarch);
526
527typedef CORE_ADDR (gdbarch_unwind_pc_ftype) (struct gdbarch *gdbarch, struct frame_info *next_frame);
528extern CORE_ADDR gdbarch_unwind_pc (struct gdbarch *gdbarch, struct frame_info *next_frame);
529extern void set_gdbarch_unwind_pc (struct gdbarch *gdbarch, gdbarch_unwind_pc_ftype *unwind_pc);
530
a9e5fdc2
AC
531extern int gdbarch_unwind_sp_p (struct gdbarch *gdbarch);
532
533typedef CORE_ADDR (gdbarch_unwind_sp_ftype) (struct gdbarch *gdbarch, struct frame_info *next_frame);
534extern CORE_ADDR gdbarch_unwind_sp (struct gdbarch *gdbarch, struct frame_info *next_frame);
535extern void set_gdbarch_unwind_sp (struct gdbarch *gdbarch, gdbarch_unwind_sp_ftype *unwind_sp);
536
42efa47a
AC
537/* DEPRECATED_FRAME_LOCALS_ADDRESS as been replaced by the per-frame
538 frame-base. Enable frame-base before frame-unwind. */
539
983a287a 540extern int gdbarch_frame_num_args_p (struct gdbarch *gdbarch);
983a287a 541
104c1213
JM
542typedef int (gdbarch_frame_num_args_ftype) (struct frame_info *frame);
543extern int gdbarch_frame_num_args (struct gdbarch *gdbarch, struct frame_info *frame);
544extern void set_gdbarch_frame_num_args (struct gdbarch *gdbarch, gdbarch_frame_num_args_ftype *frame_num_args);
0f71a2f6 545
dc604539
AC
546extern int gdbarch_frame_align_p (struct gdbarch *gdbarch);
547
548typedef CORE_ADDR (gdbarch_frame_align_ftype) (struct gdbarch *gdbarch, CORE_ADDR address);
549extern CORE_ADDR gdbarch_frame_align (struct gdbarch *gdbarch, CORE_ADDR address);
550extern void set_gdbarch_frame_align (struct gdbarch *gdbarch, gdbarch_frame_align_ftype *frame_align);
551
192cb3d4
MK
552typedef int (gdbarch_stabs_argument_has_addr_ftype) (struct gdbarch *gdbarch, struct type *type);
553extern int gdbarch_stabs_argument_has_addr (struct gdbarch *gdbarch, struct type *type);
554extern void set_gdbarch_stabs_argument_has_addr (struct gdbarch *gdbarch, gdbarch_stabs_argument_has_addr_ftype *stabs_argument_has_addr);
555
8b148df9
AC
556extern int gdbarch_frame_red_zone_size (struct gdbarch *gdbarch);
557extern void set_gdbarch_frame_red_zone_size (struct gdbarch *gdbarch, int frame_red_zone_size);
8b148df9 558
e2d0e7eb
AC
559typedef CORE_ADDR (gdbarch_convert_from_func_ptr_addr_ftype) (struct gdbarch *gdbarch, CORE_ADDR addr, struct target_ops *targ);
560extern CORE_ADDR gdbarch_convert_from_func_ptr_addr (struct gdbarch *gdbarch, CORE_ADDR addr, struct target_ops *targ);
f517ea4e 561extern void set_gdbarch_convert_from_func_ptr_addr (struct gdbarch *gdbarch, gdbarch_convert_from_func_ptr_addr_ftype *convert_from_func_ptr_addr);
f517ea4e 562
875e1767
AC
563/* On some machines there are bits in addresses which are not really
564 part of the address, but are used by the kernel, the hardware, etc.
bf6ae464 565 for special purposes. gdbarch_addr_bits_remove takes out any such bits so
875e1767
AC
566 we get a "real" address such as one would find in a symbol table.
567 This is used only for addresses of instructions, and even then I'm
568 not sure it's used in all contexts. It exists to deal with there
569 being a few stray bits in the PC which would mislead us, not as some
570 sort of generic thing to handle alignment or segmentation (it's
571 possible it should be in TARGET_READ_PC instead). */
572
24568a2c 573typedef CORE_ADDR (gdbarch_addr_bits_remove_ftype) (struct gdbarch *gdbarch, CORE_ADDR addr);
875e1767
AC
574extern CORE_ADDR gdbarch_addr_bits_remove (struct gdbarch *gdbarch, CORE_ADDR addr);
575extern void set_gdbarch_addr_bits_remove (struct gdbarch *gdbarch, gdbarch_addr_bits_remove_ftype *addr_bits_remove);
875e1767 576
260edbc2 577/* It is not at all clear why gdbarch_smash_text_address is not folded into
bf6ae464 578 gdbarch_addr_bits_remove. */
181c1381 579
24568a2c 580typedef CORE_ADDR (gdbarch_smash_text_address_ftype) (struct gdbarch *gdbarch, CORE_ADDR addr);
181c1381
RE
581extern CORE_ADDR gdbarch_smash_text_address (struct gdbarch *gdbarch, CORE_ADDR addr);
582extern void set_gdbarch_smash_text_address (struct gdbarch *gdbarch, gdbarch_smash_text_address_ftype *smash_text_address);
181c1381 583
e6590a1b
UW
584/* FIXME/cagney/2001-01-18: This should be split in two. A target method that
585 indicates if the target needs software single step. An ISA method to
586 implement it.
64c4637f 587
e6590a1b
UW
588 FIXME/cagney/2001-01-18: This should be replaced with something that inserts
589 breakpoints using the breakpoint system instead of blatting memory directly
590 (as with rs6000).
64c4637f 591
e6590a1b
UW
592 FIXME/cagney/2001-01-18: The logic is backwards. It should be asking if the
593 target can single step. If not, then implement single step using breakpoints.
594
f17b6955 595 A return value of 1 means that the software_single_step breakpoints
e6590a1b 596 were inserted; 0 means they were not. */
64c4637f 597
64c4637f 598extern int gdbarch_software_single_step_p (struct gdbarch *gdbarch);
64c4637f 599
0b1b3e42
UW
600typedef int (gdbarch_software_single_step_ftype) (struct frame_info *frame);
601extern int gdbarch_software_single_step (struct gdbarch *gdbarch, struct frame_info *frame);
64c4637f 602extern void set_gdbarch_software_single_step (struct gdbarch *gdbarch, gdbarch_software_single_step_ftype *software_single_step);
64c4637f 603
3352ef37
AC
604/* Return non-zero if the processor is executing a delay slot and a
605 further single-step is needed before the instruction finishes. */
606
607extern int gdbarch_single_step_through_delay_p (struct gdbarch *gdbarch);
608
609typedef int (gdbarch_single_step_through_delay_ftype) (struct gdbarch *gdbarch, struct frame_info *frame);
610extern int gdbarch_single_step_through_delay (struct gdbarch *gdbarch, struct frame_info *frame);
611extern void set_gdbarch_single_step_through_delay (struct gdbarch *gdbarch, gdbarch_single_step_through_delay_ftype *single_step_through_delay);
612
f6c40618 613/* FIXME: cagney/2003-08-28: Need to find a better way of selecting the
b2fa5097 614 disassembler. Perhaps objdump can handle it? */
f6c40618 615
a89aa300
AC
616typedef int (gdbarch_print_insn_ftype) (bfd_vma vma, struct disassemble_info *info);
617extern int gdbarch_print_insn (struct gdbarch *gdbarch, bfd_vma vma, struct disassemble_info *info);
2bf0cb65 618extern void set_gdbarch_print_insn (struct gdbarch *gdbarch, gdbarch_print_insn_ftype *print_insn);
2bf0cb65 619
52f729a7
UW
620typedef CORE_ADDR (gdbarch_skip_trampoline_code_ftype) (struct frame_info *frame, CORE_ADDR pc);
621extern CORE_ADDR gdbarch_skip_trampoline_code (struct gdbarch *gdbarch, struct frame_info *frame, CORE_ADDR pc);
bdcd319a 622extern void set_gdbarch_skip_trampoline_code (struct gdbarch *gdbarch, gdbarch_skip_trampoline_code_ftype *skip_trampoline_code);
bdcd319a 623
cfd8ab24 624/* If in_solib_dynsym_resolve_code() returns true, and SKIP_SOLIB_RESOLVER
dea0c52f
MK
625 evaluates non-zero, this is the address where the debugger will place
626 a step-resume breakpoint to get us past the dynamic linker. */
627
4c8c40e6 628typedef CORE_ADDR (gdbarch_skip_solib_resolver_ftype) (struct gdbarch *gdbarch, CORE_ADDR pc);
dea0c52f
MK
629extern CORE_ADDR gdbarch_skip_solib_resolver (struct gdbarch *gdbarch, CORE_ADDR pc);
630extern void set_gdbarch_skip_solib_resolver (struct gdbarch *gdbarch, gdbarch_skip_solib_resolver_ftype *skip_solib_resolver);
dea0c52f 631
d50355b6
MS
632/* Some systems also have trampoline code for returning from shared libs. */
633
e17a4113 634typedef int (gdbarch_in_solib_return_trampoline_ftype) (struct gdbarch *gdbarch, CORE_ADDR pc, char *name);
d50355b6
MS
635extern int gdbarch_in_solib_return_trampoline (struct gdbarch *gdbarch, CORE_ADDR pc, char *name);
636extern void set_gdbarch_in_solib_return_trampoline (struct gdbarch *gdbarch, gdbarch_in_solib_return_trampoline_ftype *in_solib_return_trampoline);
d50355b6 637
c12260ac
CV
638/* A target might have problems with watchpoints as soon as the stack
639 frame of the current function has been destroyed. This mostly happens
640 as the first action in a funtion's epilogue. in_function_epilogue_p()
641 is defined to return a non-zero value if either the given addr is one
642 instruction after the stack destroying instruction up to the trailing
643 return instruction or if we can figure out that the stack frame has
644 already been invalidated regardless of the value of addr. Targets
645 which don't suffer from that problem could just let this functionality
646 untouched. */
647
648typedef int (gdbarch_in_function_epilogue_p_ftype) (struct gdbarch *gdbarch, CORE_ADDR addr);
649extern int gdbarch_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR addr);
650extern void set_gdbarch_in_function_epilogue_p (struct gdbarch *gdbarch, gdbarch_in_function_epilogue_p_ftype *in_function_epilogue_p);
651
a2cf933a
EZ
652typedef void (gdbarch_elf_make_msymbol_special_ftype) (asymbol *sym, struct minimal_symbol *msym);
653extern void gdbarch_elf_make_msymbol_special (struct gdbarch *gdbarch, asymbol *sym, struct minimal_symbol *msym);
654extern void set_gdbarch_elf_make_msymbol_special (struct gdbarch *gdbarch, gdbarch_elf_make_msymbol_special_ftype *elf_make_msymbol_special);
a2cf933a 655
a2cf933a
EZ
656typedef void (gdbarch_coff_make_msymbol_special_ftype) (int val, struct minimal_symbol *msym);
657extern void gdbarch_coff_make_msymbol_special (struct gdbarch *gdbarch, int val, struct minimal_symbol *msym);
658extern void set_gdbarch_coff_make_msymbol_special (struct gdbarch *gdbarch, gdbarch_coff_make_msymbol_special_ftype *coff_make_msymbol_special);
a2cf933a 659
c4ed33b9
AC
660extern int gdbarch_cannot_step_breakpoint (struct gdbarch *gdbarch);
661extern void set_gdbarch_cannot_step_breakpoint (struct gdbarch *gdbarch, int cannot_step_breakpoint);
c4ed33b9 662
f74fa174
MM
663extern int gdbarch_have_nonsteppable_watchpoint (struct gdbarch *gdbarch);
664extern void set_gdbarch_have_nonsteppable_watchpoint (struct gdbarch *gdbarch, int have_nonsteppable_watchpoint);
f74fa174 665
8b2dbe47 666extern int gdbarch_address_class_type_flags_p (struct gdbarch *gdbarch);
8b2dbe47 667
8b2dbe47
KB
668typedef int (gdbarch_address_class_type_flags_ftype) (int byte_size, int dwarf2_addr_class);
669extern int gdbarch_address_class_type_flags (struct gdbarch *gdbarch, int byte_size, int dwarf2_addr_class);
670extern void set_gdbarch_address_class_type_flags (struct gdbarch *gdbarch, gdbarch_address_class_type_flags_ftype *address_class_type_flags);
8b2dbe47 671
8b2dbe47 672extern int gdbarch_address_class_type_flags_to_name_p (struct gdbarch *gdbarch);
8b2dbe47 673
321432c0
KB
674typedef const char * (gdbarch_address_class_type_flags_to_name_ftype) (struct gdbarch *gdbarch, int type_flags);
675extern const char * gdbarch_address_class_type_flags_to_name (struct gdbarch *gdbarch, int type_flags);
8b2dbe47 676extern 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
677
678extern int gdbarch_address_class_name_to_type_flags_p (struct gdbarch *gdbarch);
8b2dbe47 679
321432c0
KB
680typedef int (gdbarch_address_class_name_to_type_flags_ftype) (struct gdbarch *gdbarch, const char *name, int *type_flags_ptr);
681extern int gdbarch_address_class_name_to_type_flags (struct gdbarch *gdbarch, const char *name, int *type_flags_ptr);
8b2dbe47 682extern 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 683
b59ff9d5
AC
684/* Is a register in a group */
685
686typedef int (gdbarch_register_reggroup_p_ftype) (struct gdbarch *gdbarch, int regnum, struct reggroup *reggroup);
687extern int gdbarch_register_reggroup_p (struct gdbarch *gdbarch, int regnum, struct reggroup *reggroup);
688extern void set_gdbarch_register_reggroup_p (struct gdbarch *gdbarch, gdbarch_register_reggroup_p_ftype *register_reggroup_p);
689
2e092625 690/* Fetch the pointer to the ith function argument. */
143985b7 691
143985b7 692extern int gdbarch_fetch_pointer_argument_p (struct gdbarch *gdbarch);
143985b7 693
143985b7
AF
694typedef CORE_ADDR (gdbarch_fetch_pointer_argument_ftype) (struct frame_info *frame, int argi, struct type *type);
695extern CORE_ADDR gdbarch_fetch_pointer_argument (struct gdbarch *gdbarch, struct frame_info *frame, int argi, struct type *type);
696extern void set_gdbarch_fetch_pointer_argument (struct gdbarch *gdbarch, gdbarch_fetch_pointer_argument_ftype *fetch_pointer_argument);
143985b7 697
6ce6d90f
MK
698/* Return the appropriate register set for a core file section with
699 name SECT_NAME and size SECT_SIZE. */
700
701extern int gdbarch_regset_from_core_section_p (struct gdbarch *gdbarch);
702
703typedef const struct regset * (gdbarch_regset_from_core_section_ftype) (struct gdbarch *gdbarch, const char *sect_name, size_t sect_size);
704extern const struct regset * gdbarch_regset_from_core_section (struct gdbarch *gdbarch, const char *sect_name, size_t sect_size);
705extern void set_gdbarch_regset_from_core_section (struct gdbarch *gdbarch, gdbarch_regset_from_core_section_ftype *regset_from_core_section);
706
17ea7499
CES
707/* Supported register notes in a core file. */
708
709extern struct core_regset_section * gdbarch_core_regset_sections (struct gdbarch *gdbarch);
710extern void set_gdbarch_core_regset_sections (struct gdbarch *gdbarch, struct core_regset_section * core_regset_sections);
711
6432734d
UW
712/* Create core file notes */
713
714extern int gdbarch_make_corefile_notes_p (struct gdbarch *gdbarch);
715
716typedef char * (gdbarch_make_corefile_notes_ftype) (struct gdbarch *gdbarch, bfd *obfd, int *note_size);
717extern char * gdbarch_make_corefile_notes (struct gdbarch *gdbarch, bfd *obfd, int *note_size);
718extern void set_gdbarch_make_corefile_notes (struct gdbarch *gdbarch, gdbarch_make_corefile_notes_ftype *make_corefile_notes);
719
de584861
PA
720/* Read offset OFFSET of TARGET_OBJECT_LIBRARIES formatted shared libraries list from
721 core file into buffer READBUF with length LEN. */
722
723extern int gdbarch_core_xfer_shared_libraries_p (struct gdbarch *gdbarch);
724
725typedef LONGEST (gdbarch_core_xfer_shared_libraries_ftype) (struct gdbarch *gdbarch, gdb_byte *readbuf, ULONGEST offset, LONGEST len);
726extern LONGEST gdbarch_core_xfer_shared_libraries (struct gdbarch *gdbarch, gdb_byte *readbuf, ULONGEST offset, LONGEST len);
727extern void set_gdbarch_core_xfer_shared_libraries (struct gdbarch *gdbarch, gdbarch_core_xfer_shared_libraries_ftype *core_xfer_shared_libraries);
728
c0edd9ed 729/* How the core target converts a PTID from a core file to a string. */
28439f5e
PA
730
731extern int gdbarch_core_pid_to_str_p (struct gdbarch *gdbarch);
732
733typedef char * (gdbarch_core_pid_to_str_ftype) (struct gdbarch *gdbarch, ptid_t ptid);
734extern char * gdbarch_core_pid_to_str (struct gdbarch *gdbarch, ptid_t ptid);
735extern void set_gdbarch_core_pid_to_str (struct gdbarch *gdbarch, gdbarch_core_pid_to_str_ftype *core_pid_to_str);
736
a78c2d62
UW
737/* BFD target to use when generating a core file. */
738
739extern int gdbarch_gcore_bfd_target_p (struct gdbarch *gdbarch);
740
741extern const char * gdbarch_gcore_bfd_target (struct gdbarch *gdbarch);
742extern void set_gdbarch_gcore_bfd_target (struct gdbarch *gdbarch, const char * gcore_bfd_target);
743
0d5de010
DJ
744/* If the elements of C++ vtables are in-place function descriptors rather
745 than normal function pointers (which may point to code or a descriptor),
746 set this to one. */
747
748extern int gdbarch_vtable_function_descriptors (struct gdbarch *gdbarch);
749extern void set_gdbarch_vtable_function_descriptors (struct gdbarch *gdbarch, int vtable_function_descriptors);
750
751/* Set if the least significant bit of the delta is used instead of the least
752 significant bit of the pfn for pointers to virtual member functions. */
753
754extern int gdbarch_vbit_in_delta (struct gdbarch *gdbarch);
755extern void set_gdbarch_vbit_in_delta (struct gdbarch *gdbarch, int vbit_in_delta);
756
6d350bb5
UW
757/* Advance PC to next instruction in order to skip a permanent breakpoint. */
758
759extern int gdbarch_skip_permanent_breakpoint_p (struct gdbarch *gdbarch);
760
761typedef void (gdbarch_skip_permanent_breakpoint_ftype) (struct regcache *regcache);
762extern void gdbarch_skip_permanent_breakpoint (struct gdbarch *gdbarch, struct regcache *regcache);
763extern void set_gdbarch_skip_permanent_breakpoint (struct gdbarch *gdbarch, gdbarch_skip_permanent_breakpoint_ftype *skip_permanent_breakpoint);
764
1668ae25 765/* The maximum length of an instruction on this architecture in bytes. */
237fc4c9
PA
766
767extern int gdbarch_max_insn_length_p (struct gdbarch *gdbarch);
768
769extern ULONGEST gdbarch_max_insn_length (struct gdbarch *gdbarch);
770extern void set_gdbarch_max_insn_length (struct gdbarch *gdbarch, ULONGEST max_insn_length);
771
772/* Copy the instruction at FROM to TO, and make any adjustments
773 necessary to single-step it at that address.
774
775 REGS holds the state the thread's registers will have before
776 executing the copied instruction; the PC in REGS will refer to FROM,
777 not the copy at TO. The caller should update it to point at TO later.
778
779 Return a pointer to data of the architecture's choice to be passed
780 to gdbarch_displaced_step_fixup. Or, return NULL to indicate that
781 the instruction's effects have been completely simulated, with the
782 resulting state written back to REGS.
783
784 For a general explanation of displaced stepping and how GDB uses it,
785 see the comments in infrun.c.
786
787 The TO area is only guaranteed to have space for
788 gdbarch_max_insn_length (arch) bytes, so this function must not
789 write more bytes than that to that area.
790
791 If you do not provide this function, GDB assumes that the
792 architecture does not support displaced stepping.
793
794 If your architecture doesn't need to adjust instructions before
795 single-stepping them, consider using simple_displaced_step_copy_insn
796 here. */
797
798extern int gdbarch_displaced_step_copy_insn_p (struct gdbarch *gdbarch);
799
800typedef struct displaced_step_closure * (gdbarch_displaced_step_copy_insn_ftype) (struct gdbarch *gdbarch, CORE_ADDR from, CORE_ADDR to, struct regcache *regs);
801extern struct displaced_step_closure * gdbarch_displaced_step_copy_insn (struct gdbarch *gdbarch, CORE_ADDR from, CORE_ADDR to, struct regcache *regs);
802extern void set_gdbarch_displaced_step_copy_insn (struct gdbarch *gdbarch, gdbarch_displaced_step_copy_insn_ftype *displaced_step_copy_insn);
803
99e40580
UW
804/* Return true if GDB should use hardware single-stepping to execute
805 the displaced instruction identified by CLOSURE. If false,
806 GDB will simply restart execution at the displaced instruction
807 location, and it is up to the target to ensure GDB will receive
808 control again (e.g. by placing a software breakpoint instruction
809 into the displaced instruction buffer).
810
811 The default implementation returns false on all targets that
812 provide a gdbarch_software_single_step routine, and true otherwise. */
813
814typedef int (gdbarch_displaced_step_hw_singlestep_ftype) (struct gdbarch *gdbarch, struct displaced_step_closure *closure);
815extern int gdbarch_displaced_step_hw_singlestep (struct gdbarch *gdbarch, struct displaced_step_closure *closure);
816extern void set_gdbarch_displaced_step_hw_singlestep (struct gdbarch *gdbarch, gdbarch_displaced_step_hw_singlestep_ftype *displaced_step_hw_singlestep);
817
237fc4c9
PA
818/* Fix up the state resulting from successfully single-stepping a
819 displaced instruction, to give the result we would have gotten from
820 stepping the instruction in its original location.
821
822 REGS is the register state resulting from single-stepping the
823 displaced instruction.
824
825 CLOSURE is the result from the matching call to
826 gdbarch_displaced_step_copy_insn.
827
828 If you provide gdbarch_displaced_step_copy_insn.but not this
829 function, then GDB assumes that no fixup is needed after
830 single-stepping the instruction.
831
832 For a general explanation of displaced stepping and how GDB uses it,
833 see the comments in infrun.c. */
834
835extern int gdbarch_displaced_step_fixup_p (struct gdbarch *gdbarch);
836
837typedef void (gdbarch_displaced_step_fixup_ftype) (struct gdbarch *gdbarch, struct displaced_step_closure *closure, CORE_ADDR from, CORE_ADDR to, struct regcache *regs);
838extern void gdbarch_displaced_step_fixup (struct gdbarch *gdbarch, struct displaced_step_closure *closure, CORE_ADDR from, CORE_ADDR to, struct regcache *regs);
839extern void set_gdbarch_displaced_step_fixup (struct gdbarch *gdbarch, gdbarch_displaced_step_fixup_ftype *displaced_step_fixup);
840
841/* Free a closure returned by gdbarch_displaced_step_copy_insn.
842
843 If you provide gdbarch_displaced_step_copy_insn, you must provide
844 this function as well.
845
846 If your architecture uses closures that don't need to be freed, then
847 you can use simple_displaced_step_free_closure here.
848
849 For a general explanation of displaced stepping and how GDB uses it,
850 see the comments in infrun.c. */
851
852typedef void (gdbarch_displaced_step_free_closure_ftype) (struct gdbarch *gdbarch, struct displaced_step_closure *closure);
853extern void gdbarch_displaced_step_free_closure (struct gdbarch *gdbarch, struct displaced_step_closure *closure);
854extern void set_gdbarch_displaced_step_free_closure (struct gdbarch *gdbarch, gdbarch_displaced_step_free_closure_ftype *displaced_step_free_closure);
855
856/* Return the address of an appropriate place to put displaced
857 instructions while we step over them. There need only be one such
858 place, since we're only stepping one thread over a breakpoint at a
859 time.
860
861 For a general explanation of displaced stepping and how GDB uses it,
862 see the comments in infrun.c. */
863
864typedef CORE_ADDR (gdbarch_displaced_step_location_ftype) (struct gdbarch *gdbarch);
865extern CORE_ADDR gdbarch_displaced_step_location (struct gdbarch *gdbarch);
866extern void set_gdbarch_displaced_step_location (struct gdbarch *gdbarch, gdbarch_displaced_step_location_ftype *displaced_step_location);
867
dde08ee1
PA
868/* Relocate an instruction to execute at a different address. OLDLOC
869 is the address in the inferior memory where the instruction to
870 relocate is currently at. On input, TO points to the destination
871 where we want the instruction to be copied (and possibly adjusted)
872 to. On output, it points to one past the end of the resulting
873 instruction(s). The effect of executing the instruction at TO shall
874 be the same as if executing it at FROM. For example, call
875 instructions that implicitly push the return address on the stack
876 should be adjusted to return to the instruction after OLDLOC;
877 relative branches, and other PC-relative instructions need the
878 offset adjusted; etc. */
879
880extern int gdbarch_relocate_instruction_p (struct gdbarch *gdbarch);
881
882typedef void (gdbarch_relocate_instruction_ftype) (struct gdbarch *gdbarch, CORE_ADDR *to, CORE_ADDR from);
883extern void gdbarch_relocate_instruction (struct gdbarch *gdbarch, CORE_ADDR *to, CORE_ADDR from);
884extern void set_gdbarch_relocate_instruction (struct gdbarch *gdbarch, gdbarch_relocate_instruction_ftype *relocate_instruction);
885
1c772458
UW
886/* Refresh overlay mapped state for section OSECT. */
887
888extern int gdbarch_overlay_update_p (struct gdbarch *gdbarch);
889
890typedef void (gdbarch_overlay_update_ftype) (struct obj_section *osect);
891extern void gdbarch_overlay_update (struct gdbarch *gdbarch, struct obj_section *osect);
892extern void set_gdbarch_overlay_update (struct gdbarch *gdbarch, gdbarch_overlay_update_ftype *overlay_update);
893
4eb0ad19
DJ
894extern int gdbarch_core_read_description_p (struct gdbarch *gdbarch);
895
896typedef const struct target_desc * (gdbarch_core_read_description_ftype) (struct gdbarch *gdbarch, struct target_ops *target, bfd *abfd);
897extern const struct target_desc * gdbarch_core_read_description (struct gdbarch *gdbarch, struct target_ops *target, bfd *abfd);
898extern void set_gdbarch_core_read_description (struct gdbarch *gdbarch, gdbarch_core_read_description_ftype *core_read_description);
899
149ad273
UW
900/* Handle special encoding of static variables in stabs debug info. */
901
902extern int gdbarch_static_transform_name_p (struct gdbarch *gdbarch);
903
904typedef char * (gdbarch_static_transform_name_ftype) (char *name);
905extern char * gdbarch_static_transform_name (struct gdbarch *gdbarch, char *name);
906extern void set_gdbarch_static_transform_name (struct gdbarch *gdbarch, gdbarch_static_transform_name_ftype *static_transform_name);
907
203c3895
UW
908/* Set if the address in N_SO or N_FUN stabs may be zero. */
909
910extern int gdbarch_sofun_address_maybe_missing (struct gdbarch *gdbarch);
911extern void set_gdbarch_sofun_address_maybe_missing (struct gdbarch *gdbarch, int sofun_address_maybe_missing);
912
0508c3ec
HZ
913/* Parse the instruction at ADDR storing in the record execution log
914 the registers REGCACHE and memory ranges that will be affected when
915 the instruction executes, along with their current values.
916 Return -1 if something goes wrong, 0 otherwise. */
917
918extern int gdbarch_process_record_p (struct gdbarch *gdbarch);
919
920typedef int (gdbarch_process_record_ftype) (struct gdbarch *gdbarch, struct regcache *regcache, CORE_ADDR addr);
921extern int gdbarch_process_record (struct gdbarch *gdbarch, struct regcache *regcache, CORE_ADDR addr);
922extern void set_gdbarch_process_record (struct gdbarch *gdbarch, gdbarch_process_record_ftype *process_record);
3846b520
HZ
923
924/* Save process state after a signal.
925 Return -1 if something goes wrong, 0 otherwise. */
926
927extern int gdbarch_process_record_signal_p (struct gdbarch *gdbarch);
928
929typedef int (gdbarch_process_record_signal_ftype) (struct gdbarch *gdbarch, struct regcache *regcache, enum target_signal signal);
930extern int gdbarch_process_record_signal (struct gdbarch *gdbarch, struct regcache *regcache, enum target_signal signal);
931extern void set_gdbarch_process_record_signal (struct gdbarch *gdbarch, gdbarch_process_record_signal_ftype *process_record_signal);
0508c3ec 932
1cded358
AR
933/* Signal translation: translate inferior's signal (host's) number into
934 GDB's representation. */
935
936typedef enum target_signal (gdbarch_target_signal_from_host_ftype) (struct gdbarch *gdbarch, int signo);
937extern enum target_signal gdbarch_target_signal_from_host (struct gdbarch *gdbarch, int signo);
938extern void set_gdbarch_target_signal_from_host (struct gdbarch *gdbarch, gdbarch_target_signal_from_host_ftype *target_signal_from_host);
939
940/* Signal translation: translate GDB's signal number into inferior's host
941 signal number. */
942
943typedef int (gdbarch_target_signal_to_host_ftype) (struct gdbarch *gdbarch, enum target_signal ts);
944extern int gdbarch_target_signal_to_host (struct gdbarch *gdbarch, enum target_signal ts);
945extern void set_gdbarch_target_signal_to_host (struct gdbarch *gdbarch, gdbarch_target_signal_to_host_ftype *target_signal_to_host);
946
4aa995e1 947/* Extra signal info inspection.
959b8724 948
4aa995e1
PA
949 Return a type suitable to inspect extra signal information. */
950
951extern int gdbarch_get_siginfo_type_p (struct gdbarch *gdbarch);
952
953typedef struct type * (gdbarch_get_siginfo_type_ftype) (struct gdbarch *gdbarch);
954extern struct type * gdbarch_get_siginfo_type (struct gdbarch *gdbarch);
955extern void set_gdbarch_get_siginfo_type (struct gdbarch *gdbarch, gdbarch_get_siginfo_type_ftype *get_siginfo_type);
956
60c5725c
DJ
957/* Record architecture-specific information from the symbol table. */
958
959extern int gdbarch_record_special_symbol_p (struct gdbarch *gdbarch);
960
961typedef void (gdbarch_record_special_symbol_ftype) (struct gdbarch *gdbarch, struct objfile *objfile, asymbol *sym);
962extern void gdbarch_record_special_symbol (struct gdbarch *gdbarch, struct objfile *objfile, asymbol *sym);
963extern void set_gdbarch_record_special_symbol (struct gdbarch *gdbarch, gdbarch_record_special_symbol_ftype *record_special_symbol);
964
a96d9b2e
SDJ
965/* Function for the 'catch syscall' feature.
966 Get architecture-specific system calls information from registers. */
967
968extern int gdbarch_get_syscall_number_p (struct gdbarch *gdbarch);
969
970typedef LONGEST (gdbarch_get_syscall_number_ftype) (struct gdbarch *gdbarch, ptid_t ptid);
971extern LONGEST gdbarch_get_syscall_number (struct gdbarch *gdbarch, ptid_t ptid);
972extern void set_gdbarch_get_syscall_number (struct gdbarch *gdbarch, gdbarch_get_syscall_number_ftype *get_syscall_number);
973
50c71eaf 974/* True if the list of shared libraries is one and only for all
9bc9e927 975 processes, as opposed to a list of shared libraries per inferior.
2567c7d9
PA
976 This usually means that all processes, although may or may not share
977 an address space, will see the same set of symbols at the same
978 addresses. */
50c71eaf
PA
979
980extern int gdbarch_has_global_solist (struct gdbarch *gdbarch);
981extern void set_gdbarch_has_global_solist (struct gdbarch *gdbarch, int has_global_solist);
982
2567c7d9
PA
983/* On some targets, even though each inferior has its own private
984 address space, the debug interface takes care of making breakpoints
985 visible to all address spaces automatically. For such cases,
986 this property should be set to true. */
987
988extern int gdbarch_has_global_breakpoints (struct gdbarch *gdbarch);
989extern void set_gdbarch_has_global_breakpoints (struct gdbarch *gdbarch, int has_global_breakpoints);
990
6c95b8df
PA
991/* True if inferiors share an address space (e.g., uClinux). */
992
993typedef int (gdbarch_has_shared_address_space_ftype) (struct gdbarch *gdbarch);
994extern int gdbarch_has_shared_address_space (struct gdbarch *gdbarch);
995extern void set_gdbarch_has_shared_address_space (struct gdbarch *gdbarch, gdbarch_has_shared_address_space_ftype *has_shared_address_space);
996
7a697b8d
SS
997/* True if a fast tracepoint can be set at an address. */
998
999typedef int (gdbarch_fast_tracepoint_valid_at_ftype) (struct gdbarch *gdbarch, CORE_ADDR addr, int *isize, char **msg);
1000extern int gdbarch_fast_tracepoint_valid_at (struct gdbarch *gdbarch, CORE_ADDR addr, int *isize, char **msg);
1001extern void set_gdbarch_fast_tracepoint_valid_at (struct gdbarch *gdbarch, gdbarch_fast_tracepoint_valid_at_ftype *fast_tracepoint_valid_at);
1002
f870a310
TT
1003/* Return the "auto" target charset. */
1004
1005typedef const char * (gdbarch_auto_charset_ftype) (void);
1006extern const char * gdbarch_auto_charset (struct gdbarch *gdbarch);
1007extern void set_gdbarch_auto_charset (struct gdbarch *gdbarch, gdbarch_auto_charset_ftype *auto_charset);
1008
1009/* Return the "auto" target wide charset. */
1010
1011typedef const char * (gdbarch_auto_wide_charset_ftype) (void);
1012extern const char * gdbarch_auto_wide_charset (struct gdbarch *gdbarch);
1013extern void set_gdbarch_auto_wide_charset (struct gdbarch *gdbarch, gdbarch_auto_wide_charset_ftype *auto_wide_charset);
1014
08105857
PA
1015/* If non-empty, this is a file extension that will be opened in place
1016 of the file extension reported by the shared library list.
1017
1018 This is most useful for toolchains that use a post-linker tool,
1019 where the names of the files run on the target differ in extension
1020 compared to the names of the files GDB should load for debug info. */
1021
1022extern const char * gdbarch_solib_symbols_extension (struct gdbarch *gdbarch);
1023extern void set_gdbarch_solib_symbols_extension (struct gdbarch *gdbarch, const char * solib_symbols_extension);
1024
1412f70b
HZ
1025/* If true, the target OS has DOS-based file system semantics. That
1026 is, absolute paths include a drive name, and the backslash is
1027 considered a directory separator. */
ab38a727
PA
1028
1029extern int gdbarch_has_dos_based_file_system (struct gdbarch *gdbarch);
1030extern void set_gdbarch_has_dos_based_file_system (struct gdbarch *gdbarch, int has_dos_based_file_system);
1031
6710bf39
SS
1032/* Generate bytecodes to collect the return address in a frame.
1033 Since the bytecodes run on the target, possibly with GDB not even
1034 connected, the full unwinding machinery is not available, and
1035 typically this function will issue bytecodes for one or more likely
1036 places that the return address may be found. */
1037
1038typedef void (gdbarch_gen_return_address_ftype) (struct gdbarch *gdbarch, struct agent_expr *ax, struct axs_value *value, CORE_ADDR scope);
1039extern void gdbarch_gen_return_address (struct gdbarch *gdbarch, struct agent_expr *ax, struct axs_value *value, CORE_ADDR scope);
1040extern void set_gdbarch_gen_return_address (struct gdbarch *gdbarch, gdbarch_gen_return_address_ftype *gen_return_address);
1041
3030c96e
UW
1042/* Implement the "info proc" command. */
1043
1044extern int gdbarch_info_proc_p (struct gdbarch *gdbarch);
1045
1046typedef void (gdbarch_info_proc_ftype) (struct gdbarch *gdbarch, char *args, enum info_proc_what what);
1047extern void gdbarch_info_proc (struct gdbarch *gdbarch, char *args, enum info_proc_what what);
1048extern void set_gdbarch_info_proc (struct gdbarch *gdbarch, gdbarch_info_proc_ftype *info_proc);
1049
a96d9b2e
SDJ
1050/* Definition for an unknown syscall, used basically in error-cases. */
1051#define UNKNOWN_SYSCALL (-1)
1052
104c1213 1053extern struct gdbarch_tdep *gdbarch_tdep (struct gdbarch *gdbarch);
0f71a2f6
JM
1054
1055
1056/* Mechanism for co-ordinating the selection of a specific
1057 architecture.
1058
1059 GDB targets (*-tdep.c) can register an interest in a specific
1060 architecture. Other GDB components can register a need to maintain
1061 per-architecture data.
1062
1063 The mechanisms below ensures that there is only a loose connection
1064 between the set-architecture command and the various GDB
99e7bb18 1065 components. Each component can independently register their need
0f71a2f6
JM
1066 to maintain architecture specific data with gdbarch.
1067
1068 Pragmatics:
1069
1070 Previously, a single TARGET_ARCHITECTURE_HOOK was provided. It
1071 didn't scale.
1072
1073 The more traditional mega-struct containing architecture specific
1074 data for all the various GDB components was also considered. Since
99e7bb18 1075 GDB is built from a variable number of (fairly independent)
0f71a2f6 1076 components it was determined that the global aproach was not
0963b4bd 1077 applicable. */
0f71a2f6
JM
1078
1079
1080/* Register a new architectural family with GDB.
1081
1082 Register support for the specified ARCHITECTURE with GDB. When
1083 gdbarch determines that the specified architecture has been
1084 selected, the corresponding INIT function is called.
1085
1086 --
1087
1088 The INIT function takes two parameters: INFO which contains the
1089 information available to gdbarch about the (possibly new)
1090 architecture; ARCHES which is a list of the previously created
1091 ``struct gdbarch'' for this architecture.
1092
0f79675b 1093 The INFO parameter is, as far as possible, be pre-initialized with
7a107747 1094 information obtained from INFO.ABFD or the global defaults.
0f79675b
AC
1095
1096 The ARCHES parameter is a linked list (sorted most recently used)
1097 of all the previously created architures for this architecture
1098 family. The (possibly NULL) ARCHES->gdbarch can used to access
1099 values from the previously selected architecture for this
59837fe0 1100 architecture family.
0f71a2f6
JM
1101
1102 The INIT function shall return any of: NULL - indicating that it
ec3d358c 1103 doesn't recognize the selected architecture; an existing ``struct
0f71a2f6
JM
1104 gdbarch'' from the ARCHES list - indicating that the new
1105 architecture is just a synonym for an earlier architecture (see
1106 gdbarch_list_lookup_by_info()); a newly created ``struct gdbarch''
4b9b3959
AC
1107 - that describes the selected architecture (see gdbarch_alloc()).
1108
1109 The DUMP_TDEP function shall print out all target specific values.
1110 Care should be taken to ensure that the function works in both the
0963b4bd 1111 multi-arch and non- multi-arch cases. */
0f71a2f6 1112
adf40b2e
JM
1113struct gdbarch_list
1114{
1115 struct gdbarch *gdbarch;
1116 struct gdbarch_list *next;
1117};
0f71a2f6 1118
adf40b2e
JM
1119struct gdbarch_info
1120{
0963b4bd 1121 /* Use default: NULL (ZERO). */
adf40b2e 1122 const struct bfd_arch_info *bfd_arch_info;
0f71a2f6 1123
428721aa 1124 /* Use default: BFD_ENDIAN_UNKNOWN (NB: is not ZERO). */
adf40b2e 1125 int byte_order;
0f71a2f6 1126
9d4fde75
SS
1127 int byte_order_for_code;
1128
0963b4bd 1129 /* Use default: NULL (ZERO). */
adf40b2e 1130 bfd *abfd;
0f71a2f6 1131
0963b4bd 1132 /* Use default: NULL (ZERO). */
adf40b2e 1133 struct gdbarch_tdep_info *tdep_info;
4be87837
DJ
1134
1135 /* Use default: GDB_OSABI_UNINITIALIZED (-1). */
1136 enum gdb_osabi osabi;
424163ea
DJ
1137
1138 /* Use default: NULL (ZERO). */
1139 const struct target_desc *target_desc;
adf40b2e 1140};
0f71a2f6 1141
104c1213 1142typedef struct gdbarch *(gdbarch_init_ftype) (struct gdbarch_info info, struct gdbarch_list *arches);
4b9b3959 1143typedef void (gdbarch_dump_tdep_ftype) (struct gdbarch *gdbarch, struct ui_file *file);
0f71a2f6 1144
4b9b3959 1145/* DEPRECATED - use gdbarch_register() */
104c1213 1146extern void register_gdbarch_init (enum bfd_architecture architecture, gdbarch_init_ftype *);
0f71a2f6 1147
4b9b3959
AC
1148extern void gdbarch_register (enum bfd_architecture architecture,
1149 gdbarch_init_ftype *,
1150 gdbarch_dump_tdep_ftype *);
1151
0f71a2f6 1152
b4a20239
AC
1153/* Return a freshly allocated, NULL terminated, array of the valid
1154 architecture names. Since architectures are registered during the
1155 _initialize phase this function only returns useful information
0963b4bd 1156 once initialization has been completed. */
b4a20239
AC
1157
1158extern const char **gdbarch_printable_names (void);
1159
1160
0f71a2f6 1161/* Helper function. Search the list of ARCHES for a GDBARCH that
0963b4bd 1162 matches the information provided by INFO. */
0f71a2f6 1163
424163ea 1164extern struct gdbarch_list *gdbarch_list_lookup_by_info (struct gdbarch_list *arches, const struct gdbarch_info *info);
0f71a2f6
JM
1165
1166
1167/* Helper function. Create a preliminary ``struct gdbarch''. Perform
424163ea 1168 basic initialization using values obtained from the INFO and TDEP
0f71a2f6 1169 parameters. set_gdbarch_*() functions are called to complete the
0963b4bd 1170 initialization of the object. */
0f71a2f6 1171
104c1213 1172extern struct gdbarch *gdbarch_alloc (const struct gdbarch_info *info, struct gdbarch_tdep *tdep);
0f71a2f6
JM
1173
1174
4b9b3959
AC
1175/* Helper function. Free a partially-constructed ``struct gdbarch''.
1176 It is assumed that the caller freeds the ``struct
0963b4bd 1177 gdbarch_tdep''. */
4b9b3959 1178
058f20d5
JB
1179extern void gdbarch_free (struct gdbarch *);
1180
1181
aebd7893
AC
1182/* Helper function. Allocate memory from the ``struct gdbarch''
1183 obstack. The memory is freed when the corresponding architecture
1184 is also freed. */
1185
1186extern void *gdbarch_obstack_zalloc (struct gdbarch *gdbarch, long size);
1187#define GDBARCH_OBSTACK_CALLOC(GDBARCH, NR, TYPE) ((TYPE *) gdbarch_obstack_zalloc ((GDBARCH), (NR) * sizeof (TYPE)))
1188#define GDBARCH_OBSTACK_ZALLOC(GDBARCH, TYPE) ((TYPE *) gdbarch_obstack_zalloc ((GDBARCH), sizeof (TYPE)))
1189
1190
0963b4bd 1191/* Helper function. Force an update of the current architecture.
0f71a2f6 1192
b732d07d
AC
1193 The actual architecture selected is determined by INFO, ``(gdb) set
1194 architecture'' et.al., the existing architecture and BFD's default
1195 architecture. INFO should be initialized to zero and then selected
1196 fields should be updated.
0f71a2f6 1197
0963b4bd 1198 Returns non-zero if the update succeeds. */
16f33e29
AC
1199
1200extern int gdbarch_update_p (struct gdbarch_info info);
0f71a2f6
JM
1201
1202
ebdba546
AC
1203/* Helper function. Find an architecture matching info.
1204
1205 INFO should be initialized using gdbarch_info_init, relevant fields
1206 set, and then finished using gdbarch_info_fill.
1207
1208 Returns the corresponding architecture, or NULL if no matching
59837fe0 1209 architecture was found. */
ebdba546
AC
1210
1211extern struct gdbarch *gdbarch_find_by_info (struct gdbarch_info info);
1212
1213
59837fe0 1214/* Helper function. Set the global "target_gdbarch" to "gdbarch".
ebdba546
AC
1215
1216 FIXME: kettenis/20031124: Of the functions that follow, only
1217 gdbarch_from_bfd is supposed to survive. The others will
1218 dissappear since in the future GDB will (hopefully) be truly
1219 multi-arch. However, for now we're still stuck with the concept of
1220 a single active architecture. */
1221
59837fe0 1222extern void deprecated_target_gdbarch_select_hack (struct gdbarch *gdbarch);
ebdba546 1223
0f71a2f6
JM
1224
1225/* Register per-architecture data-pointer.
1226
1227 Reserve space for a per-architecture data-pointer. An identifier
1228 for the reserved data-pointer is returned. That identifer should
95160752 1229 be saved in a local static variable.
0f71a2f6 1230
fcc1c85c
AC
1231 Memory for the per-architecture data shall be allocated using
1232 gdbarch_obstack_zalloc. That memory will be deleted when the
1233 corresponding architecture object is deleted.
0f71a2f6 1234
95160752
AC
1235 When a previously created architecture is re-selected, the
1236 per-architecture data-pointer for that previous architecture is
76860b5f 1237 restored. INIT() is not re-called.
0f71a2f6
JM
1238
1239 Multiple registrarants for any architecture are allowed (and
1240 strongly encouraged). */
1241
95160752 1242struct gdbarch_data;
0f71a2f6 1243
030f20e1
AC
1244typedef void *(gdbarch_data_pre_init_ftype) (struct obstack *obstack);
1245extern struct gdbarch_data *gdbarch_data_register_pre_init (gdbarch_data_pre_init_ftype *init);
1246typedef void *(gdbarch_data_post_init_ftype) (struct gdbarch *gdbarch);
1247extern struct gdbarch_data *gdbarch_data_register_post_init (gdbarch_data_post_init_ftype *init);
1248extern void deprecated_set_gdbarch_data (struct gdbarch *gdbarch,
1249 struct gdbarch_data *data,
1250 void *pointer);
0f71a2f6 1251
451fbdda 1252extern void *gdbarch_data (struct gdbarch *gdbarch, struct gdbarch_data *);
0f71a2f6
JM
1253
1254
99e7bb18 1255/* Set the dynamic target-system-dependent parameters (architecture,
0963b4bd 1256 byte-order, ...) using information found in the BFD. */
c906108c 1257
104c1213 1258extern void set_gdbarch_from_file (bfd *);
c906108c
SS
1259
1260
e514a9d6
JM
1261/* Initialize the current architecture to the "first" one we find on
1262 our list. */
1263
1264extern void initialize_current_architecture (void);
1265
c906108c 1266/* gdbarch trace variable */
adf40b2e 1267extern int gdbarch_debug;
c906108c 1268
4b9b3959 1269extern void gdbarch_dump (struct gdbarch *gdbarch, struct ui_file *file);
0f71a2f6 1270
c906108c 1271#endif
This page took 1.034799 seconds and 4 git commands to generate.