* xtensa-modules.c: Remove comment indicating that this is a
[deliverable/binutils-gdb.git] / gdb / gdbarch.sh
CommitLineData
66b43ecb 1#!/bin/sh -u
104c1213
JM
2
3# Architecture commands for GDB, the GNU debugger.
1e698235 4# Copyright 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
104c1213
JM
5#
6# This file is part of GDB.
7#
8# This program is free software; you can redistribute it and/or modify
9# it under the terms of the GNU General Public License as published by
10# the Free Software Foundation; either version 2 of the License, or
11# (at your option) any later version.
12#
13# This program is distributed in the hope that it will be useful,
14# but WITHOUT ANY WARRANTY; without even the implied warranty of
15# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16# GNU General Public License for more details.
17#
18# You should have received a copy of the GNU General Public License
19# along with this program; if not, write to the Free Software
20# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21
d8864532
AC
22# Make certain that the script is running in an internationalized
23# environment.
24LANG=c ; export LANG
1bd316f0 25LC_ALL=c ; export LC_ALL
d8864532
AC
26
27
59233f88
AC
28compare_new ()
29{
30 file=$1
66b43ecb 31 if test ! -r ${file}
59233f88
AC
32 then
33 echo "${file} missing? cp new-${file} ${file}" 1>&2
50248794 34 elif diff -u ${file} new-${file}
59233f88
AC
35 then
36 echo "${file} unchanged" 1>&2
37 else
38 echo "${file} has changed? cp new-${file} ${file}" 1>&2
39 fi
40}
41
42
43# Format of the input table
0b8f9e4d 44read="class level macro returntype function formal actual attrib staticdefault predefault postdefault invalid_p fmt print print_p description"
c0e8c252
AC
45
46do_read ()
47{
34620563
AC
48 comment=""
49 class=""
50 while read line
51 do
52 if test "${line}" = ""
53 then
54 continue
55 elif test "${line}" = "#" -a "${comment}" = ""
f0d4cc9e 56 then
34620563
AC
57 continue
58 elif expr "${line}" : "#" > /dev/null
f0d4cc9e 59 then
34620563
AC
60 comment="${comment}
61${line}"
f0d4cc9e 62 else
3d9a5942
AC
63
64 # The semantics of IFS varies between different SH's. Some
65 # treat ``::' as three fields while some treat it as just too.
66 # Work around this by eliminating ``::'' ....
67 line="`echo "${line}" | sed -e 's/::/: :/g' -e 's/::/: :/g'`"
68
69 OFS="${IFS}" ; IFS="[:]"
34620563
AC
70 eval read ${read} <<EOF
71${line}
72EOF
73 IFS="${OFS}"
74
3d9a5942
AC
75 # .... and then going back through each field and strip out those
76 # that ended up with just that space character.
77 for r in ${read}
78 do
79 if eval test \"\${${r}}\" = \"\ \"
80 then
81 eval ${r}=""
82 fi
83 done
84
50248794
AC
85 case "${level}" in
86 1 ) gt_level=">= GDB_MULTI_ARCH_PARTIAL" ;;
87 2 ) gt_level="> GDB_MULTI_ARCH_PARTIAL" ;;
e669114a 88 "" ) gt_level="> GDB_MULTI_ARCH_PARTIAL" ;;
50248794
AC
89 * ) error "Error: bad level for ${function}" 1>&2 ; kill $$ ; exit 1 ;;
90 esac
91
a72293e2
AC
92 case "${class}" in
93 m ) staticdefault="${predefault}" ;;
94 M ) staticdefault="0" ;;
95 * ) test "${staticdefault}" || staticdefault=0 ;;
96 esac
34620563
AC
97 # NOT YET: Breaks BELIEVE_PCC_PROMOTION and confuses non-
98 # multi-arch defaults.
99 # test "${predefault}" || predefault=0
06b25f14
AC
100
101 # come up with a format, use a few guesses for variables
102 case ":${class}:${fmt}:${print}:" in
103 :[vV]::: )
104 if [ "${returntype}" = int ]
105 then
106 fmt="%d"
107 print="${macro}"
108 elif [ "${returntype}" = long ]
109 then
110 fmt="%ld"
111 print="${macro}"
112 fi
113 ;;
114 esac
34620563
AC
115 test "${fmt}" || fmt="%ld"
116 test "${print}" || print="(long) ${macro}"
06b25f14 117
ae45cd16
AC
118 case "${class}" in
119 F | V | M )
120 case "${invalid_p}" in
34620563 121 "" )
ae45cd16 122 if test -n "${predefault}" -a "${predefault}" != "0"
34620563
AC
123 then
124 #invalid_p="gdbarch->${function} == ${predefault}"
ae45cd16 125 predicate="gdbarch->${function} != ${predefault}"
34620563 126 else
ae45cd16
AC
127 # filled in later
128 predicate=""
34620563
AC
129 fi
130 ;;
ae45cd16 131 * )
1e9f55d0 132 echo "Predicate function ${function} with invalid_p." 1>&2
ae45cd16
AC
133 kill $$
134 exit 1
135 ;;
136 esac
34620563
AC
137 esac
138
139 # PREDEFAULT is a valid fallback definition of MEMBER when
140 # multi-arch is not enabled. This ensures that the
141 # default value, when multi-arch is the same as the
142 # default value when not multi-arch. POSTDEFAULT is
143 # always a valid definition of MEMBER as this again
144 # ensures consistency.
145
72e74a21 146 if [ -n "${postdefault}" ]
34620563
AC
147 then
148 fallbackdefault="${postdefault}"
72e74a21 149 elif [ -n "${predefault}" ]
34620563
AC
150 then
151 fallbackdefault="${predefault}"
152 else
73d3c16e 153 fallbackdefault="0"
34620563
AC
154 fi
155
156 #NOT YET: See gdbarch.log for basic verification of
157 # database
158
159 break
f0d4cc9e 160 fi
34620563 161 done
72e74a21 162 if [ -n "${class}" ]
34620563
AC
163 then
164 true
c0e8c252
AC
165 else
166 false
167 fi
168}
169
104c1213 170
f0d4cc9e
AC
171fallback_default_p ()
172{
72e74a21
JB
173 [ -n "${postdefault}" -a "x${invalid_p}" != "x0" ] \
174 || [ -n "${predefault}" -a "x${invalid_p}" = "x0" ]
f0d4cc9e
AC
175}
176
177class_is_variable_p ()
178{
4a5c6a1d
AC
179 case "${class}" in
180 *v* | *V* ) true ;;
181 * ) false ;;
182 esac
f0d4cc9e
AC
183}
184
185class_is_function_p ()
186{
4a5c6a1d
AC
187 case "${class}" in
188 *f* | *F* | *m* | *M* ) true ;;
189 * ) false ;;
190 esac
191}
192
193class_is_multiarch_p ()
194{
195 case "${class}" in
196 *m* | *M* ) true ;;
197 * ) false ;;
198 esac
f0d4cc9e
AC
199}
200
201class_is_predicate_p ()
202{
4a5c6a1d
AC
203 case "${class}" in
204 *F* | *V* | *M* ) true ;;
205 * ) false ;;
206 esac
f0d4cc9e
AC
207}
208
209class_is_info_p ()
210{
4a5c6a1d
AC
211 case "${class}" in
212 *i* ) true ;;
213 * ) false ;;
214 esac
f0d4cc9e
AC
215}
216
217
cff3e48b
JM
218# dump out/verify the doco
219for field in ${read}
220do
221 case ${field} in
222
223 class ) : ;;
c4093a6a 224
c0e8c252
AC
225 # # -> line disable
226 # f -> function
227 # hiding a function
2ada493a
AC
228 # F -> function + predicate
229 # hiding a function + predicate to test function validity
c0e8c252
AC
230 # v -> variable
231 # hiding a variable
2ada493a
AC
232 # V -> variable + predicate
233 # hiding a variable + predicate to test variables validity
c0e8c252
AC
234 # i -> set from info
235 # hiding something from the ``struct info'' object
4a5c6a1d
AC
236 # m -> multi-arch function
237 # hiding a multi-arch function (parameterised with the architecture)
238 # M -> multi-arch function + predicate
239 # hiding a multi-arch function + predicate to test function validity
cff3e48b
JM
240
241 level ) : ;;
242
c0e8c252
AC
243 # See GDB_MULTI_ARCH description. Having GDB_MULTI_ARCH >=
244 # LEVEL is a predicate on checking that a given method is
245 # initialized (using INVALID_P).
cff3e48b
JM
246
247 macro ) : ;;
248
c0e8c252 249 # The name of the MACRO that this method is to be accessed by.
cff3e48b
JM
250
251 returntype ) : ;;
252
c0e8c252 253 # For functions, the return type; for variables, the data type
cff3e48b
JM
254
255 function ) : ;;
256
c0e8c252
AC
257 # For functions, the member function name; for variables, the
258 # variable name. Member function names are always prefixed with
259 # ``gdbarch_'' for name-space purity.
cff3e48b
JM
260
261 formal ) : ;;
262
c0e8c252
AC
263 # The formal argument list. It is assumed that the formal
264 # argument list includes the actual name of each list element.
265 # A function with no arguments shall have ``void'' as the
266 # formal argument list.
cff3e48b
JM
267
268 actual ) : ;;
269
c0e8c252
AC
270 # The list of actual arguments. The arguments specified shall
271 # match the FORMAL list given above. Functions with out
272 # arguments leave this blank.
cff3e48b
JM
273
274 attrib ) : ;;
275
c0e8c252
AC
276 # Any GCC attributes that should be attached to the function
277 # declaration. At present this field is unused.
cff3e48b 278
0b8f9e4d 279 staticdefault ) : ;;
c0e8c252
AC
280
281 # To help with the GDB startup a static gdbarch object is
0b8f9e4d
AC
282 # created. STATICDEFAULT is the value to insert into that
283 # static gdbarch object. Since this a static object only
284 # simple expressions can be used.
cff3e48b 285
0b8f9e4d 286 # If STATICDEFAULT is empty, zero is used.
c0e8c252 287
0b8f9e4d 288 predefault ) : ;;
cff3e48b 289
10312cc4
AC
290 # An initial value to assign to MEMBER of the freshly
291 # malloc()ed gdbarch object. After initialization, the
292 # freshly malloc()ed object is passed to the target
293 # architecture code for further updates.
cff3e48b 294
0b8f9e4d
AC
295 # If PREDEFAULT is empty, zero is used.
296
10312cc4
AC
297 # A non-empty PREDEFAULT, an empty POSTDEFAULT and a zero
298 # INVALID_P are specified, PREDEFAULT will be used as the
299 # default for the non- multi-arch target.
300
301 # A zero PREDEFAULT function will force the fallback to call
302 # internal_error().
f0d4cc9e
AC
303
304 # Variable declarations can refer to ``gdbarch'' which will
305 # contain the current architecture. Care should be taken.
0b8f9e4d
AC
306
307 postdefault ) : ;;
308
309 # A value to assign to MEMBER of the new gdbarch object should
10312cc4
AC
310 # the target architecture code fail to change the PREDEFAULT
311 # value.
0b8f9e4d
AC
312
313 # If POSTDEFAULT is empty, no post update is performed.
314
315 # If both INVALID_P and POSTDEFAULT are non-empty then
316 # INVALID_P will be used to determine if MEMBER should be
317 # changed to POSTDEFAULT.
318
10312cc4
AC
319 # If a non-empty POSTDEFAULT and a zero INVALID_P are
320 # specified, POSTDEFAULT will be used as the default for the
321 # non- multi-arch target (regardless of the value of
322 # PREDEFAULT).
323
f0d4cc9e
AC
324 # You cannot specify both a zero INVALID_P and a POSTDEFAULT.
325
326 # Variable declarations can refer to ``gdbarch'' which will
327 # contain the current architecture. Care should be taken.
cff3e48b 328
c4093a6a 329 invalid_p ) : ;;
cff3e48b 330
0b8f9e4d 331 # A predicate equation that validates MEMBER. Non-zero is
c0e8c252 332 # returned if the code creating the new architecture failed to
0b8f9e4d
AC
333 # initialize MEMBER or the initialized the member is invalid.
334 # If POSTDEFAULT is non-empty then MEMBER will be updated to
335 # that value. If POSTDEFAULT is empty then internal_error()
336 # is called.
337
338 # If INVALID_P is empty, a check that MEMBER is no longer
339 # equal to PREDEFAULT is used.
340
f0d4cc9e
AC
341 # The expression ``0'' disables the INVALID_P check making
342 # PREDEFAULT a legitimate value.
0b8f9e4d
AC
343
344 # See also PREDEFAULT and POSTDEFAULT.
cff3e48b
JM
345
346 fmt ) : ;;
347
c0e8c252
AC
348 # printf style format string that can be used to print out the
349 # MEMBER. Sometimes "%s" is useful. For functions, this is
350 # ignored and the function address is printed.
351
0b8f9e4d 352 # If FMT is empty, ``%ld'' is used.
cff3e48b
JM
353
354 print ) : ;;
355
c0e8c252
AC
356 # An optional equation that casts MEMBER to a value suitable
357 # for formatting by FMT.
358
0b8f9e4d 359 # If PRINT is empty, ``(long)'' is used.
cff3e48b
JM
360
361 print_p ) : ;;
362
c0e8c252
AC
363 # An optional indicator for any predicte to wrap around the
364 # print member code.
365
4b9b3959 366 # () -> Call a custom function to do the dump.
c0e8c252
AC
367 # exp -> Wrap print up in ``if (${print_p}) ...
368 # ``'' -> No predicate
cff3e48b 369
0b8f9e4d
AC
370 # If PRINT_P is empty, ``1'' is always used.
371
cff3e48b
JM
372 description ) : ;;
373
0b8f9e4d 374 # Currently unused.
cff3e48b 375
50248794
AC
376 *)
377 echo "Bad field ${field}"
378 exit 1;;
cff3e48b
JM
379 esac
380done
381
cff3e48b 382
104c1213
JM
383function_list ()
384{
cff3e48b 385 # See below (DOCO) for description of each field
34620563 386 cat <<EOF
0b8f9e4d 387i:2:TARGET_ARCHITECTURE:const struct bfd_arch_info *:bfd_arch_info::::&bfd_default_arch_struct::::%s:TARGET_ARCHITECTURE->printable_name:TARGET_ARCHITECTURE != NULL
104c1213 388#
d7449b42 389i:2:TARGET_BYTE_ORDER:int:byte_order::::BFD_ENDIAN_BIG
4be87837
DJ
390#
391i:2:TARGET_OSABI:enum gdb_osabi:osabi::::GDB_OSABI_UNKNOWN
66b43ecb
AC
392# Number of bits in a char or unsigned char for the target machine.
393# Just like CHAR_BIT in <limits.h> but describes the target machine.
e669114a 394# v:2:TARGET_CHAR_BIT:int:char_bit::::8 * sizeof (char):8::0:
66b43ecb
AC
395#
396# Number of bits in a short or unsigned short for the target machine.
e669114a 397v:2:TARGET_SHORT_BIT:int:short_bit::::8 * sizeof (short):2*TARGET_CHAR_BIT::0
66b43ecb 398# Number of bits in an int or unsigned int for the target machine.
e669114a 399v:2:TARGET_INT_BIT:int:int_bit::::8 * sizeof (int):4*TARGET_CHAR_BIT::0
66b43ecb 400# Number of bits in a long or unsigned long for the target machine.
e669114a 401v:2:TARGET_LONG_BIT:int:long_bit::::8 * sizeof (long):4*TARGET_CHAR_BIT::0
66b43ecb
AC
402# Number of bits in a long long or unsigned long long for the target
403# machine.
e669114a 404v:2:TARGET_LONG_LONG_BIT:int:long_long_bit::::8 * sizeof (LONGEST):2*TARGET_LONG_BIT::0
66b43ecb 405# Number of bits in a float for the target machine.
e669114a 406v:2:TARGET_FLOAT_BIT:int:float_bit::::8 * sizeof (float):4*TARGET_CHAR_BIT::0
66b43ecb 407# Number of bits in a double for the target machine.
e669114a 408v:2:TARGET_DOUBLE_BIT:int:double_bit::::8 * sizeof (double):8*TARGET_CHAR_BIT::0
66b43ecb 409# Number of bits in a long double for the target machine.
e669114a 410v:2:TARGET_LONG_DOUBLE_BIT:int:long_double_bit::::8 * sizeof (long double):8*TARGET_CHAR_BIT::0
52204a0b
DT
411# For most targets, a pointer on the target and its representation as an
412# address in GDB have the same size and "look the same". For such a
413# target, you need only set TARGET_PTR_BIT / ptr_bit and TARGET_ADDR_BIT
414# / addr_bit will be set from it.
415#
416# If TARGET_PTR_BIT and TARGET_ADDR_BIT are different, you'll probably
417# also need to set POINTER_TO_ADDRESS and ADDRESS_TO_POINTER as well.
418#
419# ptr_bit is the size of a pointer on the target
e669114a 420v:2:TARGET_PTR_BIT:int:ptr_bit::::8 * sizeof (void*):TARGET_INT_BIT::0
52204a0b 421# addr_bit is the size of a target address as represented in gdb
e669114a 422v:2:TARGET_ADDR_BIT:int:addr_bit::::8 * sizeof (void*):0:TARGET_PTR_BIT:
66b43ecb 423# Number of bits in a BFD_VMA for the target object file format.
e669114a 424v:2:TARGET_BFD_VMA_BIT:int:bfd_vma_bit::::8 * sizeof (void*):TARGET_ARCHITECTURE->bits_per_address::0
104c1213 425#
4e409299 426# One if \`char' acts like \`signed char', zero if \`unsigned char'.
e669114a 427v:2:TARGET_CHAR_SIGNED:int:char_signed::::1:-1:1::::
4e409299 428#
e669114a
AC
429f:2:TARGET_READ_PC:CORE_ADDR:read_pc:ptid_t ptid:ptid::0:generic_target_read_pc::0
430f:2:TARGET_WRITE_PC:void:write_pc:CORE_ADDR val, ptid_t ptid:val, ptid::0:generic_target_write_pc::0
431f:2:TARGET_READ_FP:CORE_ADDR:read_fp:void:::0:generic_target_read_fp::0
432f:2:TARGET_READ_SP:CORE_ADDR:read_sp:void:::0:generic_target_read_sp::0
6c0e89ed
AC
433# The dummy call frame SP should be set by push_dummy_call.
434F:2:DEPRECATED_DUMMY_WRITE_SP:void:deprecated_dummy_write_sp:CORE_ADDR val:val
39d4ef09
AC
435# Function for getting target's idea of a frame pointer. FIXME: GDB's
436# whole scheme for dealing with "frames" and "frame pointers" needs a
437# serious shakedown.
e669114a 438f:2:TARGET_VIRTUAL_FRAME_POINTER:void:virtual_frame_pointer:CORE_ADDR pc, int *frame_regnum, LONGEST *frame_offset:pc, frame_regnum, frame_offset::0:legacy_virtual_frame_pointer::0
66b43ecb 439#
d8124050
AC
440M:::void:pseudo_register_read:struct regcache *regcache, int cookednum, void *buf:regcache, cookednum, buf:
441M:::void:pseudo_register_write:struct regcache *regcache, int cookednum, const void *buf:regcache, cookednum, buf:
61a0eb5b 442#
104c1213 443v:2:NUM_REGS:int:num_regs::::0:-1
0aba1244
EZ
444# This macro gives the number of pseudo-registers that live in the
445# register namespace but do not get fetched or stored on the target.
3d9a5942
AC
446# These pseudo-registers may be aliases for other registers,
447# combinations of other registers, or they may be computed by GDB.
0aba1244 448v:2:NUM_PSEUDO_REGS:int:num_pseudo_regs::::0:0::0:::
c2169756
AC
449
450# GDB's standard (or well known) register numbers. These can map onto
451# a real register or a pseudo (computed) register or not be defined at
1200cd6e
AC
452# all (-1).
453v:2:SP_REGNUM:int:sp_regnum::::-1:-1::0
454v:2:FP_REGNUM:int:fp_regnum::::-1:-1::0
455v:2:PC_REGNUM:int:pc_regnum::::-1:-1::0
c2169756 456v:2:PS_REGNUM:int:ps_regnum::::-1:-1::0
0b8f9e4d
AC
457v:2:FP0_REGNUM:int:fp0_regnum::::0:-1::0
458v:2:NPC_REGNUM:int:npc_regnum::::0:-1::0
88c72b7d
AC
459# Convert stab register number (from \`r\' declaration) to a gdb REGNUM.
460f:2:STAB_REG_TO_REGNUM:int:stab_reg_to_regnum:int stab_regnr:stab_regnr:::no_op_reg_to_regnum::0
461# Provide a default mapping from a ecoff register number to a gdb REGNUM.
462f:2:ECOFF_REG_TO_REGNUM:int:ecoff_reg_to_regnum:int ecoff_regnr:ecoff_regnr:::no_op_reg_to_regnum::0
463# Provide a default mapping from a DWARF register number to a gdb REGNUM.
464f:2:DWARF_REG_TO_REGNUM:int:dwarf_reg_to_regnum:int dwarf_regnr:dwarf_regnr:::no_op_reg_to_regnum::0
465# Convert from an sdb register number to an internal gdb register number.
466# This should be defined in tm.h, if REGISTER_NAMES is not set up
467# to map one to one onto the sdb register numbers.
468f:2:SDB_REG_TO_REGNUM:int:sdb_reg_to_regnum:int sdb_regnr:sdb_regnr:::no_op_reg_to_regnum::0
469f:2:DWARF2_REG_TO_REGNUM:int:dwarf2_reg_to_regnum:int dwarf2_regnr:dwarf2_regnr:::no_op_reg_to_regnum::0
fa88f677 470f:2:REGISTER_NAME:const char *:register_name:int regnr:regnr:::legacy_register_name::0
104c1213
JM
471v:2:REGISTER_SIZE:int:register_size::::0:-1
472v:2:REGISTER_BYTES:int:register_bytes::::0:-1
a7e3c2ad 473f:2:REGISTER_BYTE:int:register_byte:int reg_nr:reg_nr::generic_register_byte:generic_register_byte::0
35cac7cf
AC
474# The methods REGISTER_VIRTUAL_TYPE, MAX_REGISTER_RAW_SIZE,
475# MAX_REGISTER_VIRTUAL_SIZE, MAX_REGISTER_RAW_SIZE,
476# REGISTER_VIRTUAL_SIZE and REGISTER_RAW_SIZE are all being replaced
477# by REGISTER_TYPE.
b2e75d78 478f:2:REGISTER_RAW_SIZE:int:register_raw_size:int reg_nr:reg_nr::generic_register_size:generic_register_size::0
35cac7cf
AC
479# The methods REGISTER_VIRTUAL_TYPE, MAX_REGISTER_RAW_SIZE,
480# MAX_REGISTER_VIRTUAL_SIZE, MAX_REGISTER_RAW_SIZE,
481# REGISTER_VIRTUAL_SIZE and REGISTER_RAW_SIZE are all being replaced
482# by REGISTER_TYPE.
a0ed5532 483V:2:DEPRECATED_MAX_REGISTER_RAW_SIZE:int:deprecated_max_register_raw_size
35cac7cf
AC
484# The methods REGISTER_VIRTUAL_TYPE, MAX_REGISTER_RAW_SIZE,
485# MAX_REGISTER_VIRTUAL_SIZE, MAX_REGISTER_RAW_SIZE,
486# REGISTER_VIRTUAL_SIZE and REGISTER_RAW_SIZE are all being replaced
487# by REGISTER_TYPE.
b2e75d78 488f:2:REGISTER_VIRTUAL_SIZE:int:register_virtual_size:int reg_nr:reg_nr::generic_register_size:generic_register_size::0
35cac7cf
AC
489# The methods REGISTER_VIRTUAL_TYPE, MAX_REGISTER_RAW_SIZE,
490# MAX_REGISTER_VIRTUAL_SIZE, MAX_REGISTER_RAW_SIZE,
491# REGISTER_VIRTUAL_SIZE and REGISTER_RAW_SIZE are all being replaced
492# by REGISTER_TYPE.
a0ed5532 493V:2:DEPRECATED_MAX_REGISTER_VIRTUAL_SIZE:int:deprecated_max_register_virtual_size
35cac7cf
AC
494# The methods REGISTER_VIRTUAL_TYPE, MAX_REGISTER_RAW_SIZE,
495# MAX_REGISTER_VIRTUAL_SIZE, MAX_REGISTER_RAW_SIZE,
496# REGISTER_VIRTUAL_SIZE and REGISTER_RAW_SIZE have all being replaced
497# by REGISTER_TYPE.
498F:2:REGISTER_VIRTUAL_TYPE:struct type *:register_virtual_type:int reg_nr:reg_nr::0:0
499M:2:REGISTER_TYPE:struct type *:register_type:int reg_nr:reg_nr::0:
0ab7a791 500#
903ad3a6 501F:2:DEPRECATED_DO_REGISTERS_INFO:void:deprecated_do_registers_info:int reg_nr, int fpregs:reg_nr, fpregs
0ab7a791 502m:2:PRINT_REGISTERS_INFO:void:print_registers_info:struct ui_file *file, struct frame_info *frame, int regnum, int all:file, frame, regnum, all:::default_print_registers_info::0
23e3a7ac 503M:2:PRINT_FLOAT_INFO:void:print_float_info:struct ui_file *file, struct frame_info *frame, const char *args:file, frame, args
e76f1f2e 504M:2:PRINT_VECTOR_INFO:void:print_vector_info:struct ui_file *file, struct frame_info *frame, const char *args:file, frame, args
7c7651b2
AC
505# MAP a GDB RAW register number onto a simulator register number. See
506# also include/...-sim.h.
8238d0bf 507f:2:REGISTER_SIM_REGNO:int:register_sim_regno:int reg_nr:reg_nr:::legacy_register_sim_regno::0
2649061d 508F:2:REGISTER_BYTES_OK:int:register_bytes_ok:long nr_bytes:nr_bytes::0:0
01fb7433
AC
509f:2:CANNOT_FETCH_REGISTER:int:cannot_fetch_register:int regnum:regnum:::cannot_register_not::0
510f:2:CANNOT_STORE_REGISTER:int:cannot_store_register:int regnum:regnum:::cannot_register_not::0
9df628e0
RE
511# setjmp/longjmp support.
512F:2:GET_LONGJMP_TARGET:int:get_longjmp_target:CORE_ADDR *pc:pc::0:0
104c1213 513#
028c194b
AC
514# Non multi-arch DUMMY_FRAMES are a mess (multi-arch ones are not that
515# much better but at least they are vaguely consistent). The headers
516# and body contain convoluted #if/#else sequences for determine how
517# things should be compiled. Instead of trying to mimic that
518# behaviour here (and hence entrench it further) gdbarch simply
519# reqires that these methods be set up from the word go. This also
520# avoids any potential problems with moving beyond multi-arch partial.
07555a72 521v:1:DEPRECATED_USE_GENERIC_DUMMY_FRAMES:int:deprecated_use_generic_dummy_frames:::::1::0
b99fa2d2 522v:1:CALL_DUMMY_LOCATION:int:call_dummy_location:::::AT_ENTRY_POINT::0
e9a2674e 523f::CALL_DUMMY_ADDRESS:CORE_ADDR:call_dummy_address:void::::entry_point_address::0
3d30e9c2 524v::CALL_DUMMY_START_OFFSET:CORE_ADDR:call_dummy_start_offset
73dd234f 525v::CALL_DUMMY_BREAKPOINT_OFFSET:CORE_ADDR:call_dummy_breakpoint_offset
3d30e9c2 526v::CALL_DUMMY_LENGTH:int:call_dummy_length
ae45cd16
AC
527# NOTE: cagney/2002-11-24: This function with predicate has a valid
528# (callable) initial value. As a consequence, even when the predicate
529# is false, the corresponding function works. This simplifies the
530# migration process - old code, calling DEPRECATED_PC_IN_CALL_DUMMY(),
531# doesn't need to be modified.
532F:1:DEPRECATED_PC_IN_CALL_DUMMY:int:deprecated_pc_in_call_dummy:CORE_ADDR pc, CORE_ADDR sp, CORE_ADDR frame_address:pc, sp, frame_address::generic_pc_in_call_dummy:generic_pc_in_call_dummy
4d628cd7
AC
533v::CALL_DUMMY_WORDS:LONGEST *:call_dummy_words::::0:legacy_call_dummy_words::0:0x%08lx
534v::SIZEOF_CALL_DUMMY_WORDS:int:sizeof_call_dummy_words::::0:legacy_sizeof_call_dummy_words::0
1bf6d5cc 535V:2:DEPRECATED_CALL_DUMMY_STACK_ADJUST:int:deprecated_call_dummy_stack_adjust::::0
e8ab51f7 536F::FIX_CALL_DUMMY:void:fix_call_dummy:char *dummy, CORE_ADDR pc, CORE_ADDR fun, int nargs, struct value **args, struct type *type, int gcc_p:dummy, pc, fun, nargs, args, type, gcc_p
97f46953 537F:2:DEPRECATED_INIT_FRAME_PC_FIRST:CORE_ADDR:deprecated_init_frame_pc_first:int fromleaf, struct frame_info *prev:fromleaf, prev
e669114a 538F:2:DEPRECATED_INIT_FRAME_PC:CORE_ADDR:deprecated_init_frame_pc:int fromleaf, struct frame_info *prev:fromleaf, prev
104c1213 539#
f0d4cc9e 540v:2:BELIEVE_PCC_PROMOTION:int:believe_pcc_promotion:::::::
e669114a 541v::BELIEVE_PCC_PROMOTION_TYPE:int:believe_pcc_promotion_type:::::::
129c1cd6 542F:2:DEPRECATED_GET_SAVED_REGISTER:void:deprecated_get_saved_register:char *raw_buffer, int *optimized, CORE_ADDR *addrp, struct frame_info *frame, int regnum, enum lval_type *lval:raw_buffer, optimized, addrp, frame, regnum, lval
104c1213 543#
6e6d6484 544f:2:REGISTER_CONVERTIBLE:int:register_convertible:int nr:nr:::generic_register_convertible_not::0
0b8f9e4d
AC
545f:2:REGISTER_CONVERT_TO_VIRTUAL:void:register_convert_to_virtual:int regnum, struct type *type, char *from, char *to:regnum, type, from, to:::0::0
546f:2:REGISTER_CONVERT_TO_RAW:void:register_convert_to_raw:struct type *type, int regnum, char *from, char *to:type, regnum, from, to:::0::0
13d01224
AC
547#
548f:1:CONVERT_REGISTER_P:int:convert_register_p:int regnum:regnum::0:legacy_convert_register_p::0
549f:1:REGISTER_TO_VALUE:void:register_to_value:int regnum, struct type *type, char *from, char *to:regnum, type, from, to::0:legacy_register_to_value::0
550f:1:VALUE_TO_REGISTER:void:value_to_register:struct type *type, int regnum, char *from, char *to:type, regnum, from, to::0:legacy_value_to_register::0
104c1213 551#
66140c26 552f:2:POINTER_TO_ADDRESS:CORE_ADDR:pointer_to_address:struct type *type, const void *buf:type, buf:::unsigned_pointer_to_address::0
ac2e2ef7 553f:2:ADDRESS_TO_POINTER:void:address_to_pointer:struct type *type, void *buf, CORE_ADDR addr:type, buf, addr:::unsigned_address_to_pointer::0
fc0c74b1 554F:2:INTEGER_TO_ADDRESS:CORE_ADDR:integer_to_address:struct type *type, void *buf:type, buf
4478b372 555#
0b8f9e4d 556f:2:RETURN_VALUE_ON_STACK:int:return_value_on_stack:struct type *type:type:::generic_return_value_on_stack_not::0
b81774d8
AC
557# Replaced by PUSH_DUMMY_CALL
558F:2:DEPRECATED_PUSH_ARGUMENTS:CORE_ADDR:deprecated_push_arguments:int nargs, struct value **args, CORE_ADDR sp, int struct_return, CORE_ADDR struct_addr:nargs, args, sp, struct_return, struct_addr
559M::PUSH_DUMMY_CALL:CORE_ADDR:push_dummy_call:struct regcache *regcache, CORE_ADDR dummy_addr, int nargs, struct value **args, CORE_ADDR sp, int struct_return, CORE_ADDR struct_addr:regcache, dummy_addr, nargs, args, sp, struct_return, struct_addr
f3824013 560F:2:DEPRECATED_PUSH_DUMMY_FRAME:void:deprecated_push_dummy_frame:void:-:::0
28f617b3
AC
561# NOTE: This can be handled directly in push_dummy_call.
562F:2:DEPRECATED_PUSH_RETURN_ADDRESS:CORE_ADDR:deprecated_push_return_address:CORE_ADDR pc, CORE_ADDR sp:pc, sp:::0
749b82f6 563F:2:DEPRECATED_POP_FRAME:void:deprecated_pop_frame:void:-:::0
4183d812
AC
564# NOTE: cagney/2003-03-24: Replaced by PUSH_ARGUMENTS.
565F:2:DEPRECATED_STORE_STRUCT_RETURN:void:deprecated_store_struct_return:CORE_ADDR addr, CORE_ADDR sp:addr, sp:::0
ebba8386 566#
e669114a
AC
567f:2:EXTRACT_RETURN_VALUE:void:extract_return_value:struct type *type, struct regcache *regcache, void *valbuf:type, regcache, valbuf:::legacy_extract_return_value::0
568f:2:STORE_RETURN_VALUE:void:store_return_value:struct type *type, struct regcache *regcache, const void *valbuf:type, regcache, valbuf:::legacy_store_return_value::0
569f:2:DEPRECATED_EXTRACT_RETURN_VALUE:void:deprecated_extract_return_value:struct type *type, char *regbuf, char *valbuf:type, regbuf, valbuf
570f:2:DEPRECATED_STORE_RETURN_VALUE:void:deprecated_store_return_value:struct type *type, char *valbuf:type, valbuf
ebba8386 571#
049ee0e4 572F:2:EXTRACT_STRUCT_VALUE_ADDRESS:CORE_ADDR:extract_struct_value_address:struct regcache *regcache:regcache:::0
26e9b323 573F:2:DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS:CORE_ADDR:deprecated_extract_struct_value_address:char *regbuf:regbuf:::0
56f12751 574f:2:USE_STRUCT_CONVENTION:int:use_struct_convention:int gcc_p, struct type *value_type:gcc_p, value_type:::generic_use_struct_convention::0
104c1213 575#
f30ee0bc 576F:2:DEPRECATED_FRAME_INIT_SAVED_REGS:void:deprecated_frame_init_saved_regs:struct frame_info *frame:frame:::0
e9582e71 577F:2:DEPRECATED_INIT_EXTRA_FRAME_INFO:void:deprecated_init_extra_frame_info:int fromleaf, struct frame_info *frame:fromleaf, frame:::0
104c1213
JM
578#
579f:2:SKIP_PROLOGUE:CORE_ADDR:skip_prologue:CORE_ADDR ip:ip::0:0
0b8f9e4d 580f:2:PROLOGUE_FRAMELESS_P:int:prologue_frameless_p:CORE_ADDR ip:ip::0:generic_prologue_frameless_p::0
104c1213 581f:2:INNER_THAN:int:inner_than:CORE_ADDR lhs, CORE_ADDR rhs:lhs, rhs::0:0
f4f9705a 582f:2:BREAKPOINT_FROM_PC:const unsigned char *:breakpoint_from_pc:CORE_ADDR *pcptr, int *lenptr:pcptr, lenptr:::legacy_breakpoint_from_pc::0
0b8f9e4d
AC
583f:2:MEMORY_INSERT_BREAKPOINT:int:memory_insert_breakpoint:CORE_ADDR addr, char *contents_cache:addr, contents_cache::0:default_memory_insert_breakpoint::0
584f:2:MEMORY_REMOVE_BREAKPOINT:int:memory_remove_breakpoint:CORE_ADDR addr, char *contents_cache:addr, contents_cache::0:default_memory_remove_breakpoint::0
104c1213 585v:2:DECR_PC_AFTER_BREAK:CORE_ADDR:decr_pc_after_break::::0:-1
e669114a 586f:2:PREPARE_TO_PROCEED:int:prepare_to_proceed:int select_it:select_it::0:default_prepare_to_proceed::0
104c1213
JM
587v:2:FUNCTION_START_OFFSET:CORE_ADDR:function_start_offset::::0:-1
588#
0b8f9e4d 589f:2:REMOTE_TRANSLATE_XFER_ADDRESS:void:remote_translate_xfer_address:CORE_ADDR gdb_addr, int gdb_len, CORE_ADDR *rem_addr, int *rem_len:gdb_addr, gdb_len, rem_addr, rem_len:::generic_remote_translate_xfer_address::0
104c1213
JM
590#
591v:2:FRAME_ARGS_SKIP:CORE_ADDR:frame_args_skip::::0:-1
0b8f9e4d 592f:2:FRAMELESS_FUNCTION_INVOCATION:int:frameless_function_invocation:struct frame_info *fi:fi:::generic_frameless_function_invocation_not::0
618ce49f
AC
593F:2:DEPRECATED_FRAME_CHAIN:CORE_ADDR:deprecated_frame_chain:struct frame_info *frame:frame::0:0
594F:2:DEPRECATED_FRAME_CHAIN_VALID:int:deprecated_frame_chain_valid:CORE_ADDR chain, struct frame_info *thisframe:chain, thisframe::0:0
8bedc050
AC
595# DEPRECATED_FRAME_SAVED_PC has been replaced by UNWIND_PC. Please
596# note, per UNWIND_PC's doco, that while the two have similar
597# interfaces they have very different underlying implementations.
598F:2:DEPRECATED_FRAME_SAVED_PC:CORE_ADDR:deprecated_frame_saved_pc:struct frame_info *fi:fi::0:0
12cc2063 599M::UNWIND_PC:CORE_ADDR:unwind_pc:struct frame_info *next_frame:next_frame:
7d6a26a7
AC
600f:2:FRAME_ARGS_ADDRESS:CORE_ADDR:frame_args_address:struct frame_info *fi:fi::0:get_frame_base::0
601f:2:FRAME_LOCALS_ADDRESS:CORE_ADDR:frame_locals_address:struct frame_info *fi:fi::0:get_frame_base::0
104c1213
JM
602f:2:SAVED_PC_AFTER_CALL:CORE_ADDR:saved_pc_after_call:struct frame_info *frame:frame::0:0
603f:2:FRAME_NUM_ARGS:int:frame_num_args:struct frame_info *frame:frame::0:0
604#
2ada493a 605F:2:STACK_ALIGN:CORE_ADDR:stack_align:CORE_ADDR sp:sp::0:0
dc604539 606M:::CORE_ADDR:frame_align:CORE_ADDR address:address
f933a9c5
AC
607# NOTE: cagney/2003-03-24: This is better handled by PUSH_ARGUMENTS.
608v:2:DEPRECATED_EXTRA_STACK_ALIGNMENT_NEEDED:int:deprecated_extra_stack_alignment_needed::::0:0::0:::
d03e67c9 609F:2:REG_STRUCT_HAS_ADDR:int:reg_struct_has_addr:int gcc_p, struct type *type:gcc_p, type::0:0
08f3424b
MK
610# FIXME: kettenis/2003-03-08: This should be replaced by a function
611# parametrized with (at least) the regcache.
d1e3cf49 612F:2:SAVE_DUMMY_FRAME_TOS:void:save_dummy_frame_tos:CORE_ADDR sp:sp::0:0
6314f104 613M::UNWIND_DUMMY_ID:struct frame_id:unwind_dummy_id:struct frame_info *info:info::0:0
58d5518e 614v:2:PARM_BOUNDARY:int:parm_boundary
f0d4cc9e 615#
52f87c51
AC
616v:2:TARGET_FLOAT_FORMAT:const struct floatformat *:float_format::::::default_float_format (gdbarch)::%s:(TARGET_FLOAT_FORMAT)->name
617v:2:TARGET_DOUBLE_FORMAT:const struct floatformat *:double_format::::::default_double_format (gdbarch)::%s:(TARGET_DOUBLE_FORMAT)->name
618v:2:TARGET_LONG_DOUBLE_FORMAT:const struct floatformat *:long_double_format::::::default_double_format (gdbarch)::%s:(TARGET_LONG_DOUBLE_FORMAT)->name
875e1767
AC
619f:2:CONVERT_FROM_FUNC_PTR_ADDR:CORE_ADDR:convert_from_func_ptr_addr:CORE_ADDR addr:addr:::core_addr_identity::0
620# On some machines there are bits in addresses which are not really
621# part of the address, but are used by the kernel, the hardware, etc.
622# for special purposes. ADDR_BITS_REMOVE takes out any such bits so
623# we get a "real" address such as one would find in a symbol table.
624# This is used only for addresses of instructions, and even then I'm
625# not sure it's used in all contexts. It exists to deal with there
626# being a few stray bits in the PC which would mislead us, not as some
627# sort of generic thing to handle alignment or segmentation (it's
628# possible it should be in TARGET_READ_PC instead).
629f:2:ADDR_BITS_REMOVE:CORE_ADDR:addr_bits_remove:CORE_ADDR addr:addr:::core_addr_identity::0
181c1381
RE
630# It is not at all clear why SMASH_TEXT_ADDRESS is not folded into
631# ADDR_BITS_REMOVE.
632f:2:SMASH_TEXT_ADDRESS:CORE_ADDR:smash_text_address:CORE_ADDR addr:addr:::core_addr_identity::0
64c4637f
AC
633# FIXME/cagney/2001-01-18: This should be split in two. A target method that indicates if
634# the target needs software single step. An ISA method to implement it.
635#
636# FIXME/cagney/2001-01-18: This should be replaced with something that inserts breakpoints
637# using the breakpoint system instead of blatting memory directly (as with rs6000).
638#
639# FIXME/cagney/2001-01-18: The logic is backwards. It should be asking if the target can
640# single step. If not, then implement single step using breakpoints.
641F:2:SOFTWARE_SINGLE_STEP:void:software_single_step:enum target_signal sig, int insert_breakpoints_p:sig, insert_breakpoints_p::0:0
2bf0cb65 642f:2:TARGET_PRINT_INSN:int:print_insn:bfd_vma vma, disassemble_info *info:vma, info:::legacy_print_insn::0
bdcd319a 643f:2:SKIP_TRAMPOLINE_CODE:CORE_ADDR:skip_trampoline_code:CORE_ADDR pc:pc:::generic_skip_trampoline_code::0
d50355b6
MS
644
645
68e9cc94
CV
646# For SVR4 shared libraries, each call goes through a small piece of
647# trampoline code in the ".plt" section. IN_SOLIB_CALL_TRAMPOLINE evaluates
d50355b6 648# to nonzero if we are currently stopped in one of these.
68e9cc94 649f:2:IN_SOLIB_CALL_TRAMPOLINE:int:in_solib_call_trampoline:CORE_ADDR pc, char *name:pc, name:::generic_in_solib_call_trampoline::0
d50355b6
MS
650
651# Some systems also have trampoline code for returning from shared libs.
652f:2:IN_SOLIB_RETURN_TRAMPOLINE:int:in_solib_return_trampoline:CORE_ADDR pc, char *name:pc, name:::generic_in_solib_return_trampoline::0
653
d7bd68ca
AC
654# Sigtramp is a routine that the kernel calls (which then calls the
655# signal handler). On most machines it is a library routine that is
656# linked into the executable.
657#
658# This macro, given a program counter value and the name of the
659# function in which that PC resides (which can be null if the name is
660# not known), returns nonzero if the PC and name show that we are in
661# sigtramp.
662#
663# On most machines just see if the name is sigtramp (and if we have
664# no name, assume we are not in sigtramp).
665#
666# FIXME: cagney/2002-04-21: The function find_pc_partial_function
667# calls find_pc_sect_partial_function() which calls PC_IN_SIGTRAMP.
668# This means PC_IN_SIGTRAMP function can't be implemented by doing its
669# own local NAME lookup.
670#
671# FIXME: cagney/2002-04-21: PC_IN_SIGTRAMP is something of a mess.
672# Some code also depends on SIGTRAMP_START and SIGTRAMP_END but other
673# does not.
674f:2:PC_IN_SIGTRAMP:int:pc_in_sigtramp:CORE_ADDR pc, char *name:pc, name:::legacy_pc_in_sigtramp::0
43156d82 675F:2:SIGTRAMP_START:CORE_ADDR:sigtramp_start:CORE_ADDR pc:pc
e669114a 676F:2:SIGTRAMP_END:CORE_ADDR:sigtramp_end:CORE_ADDR pc:pc
c12260ac
CV
677# A target might have problems with watchpoints as soon as the stack
678# frame of the current function has been destroyed. This mostly happens
679# as the first action in a funtion's epilogue. in_function_epilogue_p()
680# is defined to return a non-zero value if either the given addr is one
681# instruction after the stack destroying instruction up to the trailing
682# return instruction or if we can figure out that the stack frame has
683# already been invalidated regardless of the value of addr. Targets
684# which don't suffer from that problem could just let this functionality
685# untouched.
686m:::int:in_function_epilogue_p:CORE_ADDR addr:addr::0:generic_in_function_epilogue_p::0
552c04a7
TT
687# Given a vector of command-line arguments, return a newly allocated
688# string which, when passed to the create_inferior function, will be
689# parsed (on Unix systems, by the shell) to yield the same vector.
690# This function should call error() if the argument vector is not
691# representable for this target or if this target does not support
692# command-line arguments.
693# ARGC is the number of elements in the vector.
694# ARGV is an array of strings, one per argument.
695m::CONSTRUCT_INFERIOR_ARGUMENTS:char *:construct_inferior_arguments:int argc, char **argv:argc, argv:::construct_inferior_arguments::0
b6af0555 696F:2:DWARF2_BUILD_FRAME_INFO:void:dwarf2_build_frame_info:struct objfile *objfile:objfile:::0
a2cf933a
EZ
697f:2:ELF_MAKE_MSYMBOL_SPECIAL:void:elf_make_msymbol_special:asymbol *sym, struct minimal_symbol *msym:sym, msym:::default_elf_make_msymbol_special::0
698f:2:COFF_MAKE_MSYMBOL_SPECIAL:void:coff_make_msymbol_special:int val, struct minimal_symbol *msym:val, msym:::default_coff_make_msymbol_special::0
e669114a
AC
699v:2:NAME_OF_MALLOC:const char *:name_of_malloc::::"malloc":"malloc"::0:%s:NAME_OF_MALLOC
700v:2:CANNOT_STEP_BREAKPOINT:int:cannot_step_breakpoint::::0:0::0
701v:2:HAVE_NONSTEPPABLE_WATCHPOINT:int:have_nonsteppable_watchpoint::::0:0::0
8b2dbe47 702F:2:ADDRESS_CLASS_TYPE_FLAGS:int:address_class_type_flags:int byte_size, int dwarf2_addr_class:byte_size, dwarf2_addr_class
321432c0
KB
703M:2:ADDRESS_CLASS_TYPE_FLAGS_TO_NAME:const char *:address_class_type_flags_to_name:int type_flags:type_flags:
704M:2:ADDRESS_CLASS_NAME_TO_TYPE_FLAGS:int:address_class_name_to_type_flags:const char *name, int *type_flags_ptr:name, type_flags_ptr
b59ff9d5 705# Is a register in a group
7e20f3fb 706m:::int:register_reggroup_p:int regnum, struct reggroup *reggroup:regnum, reggroup:::default_register_reggroup_p::0
104c1213 707EOF
104c1213
JM
708}
709
0b8f9e4d
AC
710#
711# The .log file
712#
713exec > new-gdbarch.log
34620563 714function_list | while do_read
0b8f9e4d
AC
715do
716 cat <<EOF
104c1213
JM
717${class} ${macro}(${actual})
718 ${returntype} ${function} ($formal)${attrib}
104c1213 719EOF
3d9a5942
AC
720 for r in ${read}
721 do
722 eval echo \"\ \ \ \ ${r}=\${${r}}\"
723 done
f0d4cc9e 724 if class_is_predicate_p && fallback_default_p
0b8f9e4d 725 then
66b43ecb 726 echo "Error: predicate function ${macro} can not have a non- multi-arch default" 1>&2
0b8f9e4d
AC
727 kill $$
728 exit 1
729 fi
72e74a21 730 if [ "x${invalid_p}" = "x0" -a -n "${postdefault}" ]
f0d4cc9e
AC
731 then
732 echo "Error: postdefault is useless when invalid_p=0" 1>&2
733 kill $$
734 exit 1
735 fi
a72293e2
AC
736 if class_is_multiarch_p
737 then
738 if class_is_predicate_p ; then :
739 elif test "x${predefault}" = "x"
740 then
741 echo "Error: pure multi-arch function must have a predefault" 1>&2
742 kill $$
743 exit 1
744 fi
745 fi
3d9a5942 746 echo ""
0b8f9e4d
AC
747done
748
749exec 1>&2
750compare_new gdbarch.log
751
104c1213
JM
752
753copyright ()
754{
755cat <<EOF
59233f88
AC
756/* *INDENT-OFF* */ /* THIS FILE IS GENERATED */
757
104c1213 758/* Dynamic architecture support for GDB, the GNU debugger.
1e698235 759 Copyright 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
104c1213
JM
760
761 This file is part of GDB.
762
763 This program is free software; you can redistribute it and/or modify
764 it under the terms of the GNU General Public License as published by
765 the Free Software Foundation; either version 2 of the License, or
766 (at your option) any later version.
767
768 This program is distributed in the hope that it will be useful,
769 but WITHOUT ANY WARRANTY; without even the implied warranty of
770 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
771 GNU General Public License for more details.
772
773 You should have received a copy of the GNU General Public License
774 along with this program; if not, write to the Free Software
775 Foundation, Inc., 59 Temple Place - Suite 330,
776 Boston, MA 02111-1307, USA. */
777
104c1213
JM
778/* This file was created with the aid of \`\`gdbarch.sh''.
779
52204a0b 780 The Bourne shell script \`\`gdbarch.sh'' creates the files
104c1213
JM
781 \`\`new-gdbarch.c'' and \`\`new-gdbarch.h and then compares them
782 against the existing \`\`gdbarch.[hc]''. Any differences found
783 being reported.
784
785 If editing this file, please also run gdbarch.sh and merge any
52204a0b 786 changes into that script. Conversely, when making sweeping changes
104c1213
JM
787 to this file, modifying gdbarch.sh and using its output may prove
788 easier. */
789
790EOF
791}
792
793#
794# The .h file
795#
796
797exec > new-gdbarch.h
798copyright
799cat <<EOF
800#ifndef GDBARCH_H
801#define GDBARCH_H
802
2bf0cb65 803#include "dis-asm.h" /* Get defs for disassemble_info, which unfortunately is a typedef. */
fd0407d6 804#if !GDB_MULTI_ARCH
67a2b77e 805/* Pull in function declarations refered to, indirectly, via macros. */
67a2b77e 806#include "inferior.h" /* For unsigned_address_to_pointer(). */
e9a2674e 807#include "symfile.h" /* For entry_point_address(). */
fd0407d6 808#endif
2bf0cb65 809
104c1213
JM
810struct frame_info;
811struct value;
b6af0555 812struct objfile;
a2cf933a 813struct minimal_symbol;
049ee0e4 814struct regcache;
b59ff9d5 815struct reggroup;
104c1213 816
104c1213
JM
817extern struct gdbarch *current_gdbarch;
818
819
104c1213
JM
820/* If any of the following are defined, the target wasn't correctly
821 converted. */
822
104c1213
JM
823#if GDB_MULTI_ARCH
824#if defined (EXTRA_FRAME_INFO)
825#error "EXTRA_FRAME_INFO: replaced by struct frame_extra_info"
826#endif
827#endif
828
829#if GDB_MULTI_ARCH
830#if defined (FRAME_FIND_SAVED_REGS)
f30ee0bc 831#error "FRAME_FIND_SAVED_REGS: replaced by DEPRECATED_FRAME_INIT_SAVED_REGS"
104c1213
JM
832#endif
833#endif
83905903
AC
834
835#if (GDB_MULTI_ARCH >= GDB_MULTI_ARCH_PURE) && defined (GDB_TM_FILE)
836#error "GDB_TM_FILE: Pure multi-arch targets do not have a tm.h file."
837#endif
104c1213
JM
838EOF
839
840# function typedef's
3d9a5942
AC
841printf "\n"
842printf "\n"
843printf "/* The following are pre-initialized by GDBARCH. */\n"
34620563 844function_list | while do_read
104c1213 845do
2ada493a
AC
846 if class_is_info_p
847 then
3d9a5942
AC
848 printf "\n"
849 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch);\n"
850 printf "/* set_gdbarch_${function}() - not applicable - pre-initialized. */\n"
028c194b 851 printf "#if (GDB_MULTI_ARCH ${gt_level}) && defined (${macro})\n"
83905903
AC
852 printf "#error \"Non multi-arch definition of ${macro}\"\n"
853 printf "#endif\n"
3d9a5942 854 printf "#if GDB_MULTI_ARCH\n"
028c194b 855 printf "#if (GDB_MULTI_ARCH ${gt_level}) || !defined (${macro})\n"
3d9a5942
AC
856 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
857 printf "#endif\n"
858 printf "#endif\n"
2ada493a 859 fi
104c1213
JM
860done
861
862# function typedef's
3d9a5942
AC
863printf "\n"
864printf "\n"
865printf "/* The following are initialized by the target dependent code. */\n"
34620563 866function_list | while do_read
104c1213 867do
72e74a21 868 if [ -n "${comment}" ]
34620563
AC
869 then
870 echo "${comment}" | sed \
871 -e '2 s,#,/*,' \
872 -e '3,$ s,#, ,' \
873 -e '$ s,$, */,'
874 fi
b77be6cf 875 if class_is_multiarch_p
2ada493a 876 then
b77be6cf
AC
877 if class_is_predicate_p
878 then
879 printf "\n"
880 printf "extern int gdbarch_${function}_p (struct gdbarch *gdbarch);\n"
881 fi
882 else
883 if class_is_predicate_p
884 then
885 printf "\n"
886 printf "#if defined (${macro})\n"
887 printf "/* Legacy for systems yet to multi-arch ${macro} */\n"
888 #printf "#if (GDB_MULTI_ARCH <= GDB_MULTI_ARCH_PARTIAL) && defined (${macro})\n"
eee30e78 889 printf "#if !defined (${macro}_P)\n"
b77be6cf
AC
890 printf "#define ${macro}_P() (1)\n"
891 printf "#endif\n"
eee30e78 892 printf "#endif\n"
b77be6cf
AC
893 printf "\n"
894 printf "/* Default predicate for non- multi-arch targets. */\n"
895 printf "#if (!GDB_MULTI_ARCH) && !defined (${macro}_P)\n"
896 printf "#define ${macro}_P() (0)\n"
897 printf "#endif\n"
898 printf "\n"
899 printf "extern int gdbarch_${function}_p (struct gdbarch *gdbarch);\n"
028c194b 900 printf "#if (GDB_MULTI_ARCH ${gt_level}) && defined (${macro}_P)\n"
83905903
AC
901 printf "#error \"Non multi-arch definition of ${macro}\"\n"
902 printf "#endif\n"
028c194b 903 printf "#if (GDB_MULTI_ARCH ${gt_level}) || !defined (${macro}_P)\n"
b77be6cf
AC
904 printf "#define ${macro}_P() (gdbarch_${function}_p (current_gdbarch))\n"
905 printf "#endif\n"
906 fi
4a5c6a1d 907 fi
2ada493a
AC
908 if class_is_variable_p
909 then
f0d4cc9e 910 if fallback_default_p || class_is_predicate_p
33489c5b 911 then
3d9a5942
AC
912 printf "\n"
913 printf "/* Default (value) for non- multi-arch platforms. */\n"
914 printf "#if (!GDB_MULTI_ARCH) && !defined (${macro})\n"
f0d4cc9e
AC
915 echo "#define ${macro} (${fallbackdefault})" \
916 | sed -e 's/\([^a-z_]\)\(gdbarch[^a-z_]\)/\1current_\2/g'
3d9a5942 917 printf "#endif\n"
33489c5b 918 fi
3d9a5942
AC
919 printf "\n"
920 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch);\n"
921 printf "extern void set_gdbarch_${function} (struct gdbarch *gdbarch, ${returntype} ${function});\n"
028c194b 922 printf "#if (GDB_MULTI_ARCH ${gt_level}) && defined (${macro})\n"
83905903
AC
923 printf "#error \"Non multi-arch definition of ${macro}\"\n"
924 printf "#endif\n"
e669114a
AC
925 if test "${level}" = ""
926 then
927 printf "#if !defined (${macro})\n"
928 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
929 printf "#endif\n"
930 else
931 printf "#if GDB_MULTI_ARCH\n"
932 printf "#if (GDB_MULTI_ARCH ${gt_level}) || !defined (${macro})\n"
933 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
934 printf "#endif\n"
935 printf "#endif\n"
936 fi
2ada493a
AC
937 fi
938 if class_is_function_p
939 then
b77be6cf
AC
940 if class_is_multiarch_p ; then :
941 elif fallback_default_p || class_is_predicate_p
33489c5b 942 then
3d9a5942
AC
943 printf "\n"
944 printf "/* Default (function) for non- multi-arch platforms. */\n"
945 printf "#if (!GDB_MULTI_ARCH) && !defined (${macro})\n"
72e74a21 946 if [ "x${fallbackdefault}" = "x0" ]
33489c5b 947 then
dedc2a2b
AC
948 if [ "x${actual}" = "x-" ]
949 then
950 printf "#define ${macro} (internal_error (__FILE__, __LINE__, \"${macro}\"), 0)\n"
dedc2a2b
AC
951 else
952 printf "#define ${macro}(${actual}) (internal_error (__FILE__, __LINE__, \"${macro}\"), 0)\n"
953 fi
33489c5b 954 else
f0d4cc9e
AC
955 # FIXME: Should be passing current_gdbarch through!
956 echo "#define ${macro}(${actual}) (${fallbackdefault} (${actual}))" \
957 | sed -e 's/\([^a-z_]\)\(gdbarch[^a-z_]\)/\1current_\2/g'
33489c5b 958 fi
3d9a5942 959 printf "#endif\n"
33489c5b 960 fi
3d9a5942 961 printf "\n"
72e74a21 962 if [ "x${formal}" = "xvoid" ] && class_is_multiarch_p
4a5c6a1d
AC
963 then
964 printf "typedef ${returntype} (gdbarch_${function}_ftype) (struct gdbarch *gdbarch);\n"
965 elif class_is_multiarch_p
966 then
967 printf "typedef ${returntype} (gdbarch_${function}_ftype) (struct gdbarch *gdbarch, ${formal});\n"
968 else
969 printf "typedef ${returntype} (gdbarch_${function}_ftype) (${formal});\n"
970 fi
72e74a21 971 if [ "x${formal}" = "xvoid" ]
104c1213 972 then
3d9a5942 973 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch);\n"
104c1213 974 else
3d9a5942 975 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch, ${formal});\n"
104c1213 976 fi
3d9a5942 977 printf "extern void set_gdbarch_${function} (struct gdbarch *gdbarch, gdbarch_${function}_ftype *${function});\n"
b77be6cf
AC
978 if class_is_multiarch_p ; then :
979 else
028c194b 980 printf "#if (GDB_MULTI_ARCH ${gt_level}) && defined (${macro})\n"
83905903
AC
981 printf "#error \"Non multi-arch definition of ${macro}\"\n"
982 printf "#endif\n"
4a5c6a1d 983 printf "#if GDB_MULTI_ARCH\n"
028c194b 984 printf "#if (GDB_MULTI_ARCH ${gt_level}) || !defined (${macro})\n"
72e74a21 985 if [ "x${actual}" = "x" ]
4a5c6a1d
AC
986 then
987 printf "#define ${macro}() (gdbarch_${function} (current_gdbarch))\n"
72e74a21 988 elif [ "x${actual}" = "x-" ]
4a5c6a1d
AC
989 then
990 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
991 else
992 printf "#define ${macro}(${actual}) (gdbarch_${function} (current_gdbarch, ${actual}))\n"
993 fi
994 printf "#endif\n"
995 printf "#endif\n"
104c1213 996 fi
2ada493a 997 fi
104c1213
JM
998done
999
1000# close it off
1001cat <<EOF
1002
1003extern struct gdbarch_tdep *gdbarch_tdep (struct gdbarch *gdbarch);
1004
1005
1006/* Mechanism for co-ordinating the selection of a specific
1007 architecture.
1008
1009 GDB targets (*-tdep.c) can register an interest in a specific
1010 architecture. Other GDB components can register a need to maintain
1011 per-architecture data.
1012
1013 The mechanisms below ensures that there is only a loose connection
1014 between the set-architecture command and the various GDB
0fa6923a 1015 components. Each component can independently register their need
104c1213
JM
1016 to maintain architecture specific data with gdbarch.
1017
1018 Pragmatics:
1019
1020 Previously, a single TARGET_ARCHITECTURE_HOOK was provided. It
1021 didn't scale.
1022
1023 The more traditional mega-struct containing architecture specific
1024 data for all the various GDB components was also considered. Since
0fa6923a 1025 GDB is built from a variable number of (fairly independent)
104c1213
JM
1026 components it was determined that the global aproach was not
1027 applicable. */
1028
1029
1030/* Register a new architectural family with GDB.
1031
1032 Register support for the specified ARCHITECTURE with GDB. When
1033 gdbarch determines that the specified architecture has been
1034 selected, the corresponding INIT function is called.
1035
1036 --
1037
1038 The INIT function takes two parameters: INFO which contains the
1039 information available to gdbarch about the (possibly new)
1040 architecture; ARCHES which is a list of the previously created
1041 \`\`struct gdbarch'' for this architecture.
1042
0f79675b
AC
1043 The INFO parameter is, as far as possible, be pre-initialized with
1044 information obtained from INFO.ABFD or the previously selected
1045 architecture.
1046
1047 The ARCHES parameter is a linked list (sorted most recently used)
1048 of all the previously created architures for this architecture
1049 family. The (possibly NULL) ARCHES->gdbarch can used to access
1050 values from the previously selected architecture for this
1051 architecture family. The global \`\`current_gdbarch'' shall not be
1052 used.
104c1213
JM
1053
1054 The INIT function shall return any of: NULL - indicating that it
ec3d358c 1055 doesn't recognize the selected architecture; an existing \`\`struct
104c1213
JM
1056 gdbarch'' from the ARCHES list - indicating that the new
1057 architecture is just a synonym for an earlier architecture (see
1058 gdbarch_list_lookup_by_info()); a newly created \`\`struct gdbarch''
4b9b3959
AC
1059 - that describes the selected architecture (see gdbarch_alloc()).
1060
1061 The DUMP_TDEP function shall print out all target specific values.
1062 Care should be taken to ensure that the function works in both the
1063 multi-arch and non- multi-arch cases. */
104c1213
JM
1064
1065struct gdbarch_list
1066{
1067 struct gdbarch *gdbarch;
1068 struct gdbarch_list *next;
1069};
1070
1071struct gdbarch_info
1072{
104c1213
JM
1073 /* Use default: NULL (ZERO). */
1074 const struct bfd_arch_info *bfd_arch_info;
1075
428721aa 1076 /* Use default: BFD_ENDIAN_UNKNOWN (NB: is not ZERO). */
104c1213
JM
1077 int byte_order;
1078
1079 /* Use default: NULL (ZERO). */
1080 bfd *abfd;
1081
1082 /* Use default: NULL (ZERO). */
1083 struct gdbarch_tdep_info *tdep_info;
4be87837
DJ
1084
1085 /* Use default: GDB_OSABI_UNINITIALIZED (-1). */
1086 enum gdb_osabi osabi;
104c1213
JM
1087};
1088
1089typedef struct gdbarch *(gdbarch_init_ftype) (struct gdbarch_info info, struct gdbarch_list *arches);
4b9b3959 1090typedef void (gdbarch_dump_tdep_ftype) (struct gdbarch *gdbarch, struct ui_file *file);
104c1213 1091
4b9b3959 1092/* DEPRECATED - use gdbarch_register() */
104c1213
JM
1093extern void register_gdbarch_init (enum bfd_architecture architecture, gdbarch_init_ftype *);
1094
4b9b3959
AC
1095extern void gdbarch_register (enum bfd_architecture architecture,
1096 gdbarch_init_ftype *,
1097 gdbarch_dump_tdep_ftype *);
1098
104c1213 1099
b4a20239
AC
1100/* Return a freshly allocated, NULL terminated, array of the valid
1101 architecture names. Since architectures are registered during the
1102 _initialize phase this function only returns useful information
1103 once initialization has been completed. */
1104
1105extern const char **gdbarch_printable_names (void);
1106
1107
104c1213
JM
1108/* Helper function. Search the list of ARCHES for a GDBARCH that
1109 matches the information provided by INFO. */
1110
1111extern struct gdbarch_list *gdbarch_list_lookup_by_info (struct gdbarch_list *arches, const struct gdbarch_info *info);
1112
1113
1114/* Helper function. Create a preliminary \`\`struct gdbarch''. Perform
1115 basic initialization using values obtained from the INFO andTDEP
1116 parameters. set_gdbarch_*() functions are called to complete the
1117 initialization of the object. */
1118
1119extern struct gdbarch *gdbarch_alloc (const struct gdbarch_info *info, struct gdbarch_tdep *tdep);
1120
1121
4b9b3959
AC
1122/* Helper function. Free a partially-constructed \`\`struct gdbarch''.
1123 It is assumed that the caller freeds the \`\`struct
1124 gdbarch_tdep''. */
1125
058f20d5
JB
1126extern void gdbarch_free (struct gdbarch *);
1127
1128
b732d07d 1129/* Helper function. Force an update of the current architecture.
104c1213 1130
b732d07d
AC
1131 The actual architecture selected is determined by INFO, \`\`(gdb) set
1132 architecture'' et.al., the existing architecture and BFD's default
1133 architecture. INFO should be initialized to zero and then selected
1134 fields should be updated.
104c1213 1135
16f33e29
AC
1136 Returns non-zero if the update succeeds */
1137
1138extern int gdbarch_update_p (struct gdbarch_info info);
104c1213
JM
1139
1140
1141
1142/* Register per-architecture data-pointer.
1143
1144 Reserve space for a per-architecture data-pointer. An identifier
1145 for the reserved data-pointer is returned. That identifer should
95160752 1146 be saved in a local static variable.
104c1213 1147
76860b5f
AC
1148 The per-architecture data-pointer is either initialized explicitly
1149 (set_gdbarch_data()) or implicitly (by INIT() via a call to
1150 gdbarch_data()). FREE() is called to delete either an existing
2af496cb 1151 data-pointer overridden by set_gdbarch_data() or when the
76860b5f 1152 architecture object is being deleted.
104c1213 1153
95160752
AC
1154 When a previously created architecture is re-selected, the
1155 per-architecture data-pointer for that previous architecture is
76860b5f 1156 restored. INIT() is not re-called.
104c1213
JM
1157
1158 Multiple registrarants for any architecture are allowed (and
1159 strongly encouraged). */
1160
95160752 1161struct gdbarch_data;
104c1213 1162
95160752
AC
1163typedef void *(gdbarch_data_init_ftype) (struct gdbarch *gdbarch);
1164typedef void (gdbarch_data_free_ftype) (struct gdbarch *gdbarch,
1165 void *pointer);
1166extern struct gdbarch_data *register_gdbarch_data (gdbarch_data_init_ftype *init,
1167 gdbarch_data_free_ftype *free);
1168extern void set_gdbarch_data (struct gdbarch *gdbarch,
1169 struct gdbarch_data *data,
1170 void *pointer);
104c1213 1171
451fbdda 1172extern void *gdbarch_data (struct gdbarch *gdbarch, struct gdbarch_data *);
104c1213
JM
1173
1174
104c1213
JM
1175/* Register per-architecture memory region.
1176
1177 Provide a memory-region swap mechanism. Per-architecture memory
1178 region are created. These memory regions are swapped whenever the
1179 architecture is changed. For a new architecture, the memory region
1180 is initialized with zero (0) and the INIT function is called.
1181
1182 Memory regions are swapped / initialized in the order that they are
1183 registered. NULL DATA and/or INIT values can be specified.
1184
1185 New code should use register_gdbarch_data(). */
1186
1187typedef void (gdbarch_swap_ftype) (void);
1188extern void register_gdbarch_swap (void *data, unsigned long size, gdbarch_swap_ftype *init);
e514a9d6 1189#define REGISTER_GDBARCH_SWAP(VAR) register_gdbarch_swap (&(VAR), sizeof ((VAR)), NULL)
104c1213
JM
1190
1191
1192
0fa6923a 1193/* The target-system-dependent byte order is dynamic */
104c1213 1194
104c1213 1195extern int target_byte_order;
104c1213
JM
1196#ifndef TARGET_BYTE_ORDER
1197#define TARGET_BYTE_ORDER (target_byte_order + 0)
1198#endif
1199
1200extern int target_byte_order_auto;
1201#ifndef TARGET_BYTE_ORDER_AUTO
1202#define TARGET_BYTE_ORDER_AUTO (target_byte_order_auto + 0)
1203#endif
1204
1205
1206
0fa6923a 1207/* The target-system-dependent BFD architecture is dynamic */
104c1213
JM
1208
1209extern int target_architecture_auto;
1210#ifndef TARGET_ARCHITECTURE_AUTO
1211#define TARGET_ARCHITECTURE_AUTO (target_architecture_auto + 0)
1212#endif
1213
1214extern const struct bfd_arch_info *target_architecture;
1215#ifndef TARGET_ARCHITECTURE
1216#define TARGET_ARCHITECTURE (target_architecture + 0)
1217#endif
1218
104c1213 1219
0fa6923a 1220/* The target-system-dependent disassembler is semi-dynamic */
104c1213 1221
104c1213 1222extern int dis_asm_read_memory (bfd_vma memaddr, bfd_byte *myaddr,
ff844c8d 1223 unsigned int len, disassemble_info *info);
104c1213
JM
1224
1225extern void dis_asm_memory_error (int status, bfd_vma memaddr,
1226 disassemble_info *info);
1227
1228extern void dis_asm_print_address (bfd_vma addr,
1229 disassemble_info *info);
1230
1231extern int (*tm_print_insn) (bfd_vma, disassemble_info*);
1232extern disassemble_info tm_print_insn_info;
104c1213
JM
1233#ifndef TARGET_PRINT_INSN_INFO
1234#define TARGET_PRINT_INSN_INFO (&tm_print_insn_info)
1235#endif
1236
1237
1238
0fa6923a 1239/* Set the dynamic target-system-dependent parameters (architecture,
104c1213
JM
1240 byte-order, ...) using information found in the BFD */
1241
1242extern void set_gdbarch_from_file (bfd *);
1243
1244
e514a9d6
JM
1245/* Initialize the current architecture to the "first" one we find on
1246 our list. */
1247
1248extern void initialize_current_architecture (void);
1249
ceaa8edf
JB
1250/* For non-multiarched targets, do any initialization of the default
1251 gdbarch object necessary after the _initialize_MODULE functions
1252 have run. */
5ae5f592 1253extern void initialize_non_multiarch (void);
104c1213
JM
1254
1255/* gdbarch trace variable */
1256extern int gdbarch_debug;
1257
4b9b3959 1258extern void gdbarch_dump (struct gdbarch *gdbarch, struct ui_file *file);
104c1213
JM
1259
1260#endif
1261EOF
1262exec 1>&2
1263#../move-if-change new-gdbarch.h gdbarch.h
59233f88 1264compare_new gdbarch.h
104c1213
JM
1265
1266
1267#
1268# C file
1269#
1270
1271exec > new-gdbarch.c
1272copyright
1273cat <<EOF
1274
1275#include "defs.h"
7355ddba 1276#include "arch-utils.h"
104c1213
JM
1277
1278#if GDB_MULTI_ARCH
1279#include "gdbcmd.h"
1280#include "inferior.h" /* enum CALL_DUMMY_LOCATION et.al. */
1281#else
1282/* Just include everything in sight so that the every old definition
1283 of macro is visible. */
1284#include "gdb_string.h"
1285#include <ctype.h>
1286#include "symtab.h"
1287#include "frame.h"
1288#include "inferior.h"
1289#include "breakpoint.h"
0596389c 1290#include "gdb_wait.h"
104c1213
JM
1291#include "gdbcore.h"
1292#include "gdbcmd.h"
1293#include "target.h"
1294#include "gdbthread.h"
1295#include "annotate.h"
1296#include "symfile.h" /* for overlay functions */
fd0407d6 1297#include "value.h" /* For old tm.h/nm.h macros. */
104c1213
JM
1298#endif
1299#include "symcat.h"
1300
f0d4cc9e 1301#include "floatformat.h"
104c1213 1302
95160752 1303#include "gdb_assert.h"
b66d6d2e 1304#include "gdb_string.h"
67c2c32c 1305#include "gdb-events.h"
b59ff9d5 1306#include "reggroups.h"
4be87837 1307#include "osabi.h"
e9a2674e 1308#include "symfile.h" /* For entry_point_address. */
95160752 1309
104c1213
JM
1310/* Static function declarations */
1311
1312static void verify_gdbarch (struct gdbarch *gdbarch);
b3cc3077 1313static void alloc_gdbarch_data (struct gdbarch *);
95160752 1314static void free_gdbarch_data (struct gdbarch *);
104c1213 1315static void init_gdbarch_swap (struct gdbarch *);
40af4b0c 1316static void clear_gdbarch_swap (struct gdbarch *);
104c1213
JM
1317static void swapout_gdbarch_swap (struct gdbarch *);
1318static void swapin_gdbarch_swap (struct gdbarch *);
1319
104c1213
JM
1320/* Non-zero if we want to trace architecture code. */
1321
1322#ifndef GDBARCH_DEBUG
1323#define GDBARCH_DEBUG 0
1324#endif
1325int gdbarch_debug = GDBARCH_DEBUG;
1326
1327EOF
1328
1329# gdbarch open the gdbarch object
3d9a5942
AC
1330printf "\n"
1331printf "/* Maintain the struct gdbarch object */\n"
1332printf "\n"
1333printf "struct gdbarch\n"
1334printf "{\n"
76860b5f
AC
1335printf " /* Has this architecture been fully initialized? */\n"
1336printf " int initialized_p;\n"
3d9a5942 1337printf " /* basic architectural information */\n"
34620563 1338function_list | while do_read
104c1213 1339do
2ada493a
AC
1340 if class_is_info_p
1341 then
3d9a5942 1342 printf " ${returntype} ${function};\n"
2ada493a 1343 fi
104c1213 1344done
3d9a5942
AC
1345printf "\n"
1346printf " /* target specific vector. */\n"
1347printf " struct gdbarch_tdep *tdep;\n"
1348printf " gdbarch_dump_tdep_ftype *dump_tdep;\n"
1349printf "\n"
1350printf " /* per-architecture data-pointers */\n"
95160752 1351printf " unsigned nr_data;\n"
3d9a5942
AC
1352printf " void **data;\n"
1353printf "\n"
1354printf " /* per-architecture swap-regions */\n"
1355printf " struct gdbarch_swap *swap;\n"
1356printf "\n"
104c1213
JM
1357cat <<EOF
1358 /* Multi-arch values.
1359
1360 When extending this structure you must:
1361
1362 Add the field below.
1363
1364 Declare set/get functions and define the corresponding
1365 macro in gdbarch.h.
1366
1367 gdbarch_alloc(): If zero/NULL is not a suitable default,
1368 initialize the new field.
1369
1370 verify_gdbarch(): Confirm that the target updated the field
1371 correctly.
1372
7e73cedf 1373 gdbarch_dump(): Add a fprintf_unfiltered call so that the new
104c1213
JM
1374 field is dumped out
1375
c0e8c252 1376 \`\`startup_gdbarch()'': Append an initial value to the static
104c1213
JM
1377 variable (base values on the host's c-type system).
1378
1379 get_gdbarch(): Implement the set/get functions (probably using
1380 the macro's as shortcuts).
1381
1382 */
1383
1384EOF
34620563 1385function_list | while do_read
104c1213 1386do
2ada493a
AC
1387 if class_is_variable_p
1388 then
3d9a5942 1389 printf " ${returntype} ${function};\n"
2ada493a
AC
1390 elif class_is_function_p
1391 then
3d9a5942 1392 printf " gdbarch_${function}_ftype *${function}${attrib};\n"
2ada493a 1393 fi
104c1213 1394done
3d9a5942 1395printf "};\n"
104c1213
JM
1396
1397# A pre-initialized vector
3d9a5942
AC
1398printf "\n"
1399printf "\n"
104c1213
JM
1400cat <<EOF
1401/* The default architecture uses host values (for want of a better
1402 choice). */
1403EOF
3d9a5942
AC
1404printf "\n"
1405printf "extern const struct bfd_arch_info bfd_default_arch_struct;\n"
1406printf "\n"
1407printf "struct gdbarch startup_gdbarch =\n"
1408printf "{\n"
76860b5f 1409printf " 1, /* Always initialized. */\n"
3d9a5942 1410printf " /* basic architecture information */\n"
4b9b3959 1411function_list | while do_read
104c1213 1412do
2ada493a
AC
1413 if class_is_info_p
1414 then
3d9a5942 1415 printf " ${staticdefault},\n"
2ada493a 1416 fi
104c1213
JM
1417done
1418cat <<EOF
4b9b3959
AC
1419 /* target specific vector and its dump routine */
1420 NULL, NULL,
104c1213
JM
1421 /*per-architecture data-pointers and swap regions */
1422 0, NULL, NULL,
1423 /* Multi-arch values */
1424EOF
34620563 1425function_list | while do_read
104c1213 1426do
2ada493a
AC
1427 if class_is_function_p || class_is_variable_p
1428 then
3d9a5942 1429 printf " ${staticdefault},\n"
2ada493a 1430 fi
104c1213
JM
1431done
1432cat <<EOF
c0e8c252 1433 /* startup_gdbarch() */
104c1213 1434};
4b9b3959 1435
c0e8c252 1436struct gdbarch *current_gdbarch = &startup_gdbarch;
ceaa8edf
JB
1437
1438/* Do any initialization needed for a non-multiarch configuration
1439 after the _initialize_MODULE functions have been run. */
1440void
5ae5f592 1441initialize_non_multiarch (void)
ceaa8edf
JB
1442{
1443 alloc_gdbarch_data (&startup_gdbarch);
40af4b0c
AC
1444 /* Ensure that all swap areas are zeroed so that they again think
1445 they are starting from scratch. */
1446 clear_gdbarch_swap (&startup_gdbarch);
6c1e5d11 1447 init_gdbarch_swap (&startup_gdbarch);
ceaa8edf 1448}
104c1213
JM
1449EOF
1450
1451# Create a new gdbarch struct
3d9a5942
AC
1452printf "\n"
1453printf "\n"
104c1213 1454cat <<EOF
66b43ecb 1455/* Create a new \`\`struct gdbarch'' based on information provided by
104c1213
JM
1456 \`\`struct gdbarch_info''. */
1457EOF
3d9a5942 1458printf "\n"
104c1213
JM
1459cat <<EOF
1460struct gdbarch *
1461gdbarch_alloc (const struct gdbarch_info *info,
1462 struct gdbarch_tdep *tdep)
1463{
85de9627
AC
1464 /* NOTE: The new architecture variable is named \`\`current_gdbarch''
1465 so that macros such as TARGET_DOUBLE_BIT, when expanded, refer to
1466 the current local architecture and not the previous global
1467 architecture. This ensures that the new architectures initial
1468 values are not influenced by the previous architecture. Once
1469 everything is parameterised with gdbarch, this will go away. */
1470 struct gdbarch *current_gdbarch = XMALLOC (struct gdbarch);
1471 memset (current_gdbarch, 0, sizeof (*current_gdbarch));
1472
1473 alloc_gdbarch_data (current_gdbarch);
1474
1475 current_gdbarch->tdep = tdep;
104c1213 1476EOF
3d9a5942 1477printf "\n"
34620563 1478function_list | while do_read
104c1213 1479do
2ada493a
AC
1480 if class_is_info_p
1481 then
85de9627 1482 printf " current_gdbarch->${function} = info->${function};\n"
2ada493a 1483 fi
104c1213 1484done
3d9a5942
AC
1485printf "\n"
1486printf " /* Force the explicit initialization of these. */\n"
34620563 1487function_list | while do_read
104c1213 1488do
2ada493a
AC
1489 if class_is_function_p || class_is_variable_p
1490 then
72e74a21 1491 if [ -n "${predefault}" -a "x${predefault}" != "x0" ]
104c1213 1492 then
85de9627 1493 printf " current_gdbarch->${function} = ${predefault};\n"
104c1213 1494 fi
2ada493a 1495 fi
104c1213
JM
1496done
1497cat <<EOF
1498 /* gdbarch_alloc() */
1499
85de9627 1500 return current_gdbarch;
104c1213
JM
1501}
1502EOF
1503
058f20d5 1504# Free a gdbarch struct.
3d9a5942
AC
1505printf "\n"
1506printf "\n"
058f20d5
JB
1507cat <<EOF
1508/* Free a gdbarch struct. This should never happen in normal
1509 operation --- once you've created a gdbarch, you keep it around.
1510 However, if an architecture's init function encounters an error
1511 building the structure, it may need to clean up a partially
1512 constructed gdbarch. */
4b9b3959 1513
058f20d5
JB
1514void
1515gdbarch_free (struct gdbarch *arch)
1516{
95160752
AC
1517 gdb_assert (arch != NULL);
1518 free_gdbarch_data (arch);
338d7c5c 1519 xfree (arch);
058f20d5
JB
1520}
1521EOF
1522
104c1213 1523# verify a new architecture
3d9a5942
AC
1524printf "\n"
1525printf "\n"
1526printf "/* Ensure that all values in a GDBARCH are reasonable. */\n"
1527printf "\n"
104c1213
JM
1528cat <<EOF
1529static void
1530verify_gdbarch (struct gdbarch *gdbarch)
1531{
f16a1923
AC
1532 struct ui_file *log;
1533 struct cleanup *cleanups;
1534 long dummy;
1535 char *buf;
104c1213 1536 /* Only perform sanity checks on a multi-arch target. */
6166d547 1537 if (!GDB_MULTI_ARCH)
104c1213 1538 return;
f16a1923
AC
1539 log = mem_fileopen ();
1540 cleanups = make_cleanup_ui_file_delete (log);
104c1213 1541 /* fundamental */
428721aa 1542 if (gdbarch->byte_order == BFD_ENDIAN_UNKNOWN)
f16a1923 1543 fprintf_unfiltered (log, "\n\tbyte-order");
104c1213 1544 if (gdbarch->bfd_arch_info == NULL)
f16a1923 1545 fprintf_unfiltered (log, "\n\tbfd_arch_info");
104c1213
JM
1546 /* Check those that need to be defined for the given multi-arch level. */
1547EOF
34620563 1548function_list | while do_read
104c1213 1549do
2ada493a
AC
1550 if class_is_function_p || class_is_variable_p
1551 then
72e74a21 1552 if [ "x${invalid_p}" = "x0" ]
c0e8c252 1553 then
3d9a5942 1554 printf " /* Skip verify of ${function}, invalid_p == 0 */\n"
2ada493a
AC
1555 elif class_is_predicate_p
1556 then
3d9a5942 1557 printf " /* Skip verify of ${function}, has predicate */\n"
f0d4cc9e 1558 # FIXME: See do_read for potential simplification
72e74a21 1559 elif [ -n "${invalid_p}" -a -n "${postdefault}" ]
f0d4cc9e 1560 then
3d9a5942
AC
1561 printf " if (${invalid_p})\n"
1562 printf " gdbarch->${function} = ${postdefault};\n"
72e74a21 1563 elif [ -n "${predefault}" -a -n "${postdefault}" ]
f0d4cc9e 1564 then
3d9a5942
AC
1565 printf " if (gdbarch->${function} == ${predefault})\n"
1566 printf " gdbarch->${function} = ${postdefault};\n"
72e74a21 1567 elif [ -n "${postdefault}" ]
f0d4cc9e 1568 then
3d9a5942
AC
1569 printf " if (gdbarch->${function} == 0)\n"
1570 printf " gdbarch->${function} = ${postdefault};\n"
72e74a21 1571 elif [ -n "${invalid_p}" ]
104c1213 1572 then
50248794 1573 printf " if ((GDB_MULTI_ARCH ${gt_level})\n"
3d9a5942 1574 printf " && (${invalid_p}))\n"
f16a1923 1575 printf " fprintf_unfiltered (log, \"\\\\n\\\\t${function}\");\n"
72e74a21 1576 elif [ -n "${predefault}" ]
104c1213 1577 then
50248794 1578 printf " if ((GDB_MULTI_ARCH ${gt_level})\n"
3d9a5942 1579 printf " && (gdbarch->${function} == ${predefault}))\n"
f16a1923 1580 printf " fprintf_unfiltered (log, \"\\\\n\\\\t${function}\");\n"
104c1213 1581 fi
2ada493a 1582 fi
104c1213
JM
1583done
1584cat <<EOF
f16a1923
AC
1585 buf = ui_file_xstrdup (log, &dummy);
1586 make_cleanup (xfree, buf);
1587 if (strlen (buf) > 0)
1588 internal_error (__FILE__, __LINE__,
1589 "verify_gdbarch: the following are invalid ...%s",
1590 buf);
1591 do_cleanups (cleanups);
104c1213
JM
1592}
1593EOF
1594
1595# dump the structure
3d9a5942
AC
1596printf "\n"
1597printf "\n"
104c1213 1598cat <<EOF
4b9b3959
AC
1599/* Print out the details of the current architecture. */
1600
1601/* NOTE/WARNING: The parameter is called \`\`current_gdbarch'' so that it
1602 just happens to match the global variable \`\`current_gdbarch''. That
1603 way macros refering to that variable get the local and not the global
1604 version - ulgh. Once everything is parameterised with gdbarch, this
1605 will go away. */
1606
104c1213 1607void
4b9b3959 1608gdbarch_dump (struct gdbarch *gdbarch, struct ui_file *file)
104c1213 1609{
4b9b3959
AC
1610 fprintf_unfiltered (file,
1611 "gdbarch_dump: GDB_MULTI_ARCH = %d\\n",
1612 GDB_MULTI_ARCH);
104c1213 1613EOF
9ba8d803 1614function_list | sort -t: -k 3 | while do_read
104c1213 1615do
1e9f55d0
AC
1616 # First the predicate
1617 if class_is_predicate_p
1618 then
1619 if class_is_multiarch_p
1620 then
1621 printf " if (GDB_MULTI_ARCH)\n"
1622 printf " fprintf_unfiltered (file,\n"
1623 printf " \"gdbarch_dump: gdbarch_${function}_p() = %%d\\\\n\",\n"
1624 printf " gdbarch_${function}_p (current_gdbarch));\n"
1625 else
1626 printf "#ifdef ${macro}_P\n"
1627 printf " fprintf_unfiltered (file,\n"
1628 printf " \"gdbarch_dump: %%s # %%s\\\\n\",\n"
1629 printf " \"${macro}_P()\",\n"
1630 printf " XSTRING (${macro}_P ()));\n"
1631 printf " fprintf_unfiltered (file,\n"
1632 printf " \"gdbarch_dump: ${macro}_P() = %%d\\\\n\",\n"
1633 printf " ${macro}_P ());\n"
1634 printf "#endif\n"
1635 fi
1636 fi
4a5c6a1d 1637 # multiarch functions don't have macros.
08e45a40
AC
1638 if class_is_multiarch_p
1639 then
1640 printf " if (GDB_MULTI_ARCH)\n"
1641 printf " fprintf_unfiltered (file,\n"
1642 printf " \"gdbarch_dump: ${function} = 0x%%08lx\\\\n\",\n"
1643 printf " (long) current_gdbarch->${function});\n"
1644 continue
1645 fi
06b25f14 1646 # Print the macro definition.
08e45a40 1647 printf "#ifdef ${macro}\n"
72e74a21 1648 if [ "x${returntype}" = "xvoid" ]
63e69063 1649 then
08e45a40 1650 printf "#if GDB_MULTI_ARCH\n"
3d9a5942 1651 printf " /* Macro might contain \`[{}]' when not multi-arch */\n"
63e69063 1652 fi
2ada493a
AC
1653 if class_is_function_p
1654 then
3d9a5942
AC
1655 printf " fprintf_unfiltered (file,\n"
1656 printf " \"gdbarch_dump: %%s # %%s\\\\n\",\n"
1657 printf " \"${macro}(${actual})\",\n"
1658 printf " XSTRING (${macro} (${actual})));\n"
2ada493a 1659 else
3d9a5942
AC
1660 printf " fprintf_unfiltered (file,\n"
1661 printf " \"gdbarch_dump: ${macro} # %%s\\\\n\",\n"
1662 printf " XSTRING (${macro}));\n"
4b9b3959 1663 fi
06b25f14 1664 # Print the architecture vector value
08e45a40 1665 if [ "x${returntype}" = "xvoid" ]
4a5c6a1d 1666 then
08e45a40 1667 printf "#endif\n"
4a5c6a1d 1668 fi
72e74a21 1669 if [ "x${print_p}" = "x()" ]
4b9b3959 1670 then
4a5c6a1d 1671 printf " gdbarch_dump_${function} (current_gdbarch);\n"
72e74a21 1672 elif [ "x${print_p}" = "x0" ]
4b9b3959 1673 then
4a5c6a1d 1674 printf " /* skip print of ${macro}, print_p == 0. */\n"
72e74a21 1675 elif [ -n "${print_p}" ]
4b9b3959 1676 then
4a5c6a1d 1677 printf " if (${print_p})\n"
3d9a5942
AC
1678 printf " fprintf_unfiltered (file,\n"
1679 printf " \"gdbarch_dump: ${macro} = %s\\\\n\",\n" "${fmt}"
1680 printf " ${print});\n"
4b9b3959
AC
1681 elif class_is_function_p
1682 then
3d9a5942
AC
1683 printf " if (GDB_MULTI_ARCH)\n"
1684 printf " fprintf_unfiltered (file,\n"
6cbda714 1685 printf " \"gdbarch_dump: ${macro} = <0x%%08lx>\\\\n\",\n"
3d9a5942
AC
1686 printf " (long) current_gdbarch->${function}\n"
1687 printf " /*${macro} ()*/);\n"
4b9b3959 1688 else
3d9a5942
AC
1689 printf " fprintf_unfiltered (file,\n"
1690 printf " \"gdbarch_dump: ${macro} = %s\\\\n\",\n" "${fmt}"
1691 printf " ${print});\n"
2ada493a 1692 fi
3d9a5942 1693 printf "#endif\n"
104c1213 1694done
381323f4 1695cat <<EOF
4b9b3959
AC
1696 if (current_gdbarch->dump_tdep != NULL)
1697 current_gdbarch->dump_tdep (current_gdbarch, file);
381323f4
AC
1698}
1699EOF
104c1213
JM
1700
1701
1702# GET/SET
3d9a5942 1703printf "\n"
104c1213
JM
1704cat <<EOF
1705struct gdbarch_tdep *
1706gdbarch_tdep (struct gdbarch *gdbarch)
1707{
1708 if (gdbarch_debug >= 2)
3d9a5942 1709 fprintf_unfiltered (gdb_stdlog, "gdbarch_tdep called\\n");
104c1213
JM
1710 return gdbarch->tdep;
1711}
1712EOF
3d9a5942 1713printf "\n"
34620563 1714function_list | while do_read
104c1213 1715do
2ada493a
AC
1716 if class_is_predicate_p
1717 then
3d9a5942
AC
1718 printf "\n"
1719 printf "int\n"
1720 printf "gdbarch_${function}_p (struct gdbarch *gdbarch)\n"
1721 printf "{\n"
8de9bdc4 1722 printf " gdb_assert (gdbarch != NULL);\n"
ae45cd16 1723 if [ -n "${predicate}" ]
2ada493a 1724 then
ae45cd16 1725 printf " return ${predicate};\n"
2ada493a 1726 else
ae45cd16 1727 printf " return gdbarch->${function} != 0;\n"
2ada493a 1728 fi
3d9a5942 1729 printf "}\n"
2ada493a
AC
1730 fi
1731 if class_is_function_p
1732 then
3d9a5942
AC
1733 printf "\n"
1734 printf "${returntype}\n"
72e74a21 1735 if [ "x${formal}" = "xvoid" ]
104c1213 1736 then
3d9a5942 1737 printf "gdbarch_${function} (struct gdbarch *gdbarch)\n"
104c1213 1738 else
3d9a5942 1739 printf "gdbarch_${function} (struct gdbarch *gdbarch, ${formal})\n"
104c1213 1740 fi
3d9a5942 1741 printf "{\n"
8de9bdc4 1742 printf " gdb_assert (gdbarch != NULL);\n"
3d9a5942 1743 printf " if (gdbarch->${function} == 0)\n"
8e65ff28
AC
1744 printf " internal_error (__FILE__, __LINE__,\n"
1745 printf " \"gdbarch: gdbarch_${function} invalid\");\n"
ae45cd16
AC
1746 if class_is_predicate_p && test -n "${predicate}"
1747 then
1748 # Allow a call to a function with a predicate.
1749 printf " /* Ignore predicate (${predicate}). */\n"
1750 fi
3d9a5942
AC
1751 printf " if (gdbarch_debug >= 2)\n"
1752 printf " fprintf_unfiltered (gdb_stdlog, \"gdbarch_${function} called\\\\n\");\n"
72e74a21 1753 if [ "x${actual}" = "x-" -o "x${actual}" = "x" ]
4a5c6a1d
AC
1754 then
1755 if class_is_multiarch_p
1756 then
1757 params="gdbarch"
1758 else
1759 params=""
1760 fi
1761 else
1762 if class_is_multiarch_p
1763 then
1764 params="gdbarch, ${actual}"
1765 else
1766 params="${actual}"
1767 fi
1768 fi
72e74a21 1769 if [ "x${returntype}" = "xvoid" ]
104c1213 1770 then
4a5c6a1d 1771 printf " gdbarch->${function} (${params});\n"
104c1213 1772 else
4a5c6a1d 1773 printf " return gdbarch->${function} (${params});\n"
104c1213 1774 fi
3d9a5942
AC
1775 printf "}\n"
1776 printf "\n"
1777 printf "void\n"
1778 printf "set_gdbarch_${function} (struct gdbarch *gdbarch,\n"
1779 printf " `echo ${function} | sed -e 's/./ /g'` gdbarch_${function}_ftype ${function})\n"
1780 printf "{\n"
1781 printf " gdbarch->${function} = ${function};\n"
1782 printf "}\n"
2ada493a
AC
1783 elif class_is_variable_p
1784 then
3d9a5942
AC
1785 printf "\n"
1786 printf "${returntype}\n"
1787 printf "gdbarch_${function} (struct gdbarch *gdbarch)\n"
1788 printf "{\n"
8de9bdc4 1789 printf " gdb_assert (gdbarch != NULL);\n"
72e74a21 1790 if [ "x${invalid_p}" = "x0" ]
c0e8c252 1791 then
3d9a5942 1792 printf " /* Skip verify of ${function}, invalid_p == 0 */\n"
72e74a21 1793 elif [ -n "${invalid_p}" ]
104c1213 1794 then
3d9a5942 1795 printf " if (${invalid_p})\n"
8e65ff28
AC
1796 printf " internal_error (__FILE__, __LINE__,\n"
1797 printf " \"gdbarch: gdbarch_${function} invalid\");\n"
72e74a21 1798 elif [ -n "${predefault}" ]
104c1213 1799 then
3d9a5942 1800 printf " if (gdbarch->${function} == ${predefault})\n"
8e65ff28
AC
1801 printf " internal_error (__FILE__, __LINE__,\n"
1802 printf " \"gdbarch: gdbarch_${function} invalid\");\n"
104c1213 1803 fi
3d9a5942
AC
1804 printf " if (gdbarch_debug >= 2)\n"
1805 printf " fprintf_unfiltered (gdb_stdlog, \"gdbarch_${function} called\\\\n\");\n"
1806 printf " return gdbarch->${function};\n"
1807 printf "}\n"
1808 printf "\n"
1809 printf "void\n"
1810 printf "set_gdbarch_${function} (struct gdbarch *gdbarch,\n"
1811 printf " `echo ${function} | sed -e 's/./ /g'` ${returntype} ${function})\n"
1812 printf "{\n"
1813 printf " gdbarch->${function} = ${function};\n"
1814 printf "}\n"
2ada493a
AC
1815 elif class_is_info_p
1816 then
3d9a5942
AC
1817 printf "\n"
1818 printf "${returntype}\n"
1819 printf "gdbarch_${function} (struct gdbarch *gdbarch)\n"
1820 printf "{\n"
8de9bdc4 1821 printf " gdb_assert (gdbarch != NULL);\n"
3d9a5942
AC
1822 printf " if (gdbarch_debug >= 2)\n"
1823 printf " fprintf_unfiltered (gdb_stdlog, \"gdbarch_${function} called\\\\n\");\n"
1824 printf " return gdbarch->${function};\n"
1825 printf "}\n"
2ada493a 1826 fi
104c1213
JM
1827done
1828
1829# All the trailing guff
1830cat <<EOF
1831
1832
f44c642f 1833/* Keep a registry of per-architecture data-pointers required by GDB
104c1213
JM
1834 modules. */
1835
1836struct gdbarch_data
1837{
95160752 1838 unsigned index;
76860b5f 1839 int init_p;
95160752
AC
1840 gdbarch_data_init_ftype *init;
1841 gdbarch_data_free_ftype *free;
104c1213
JM
1842};
1843
1844struct gdbarch_data_registration
1845{
104c1213
JM
1846 struct gdbarch_data *data;
1847 struct gdbarch_data_registration *next;
1848};
1849
f44c642f 1850struct gdbarch_data_registry
104c1213 1851{
95160752 1852 unsigned nr;
104c1213
JM
1853 struct gdbarch_data_registration *registrations;
1854};
1855
f44c642f 1856struct gdbarch_data_registry gdbarch_data_registry =
104c1213
JM
1857{
1858 0, NULL,
1859};
1860
1861struct gdbarch_data *
95160752
AC
1862register_gdbarch_data (gdbarch_data_init_ftype *init,
1863 gdbarch_data_free_ftype *free)
104c1213
JM
1864{
1865 struct gdbarch_data_registration **curr;
76860b5f 1866 /* Append the new registraration. */
f44c642f 1867 for (curr = &gdbarch_data_registry.registrations;
104c1213
JM
1868 (*curr) != NULL;
1869 curr = &(*curr)->next);
1870 (*curr) = XMALLOC (struct gdbarch_data_registration);
1871 (*curr)->next = NULL;
104c1213 1872 (*curr)->data = XMALLOC (struct gdbarch_data);
f44c642f 1873 (*curr)->data->index = gdbarch_data_registry.nr++;
95160752 1874 (*curr)->data->init = init;
76860b5f 1875 (*curr)->data->init_p = 1;
95160752 1876 (*curr)->data->free = free;
104c1213
JM
1877 return (*curr)->data;
1878}
1879
1880
b3cc3077 1881/* Create/delete the gdbarch data vector. */
95160752
AC
1882
1883static void
b3cc3077 1884alloc_gdbarch_data (struct gdbarch *gdbarch)
95160752 1885{
b3cc3077
JB
1886 gdb_assert (gdbarch->data == NULL);
1887 gdbarch->nr_data = gdbarch_data_registry.nr;
1888 gdbarch->data = xcalloc (gdbarch->nr_data, sizeof (void*));
1889}
3c875b6f 1890
b3cc3077
JB
1891static void
1892free_gdbarch_data (struct gdbarch *gdbarch)
1893{
1894 struct gdbarch_data_registration *rego;
1895 gdb_assert (gdbarch->data != NULL);
1896 for (rego = gdbarch_data_registry.registrations;
1897 rego != NULL;
1898 rego = rego->next)
95160752 1899 {
b3cc3077
JB
1900 struct gdbarch_data *data = rego->data;
1901 gdb_assert (data->index < gdbarch->nr_data);
1902 if (data->free != NULL && gdbarch->data[data->index] != NULL)
95160752 1903 {
b3cc3077
JB
1904 data->free (gdbarch, gdbarch->data[data->index]);
1905 gdbarch->data[data->index] = NULL;
95160752 1906 }
104c1213 1907 }
b3cc3077
JB
1908 xfree (gdbarch->data);
1909 gdbarch->data = NULL;
104c1213
JM
1910}
1911
1912
76860b5f 1913/* Initialize the current value of the specified per-architecture
b3cc3077
JB
1914 data-pointer. */
1915
95160752
AC
1916void
1917set_gdbarch_data (struct gdbarch *gdbarch,
1918 struct gdbarch_data *data,
1919 void *pointer)
1920{
1921 gdb_assert (data->index < gdbarch->nr_data);
76860b5f
AC
1922 if (gdbarch->data[data->index] != NULL)
1923 {
1924 gdb_assert (data->free != NULL);
1925 data->free (gdbarch, gdbarch->data[data->index]);
1926 }
95160752
AC
1927 gdbarch->data[data->index] = pointer;
1928}
1929
104c1213
JM
1930/* Return the current value of the specified per-architecture
1931 data-pointer. */
1932
1933void *
451fbdda 1934gdbarch_data (struct gdbarch *gdbarch, struct gdbarch_data *data)
104c1213 1935{
451fbdda 1936 gdb_assert (data->index < gdbarch->nr_data);
76860b5f
AC
1937 /* The data-pointer isn't initialized, call init() to get a value but
1938 only if the architecture initializaiton has completed. Otherwise
1939 punt - hope that the caller knows what they are doing. */
1940 if (gdbarch->data[data->index] == NULL
1941 && gdbarch->initialized_p)
1942 {
1943 /* Be careful to detect an initialization cycle. */
1944 gdb_assert (data->init_p);
1945 data->init_p = 0;
1946 gdb_assert (data->init != NULL);
1947 gdbarch->data[data->index] = data->init (gdbarch);
1948 data->init_p = 1;
1949 gdb_assert (gdbarch->data[data->index] != NULL);
1950 }
451fbdda 1951 return gdbarch->data[data->index];
104c1213
JM
1952}
1953
1954
1955
f44c642f 1956/* Keep a registry of swapped data required by GDB modules. */
104c1213
JM
1957
1958struct gdbarch_swap
1959{
1960 void *swap;
1961 struct gdbarch_swap_registration *source;
1962 struct gdbarch_swap *next;
1963};
1964
1965struct gdbarch_swap_registration
1966{
1967 void *data;
1968 unsigned long sizeof_data;
1969 gdbarch_swap_ftype *init;
1970 struct gdbarch_swap_registration *next;
1971};
1972
f44c642f 1973struct gdbarch_swap_registry
104c1213
JM
1974{
1975 int nr;
1976 struct gdbarch_swap_registration *registrations;
1977};
1978
f44c642f 1979struct gdbarch_swap_registry gdbarch_swap_registry =
104c1213
JM
1980{
1981 0, NULL,
1982};
1983
1984void
1985register_gdbarch_swap (void *data,
1986 unsigned long sizeof_data,
1987 gdbarch_swap_ftype *init)
1988{
1989 struct gdbarch_swap_registration **rego;
f44c642f 1990 for (rego = &gdbarch_swap_registry.registrations;
104c1213
JM
1991 (*rego) != NULL;
1992 rego = &(*rego)->next);
1993 (*rego) = XMALLOC (struct gdbarch_swap_registration);
1994 (*rego)->next = NULL;
1995 (*rego)->init = init;
1996 (*rego)->data = data;
1997 (*rego)->sizeof_data = sizeof_data;
1998}
1999
40af4b0c
AC
2000static void
2001clear_gdbarch_swap (struct gdbarch *gdbarch)
2002{
2003 struct gdbarch_swap *curr;
2004 for (curr = gdbarch->swap;
2005 curr != NULL;
2006 curr = curr->next)
2007 {
2008 memset (curr->source->data, 0, curr->source->sizeof_data);
2009 }
2010}
104c1213
JM
2011
2012static void
2013init_gdbarch_swap (struct gdbarch *gdbarch)
2014{
2015 struct gdbarch_swap_registration *rego;
2016 struct gdbarch_swap **curr = &gdbarch->swap;
f44c642f 2017 for (rego = gdbarch_swap_registry.registrations;
104c1213
JM
2018 rego != NULL;
2019 rego = rego->next)
2020 {
2021 if (rego->data != NULL)
2022 {
2023 (*curr) = XMALLOC (struct gdbarch_swap);
2024 (*curr)->source = rego;
2025 (*curr)->swap = xmalloc (rego->sizeof_data);
2026 (*curr)->next = NULL;
104c1213
JM
2027 curr = &(*curr)->next;
2028 }
2029 if (rego->init != NULL)
2030 rego->init ();
2031 }
2032}
2033
2034static void
2035swapout_gdbarch_swap (struct gdbarch *gdbarch)
2036{
2037 struct gdbarch_swap *curr;
2038 for (curr = gdbarch->swap;
2039 curr != NULL;
2040 curr = curr->next)
2041 memcpy (curr->swap, curr->source->data, curr->source->sizeof_data);
2042}
2043
2044static void
2045swapin_gdbarch_swap (struct gdbarch *gdbarch)
2046{
2047 struct gdbarch_swap *curr;
2048 for (curr = gdbarch->swap;
2049 curr != NULL;
2050 curr = curr->next)
2051 memcpy (curr->source->data, curr->swap, curr->source->sizeof_data);
2052}
2053
2054
f44c642f 2055/* Keep a registry of the architectures known by GDB. */
104c1213 2056
4b9b3959 2057struct gdbarch_registration
104c1213
JM
2058{
2059 enum bfd_architecture bfd_architecture;
2060 gdbarch_init_ftype *init;
4b9b3959 2061 gdbarch_dump_tdep_ftype *dump_tdep;
104c1213 2062 struct gdbarch_list *arches;
4b9b3959 2063 struct gdbarch_registration *next;
104c1213
JM
2064};
2065
f44c642f 2066static struct gdbarch_registration *gdbarch_registry = NULL;
104c1213 2067
b4a20239
AC
2068static void
2069append_name (const char ***buf, int *nr, const char *name)
2070{
2071 *buf = xrealloc (*buf, sizeof (char**) * (*nr + 1));
2072 (*buf)[*nr] = name;
2073 *nr += 1;
2074}
2075
2076const char **
2077gdbarch_printable_names (void)
2078{
2079 if (GDB_MULTI_ARCH)
2080 {
2081 /* Accumulate a list of names based on the registed list of
2082 architectures. */
2083 enum bfd_architecture a;
2084 int nr_arches = 0;
2085 const char **arches = NULL;
4b9b3959 2086 struct gdbarch_registration *rego;
f44c642f 2087 for (rego = gdbarch_registry;
b4a20239
AC
2088 rego != NULL;
2089 rego = rego->next)
2090 {
2091 const struct bfd_arch_info *ap;
2092 ap = bfd_lookup_arch (rego->bfd_architecture, 0);
2093 if (ap == NULL)
8e65ff28
AC
2094 internal_error (__FILE__, __LINE__,
2095 "gdbarch_architecture_names: multi-arch unknown");
b4a20239
AC
2096 do
2097 {
2098 append_name (&arches, &nr_arches, ap->printable_name);
2099 ap = ap->next;
2100 }
2101 while (ap != NULL);
2102 }
2103 append_name (&arches, &nr_arches, NULL);
2104 return arches;
2105 }
2106 else
2107 /* Just return all the architectures that BFD knows. Assume that
2108 the legacy architecture framework supports them. */
2109 return bfd_arch_list ();
2110}
2111
2112
104c1213 2113void
4b9b3959
AC
2114gdbarch_register (enum bfd_architecture bfd_architecture,
2115 gdbarch_init_ftype *init,
2116 gdbarch_dump_tdep_ftype *dump_tdep)
104c1213 2117{
4b9b3959 2118 struct gdbarch_registration **curr;
104c1213 2119 const struct bfd_arch_info *bfd_arch_info;
ec3d358c 2120 /* Check that BFD recognizes this architecture */
104c1213
JM
2121 bfd_arch_info = bfd_lookup_arch (bfd_architecture, 0);
2122 if (bfd_arch_info == NULL)
2123 {
8e65ff28
AC
2124 internal_error (__FILE__, __LINE__,
2125 "gdbarch: Attempt to register unknown architecture (%d)",
2126 bfd_architecture);
104c1213
JM
2127 }
2128 /* Check that we haven't seen this architecture before */
f44c642f 2129 for (curr = &gdbarch_registry;
104c1213
JM
2130 (*curr) != NULL;
2131 curr = &(*curr)->next)
2132 {
2133 if (bfd_architecture == (*curr)->bfd_architecture)
8e65ff28
AC
2134 internal_error (__FILE__, __LINE__,
2135 "gdbarch: Duplicate registraration of architecture (%s)",
2136 bfd_arch_info->printable_name);
104c1213
JM
2137 }
2138 /* log it */
2139 if (gdbarch_debug)
2140 fprintf_unfiltered (gdb_stdlog, "register_gdbarch_init (%s, 0x%08lx)\n",
2141 bfd_arch_info->printable_name,
2142 (long) init);
2143 /* Append it */
4b9b3959 2144 (*curr) = XMALLOC (struct gdbarch_registration);
104c1213
JM
2145 (*curr)->bfd_architecture = bfd_architecture;
2146 (*curr)->init = init;
4b9b3959 2147 (*curr)->dump_tdep = dump_tdep;
104c1213
JM
2148 (*curr)->arches = NULL;
2149 (*curr)->next = NULL;
8e1a459b
C
2150 /* When non- multi-arch, install whatever target dump routine we've
2151 been provided - hopefully that routine has been written correctly
4b9b3959
AC
2152 and works regardless of multi-arch. */
2153 if (!GDB_MULTI_ARCH && dump_tdep != NULL
2154 && startup_gdbarch.dump_tdep == NULL)
2155 startup_gdbarch.dump_tdep = dump_tdep;
2156}
2157
2158void
2159register_gdbarch_init (enum bfd_architecture bfd_architecture,
2160 gdbarch_init_ftype *init)
2161{
2162 gdbarch_register (bfd_architecture, init, NULL);
104c1213 2163}
104c1213
JM
2164
2165
2166/* Look for an architecture using gdbarch_info. Base search on only
2167 BFD_ARCH_INFO and BYTE_ORDER. */
2168
2169struct gdbarch_list *
2170gdbarch_list_lookup_by_info (struct gdbarch_list *arches,
2171 const struct gdbarch_info *info)
2172{
2173 for (; arches != NULL; arches = arches->next)
2174 {
2175 if (info->bfd_arch_info != arches->gdbarch->bfd_arch_info)
2176 continue;
2177 if (info->byte_order != arches->gdbarch->byte_order)
2178 continue;
4be87837
DJ
2179 if (info->osabi != arches->gdbarch->osabi)
2180 continue;
104c1213
JM
2181 return arches;
2182 }
2183 return NULL;
2184}
2185
2186
2187/* Update the current architecture. Return ZERO if the update request
2188 failed. */
2189
2190int
16f33e29 2191gdbarch_update_p (struct gdbarch_info info)
104c1213
JM
2192{
2193 struct gdbarch *new_gdbarch;
40af4b0c 2194 struct gdbarch *old_gdbarch;
4b9b3959 2195 struct gdbarch_registration *rego;
104c1213 2196
b732d07d
AC
2197 /* Fill in missing parts of the INFO struct using a number of
2198 sources: \`\`set ...''; INFOabfd supplied; existing target. */
2199
2200 /* \`\`(gdb) set architecture ...'' */
2201 if (info.bfd_arch_info == NULL
2202 && !TARGET_ARCHITECTURE_AUTO)
2203 info.bfd_arch_info = TARGET_ARCHITECTURE;
2204 if (info.bfd_arch_info == NULL
2205 && info.abfd != NULL
2206 && bfd_get_arch (info.abfd) != bfd_arch_unknown
2207 && bfd_get_arch (info.abfd) != bfd_arch_obscure)
2208 info.bfd_arch_info = bfd_get_arch_info (info.abfd);
104c1213 2209 if (info.bfd_arch_info == NULL)
b732d07d
AC
2210 info.bfd_arch_info = TARGET_ARCHITECTURE;
2211
2212 /* \`\`(gdb) set byte-order ...'' */
428721aa 2213 if (info.byte_order == BFD_ENDIAN_UNKNOWN
b732d07d
AC
2214 && !TARGET_BYTE_ORDER_AUTO)
2215 info.byte_order = TARGET_BYTE_ORDER;
2216 /* From the INFO struct. */
428721aa 2217 if (info.byte_order == BFD_ENDIAN_UNKNOWN
b732d07d 2218 && info.abfd != NULL)
d7449b42 2219 info.byte_order = (bfd_big_endian (info.abfd) ? BFD_ENDIAN_BIG
778eb05e 2220 : bfd_little_endian (info.abfd) ? BFD_ENDIAN_LITTLE
428721aa 2221 : BFD_ENDIAN_UNKNOWN);
b732d07d 2222 /* From the current target. */
428721aa 2223 if (info.byte_order == BFD_ENDIAN_UNKNOWN)
b732d07d 2224 info.byte_order = TARGET_BYTE_ORDER;
104c1213 2225
4be87837
DJ
2226 /* \`\`(gdb) set osabi ...'' is handled by gdbarch_lookup_osabi. */
2227 if (info.osabi == GDB_OSABI_UNINITIALIZED)
2228 info.osabi = gdbarch_lookup_osabi (info.abfd);
2229 if (info.osabi == GDB_OSABI_UNINITIALIZED)
2230 info.osabi = current_gdbarch->osabi;
2231
b732d07d
AC
2232 /* Must have found some sort of architecture. */
2233 gdb_assert (info.bfd_arch_info != NULL);
104c1213
JM
2234
2235 if (gdbarch_debug)
2236 {
2237 fprintf_unfiltered (gdb_stdlog,
b732d07d 2238 "gdbarch_update: info.bfd_arch_info %s\n",
104c1213
JM
2239 (info.bfd_arch_info != NULL
2240 ? info.bfd_arch_info->printable_name
2241 : "(null)"));
2242 fprintf_unfiltered (gdb_stdlog,
b732d07d 2243 "gdbarch_update: info.byte_order %d (%s)\n",
104c1213 2244 info.byte_order,
d7449b42 2245 (info.byte_order == BFD_ENDIAN_BIG ? "big"
778eb05e 2246 : info.byte_order == BFD_ENDIAN_LITTLE ? "little"
104c1213 2247 : "default"));
4be87837
DJ
2248 fprintf_unfiltered (gdb_stdlog,
2249 "gdbarch_update: info.osabi %d (%s)\n",
2250 info.osabi, gdbarch_osabi_name (info.osabi));
104c1213 2251 fprintf_unfiltered (gdb_stdlog,
b732d07d 2252 "gdbarch_update: info.abfd 0x%lx\n",
104c1213
JM
2253 (long) info.abfd);
2254 fprintf_unfiltered (gdb_stdlog,
b732d07d 2255 "gdbarch_update: info.tdep_info 0x%lx\n",
104c1213
JM
2256 (long) info.tdep_info);
2257 }
2258
b732d07d
AC
2259 /* Find the target that knows about this architecture. */
2260 for (rego = gdbarch_registry;
2261 rego != NULL;
2262 rego = rego->next)
2263 if (rego->bfd_architecture == info.bfd_arch_info->arch)
2264 break;
2265 if (rego == NULL)
2266 {
2267 if (gdbarch_debug)
2268 fprintf_unfiltered (gdb_stdlog, "gdbarch_update: No matching architecture\\n");
2269 return 0;
2270 }
2271
40af4b0c
AC
2272 /* Swap the data belonging to the old target out setting the
2273 installed data to zero. This stops the ->init() function trying
2274 to refer to the previous architecture's global data structures. */
2275 swapout_gdbarch_swap (current_gdbarch);
2276 clear_gdbarch_swap (current_gdbarch);
2277
2278 /* Save the previously selected architecture, setting the global to
2279 NULL. This stops ->init() trying to use the previous
2280 architecture's configuration. The previous architecture may not
2281 even be of the same architecture family. The most recent
2282 architecture of the same family is found at the head of the
2283 rego->arches list. */
2284 old_gdbarch = current_gdbarch;
2285 current_gdbarch = NULL;
2286
104c1213
JM
2287 /* Ask the target for a replacement architecture. */
2288 new_gdbarch = rego->init (info, rego->arches);
2289
40af4b0c
AC
2290 /* Did the target like it? No. Reject the change and revert to the
2291 old architecture. */
104c1213
JM
2292 if (new_gdbarch == NULL)
2293 {
2294 if (gdbarch_debug)
3d9a5942 2295 fprintf_unfiltered (gdb_stdlog, "gdbarch_update: Target rejected architecture\\n");
40af4b0c
AC
2296 swapin_gdbarch_swap (old_gdbarch);
2297 current_gdbarch = old_gdbarch;
104c1213
JM
2298 return 0;
2299 }
2300
40af4b0c
AC
2301 /* Did the architecture change? No. Oops, put the old architecture
2302 back. */
2303 if (old_gdbarch == new_gdbarch)
104c1213
JM
2304 {
2305 if (gdbarch_debug)
3d9a5942 2306 fprintf_unfiltered (gdb_stdlog, "gdbarch_update: Architecture 0x%08lx (%s) unchanged\\n",
104c1213
JM
2307 (long) new_gdbarch,
2308 new_gdbarch->bfd_arch_info->printable_name);
40af4b0c
AC
2309 swapin_gdbarch_swap (old_gdbarch);
2310 current_gdbarch = old_gdbarch;
104c1213
JM
2311 return 1;
2312 }
2313
0f79675b
AC
2314 /* Is this a pre-existing architecture? Yes. Move it to the front
2315 of the list of architectures (keeping the list sorted Most
2316 Recently Used) and then copy it in. */
2317 {
2318 struct gdbarch_list **list;
2319 for (list = &rego->arches;
2320 (*list) != NULL;
2321 list = &(*list)->next)
2322 {
2323 if ((*list)->gdbarch == new_gdbarch)
2324 {
2325 struct gdbarch_list *this;
2326 if (gdbarch_debug)
2327 fprintf_unfiltered (gdb_stdlog,
2328 "gdbarch_update: Previous architecture 0x%08lx (%s) selected\n",
2329 (long) new_gdbarch,
2330 new_gdbarch->bfd_arch_info->printable_name);
2331 /* Unlink this. */
2332 this = (*list);
2333 (*list) = this->next;
2334 /* Insert in the front. */
2335 this->next = rego->arches;
2336 rego->arches = this;
2337 /* Copy the new architecture in. */
2338 current_gdbarch = new_gdbarch;
2339 swapin_gdbarch_swap (new_gdbarch);
2340 architecture_changed_event ();
2341 return 1;
2342 }
2343 }
2344 }
2345
2346 /* Prepend this new architecture to the architecture list (keep the
2347 list sorted Most Recently Used). */
2348 {
2349 struct gdbarch_list *this = XMALLOC (struct gdbarch_list);
2350 this->next = rego->arches;
2351 this->gdbarch = new_gdbarch;
2352 rego->arches = this;
2353 }
104c1213 2354
76860b5f 2355 /* Switch to this new architecture marking it initialized. */
104c1213 2356 current_gdbarch = new_gdbarch;
76860b5f 2357 current_gdbarch->initialized_p = 1;
104c1213
JM
2358 if (gdbarch_debug)
2359 {
2360 fprintf_unfiltered (gdb_stdlog,
3d9a5942 2361 "gdbarch_update: New architecture 0x%08lx (%s) selected\\n",
104c1213
JM
2362 (long) new_gdbarch,
2363 new_gdbarch->bfd_arch_info->printable_name);
104c1213
JM
2364 }
2365
4b9b3959
AC
2366 /* Check that the newly installed architecture is valid. Plug in
2367 any post init values. */
2368 new_gdbarch->dump_tdep = rego->dump_tdep;
104c1213
JM
2369 verify_gdbarch (new_gdbarch);
2370
cf17c188
AC
2371 /* Initialize the per-architecture memory (swap) areas.
2372 CURRENT_GDBARCH must be update before these modules are
2373 called. */
2374 init_gdbarch_swap (new_gdbarch);
2375
76860b5f 2376 /* Initialize the per-architecture data. CURRENT_GDBARCH
cf17c188 2377 must be updated before these modules are called. */
67c2c32c
KS
2378 architecture_changed_event ();
2379
4b9b3959
AC
2380 if (gdbarch_debug)
2381 gdbarch_dump (current_gdbarch, gdb_stdlog);
2382
104c1213
JM
2383 return 1;
2384}
2385
2386
104c1213
JM
2387/* Disassembler */
2388
2389/* Pointer to the target-dependent disassembly function. */
2390int (*tm_print_insn) (bfd_vma, disassemble_info *);
2391disassemble_info tm_print_insn_info;
2392
2393
104c1213 2394extern void _initialize_gdbarch (void);
b4a20239 2395
104c1213 2396void
34620563 2397_initialize_gdbarch (void)
104c1213 2398{
59233f88
AC
2399 struct cmd_list_element *c;
2400
104c1213
JM
2401 INIT_DISASSEMBLE_INFO_NO_ARCH (tm_print_insn_info, gdb_stdout, (fprintf_ftype)fprintf_filtered);
2402 tm_print_insn_info.flavour = bfd_target_unknown_flavour;
2403 tm_print_insn_info.read_memory_func = dis_asm_read_memory;
2404 tm_print_insn_info.memory_error_func = dis_asm_memory_error;
2405 tm_print_insn_info.print_address_func = dis_asm_print_address;
2406
59233f88 2407 add_show_from_set (add_set_cmd ("arch",
104c1213
JM
2408 class_maintenance,
2409 var_zinteger,
2410 (char *)&gdbarch_debug,
3d9a5942 2411 "Set architecture debugging.\\n\\
59233f88
AC
2412When non-zero, architecture debugging is enabled.", &setdebuglist),
2413 &showdebuglist);
2414 c = add_set_cmd ("archdebug",
2415 class_maintenance,
2416 var_zinteger,
2417 (char *)&gdbarch_debug,
3d9a5942 2418 "Set architecture debugging.\\n\\
59233f88
AC
2419When non-zero, architecture debugging is enabled.", &setlist);
2420
2421 deprecate_cmd (c, "set debug arch");
2422 deprecate_cmd (add_show_from_set (c, &showlist), "show debug arch");
104c1213
JM
2423}
2424EOF
2425
2426# close things off
2427exec 1>&2
2428#../move-if-change new-gdbarch.c gdbarch.c
59233f88 2429compare_new gdbarch.c
This page took 0.379911 seconds and 4 git commands to generate.