archures.c revision 91041
1/* BFD library support routines for architectures. 2 Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 3 2000, 2001, 2002 4 Free Software Foundation, Inc. 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" 26#include "safe-ctype.h" 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 35 <<bfd_arch_info_type>>. 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 45 defined, then all the architectures supported are included. 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 51 default case (an item with a machine field of 0). 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, 68 and 68020 and 68030 for Motorola 68020 and 68030. 69 70.enum bfd_architecture 71.{ 72. bfd_arch_unknown, {* File arch not known. *} 73. bfd_arch_obscure, {* Arch known, not one of these. *} 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 83.#define bfd_mach_mcf5200 9 84.#define bfd_mach_mcf5206e 10 85.#define bfd_mach_mcf5307 11 86.#define bfd_mach_mcf5407 12 87. bfd_arch_vax, {* DEC Vax *} 88. bfd_arch_i960, {* Intel 960 *} 89. {* The order of the following is important. 90. lower number indicates a machine type that 91. only accepts a subset of the instructions 92. available to machines with higher numbers. 93. The exception is the "ca", which is 94. incompatible with all other machines except 95. "core". *} 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. 106. bfd_arch_or32, {* OpenRISC 32 *} 107. 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 115.#define bfd_mach_sparc_v8plusa 5 {* with ultrasparc add'ns. *} 116.#define bfd_mach_sparc_sparclite_le 6 117.#define bfd_mach_sparc_v9 7 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. *} 121.{* Nonzero if MACH has the v9 instruction set. *} 122.#define bfd_mach_sparc_v9_p(mach) \ 123. ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9b \ 124. && (mach) != bfd_mach_sparc_sparclite_le) 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 140.#define bfd_mach_mips12000 12000 141.#define bfd_mach_mips16 16 142.#define bfd_mach_mips5 5 143.#define bfd_mach_mips_sb1 12310201 {* octal 'SB', 01 *} 144.#define bfd_mach_mipsisa32 32 145.#define bfd_mach_mipsisa64 64 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 150.#define bfd_mach_x86_64 3 151.#define bfd_mach_x86_64_intel_syntax 4 152. bfd_arch_we32k, {* AT&T WE32xxx *} 153. bfd_arch_tahoe, {* CCI/Harris Tahoe *} 154. bfd_arch_i860, {* Intel 860 *} 155. bfd_arch_i370, {* IBM 360/370 Mainframes *} 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 165. bfd_arch_pdp11, {* DEC PDP-11 *} 166. bfd_arch_powerpc, {* PowerPC *} 167.#define bfd_mach_ppc 0 168.#define bfd_mach_ppc64 1 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 185. bfd_arch_rs6000, {* IBM RS/6000 *} 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 190. bfd_arch_hppa, {* HP PA RISC *} 191. bfd_arch_d10v, {* Mitsubishi D10V *} 192.#define bfd_mach_d10v 0 193.#define bfd_mach_d10v_ts2 2 194.#define bfd_mach_d10v_ts3 3 195. bfd_arch_d30v, {* Mitsubishi D30V *} 196. bfd_arch_m68hc11, {* Motorola 68HC11 *} 197. bfd_arch_m68hc12, {* Motorola 68HC12 *} 198. bfd_arch_z8k, {* Zilog Z8000 *} 199.#define bfd_mach_z8001 1 200.#define bfd_mach_z8002 2 201. bfd_arch_h8500, {* Hitachi H8/500 *} 202. bfd_arch_sh, {* Hitachi SH *} 203.#define bfd_mach_sh 0 204.#define bfd_mach_sh2 0x20 205.#define bfd_mach_sh_dsp 0x2d 206.#define bfd_mach_sh3 0x30 207.#define bfd_mach_sh3_dsp 0x3d 208.#define bfd_mach_sh3e 0x3e 209.#define bfd_mach_sh4 0x40 210.#define bfd_mach_sh5 0x50 211. bfd_arch_alpha, {* Dec Alpha *} 212.#define bfd_mach_alpha_ev4 0x10 213.#define bfd_mach_alpha_ev5 0x20 214.#define bfd_mach_alpha_ev6 0x30 215. bfd_arch_arm, {* Advanced Risc Machines ARM. *} 216.#define bfd_mach_arm_2 1 217.#define bfd_mach_arm_2a 2 218.#define bfd_mach_arm_3 3 219.#define bfd_mach_arm_3M 4 220.#define bfd_mach_arm_4 5 221.#define bfd_mach_arm_4T 6 222.#define bfd_mach_arm_5 7 223.#define bfd_mach_arm_5T 8 224.#define bfd_mach_arm_5TE 9 225.#define bfd_mach_arm_XScale 10 226. bfd_arch_ns32k, {* National Semiconductors ns32000 *} 227. bfd_arch_w65, {* WDC 65816 *} 228. bfd_arch_tic30, {* Texas Instruments TMS320C30 *} 229. bfd_arch_tic54x, {* Texas Instruments TMS320C54X *} 230. bfd_arch_tic80, {* TI TMS320c80 (MVP) *} 231. bfd_arch_v850, {* NEC V850 *} 232.#define bfd_mach_v850 0 233.#define bfd_mach_v850e 'E' 234.#define bfd_mach_v850ea 'A' 235. bfd_arch_arc, {* ARC Cores *} 236.#define bfd_mach_arc_5 0 237.#define bfd_mach_arc_6 1 238.#define bfd_mach_arc_7 2 239.#define bfd_mach_arc_8 3 240. bfd_arch_m32r, {* Mitsubishi M32R/D *} 241.#define bfd_mach_m32r 0 {* For backwards compatibility. *} 242.#define bfd_mach_m32rx 'x' 243. bfd_arch_mn10200, {* Matsushita MN10200 *} 244. bfd_arch_mn10300, {* Matsushita MN10300 *} 245.#define bfd_mach_mn10300 300 246.#define bfd_mach_am33 330 247. bfd_arch_fr30, 248.#define bfd_mach_fr30 0x46523330 249. bfd_arch_mcore, 250. bfd_arch_ia64, {* HP/Intel ia64 *} 251.#define bfd_mach_ia64_elf64 0 252.#define bfd_mach_ia64_elf32 1 253. bfd_arch_pj, 254. bfd_arch_avr, {* Atmel AVR microcontrollers. *} 255.#define bfd_mach_avr1 1 256.#define bfd_mach_avr2 2 257.#define bfd_mach_avr3 3 258.#define bfd_mach_avr4 4 259.#define bfd_mach_avr5 5 260. bfd_arch_cris, {* Axis CRIS *} 261. bfd_arch_s390, {* IBM s390 *} 262.#define bfd_mach_s390_esa 0 263.#define bfd_mach_s390_esame 1 264. bfd_arch_openrisc, {* OpenRISC *} 265. bfd_arch_mmix, {* Donald Knuth's educational processor. *} 266. bfd_arch_xstormy16, 267.#define bfd_mach_xstormy16 0 268. bfd_arch_last 269. }; 270*/ 271 272/* 273SUBSECTION 274 bfd_arch_info 275 276DESCRIPTION 277 This structure contains information on architectures for use 278 within BFD. 279 280. 281.typedef struct bfd_arch_info 282.{ 283. int bits_per_word; 284. int bits_per_address; 285. int bits_per_byte; 286. enum bfd_architecture arch; 287. unsigned long mach; 288. const char *arch_name; 289. const char *printable_name; 290. unsigned int section_align_power; 291. {* True if this is the default machine for the architecture. *} 292. boolean the_default; 293. const struct bfd_arch_info * (*compatible) 294. PARAMS ((const struct bfd_arch_info *a, 295. const struct bfd_arch_info *b)); 296. 297. boolean (*scan) PARAMS ((const struct bfd_arch_info *, const char *)); 298. 299. const struct bfd_arch_info *next; 300.} 301.bfd_arch_info_type; 302. 303*/ 304 305extern const bfd_arch_info_type bfd_a29k_arch; 306extern const bfd_arch_info_type bfd_alpha_arch; 307extern const bfd_arch_info_type bfd_arc_arch; 308extern const bfd_arch_info_type bfd_arm_arch; 309extern const bfd_arch_info_type bfd_avr_arch; 310extern const bfd_arch_info_type bfd_cris_arch; 311extern const bfd_arch_info_type bfd_d10v_arch; 312extern const bfd_arch_info_type bfd_d30v_arch; 313extern const bfd_arch_info_type bfd_fr30_arch; 314extern const bfd_arch_info_type bfd_h8300_arch; 315extern const bfd_arch_info_type bfd_h8500_arch; 316extern const bfd_arch_info_type bfd_hppa_arch; 317extern const bfd_arch_info_type bfd_i370_arch; 318extern const bfd_arch_info_type bfd_i386_arch; 319extern const bfd_arch_info_type bfd_i860_arch; 320extern const bfd_arch_info_type bfd_i960_arch; 321extern const bfd_arch_info_type bfd_ia64_arch; 322extern const bfd_arch_info_type bfd_m32r_arch; 323extern const bfd_arch_info_type bfd_m68hc11_arch; 324extern const bfd_arch_info_type bfd_m68hc12_arch; 325extern const bfd_arch_info_type bfd_m68k_arch; 326extern const bfd_arch_info_type bfd_m88k_arch; 327extern const bfd_arch_info_type bfd_mcore_arch; 328extern const bfd_arch_info_type bfd_mips_arch; 329extern const bfd_arch_info_type bfd_mmix_arch; 330extern const bfd_arch_info_type bfd_mn10200_arch; 331extern const bfd_arch_info_type bfd_mn10300_arch; 332extern const bfd_arch_info_type bfd_ns32k_arch; 333extern const bfd_arch_info_type bfd_openrisc_arch; 334extern const bfd_arch_info_type bfd_or32_arch; 335extern const bfd_arch_info_type bfd_pdp11_arch; 336extern const bfd_arch_info_type bfd_pj_arch; 337extern const bfd_arch_info_type bfd_powerpc_archs[]; 338#define bfd_powerpc_arch bfd_powerpc_archs[0] 339extern const bfd_arch_info_type bfd_rs6000_arch; 340extern const bfd_arch_info_type bfd_s390_arch; 341extern const bfd_arch_info_type bfd_sh_arch; 342extern const bfd_arch_info_type bfd_sparc_arch; 343extern const bfd_arch_info_type bfd_tic30_arch; 344extern const bfd_arch_info_type bfd_tic54x_arch; 345extern const bfd_arch_info_type bfd_tic80_arch; 346extern const bfd_arch_info_type bfd_v850_arch; 347extern const bfd_arch_info_type bfd_vax_arch; 348extern const bfd_arch_info_type bfd_we32k_arch; 349extern const bfd_arch_info_type bfd_w65_arch; 350extern const bfd_arch_info_type bfd_xstormy16_arch; 351extern const bfd_arch_info_type bfd_z8k_arch; 352 353static const bfd_arch_info_type * const bfd_archures_list[] = 354 { 355#ifdef SELECT_ARCHITECTURES 356 SELECT_ARCHITECTURES, 357#else 358 &bfd_a29k_arch, 359 &bfd_alpha_arch, 360 &bfd_arc_arch, 361 &bfd_arm_arch, 362 &bfd_avr_arch, 363 &bfd_cris_arch, 364 &bfd_d10v_arch, 365 &bfd_d30v_arch, 366 &bfd_fr30_arch, 367 &bfd_h8300_arch, 368 &bfd_h8500_arch, 369 &bfd_hppa_arch, 370 &bfd_i370_arch, 371 &bfd_i386_arch, 372 &bfd_i860_arch, 373 &bfd_i960_arch, 374 &bfd_ia64_arch, 375 &bfd_m32r_arch, 376 &bfd_m68hc11_arch, 377 &bfd_m68hc12_arch, 378 &bfd_m68k_arch, 379 &bfd_m88k_arch, 380 &bfd_mcore_arch, 381 &bfd_mips_arch, 382 &bfd_mmix_arch, 383 &bfd_mn10200_arch, 384 &bfd_mn10300_arch, 385 &bfd_ns32k_arch, 386 &bfd_openrisc_arch, 387 &bfd_or32_arch, 388 &bfd_pdp11_arch, 389 &bfd_powerpc_arch, 390 &bfd_rs6000_arch, 391 &bfd_s390_arch, 392 &bfd_sh_arch, 393 &bfd_sparc_arch, 394 &bfd_tic30_arch, 395 &bfd_tic54x_arch, 396 &bfd_tic80_arch, 397 &bfd_v850_arch, 398 &bfd_vax_arch, 399 &bfd_w65_arch, 400 &bfd_we32k_arch, 401 &bfd_xstormy16_arch, 402 &bfd_z8k_arch, 403#endif 404 0 405}; 406 407/* 408FUNCTION 409 bfd_printable_name 410 411SYNOPSIS 412 const char *bfd_printable_name(bfd *abfd); 413 414DESCRIPTION 415 Return a printable string representing the architecture and machine 416 from the pointer to the architecture info structure. 417 418*/ 419 420const char * 421bfd_printable_name (abfd) 422 bfd *abfd; 423{ 424 return abfd->arch_info->printable_name; 425} 426 427/* 428FUNCTION 429 bfd_scan_arch 430 431SYNOPSIS 432 const bfd_arch_info_type *bfd_scan_arch(const char *string); 433 434DESCRIPTION 435 Figure out if BFD supports any cpu which could be described with 436 the name @var{string}. Return a pointer to an <<arch_info>> 437 structure if a machine is found, otherwise NULL. 438*/ 439 440const bfd_arch_info_type * 441bfd_scan_arch (string) 442 const char *string; 443{ 444 const bfd_arch_info_type * const *app, *ap; 445 446 /* Look through all the installed architectures. */ 447 for (app = bfd_archures_list; *app != NULL; app++) 448 { 449 for (ap = *app; ap != NULL; ap = ap->next) 450 { 451 if (ap->scan (ap, string)) 452 return ap; 453 } 454 } 455 456 return NULL; 457} 458 459/* 460FUNCTION 461 bfd_arch_list 462 463SYNOPSIS 464 const char **bfd_arch_list(void); 465 466DESCRIPTION 467 Return a freshly malloced NULL-terminated vector of the names 468 of all the valid BFD architectures. Do not modify the names. 469*/ 470 471const char ** 472bfd_arch_list () 473{ 474 int vec_length = 0; 475 const char **name_ptr; 476 const char **name_list; 477 const bfd_arch_info_type * const *app; 478 bfd_size_type amt; 479 480 /* Determine the number of architectures. */ 481 vec_length = 0; 482 for (app = bfd_archures_list; *app != NULL; app++) 483 { 484 const bfd_arch_info_type *ap; 485 for (ap = *app; ap != NULL; ap = ap->next) 486 { 487 vec_length++; 488 } 489 } 490 491 amt = (vec_length + 1) * sizeof (char **); 492 name_list = (const char **) bfd_malloc (amt); 493 if (name_list == NULL) 494 return NULL; 495 496 /* Point the list at each of the names. */ 497 name_ptr = name_list; 498 for (app = bfd_archures_list; *app != NULL; app++) 499 { 500 const bfd_arch_info_type *ap; 501 for (ap = *app; ap != NULL; ap = ap->next) 502 { 503 *name_ptr = ap->printable_name; 504 name_ptr++; 505 } 506 } 507 *name_ptr = NULL; 508 509 return name_list; 510} 511 512/* 513FUNCTION 514 bfd_arch_get_compatible 515 516SYNOPSIS 517 const bfd_arch_info_type *bfd_arch_get_compatible( 518 const bfd *abfd, 519 const bfd *bbfd); 520 521DESCRIPTION 522 Determine whether two BFDs' 523 architectures and machine types are compatible. Calculates 524 the lowest common denominator between the two architectures 525 and machine types implied by the BFDs and returns a pointer to 526 an <<arch_info>> structure describing the compatible machine. 527*/ 528 529const bfd_arch_info_type * 530bfd_arch_get_compatible (abfd, bbfd) 531 const bfd *abfd; 532 const bfd *bbfd; 533{ 534 /* If either architecture is unknown, then all we can do is assume 535 the user knows what he's doing. */ 536 if (abfd->arch_info->arch == bfd_arch_unknown) 537 return bbfd->arch_info; 538 if (bbfd->arch_info->arch == bfd_arch_unknown) 539 return abfd->arch_info; 540 541 /* Otherwise architecture-specific code has to decide. */ 542 return abfd->arch_info->compatible (abfd->arch_info, bbfd->arch_info); 543} 544 545/* 546INTERNAL_DEFINITION 547 bfd_default_arch_struct 548 549DESCRIPTION 550 The <<bfd_default_arch_struct>> is an item of 551 <<bfd_arch_info_type>> which has been initialized to a fairly 552 generic state. A BFD starts life by pointing to this 553 structure, until the correct back end has determined the real 554 architecture of the file. 555 556.extern const bfd_arch_info_type bfd_default_arch_struct; 557*/ 558 559const bfd_arch_info_type bfd_default_arch_struct = { 560 32, 32, 8, bfd_arch_unknown, 0, "unknown", "unknown", 2, true, 561 bfd_default_compatible, 562 bfd_default_scan, 563 0, 564}; 565 566/* 567FUNCTION 568 bfd_set_arch_info 569 570SYNOPSIS 571 void bfd_set_arch_info(bfd *abfd, const bfd_arch_info_type *arg); 572 573DESCRIPTION 574 Set the architecture info of @var{abfd} to @var{arg}. 575*/ 576 577void 578bfd_set_arch_info (abfd, arg) 579 bfd *abfd; 580 const bfd_arch_info_type *arg; 581{ 582 abfd->arch_info = arg; 583} 584 585/* 586INTERNAL_FUNCTION 587 bfd_default_set_arch_mach 588 589SYNOPSIS 590 boolean bfd_default_set_arch_mach(bfd *abfd, 591 enum bfd_architecture arch, 592 unsigned long mach); 593 594DESCRIPTION 595 Set the architecture and machine type in BFD @var{abfd} 596 to @var{arch} and @var{mach}. Find the correct 597 pointer to a structure and insert it into the <<arch_info>> 598 pointer. 599*/ 600 601boolean 602bfd_default_set_arch_mach (abfd, arch, mach) 603 bfd *abfd; 604 enum bfd_architecture arch; 605 unsigned long mach; 606{ 607 const bfd_arch_info_type * const *app, *ap; 608 609 for (app = bfd_archures_list; *app != NULL; app++) 610 { 611 for (ap = *app; ap != NULL; ap = ap->next) 612 { 613 if (ap->arch == arch 614 && (ap->mach == mach 615 || (mach == 0 && ap->the_default))) 616 { 617 abfd->arch_info = ap; 618 return true; 619 } 620 } 621 } 622 623 abfd->arch_info = &bfd_default_arch_struct; 624 bfd_set_error (bfd_error_bad_value); 625 return false; 626} 627 628/* 629FUNCTION 630 bfd_get_arch 631 632SYNOPSIS 633 enum bfd_architecture bfd_get_arch(bfd *abfd); 634 635DESCRIPTION 636 Return the enumerated type which describes the BFD @var{abfd}'s 637 architecture. 638*/ 639 640enum bfd_architecture 641bfd_get_arch (abfd) 642 bfd *abfd; 643{ 644 return abfd->arch_info->arch; 645} 646 647/* 648FUNCTION 649 bfd_get_mach 650 651SYNOPSIS 652 unsigned long bfd_get_mach(bfd *abfd); 653 654DESCRIPTION 655 Return the long type which describes the BFD @var{abfd}'s 656 machine. 657*/ 658 659unsigned long 660bfd_get_mach (abfd) 661 bfd *abfd; 662{ 663 return abfd->arch_info->mach; 664} 665 666/* 667FUNCTION 668 bfd_arch_bits_per_byte 669 670SYNOPSIS 671 unsigned int bfd_arch_bits_per_byte(bfd *abfd); 672 673DESCRIPTION 674 Return the number of bits in one of the BFD @var{abfd}'s 675 architecture's bytes. 676*/ 677 678unsigned int 679bfd_arch_bits_per_byte (abfd) 680 bfd *abfd; 681{ 682 return abfd->arch_info->bits_per_byte; 683} 684 685/* 686FUNCTION 687 bfd_arch_bits_per_address 688 689SYNOPSIS 690 unsigned int bfd_arch_bits_per_address(bfd *abfd); 691 692DESCRIPTION 693 Return the number of bits in one of the BFD @var{abfd}'s 694 architecture's addresses. 695*/ 696 697unsigned int 698bfd_arch_bits_per_address (abfd) 699 bfd *abfd; 700{ 701 return abfd->arch_info->bits_per_address; 702} 703 704/* 705INTERNAL_FUNCTION 706 bfd_default_compatible 707 708SYNOPSIS 709 const bfd_arch_info_type *bfd_default_compatible 710 (const bfd_arch_info_type *a, 711 const bfd_arch_info_type *b); 712 713DESCRIPTION 714 The default function for testing for compatibility. 715*/ 716 717const bfd_arch_info_type * 718bfd_default_compatible (a, b) 719 const bfd_arch_info_type *a; 720 const bfd_arch_info_type *b; 721{ 722 if (a->arch != b->arch) 723 return NULL; 724 725 if (a->mach > b->mach) 726 return a; 727 728 if (b->mach > a->mach) 729 return b; 730 731 return a; 732} 733 734/* 735INTERNAL_FUNCTION 736 bfd_default_scan 737 738SYNOPSIS 739 boolean bfd_default_scan(const struct bfd_arch_info *info, const char *string); 740 741DESCRIPTION 742 The default function for working out whether this is an 743 architecture hit and a machine hit. 744*/ 745 746boolean 747bfd_default_scan (info, string) 748 const bfd_arch_info_type *info; 749 const char *string; 750{ 751 const char *ptr_src; 752 const char *ptr_tst; 753 unsigned long number; 754 enum bfd_architecture arch; 755 const char *printable_name_colon; 756 757 /* Exact match of the architecture name (ARCH_NAME) and also the 758 default architecture? */ 759 if (strcasecmp (string, info->arch_name) == 0 760 && info->the_default) 761 return true; 762 763 /* Exact match of the machine name (PRINTABLE_NAME)? */ 764 if (strcasecmp (string, info->printable_name) == 0) 765 return true; 766 767 /* Given that printable_name contains no colon, attempt to match: 768 ARCH_NAME [ ":" ] PRINTABLE_NAME? */ 769 printable_name_colon = strchr (info->printable_name, ':'); 770 if (printable_name_colon == NULL) 771 { 772 size_t strlen_arch_name = strlen (info->arch_name); 773 if (strncasecmp (string, info->arch_name, strlen_arch_name) == 0) 774 { 775 if (string[strlen_arch_name] == ':') 776 { 777 if (strcasecmp (string + strlen_arch_name + 1, 778 info->printable_name) == 0) 779 return true; 780 } 781 else 782 { 783 if (strcasecmp (string + strlen_arch_name, 784 info->printable_name) == 0) 785 return true; 786 } 787 } 788 } 789 790 /* Given that PRINTABLE_NAME has the form: <arch> ":" <mach>; 791 Attempt to match: <arch> <mach>? */ 792 if (printable_name_colon != NULL) 793 { 794 size_t colon_index = printable_name_colon - info->printable_name; 795 if (strncasecmp (string, info->printable_name, colon_index) == 0 796 && strcasecmp (string + colon_index, 797 info->printable_name + colon_index + 1) == 0) 798 return true; 799 } 800 801 /* Given that PRINTABLE_NAME has the form: <arch> ":" <mach>; Do not 802 attempt to match just <mach>, it could be ambigious. This test 803 is left until later. */ 804 805 /* NOTE: The below is retained for compatibility only. Please do 806 not add to this code. */ 807 808 /* See how much of the supplied string matches with the 809 architecture, eg the string m68k:68020 would match the 68k entry 810 up to the :, then we get left with the machine number. */ 811 812 for (ptr_src = string, ptr_tst = info->arch_name; 813 *ptr_src && *ptr_tst; 814 ptr_src++, ptr_tst++) 815 { 816 if (*ptr_src != *ptr_tst) 817 break; 818 } 819 820 /* Chewed up as much of the architecture as will match, skip any 821 colons. */ 822 if (*ptr_src == ':') 823 ptr_src++; 824 825 if (*ptr_src == 0) 826 { 827 /* Nothing more, then only keep this one if it is the default 828 machine for this architecture. */ 829 return info->the_default; 830 } 831 832 number = 0; 833 while (ISDIGIT (*ptr_src)) 834 { 835 number = number * 10 + *ptr_src - '0'; 836 ptr_src++; 837 } 838 839 /* NOTE: The below is retained for compatibility only. 840 PLEASE DO NOT ADD TO THIS CODE. */ 841 842 switch (number) 843 { 844 /* FIXME: These are needed to parse IEEE objects. */ 845 /* The following seven case's are here only for compatibility with 846 older binutils (at least IEEE objects from binutils 2.9.1 require 847 them). */ 848 case bfd_mach_m68000: 849 case bfd_mach_m68010: 850 case bfd_mach_m68020: 851 case bfd_mach_m68030: 852 case bfd_mach_m68040: 853 case bfd_mach_m68060: 854 case bfd_mach_cpu32: 855 arch = bfd_arch_m68k; 856 break; 857 case 68000: 858 arch = bfd_arch_m68k; 859 number = bfd_mach_m68000; 860 break; 861 case 68010: 862 arch = bfd_arch_m68k; 863 number = bfd_mach_m68010; 864 break; 865 case 68020: 866 arch = bfd_arch_m68k; 867 number = bfd_mach_m68020; 868 break; 869 case 68030: 870 arch = bfd_arch_m68k; 871 number = bfd_mach_m68030; 872 break; 873 case 68040: 874 arch = bfd_arch_m68k; 875 number = bfd_mach_m68040; 876 break; 877 case 68060: 878 arch = bfd_arch_m68k; 879 number = bfd_mach_m68060; 880 break; 881 case 68332: 882 arch = bfd_arch_m68k; 883 number = bfd_mach_cpu32; 884 break; 885 case 5200: 886 arch = bfd_arch_m68k; 887 number = bfd_mach_mcf5200; 888 break; 889 case 5206: 890 arch = bfd_arch_m68k; 891 number = bfd_mach_mcf5206e; 892 break; 893 case 5307: 894 arch = bfd_arch_m68k; 895 number = bfd_mach_mcf5307; 896 break; 897 case 5407: 898 arch = bfd_arch_m68k; 899 number = bfd_mach_mcf5407; 900 break; 901 902 case 32000: 903 arch = bfd_arch_we32k; 904 break; 905 906 case 3000: 907 arch = bfd_arch_mips; 908 number = bfd_mach_mips3000; 909 break; 910 911 case 4000: 912 arch = bfd_arch_mips; 913 number = bfd_mach_mips4000; 914 break; 915 916 case 6000: 917 arch = bfd_arch_rs6000; 918 break; 919 920 case 7410: 921 arch = bfd_arch_sh; 922 number = bfd_mach_sh_dsp; 923 break; 924 925 case 7708: 926 arch = bfd_arch_sh; 927 number = bfd_mach_sh3; 928 break; 929 930 case 7729: 931 arch = bfd_arch_sh; 932 number = bfd_mach_sh3_dsp; 933 break; 934 935 case 7750: 936 arch = bfd_arch_sh; 937 number = bfd_mach_sh4; 938 break; 939 940 default: 941 return false; 942 } 943 944 if (arch != info->arch) 945 return false; 946 947 if (number != info->mach) 948 return false; 949 950 return true; 951} 952 953/* 954FUNCTION 955 bfd_get_arch_info 956 957SYNOPSIS 958 const bfd_arch_info_type * bfd_get_arch_info(bfd *abfd); 959 960DESCRIPTION 961 Return the architecture info struct in @var{abfd}. 962*/ 963 964const bfd_arch_info_type * 965bfd_get_arch_info (abfd) 966 bfd *abfd; 967{ 968 return abfd->arch_info; 969} 970 971/* 972FUNCTION 973 bfd_lookup_arch 974 975SYNOPSIS 976 const bfd_arch_info_type *bfd_lookup_arch 977 (enum bfd_architecture 978 arch, 979 unsigned long machine); 980 981DESCRIPTION 982 Look for the architecure info structure which matches the 983 arguments @var{arch} and @var{machine}. A machine of 0 matches the 984 machine/architecture structure which marks itself as the 985 default. 986*/ 987 988const bfd_arch_info_type * 989bfd_lookup_arch (arch, machine) 990 enum bfd_architecture arch; 991 unsigned long machine; 992{ 993 const bfd_arch_info_type * const *app, *ap; 994 995 for (app = bfd_archures_list; *app != NULL; app++) 996 { 997 for (ap = *app; ap != NULL; ap = ap->next) 998 { 999 if (ap->arch == arch 1000 && (ap->mach == machine 1001 || (machine == 0 && ap->the_default))) 1002 return ap; 1003 } 1004 } 1005 1006 return NULL; 1007} 1008 1009/* 1010FUNCTION 1011 bfd_printable_arch_mach 1012 1013SYNOPSIS 1014 const char *bfd_printable_arch_mach 1015 (enum bfd_architecture arch, unsigned long machine); 1016 1017DESCRIPTION 1018 Return a printable string representing the architecture and 1019 machine type. 1020 1021 This routine is depreciated. 1022*/ 1023 1024const char * 1025bfd_printable_arch_mach (arch, machine) 1026 enum bfd_architecture arch; 1027 unsigned long machine; 1028{ 1029 const bfd_arch_info_type *ap = bfd_lookup_arch (arch, machine); 1030 1031 if (ap) 1032 return ap->printable_name; 1033 return "UNKNOWN!"; 1034} 1035 1036/* 1037FUNCTION 1038 bfd_octets_per_byte 1039 1040SYNOPSIS 1041 unsigned int bfd_octets_per_byte(bfd *abfd); 1042 1043DESCRIPTION 1044 Return the number of octets (8-bit quantities) per target byte 1045 (minimum addressable unit). In most cases, this will be one, but some 1046 DSP targets have 16, 32, or even 48 bits per byte. 1047*/ 1048 1049unsigned int 1050bfd_octets_per_byte (abfd) 1051 bfd *abfd; 1052{ 1053 return bfd_arch_mach_octets_per_byte (bfd_get_arch (abfd), 1054 bfd_get_mach (abfd)); 1055} 1056 1057/* 1058FUNCTION 1059 bfd_arch_mach_octets_per_byte 1060 1061SYNOPSIS 1062 unsigned int bfd_arch_mach_octets_per_byte(enum bfd_architecture arch, 1063 unsigned long machine); 1064 1065DESCRIPTION 1066 See bfd_octets_per_byte. 1067 1068 This routine is provided for those cases where a bfd * is not 1069 available 1070*/ 1071 1072unsigned int 1073bfd_arch_mach_octets_per_byte (arch, mach) 1074 enum bfd_architecture arch; 1075 unsigned long mach; 1076{ 1077 const bfd_arch_info_type *ap = bfd_lookup_arch (arch, mach); 1078 1079 if (ap) 1080 return ap->bits_per_byte / 8; 1081 return 1; 1082} 1083