]> Git Repo - binutils.git/blame - bfd/archures.c
projects / binutils.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Add DLX target
[binutils.git] / bfd / archures.c
CommitLineData
252b5132 1/* BFD library support routines for architectures.
7898deda 2 Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
3b16e843 3 2000, 2001, 2002
d4845d57 4 Free Software Foundation, Inc.
252b5132
RH		 5 Hacked by John Gilmore and Steve Chamberlain of Cygnus Support.
6
7This file is part of BFD, the Binary File Descriptor library.
8
9This program is free software; you can redistribute it and/or modify
10it under the terms of the GNU General Public License as published by
11the Free Software Foundation; either version 2 of the License, or
12(at your option) any later version.
13
14This program is distributed in the hope that it will be useful,
15but WITHOUT ANY WARRANTY; without even the implied warranty of
16MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17GNU General Public License for more details.
18
19You should have received a copy of the GNU General Public License
20along with this program; if not, write to the Free Software
21Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
22
23#include "bfd.h"
24#include "sysdep.h"
25#include "libbfd.h"
3882b010 26#include "safe-ctype.h"
252b5132
RH		 27
28/*
29
30SECTION
31 Architectures
32
33 BFD keeps one atom in a BFD describing the
34 architecture of the data attached to the BFD: a pointer to a
0ef5a5bd 35 <<bfd_arch_info_type>>.
252b5132
RH		 36
37 Pointers to structures can be requested independently of a BFD
38 so that an architecture's information can be interrogated
39 without access to an open BFD.
40
41 The architecture information is provided by each architecture package.
42 The set of default architectures is selected by the macro
43 <<SELECT_ARCHITECTURES>>. This is normally set up in the
44 @file{config/@var{target}.mt} file of your choice. If the name is not
0ef5a5bd 45 defined, then all the architectures supported are included.
252b5132
RH		 46
47 When BFD starts up, all the architectures are called with an
48 initialize method. It is up to the architecture back end to
49 insert as many items into the list of architectures as it wants to;
50 generally this would be one for each machine and one for the
0ef5a5bd 51 default case (an item with a machine field of 0).
252b5132
RH		 52
53 BFD's idea of an architecture is implemented in @file{archures.c}.
54*/
55
56/*
57
58SUBSECTION
59 bfd_architecture
60
61DESCRIPTION
62 This enum gives the object file's CPU architecture, in a
63 global sense---i.e., what processor family does it belong to?
64 Another field indicates which processor within
65 the family is in use. The machine gives a number which
66 distinguishes different versions of the architecture,
67 containing, for example, 2 and 3 for Intel i960 KA and i960 KB,
0ef5a5bd 68 and 68020 and 68030 for Motorola 68020 and 68030.
252b5132 69
0ef5a5bd 70.enum bfd_architecture
252b5132 71.{
c312a6a4
NC		 72. bfd_arch_unknown, {* File arch not known. *}
73. bfd_arch_obscure, {* Arch known, not one of these. *}
252b5132
RH		 74. bfd_arch_m68k, {* Motorola 68xxx *}
75.#define bfd_mach_m68000 1
76.#define bfd_mach_m68008 2
77.#define bfd_mach_m68010 3
78.#define bfd_mach_m68020 4
79.#define bfd_mach_m68030 5
80.#define bfd_mach_m68040 6
81.#define bfd_mach_m68060 7
82.#define bfd_mach_cpu32 8
3cac17ae
NC		 83.#define bfd_mach_mcf5200 9
84.#define bfd_mach_mcf5206e 10
85.#define bfd_mach_mcf5307 11
86.#define bfd_mach_mcf5407 12
0ef5a5bd 87. bfd_arch_vax, {* DEC Vax *}
252b5132
RH		 88. bfd_arch_i960, {* Intel 960 *}
89. {* The order of the following is important.
0ef5a5bd 90. lower number indicates a machine type that
252b5132
RH		 91. only accepts a subset of the instructions
92. available to machines with higher numbers.
93. The exception is the "ca", which is
0ef5a5bd 94. incompatible with all other machines except
c312a6a4 95. "core". *}
252b5132
RH		 96.
97.#define bfd_mach_i960_core 1
98.#define bfd_mach_i960_ka_sa 2
99.#define bfd_mach_i960_kb_sb 3
100.#define bfd_mach_i960_mc 4
101.#define bfd_mach_i960_xa 5
102.#define bfd_mach_i960_ca 6
103.#define bfd_mach_i960_jx 7
104.#define bfd_mach_i960_hx 8
105.
3b16e843
NC		 106. bfd_arch_or32, {* OpenRISC 32 *}
107.
252b5132
RH		 108. bfd_arch_a29k, {* AMD 29000 *}
109. bfd_arch_sparc, {* SPARC *}
110.#define bfd_mach_sparc 1
111.{* The difference between v8plus and v9 is that v9 is a true 64 bit env. *}
112.#define bfd_mach_sparc_sparclet 2
113.#define bfd_mach_sparc_sparclite 3
114.#define bfd_mach_sparc_v8plus 4
c312a6a4 115.#define bfd_mach_sparc_v8plusa 5 {* with ultrasparc add'ns. *}
252b5132
RH		 116.#define bfd_mach_sparc_sparclite_le 6
117.#define bfd_mach_sparc_v9 7
c312a6a4
NC		 118.#define bfd_mach_sparc_v9a 8 {* with ultrasparc add'ns. *}
119.#define bfd_mach_sparc_v8plusb 9 {* with cheetah add'ns. *}
120.#define bfd_mach_sparc_v9b 10 {* with cheetah add'ns. *}
252b5132
RH		 121.{* Nonzero if MACH has the v9 instruction set. *}
122.#define bfd_mach_sparc_v9_p(mach) \
19f7b010
JJ		 123. ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9b \
124. && (mach) != bfd_mach_sparc_sparclite_le)
252b5132
RH		 125. bfd_arch_mips, {* MIPS Rxxxx *}
126.#define bfd_mach_mips3000 3000
127.#define bfd_mach_mips3900 3900
128.#define bfd_mach_mips4000 4000
129.#define bfd_mach_mips4010 4010
130.#define bfd_mach_mips4100 4100
131.#define bfd_mach_mips4111 4111
132.#define bfd_mach_mips4300 4300
133.#define bfd_mach_mips4400 4400
134.#define bfd_mach_mips4600 4600
135.#define bfd_mach_mips4650 4650
136.#define bfd_mach_mips5000 5000
137.#define bfd_mach_mips6000 6000
138.#define bfd_mach_mips8000 8000
139.#define bfd_mach_mips10000 10000
d1cf510e 140.#define bfd_mach_mips12000 12000
252b5132 141.#define bfd_mach_mips16 16
84ea6cf2 142.#define bfd_mach_mips5 5
c6c98b38 143.#define bfd_mach_mips_sb1 12310201 {* octal 'SB', 01 *}
a1cd6a8f
EC		 144.#define bfd_mach_mipsisa32 32
145.#define bfd_mach_mipsisa64 64
252b5132
RH		 146. bfd_arch_i386, {* Intel 386 *}
147.#define bfd_mach_i386_i386 0
148.#define bfd_mach_i386_i8086 1
149.#define bfd_mach_i386_i386_intel_syntax 2
8d88c4ca
NC		 150.#define bfd_mach_x86_64 3
151.#define bfd_mach_x86_64_intel_syntax 4
252b5132
RH		 152. bfd_arch_we32k, {* AT&T WE32xxx *}
153. bfd_arch_tahoe, {* CCI/Harris Tahoe *}
154. bfd_arch_i860, {* Intel 860 *}
5b93d8bb 155. bfd_arch_i370, {* IBM 360/370 Mainframes *}
252b5132
RH		 156. bfd_arch_romp, {* IBM ROMP PC/RT *}
157. bfd_arch_alliant, {* Alliant *}
158. bfd_arch_convex, {* Convex *}
159. bfd_arch_m88k, {* Motorola 88xxx *}
160. bfd_arch_pyramid, {* Pyramid Technology *}
161. bfd_arch_h8300, {* Hitachi H8/300 *}
162.#define bfd_mach_h8300 1
163.#define bfd_mach_h8300h 2
164.#define bfd_mach_h8300s 3
e135f41b 165. bfd_arch_pdp11, {* DEC PDP-11 *}
252b5132 166. bfd_arch_powerpc, {* PowerPC *}
87f33987 167.#define bfd_mach_ppc 0
899f54f5 168.#define bfd_mach_ppc64 1
87f33987
ND		 169.#define bfd_mach_ppc_403 403
170.#define bfd_mach_ppc_403gc 4030
171.#define bfd_mach_ppc_505 505
172.#define bfd_mach_ppc_601 601
173.#define bfd_mach_ppc_602 602
174.#define bfd_mach_ppc_603 603
175.#define bfd_mach_ppc_ec603e 6031
176.#define bfd_mach_ppc_604 604
177.#define bfd_mach_ppc_620 620
178.#define bfd_mach_ppc_630 630
179.#define bfd_mach_ppc_750 750
180.#define bfd_mach_ppc_860 860
181.#define bfd_mach_ppc_a35 35
182.#define bfd_mach_ppc_rs64ii 642
183.#define bfd_mach_ppc_rs64iii 643
184.#define bfd_mach_ppc_7400 7400
252b5132 185. bfd_arch_rs6000, {* IBM RS/6000 *}
87f33987
ND		 186.#define bfd_mach_rs6k 0
187.#define bfd_mach_rs6k_rs1 6001
188.#define bfd_mach_rs6k_rsc 6003
189.#define bfd_mach_rs6k_rs2 6002
252b5132
RH		 190. bfd_arch_hppa, {* HP PA RISC *}
191. bfd_arch_d10v, {* Mitsubishi D10V *}
7af8cca9
MM		 192.#define bfd_mach_d10v 0
193.#define bfd_mach_d10v_ts2 2
194.#define bfd_mach_d10v_ts3 3
252b5132 195. bfd_arch_d30v, {* Mitsubishi D30V *}
d172d4ba 196. bfd_arch_dlx, {* DLX *}
60bcf0fa
NC		 197. bfd_arch_m68hc11, {* Motorola 68HC11 *}
198. bfd_arch_m68hc12, {* Motorola 68HC12 *}
252b5132
RH		 199. bfd_arch_z8k, {* Zilog Z8000 *}
200.#define bfd_mach_z8001 1
201.#define bfd_mach_z8002 2
202. bfd_arch_h8500, {* Hitachi H8/500 *}
203. bfd_arch_sh, {* Hitachi SH *}
204.#define bfd_mach_sh 0
d4845d57
JR		 205.#define bfd_mach_sh2 0x20
206.#define bfd_mach_sh_dsp 0x2d
252b5132 207.#define bfd_mach_sh3 0x30
d4845d57 208.#define bfd_mach_sh3_dsp 0x3d
252b5132 209.#define bfd_mach_sh3e 0x3e
d4845d57 210.#define bfd_mach_sh4 0x40
fbca6ad9 211.#define bfd_mach_sh5 0x50
252b5132
RH		 212. bfd_arch_alpha, {* Dec Alpha *}
213.#define bfd_mach_alpha_ev4 0x10
214.#define bfd_mach_alpha_ev5 0x20
215.#define bfd_mach_alpha_ev6 0x30
c312a6a4 216. bfd_arch_arm, {* Advanced Risc Machines ARM. *}
252b5132 217.#define bfd_mach_arm_2 1
478d07d6 218.#define bfd_mach_arm_2a 2
252b5132
RH		 219.#define bfd_mach_arm_3 3
220.#define bfd_mach_arm_3M 4
478d07d6 221.#define bfd_mach_arm_4 5
252b5132 222.#define bfd_mach_arm_4T 6
478d07d6
NC		 223.#define bfd_mach_arm_5 7
224.#define bfd_mach_arm_5T 8
077b8428
NC		 225.#define bfd_mach_arm_5TE 9
226.#define bfd_mach_arm_XScale 10
252b5132
RH		 227. bfd_arch_ns32k, {* National Semiconductors ns32000 *}
228. bfd_arch_w65, {* WDC 65816 *}
229. bfd_arch_tic30, {* Texas Instruments TMS320C30 *}
81635ce4 230. bfd_arch_tic54x, {* Texas Instruments TMS320C54X *}
252b5132
RH		 231. bfd_arch_tic80, {* TI TMS320c80 (MVP) *}
232. bfd_arch_v850, {* NEC V850 *}
233.#define bfd_mach_v850 0
234.#define bfd_mach_v850e 'E'
235.#define bfd_mach_v850ea 'A'
0d2bcfaf
NC		 236. bfd_arch_arc, {* ARC Cores *}
237.#define bfd_mach_arc_5 0
238.#define bfd_mach_arc_6 1
239.#define bfd_mach_arc_7 2
240.#define bfd_mach_arc_8 3
252b5132 241. bfd_arch_m32r, {* Mitsubishi M32R/D *}
c312a6a4 242.#define bfd_mach_m32r 0 {* For backwards compatibility. *}
a23ef39f 243.#define bfd_mach_m32rx 'x'
252b5132
RH		 244. bfd_arch_mn10200, {* Matsushita MN10200 *}
245. bfd_arch_mn10300, {* Matsushita MN10300 *}
246.#define bfd_mach_mn10300 300
31f8dc8f 247.#define bfd_mach_am33 330
252b5132
RH		 248. bfd_arch_fr30,
249.#define bfd_mach_fr30 0x46523330
250. bfd_arch_mcore,
800eeca4 251. bfd_arch_ia64, {* HP/Intel ia64 *}
bbe66d08
JW		 252.#define bfd_mach_ia64_elf64 0
253.#define bfd_mach_ia64_elf32 1
0bcb993b 254. bfd_arch_pj,
c312a6a4 255. bfd_arch_avr, {* Atmel AVR microcontrollers. *}
adde6300
AM		 256.#define bfd_mach_avr1 1
257.#define bfd_mach_avr2 2
258.#define bfd_mach_avr3 3
259.#define bfd_mach_avr4 4
65aa24b6 260.#define bfd_mach_avr5 5
06c15ad7 261. bfd_arch_cris, {* Axis CRIS *}
a85d7ed0 262. bfd_arch_s390, {* IBM s390 *}
befc3abb
MS		 263.#define bfd_mach_s390_31 0
264.#define bfd_mach_s390_64 1
b3baf5d0 265. bfd_arch_openrisc, {* OpenRISC *}
c312a6a4 266. bfd_arch_mmix, {* Donald Knuth's educational processor. *}
93fbbb04
GK		 267. bfd_arch_xstormy16,
268.#define bfd_mach_xstormy16 0
252b5132
RH		 269. bfd_arch_last
270. };
252b5132
RH		 271*/
272
273/*
252b5132
RH		 274SUBSECTION
275 bfd_arch_info
276
277DESCRIPTION
278 This structure contains information on architectures for use
279 within BFD.
280
281.
0ef5a5bd 282.typedef struct bfd_arch_info
252b5132
RH		 283.{
284. int bits_per_word;
285. int bits_per_address;
286. int bits_per_byte;
287. enum bfd_architecture arch;
288. unsigned long mach;
289. const char *arch_name;
290. const char *printable_name;
291. unsigned int section_align_power;
aa3d5824
AM		 292. {* True if this is the default machine for the architecture.
293. The default arch should be the first entry for an arch so that
294. all the entries for that arch can be accessed via <<next>>. *}
0ef5a5bd 295. boolean the_default;
252b5132
RH		 296. const struct bfd_arch_info * (*compatible)
297. PARAMS ((const struct bfd_arch_info *a,
298. const struct bfd_arch_info *b));
299.
300. boolean (*scan) PARAMS ((const struct bfd_arch_info *, const char *));
301.
302. const struct bfd_arch_info *next;
3b16e843
NC		 303.}
304.bfd_arch_info_type;
305.
252b5132
RH		 306*/
307
308extern const bfd_arch_info_type bfd_a29k_arch;
309extern const bfd_arch_info_type bfd_alpha_arch;
310extern const bfd_arch_info_type bfd_arc_arch;
311extern const bfd_arch_info_type bfd_arm_arch;
3b16e843 312extern const bfd_arch_info_type bfd_avr_arch;
06c15ad7 313extern const bfd_arch_info_type bfd_cris_arch;
252b5132
RH		 314extern const bfd_arch_info_type bfd_d10v_arch;
315extern const bfd_arch_info_type bfd_d30v_arch;
d172d4ba 316extern const bfd_arch_info_type bfd_dlx_arch;
3b16e843 317extern const bfd_arch_info_type bfd_fr30_arch;
252b5132
RH		 318extern const bfd_arch_info_type bfd_h8300_arch;
319extern const bfd_arch_info_type bfd_h8500_arch;
320extern const bfd_arch_info_type bfd_hppa_arch;
5b93d8bb 321extern const bfd_arch_info_type bfd_i370_arch;
252b5132
RH		 322extern const bfd_arch_info_type bfd_i386_arch;
323extern const bfd_arch_info_type bfd_i860_arch;
324extern const bfd_arch_info_type bfd_i960_arch;
3b16e843 325extern const bfd_arch_info_type bfd_ia64_arch;
252b5132 326extern const bfd_arch_info_type bfd_m32r_arch;
60bcf0fa
NC		 327extern const bfd_arch_info_type bfd_m68hc11_arch;
328extern const bfd_arch_info_type bfd_m68hc12_arch;
252b5132
RH		 329extern const bfd_arch_info_type bfd_m68k_arch;
330extern const bfd_arch_info_type bfd_m88k_arch;
3b16e843 331extern const bfd_arch_info_type bfd_mcore_arch;
252b5132 332extern const bfd_arch_info_type bfd_mips_arch;
3b16e843 333extern const bfd_arch_info_type bfd_mmix_arch;
252b5132
RH		 334extern const bfd_arch_info_type bfd_mn10200_arch;
335extern const bfd_arch_info_type bfd_mn10300_arch;
3b16e843
NC		 336extern const bfd_arch_info_type bfd_ns32k_arch;
337extern const bfd_arch_info_type bfd_openrisc_arch;
338extern const bfd_arch_info_type bfd_or32_arch;
e135f41b 339extern const bfd_arch_info_type bfd_pdp11_arch;
3b16e843 340extern const bfd_arch_info_type bfd_pj_arch;
899f54f5
AM		 341extern const bfd_arch_info_type bfd_powerpc_archs[];
342#define bfd_powerpc_arch bfd_powerpc_archs[0]
252b5132 343extern const bfd_arch_info_type bfd_rs6000_arch;
3b16e843 344extern const bfd_arch_info_type bfd_s390_arch;
252b5132
RH		 345extern const bfd_arch_info_type bfd_sh_arch;
346extern const bfd_arch_info_type bfd_sparc_arch;
347extern const bfd_arch_info_type bfd_tic30_arch;
81635ce4 348extern const bfd_arch_info_type bfd_tic54x_arch;
252b5132 349extern const bfd_arch_info_type bfd_tic80_arch;
3b16e843 350extern const bfd_arch_info_type bfd_v850_arch;
252b5132
RH		 351extern const bfd_arch_info_type bfd_vax_arch;
352extern const bfd_arch_info_type bfd_we32k_arch;
252b5132 353extern const bfd_arch_info_type bfd_w65_arch;
93fbbb04 354extern const bfd_arch_info_type bfd_xstormy16_arch;
3b16e843 355extern const bfd_arch_info_type bfd_z8k_arch;
252b5132 356
3b16e843
NC		 357static const bfd_arch_info_type * const bfd_archures_list[] =
358 {
252b5132 359#ifdef SELECT_ARCHITECTURES
3b16e843 360 SELECT_ARCHITECTURES,
252b5132 361#else
3b16e843
NC		 362 &bfd_a29k_arch,
363 &bfd_alpha_arch,
364 &bfd_arc_arch,
365 &bfd_arm_arch,
366 &bfd_avr_arch,
367 &bfd_cris_arch,
368 &bfd_d10v_arch,
369 &bfd_d30v_arch,
d172d4ba 370 &bfd_dlx_arch,
3b16e843
NC		 371 &bfd_fr30_arch,
372 &bfd_h8300_arch,
373 &bfd_h8500_arch,
374 &bfd_hppa_arch,
375 &bfd_i370_arch,
376 &bfd_i386_arch,
377 &bfd_i860_arch,
378 &bfd_i960_arch,
379 &bfd_ia64_arch,
380 &bfd_m32r_arch,
381 &bfd_m68hc11_arch,
382 &bfd_m68hc12_arch,
383 &bfd_m68k_arch,
384 &bfd_m88k_arch,
385 &bfd_mcore_arch,
386 &bfd_mips_arch,
387 &bfd_mmix_arch,
388 &bfd_mn10200_arch,
389 &bfd_mn10300_arch,
390 &bfd_ns32k_arch,
391 &bfd_openrisc_arch,
392 &bfd_or32_arch,
393 &bfd_pdp11_arch,
394 &bfd_powerpc_arch,
395 &bfd_rs6000_arch,
396 &bfd_s390_arch,
397 &bfd_sh_arch,
398 &bfd_sparc_arch,
399 &bfd_tic30_arch,
400 &bfd_tic54x_arch,
401 &bfd_tic80_arch,
402 &bfd_v850_arch,
403 &bfd_vax_arch,
404 &bfd_w65_arch,
405 &bfd_we32k_arch,
406 &bfd_xstormy16_arch,
407 &bfd_z8k_arch,
252b5132
RH		 408#endif
409 0
410};
411
412/*
413FUNCTION
414 bfd_printable_name
415
416SYNOPSIS
417 const char *bfd_printable_name(bfd *abfd);
418
419DESCRIPTION
420 Return a printable string representing the architecture and machine
421 from the pointer to the architecture info structure.
422
423*/
424
425const char *
426bfd_printable_name (abfd)
427 bfd *abfd;
428{
429 return abfd->arch_info->printable_name;
430}
431
252b5132
RH		 432/*
433FUNCTION
434 bfd_scan_arch
435
436SYNOPSIS
437 const bfd_arch_info_type *bfd_scan_arch(const char *string);
438
439DESCRIPTION
440 Figure out if BFD supports any cpu which could be described with
441 the name @var{string}. Return a pointer to an <<arch_info>>
442 structure if a machine is found, otherwise NULL.
252b5132
RH		 443*/
444
445const bfd_arch_info_type *
446bfd_scan_arch (string)
447 const char *string;
448{
449 const bfd_arch_info_type * const *app, *ap;
450
047066e1 451 /* Look through all the installed architectures. */
252b5132
RH		 452 for (app = bfd_archures_list; *app != NULL; app++)
453 {
454 for (ap = *app; ap != NULL; ap = ap->next)
455 {
456 if (ap->scan (ap, string))
457 return ap;
458 }
459 }
460
461 return NULL;
462}
463
252b5132
RH		 464/*
465FUNCTION
466 bfd_arch_list
467
468SYNOPSIS
469 const char **bfd_arch_list(void);
470
471DESCRIPTION
472 Return a freshly malloced NULL-terminated vector of the names
473 of all the valid BFD architectures. Do not modify the names.
252b5132
RH		 474*/
475
476const char **
477bfd_arch_list ()
478{
479 int vec_length = 0;
480 const char **name_ptr;
481 const char **name_list;
482 const bfd_arch_info_type * const *app;
dc810e39 483 bfd_size_type amt;
252b5132 484
047066e1 485 /* Determine the number of architectures. */
252b5132
RH		 486 vec_length = 0;
487 for (app = bfd_archures_list; *app != NULL; app++)
488 {
489 const bfd_arch_info_type *ap;
490 for (ap = *app; ap != NULL; ap = ap->next)
491 {
492 vec_length++;
493 }
494 }
495
dc810e39
AM		 496 amt = (vec_length + 1) * sizeof (char **);
497 name_list = (const char **) bfd_malloc (amt);
252b5132
RH		 498 if (name_list == NULL)
499 return NULL;
500
047066e1 501 /* Point the list at each of the names. */
252b5132
RH		 502 name_ptr = name_list;
503 for (app = bfd_archures_list; *app != NULL; app++)
504 {
505 const bfd_arch_info_type *ap;
506 for (ap = *app; ap != NULL; ap = ap->next)
507 {
508 *name_ptr = ap->printable_name;
509 name_ptr++;
510 }
511 }
512 *name_ptr = NULL;
513
514 return name_list;
515}
516
252b5132
RH		 517/*
518FUNCTION
519 bfd_arch_get_compatible
520
521SYNOPSIS
522 const bfd_arch_info_type *bfd_arch_get_compatible(
523 const bfd *abfd,
524 const bfd *bbfd);
525
526DESCRIPTION
527 Determine whether two BFDs'
528 architectures and machine types are compatible. Calculates
529 the lowest common denominator between the two architectures
530 and machine types implied by the BFDs and returns a pointer to
531 an <<arch_info>> structure describing the compatible machine.
532*/
533
534const bfd_arch_info_type *
535bfd_arch_get_compatible (abfd, bbfd)
536 const bfd *abfd;
537 const bfd *bbfd;
538{
539 /* If either architecture is unknown, then all we can do is assume
540 the user knows what he's doing. */
541 if (abfd->arch_info->arch == bfd_arch_unknown)
047066e1 542 return bbfd->arch_info;
252b5132 543 if (bbfd->arch_info->arch == bfd_arch_unknown)
047066e1 544 return abfd->arch_info;
252b5132
RH		 545
546 /* Otherwise architecture-specific code has to decide. */
547 return abfd->arch_info->compatible (abfd->arch_info, bbfd->arch_info);
548}
549
252b5132
RH		 550/*
551INTERNAL_DEFINITION
552 bfd_default_arch_struct
553
554DESCRIPTION
555 The <<bfd_default_arch_struct>> is an item of
556 <<bfd_arch_info_type>> which has been initialized to a fairly
557 generic state. A BFD starts life by pointing to this
558 structure, until the correct back end has determined the real
559 architecture of the file.
560
561.extern const bfd_arch_info_type bfd_default_arch_struct;
252b5132
RH		 562*/
563
047066e1
KH		 564const bfd_arch_info_type bfd_default_arch_struct = {
565 32, 32, 8, bfd_arch_unknown, 0, "unknown", "unknown", 2, true,
566 bfd_default_compatible,
567 bfd_default_scan,
568 0,
252b5132
RH		 569};
570
571/*
572FUNCTION
573 bfd_set_arch_info
574
575SYNOPSIS
576 void bfd_set_arch_info(bfd *abfd, const bfd_arch_info_type *arg);
577
578DESCRIPTION
579 Set the architecture info of @var{abfd} to @var{arg}.
580*/
581
582void
583bfd_set_arch_info (abfd, arg)
584 bfd *abfd;
585 const bfd_arch_info_type *arg;
586{
587 abfd->arch_info = arg;
588}
589
590/*
591INTERNAL_FUNCTION
592 bfd_default_set_arch_mach
593
594SYNOPSIS
595 boolean bfd_default_set_arch_mach(bfd *abfd,
596 enum bfd_architecture arch,
597 unsigned long mach);
598
599DESCRIPTION
600 Set the architecture and machine type in BFD @var{abfd}
601 to @var{arch} and @var{mach}. Find the correct
602 pointer to a structure and insert it into the <<arch_info>>
0ef5a5bd 603 pointer.
252b5132
RH		 604*/
605
606boolean
607bfd_default_set_arch_mach (abfd, arch, mach)
608 bfd *abfd;
609 enum bfd_architecture arch;
610 unsigned long mach;
611{
99dc0092
AM		 612 abfd->arch_info = bfd_lookup_arch (arch, mach);
613 if (abfd->arch_info != NULL)
614 return true;
252b5132
RH		 615
616 abfd->arch_info = &bfd_default_arch_struct;
617 bfd_set_error (bfd_error_bad_value);
618 return false;
619}
620
252b5132
RH		 621/*
622FUNCTION
623 bfd_get_arch
624
625SYNOPSIS
626 enum bfd_architecture bfd_get_arch(bfd *abfd);
627
628DESCRIPTION
629 Return the enumerated type which describes the BFD @var{abfd}'s
630 architecture.
252b5132
RH		 631*/
632
633enum bfd_architecture
634bfd_get_arch (abfd)
635 bfd *abfd;
636{
047066e1 637 return abfd->arch_info->arch;
252b5132
RH		 638}
639
640/*
641FUNCTION
642 bfd_get_mach
643
644SYNOPSIS
645 unsigned long bfd_get_mach(bfd *abfd);
646
647DESCRIPTION
648 Return the long type which describes the BFD @var{abfd}'s
649 machine.
650*/
651
0ef5a5bd 652unsigned long
252b5132
RH		 653bfd_get_mach (abfd)
654 bfd *abfd;
655{
047066e1 656 return abfd->arch_info->mach;
252b5132
RH		 657}
658
659/*
660FUNCTION
661 bfd_arch_bits_per_byte
662
663SYNOPSIS
664 unsigned int bfd_arch_bits_per_byte(bfd *abfd);
665
666DESCRIPTION
667 Return the number of bits in one of the BFD @var{abfd}'s
668 architecture's bytes.
252b5132
RH		 669*/
670
671unsigned int
672bfd_arch_bits_per_byte (abfd)
673 bfd *abfd;
674{
675 return abfd->arch_info->bits_per_byte;
676}
677
678/*
679FUNCTION
680 bfd_arch_bits_per_address
681
682SYNOPSIS
683 unsigned int bfd_arch_bits_per_address(bfd *abfd);
684
685DESCRIPTION
686 Return the number of bits in one of the BFD @var{abfd}'s
687 architecture's addresses.
688*/
689
690unsigned int
691bfd_arch_bits_per_address (abfd)
692 bfd *abfd;
693{
694 return abfd->arch_info->bits_per_address;
695}
696
252b5132 697/*
0ef5a5bd 698INTERNAL_FUNCTION
252b5132
RH		 699 bfd_default_compatible
700
701SYNOPSIS
702 const bfd_arch_info_type *bfd_default_compatible
703 (const bfd_arch_info_type *a,
704 const bfd_arch_info_type *b);
705
706DESCRIPTION
707 The default function for testing for compatibility.
708*/
709
710const bfd_arch_info_type *
047066e1 711bfd_default_compatible (a, b)
252b5132
RH		 712 const bfd_arch_info_type *a;
713 const bfd_arch_info_type *b;
714{
715 if (a->arch != b->arch)
716 return NULL;
717
b74fa2cd
AM		 718 if (a->bits_per_word != b->bits_per_word)
719 return NULL;
720
252b5132
RH		 721 if (a->mach > b->mach)
722 return a;
723
724 if (b->mach > a->mach)
725 return b;
726
727 return a;
728}
729
252b5132
RH		 730/*
731INTERNAL_FUNCTION
732 bfd_default_scan
733
734SYNOPSIS
735 boolean bfd_default_scan(const struct bfd_arch_info *info, const char *string);
736
737DESCRIPTION
738 The default function for working out whether this is an
739 architecture hit and a machine hit.
740*/
741
0ef5a5bd 742boolean
252b5132 743bfd_default_scan (info, string)
d1cf510e 744 const bfd_arch_info_type *info;
252b5132
RH		 745 const char *string;
746{
747 const char *ptr_src;
748 const char *ptr_tst;
749 unsigned long number;
750 enum bfd_architecture arch;
751 const char *printable_name_colon;
752
753 /* Exact match of the architecture name (ARCH_NAME) and also the
047066e1 754 default architecture? */
252b5132
RH		 755 if (strcasecmp (string, info->arch_name) == 0
756 && info->the_default)
757 return true;
758
047066e1 759 /* Exact match of the machine name (PRINTABLE_NAME)? */
252b5132
RH		 760 if (strcasecmp (string, info->printable_name) == 0)
761 return true;
0ef5a5bd 762
252b5132 763 /* Given that printable_name contains no colon, attempt to match:
047066e1 764 ARCH_NAME [ ":" ] PRINTABLE_NAME? */
252b5132
RH		 765 printable_name_colon = strchr (info->printable_name, ':');
766 if (printable_name_colon == NULL)
767 {
dc810e39 768 size_t strlen_arch_name = strlen (info->arch_name);
252b5132
RH		 769 if (strncasecmp (string, info->arch_name, strlen_arch_name) == 0)
770 {
771 if (string[strlen_arch_name] == ':')
772 {
773 if (strcasecmp (string + strlen_arch_name + 1,
774 info->printable_name) == 0)
775 return true;
776 }
777 else
778 {
779 if (strcasecmp (string + strlen_arch_name,
780 info->printable_name) == 0)
781 return true;
782 }
783 }
784 }
785
786 /* Given that PRINTABLE_NAME has the form: <arch> ":" <mach>;
047066e1 787 Attempt to match: <arch> <mach>? */
252b5132
RH		 788 if (printable_name_colon != NULL)
789 {
dc810e39 790 size_t colon_index = printable_name_colon - info->printable_name;
252b5132
RH		 791 if (strncasecmp (string, info->printable_name, colon_index) == 0
792 && strcasecmp (string + colon_index,
793 info->printable_name + colon_index + 1) == 0)
794 return true;
795 }
796
797 /* Given that PRINTABLE_NAME has the form: <arch> ":" <mach>; Do not
798 attempt to match just <mach>, it could be ambigious. This test
0ef5a5bd 799 is left until later. */
252b5132 800
047066e1
KH		 801 /* NOTE: The below is retained for compatibility only. Please do
802 not add to this code. */
252b5132
RH		 803
804 /* See how much of the supplied string matches with the
805 architecture, eg the string m68k:68020 would match the 68k entry
047066e1 806 up to the :, then we get left with the machine number. */
252b5132 807
0ef5a5bd 808 for (ptr_src = string, ptr_tst = info->arch_name;
252b5132 809 *ptr_src && *ptr_tst;
0ef5a5bd 810 ptr_src++, ptr_tst++)
252b5132 811 {
047066e1
KH		 812 if (*ptr_src != *ptr_tst)
813 break;
252b5132
RH		 814 }
815
816 /* Chewed up as much of the architecture as will match, skip any
047066e1 817 colons. */
252b5132
RH		 818 if (*ptr_src == ':')
819 ptr_src++;
0ef5a5bd 820
252b5132
RH		 821 if (*ptr_src == 0)
822 {
047066e1
KH		 823 /* Nothing more, then only keep this one if it is the default
824 machine for this architecture. */
252b5132
RH		 825 return info->the_default;
826 }
827
828 number = 0;
3882b010 829 while (ISDIGIT (*ptr_src))
252b5132 830 {
047066e1 831 number = number * 10 + *ptr_src - '0';
252b5132
RH		 832 ptr_src++;
833 }
834
835 /* NOTE: The below is retained for compatibility only.
0ef5a5bd 836 PLEASE DO NOT ADD TO THIS CODE. */
252b5132 837
0ef5a5bd 838 switch (number)
252b5132
RH		 839 {
840 /* FIXME: These are needed to parse IEEE objects. */
83ea41ad
NC		 841 /* The following seven case's are here only for compatibility with
842 older binutils (at least IEEE objects from binutils 2.9.1 require
843 them). */
844 case bfd_mach_m68000:
845 case bfd_mach_m68010:
846 case bfd_mach_m68020:
847 case bfd_mach_m68030:
848 case bfd_mach_m68040:
849 case bfd_mach_m68060:
850 case bfd_mach_cpu32:
851 arch = bfd_arch_m68k;
852 break;
0ef5a5bd 853 case 68000:
252b5132
RH		 854 arch = bfd_arch_m68k;
855 number = bfd_mach_m68000;
856 break;
857 case 68010:
858 arch = bfd_arch_m68k;
859 number = bfd_mach_m68010;
860 break;
861 case 68020:
862 arch = bfd_arch_m68k;
863 number = bfd_mach_m68020;
864 break;
865 case 68030:
866 arch = bfd_arch_m68k;
867 number = bfd_mach_m68030;
868 break;
869 case 68040:
870 arch = bfd_arch_m68k;
871 number = bfd_mach_m68040;
872 break;
873 case 68060:
874 arch = bfd_arch_m68k;
875 number = bfd_mach_m68060;
876 break;
877 case 68332:
878 arch = bfd_arch_m68k;
879 number = bfd_mach_cpu32;
880 break;
3cac17ae
NC		 881 case 5200:
882 arch = bfd_arch_m68k;
883 number = bfd_mach_mcf5200;
884 break;
885 case 5206:
886 arch = bfd_arch_m68k;
887 number = bfd_mach_mcf5206e;
888 break;
889 case 5307:
890 arch = bfd_arch_m68k;
891 number = bfd_mach_mcf5307;
892 break;
893 case 5407:
894 arch = bfd_arch_m68k;
895 number = bfd_mach_mcf5407;
896 break;
252b5132
RH		 897
898 case 32000:
899 arch = bfd_arch_we32k;
900 break;
901
902 case 3000:
903 arch = bfd_arch_mips;
904 number = bfd_mach_mips3000;
905 break;
906
907 case 4000:
908 arch = bfd_arch_mips;
909 number = bfd_mach_mips4000;
910 break;
911
912 case 6000:
913 arch = bfd_arch_rs6000;
914 break;
915
d4845d57
JR		 916 case 7410:
917 arch = bfd_arch_sh;
918 number = bfd_mach_sh_dsp;
919 break;
920
921 case 7708:
922 arch = bfd_arch_sh;
923 number = bfd_mach_sh3;
924 break;
925
926 case 7729:
927 arch = bfd_arch_sh;
928 number = bfd_mach_sh3_dsp;
929 break;
930
931 case 7750:
932 arch = bfd_arch_sh;
933 number = bfd_mach_sh4;
934 break;
935
0ef5a5bd 936 default:
252b5132
RH		 937 return false;
938 }
939
0ef5a5bd 940 if (arch != info->arch)
252b5132
RH		 941 return false;
942
943 if (number != info->mach)
944 return false;
945
946 return true;
947}
948
252b5132
RH		 949/*
950FUNCTION
951 bfd_get_arch_info
952
953SYNOPSIS
954 const bfd_arch_info_type * bfd_get_arch_info(bfd *abfd);
955
956DESCRIPTION
957 Return the architecture info struct in @var{abfd}.
958*/
959
960const bfd_arch_info_type *
961bfd_get_arch_info (abfd)
962 bfd *abfd;
963{
964 return abfd->arch_info;
965}
966
252b5132
RH		 967/*
968FUNCTION
969 bfd_lookup_arch
970
971SYNOPSIS
972 const bfd_arch_info_type *bfd_lookup_arch
973 (enum bfd_architecture
974 arch,
975 unsigned long machine);
976
977DESCRIPTION
978 Look for the architecure info structure which matches the
979 arguments @var{arch} and @var{machine}. A machine of 0 matches the
980 machine/architecture structure which marks itself as the
aa3d5824 981 default.
252b5132
RH		 982*/
983
0ef5a5bd 984const bfd_arch_info_type *
252b5132
RH		 985bfd_lookup_arch (arch, machine)
986 enum bfd_architecture arch;
987 unsigned long machine;
988{
989 const bfd_arch_info_type * const *app, *ap;
990
991 for (app = bfd_archures_list; *app != NULL; app++)
992 {
993 for (ap = *app; ap != NULL; ap = ap->next)
994 {
995 if (ap->arch == arch
996 && (ap->mach == machine
997 || (machine == 0 && ap->the_default)))
998 return ap;
999 }
1000 }
1001
1002 return NULL;
1003}
1004
252b5132
RH		 1005/*
1006FUNCTION
1007 bfd_printable_arch_mach
1008
1009SYNOPSIS
1010 const char *bfd_printable_arch_mach
1011 (enum bfd_architecture arch, unsigned long machine);
1012
1013DESCRIPTION
1014 Return a printable string representing the architecture and
0ef5a5bd 1015 machine type.
252b5132
RH		 1016
1017 This routine is depreciated.
1018*/
1019
1020const char *
1021bfd_printable_arch_mach (arch, machine)
1022 enum bfd_architecture arch;
1023 unsigned long machine;
1024{
047066e1 1025 const bfd_arch_info_type *ap = bfd_lookup_arch (arch, machine);
252b5132 1026
047066e1
KH		 1027 if (ap)
1028 return ap->printable_name;
1029 return "UNKNOWN!";
252b5132 1030}
9a968f43
NC		 1031
1032/*
1033FUNCTION
1034 bfd_octets_per_byte
1035
1036SYNOPSIS
f6af82bd 1037 unsigned int bfd_octets_per_byte(bfd *abfd);
9a968f43
NC		 1038
1039DESCRIPTION
1040 Return the number of octets (8-bit quantities) per target byte
1041 (minimum addressable unit). In most cases, this will be one, but some
1042 DSP targets have 16, 32, or even 48 bits per byte.
9a968f43
NC		 1043*/
1044
f6af82bd 1045unsigned int
9a968f43 1046bfd_octets_per_byte (abfd)
047066e1 1047 bfd *abfd;
9a968f43 1048{
047066e1
KH		 1049 return bfd_arch_mach_octets_per_byte (bfd_get_arch (abfd),
1050 bfd_get_mach (abfd));
9a968f43
NC		 1051}
1052
1053/*
1054FUNCTION
1055 bfd_arch_mach_octets_per_byte
1056
1057SYNOPSIS
f6af82bd
AM		 1058 unsigned int bfd_arch_mach_octets_per_byte(enum bfd_architecture arch,
1059 unsigned long machine);
9a968f43
NC		 1060
1061DESCRIPTION
1062 See bfd_octets_per_byte.
0ef5a5bd 1063
9a968f43
NC		 1064 This routine is provided for those cases where a bfd * is not
1065 available
1066*/
1067
f6af82bd 1068unsigned int
9a968f43 1069bfd_arch_mach_octets_per_byte (arch, mach)
047066e1
KH		 1070 enum bfd_architecture arch;
1071 unsigned long mach;
9a968f43 1072{
047066e1 1073 const bfd_arch_info_type *ap = bfd_lookup_arch (arch, mach);
0ef5a5bd 1074
047066e1
KH		 1075 if (ap)
1076 return ap->bits_per_byte / 8;
1077 return 1;
9a968f43 1078}
Empty description
This page took 0.418609 seconds and 4 git commands to generate.