gdb/arch-utils.c

   1 /* Dynamic architecture support for GDB, the GNU debugger.
   2
   3    Copyright 1998, 1999, 2000, 2001, 2002, 2003, 2004 Free Software
   4    Foundation, Inc.
   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,
  21    Boston, MA 02111-1307, USA.  */
  22
  23 #include "defs.h"
  24
  25 #include "arch-utils.h"
  26 #include "buildsym.h"
  27 #include "gdbcmd.h"
  28 #include "inferior.h"           /* enum CALL_DUMMY_LOCATION et.al. */
  29 #include "gdb_string.h"
  30 #include "regcache.h"
  31 #include "gdb_assert.h"
  32 #include "sim-regno.h"
  33 #include "gdbcore.h"
  34 #include "osabi.h"
  35
  36 #include "version.h"
  37
  38 #include "floatformat.h"
  39
  40 /* Implementation of extract return value that grubs around in the
  41    register cache.  */
  42 void
  43 legacy_extract_return_value (struct type *type, struct regcache *regcache,
  44                              void *valbuf)
  45 {
  46   char *registers = deprecated_grub_regcache_for_registers (regcache);
  47   bfd_byte *buf = valbuf;
  48   DEPRECATED_EXTRACT_RETURN_VALUE (type, registers, buf); /* OK */
  49 }
  50
  51 /* Implementation of store return value that grubs the register cache.
  52    Takes a local copy of the buffer to avoid const problems.  */
  53 void
  54 legacy_store_return_value (struct type *type, struct regcache *regcache,
  55                            const void *buf)
  56 {
  57   bfd_byte *b = alloca (TYPE_LENGTH (type));
  58   gdb_assert (regcache == current_regcache);
  59   memcpy (b, buf, TYPE_LENGTH (type));
  60   DEPRECATED_STORE_RETURN_VALUE (type, b);
  61 }
  62
  63 int
  64 always_use_struct_convention (int gcc_p, struct type *value_type)
  65 {
  66   return 1;
  67 }
  68
  69 enum return_value_convention
  70 legacy_return_value (struct gdbarch *gdbarch, struct type *valtype,
  71                      struct regcache *regcache, void *readbuf,
  72                      const void *writebuf)
  73 {
  74   /* NOTE: cagney/2004-06-13: The gcc_p parameter to
  75      USE_STRUCT_CONVENTION isn't used.  */
  76   int struct_return = ((TYPE_CODE (valtype) == TYPE_CODE_STRUCT
  77                         || TYPE_CODE (valtype) == TYPE_CODE_UNION
  78                         || TYPE_CODE (valtype) == TYPE_CODE_ARRAY)
  79                        && DEPRECATED_USE_STRUCT_CONVENTION (0, valtype));
  80
  81   if (writebuf != NULL)
  82     {
  83       gdb_assert (!struct_return);
  84       /* NOTE: cagney/2004-06-13: See stack.c:return_command.  Old
  85          architectures don't expect STORE_RETURN_VALUE to handle small
  86          structures.  Should not be called with such types.  */
  87       gdb_assert (TYPE_CODE (valtype) != TYPE_CODE_STRUCT
  88                   && TYPE_CODE (valtype) != TYPE_CODE_UNION);
  89       STORE_RETURN_VALUE (valtype, regcache, writebuf);
  90     }
  91
  92   if (readbuf != NULL)
  93     {
  94       gdb_assert (!struct_return);
  95       EXTRACT_RETURN_VALUE (valtype, regcache, readbuf);
  96     }
  97
  98   if (struct_return)
  99     return RETURN_VALUE_STRUCT_CONVENTION;
 100   else
 101     return RETURN_VALUE_REGISTER_CONVENTION;
 102 }
 103
 104 int
 105 legacy_register_sim_regno (int regnum)
 106 {
 107   /* Only makes sense to supply raw registers.  */
 108   gdb_assert (regnum >= 0 && regnum < NUM_REGS);
 109   /* NOTE: cagney/2002-05-13: The old code did it this way and it is
 110      suspected that some GDB/SIM combinations may rely on this
 111      behavour.  The default should be one2one_register_sim_regno
 112      (below).  */
 113   if (REGISTER_NAME (regnum) != NULL
 114       && REGISTER_NAME (regnum)[0] != '\0')
 115     return regnum;
 116   else
 117     return LEGACY_SIM_REGNO_IGNORE;
 118 }
 119
 120 CORE_ADDR
 121 generic_skip_trampoline_code (CORE_ADDR pc)
 122 {
 123   return 0;
 124 }
 125
 126 CORE_ADDR
 127 generic_skip_solib_resolver (struct gdbarch *gdbarch, CORE_ADDR pc)
 128 {
 129   return 0;
 130 }
 131
 132 int
 133 generic_in_solib_call_trampoline (CORE_ADDR pc, char *name)
 134 {
 135   return 0;
 136 }
 137
 138 int
 139 generic_in_solib_return_trampoline (CORE_ADDR pc, char *name)
 140 {
 141   return 0;
 142 }
 143
 144 int
 145 generic_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR pc)
 146 {
 147   return 0;
 148 }
 149
 150 void
 151 generic_remote_translate_xfer_address (struct gdbarch *gdbarch,
 152                                        struct regcache *regcache,
 153                                        CORE_ADDR gdb_addr, int gdb_len,
 154                                        CORE_ADDR * rem_addr, int *rem_len)
 155 {
 156   *rem_addr = gdb_addr;
 157   *rem_len = gdb_len;
 158 }
 159
 160 /* Helper functions for INNER_THAN */
 161
 162 int
 163 core_addr_lessthan (CORE_ADDR lhs, CORE_ADDR rhs)
 164 {
 165   return (lhs < rhs);
 166 }
 167
 168 int
 169 core_addr_greaterthan (CORE_ADDR lhs, CORE_ADDR rhs)
 170 {
 171   return (lhs > rhs);
 172 }
 173
 174
 175 /* Helper functions for TARGET_{FLOAT,DOUBLE}_FORMAT */
 176
 177 const struct floatformat *
 178 default_float_format (struct gdbarch *gdbarch)
 179 {
 180   int byte_order = gdbarch_byte_order (gdbarch);
 181   switch (byte_order)
 182     {
 183     case BFD_ENDIAN_BIG:
 184       return &floatformat_ieee_single_big;
 185     case BFD_ENDIAN_LITTLE:
 186       return &floatformat_ieee_single_little;
 187     default:
 188       internal_error (__FILE__, __LINE__,
 189                       "default_float_format: bad byte order");
 190     }
 191 }
 192
 193
 194 const struct floatformat *
 195 default_double_format (struct gdbarch *gdbarch)
 196 {
 197   int byte_order = gdbarch_byte_order (gdbarch);
 198   switch (byte_order)
 199     {
 200     case BFD_ENDIAN_BIG:
 201       return &floatformat_ieee_double_big;
 202     case BFD_ENDIAN_LITTLE:
 203       return &floatformat_ieee_double_little;
 204     default:
 205       internal_error (__FILE__, __LINE__,
 206                       "default_double_format: bad byte order");
 207     }
 208 }
 209
 210 /* Misc helper functions for targets. */
 211
 212 CORE_ADDR
 213 core_addr_identity (CORE_ADDR addr)
 214 {
 215   return addr;
 216 }
 217
 218 CORE_ADDR
 219 convert_from_func_ptr_addr_identity (struct gdbarch *gdbarch, CORE_ADDR addr,
 220                                      struct target_ops *targ)
 221 {
 222   return addr;
 223 }
 224
 225 int
 226 no_op_reg_to_regnum (int reg)
 227 {
 228   return reg;
 229 }
 230
 231 CORE_ADDR
 232 deprecated_init_frame_pc_default (int fromleaf, struct frame_info *prev)
 233 {
 234   if (fromleaf && DEPRECATED_SAVED_PC_AFTER_CALL_P ())
 235     return DEPRECATED_SAVED_PC_AFTER_CALL (get_next_frame (prev));
 236   else if (get_next_frame (prev) != NULL)
 237     return DEPRECATED_FRAME_SAVED_PC (get_next_frame (prev));
 238   else
 239     return read_pc ();
 240 }
 241
 242 void
 243 default_elf_make_msymbol_special (asymbol *sym, struct minimal_symbol *msym)
 244 {
 245   return;
 246 }
 247
 248 void
 249 default_coff_make_msymbol_special (int val, struct minimal_symbol *msym)
 250 {
 251   return;
 252 }
 253
 254 int
 255 cannot_register_not (int regnum)
 256 {
 257   return 0;
 258 }
 259
 260 /* Legacy version of target_virtual_frame_pointer().  Assumes that
 261    there is an DEPRECATED_FP_REGNUM and that it is the same, cooked or
 262    raw.  */
 263
 264 void
 265 legacy_virtual_frame_pointer (CORE_ADDR pc,
 266                               int *frame_regnum,
 267                               LONGEST *frame_offset)
 268 {
 269   /* FIXME: cagney/2002-09-13: This code is used when identifying the
 270      frame pointer of the current PC.  It is assuming that a single
 271      register and an offset can determine this.  I think it should
 272      instead generate a byte code expression as that would work better
 273      with things like Dwarf2's CFI.  */
 274   if (DEPRECATED_FP_REGNUM >= 0 && DEPRECATED_FP_REGNUM < NUM_REGS)
 275     *frame_regnum = DEPRECATED_FP_REGNUM;
 276   else if (SP_REGNUM >= 0 && SP_REGNUM < NUM_REGS)
 277     *frame_regnum = SP_REGNUM;
 278   else
 279     /* Should this be an internal error?  I guess so, it is reflecting
 280        an architectural limitation in the current design.  */
 281     internal_error (__FILE__, __LINE__, "No virtual frame pointer available");
 282   *frame_offset = 0;
 283 }
 284
 285 /* Assume the world is sane, every register's virtual and real size
 286    is identical.  */
 287
 288 int
 289 generic_register_size (int regnum)
 290 {
 291   gdb_assert (regnum >= 0 && regnum < NUM_REGS + NUM_PSEUDO_REGS);
 292   if (gdbarch_register_type_p (current_gdbarch))
 293     return TYPE_LENGTH (gdbarch_register_type (current_gdbarch, regnum));
 294   else
 295     /* FIXME: cagney/2003-03-01: Once all architectures implement
 296        gdbarch_register_type(), this entire function can go away.  It
 297        is made obsolete by register_size().  */
 298     return TYPE_LENGTH (DEPRECATED_REGISTER_VIRTUAL_TYPE (regnum)); /* OK */
 299 }
 300
 301 /* Assume all registers are adjacent.  */
 302
 303 int
 304 generic_register_byte (int regnum)
 305 {
 306   int byte;
 307   int i;
 308   gdb_assert (regnum >= 0 && regnum < NUM_REGS + NUM_PSEUDO_REGS);
 309   byte = 0;
 310   for (i = 0; i < regnum; i++)
 311     {
 312       byte += generic_register_size (i);
 313     }
 314   return byte;
 315 }
 316
 317 \f
 318 int
 319 legacy_pc_in_sigtramp (CORE_ADDR pc, char *name)
 320 {
 321 #if defined (DEPRECATED_IN_SIGTRAMP)
 322   return DEPRECATED_IN_SIGTRAMP (pc, name);
 323 #else
 324   return name && strcmp ("_sigtramp", name) == 0;
 325 #endif
 326 }
 327
 328 int
 329 generic_convert_register_p (int regnum, struct type *type)
 330 {
 331   return 0;
 332 }
 333
 334 int
 335 default_stabs_argument_has_addr (struct gdbarch *gdbarch, struct type *type)
 336 {
 337   if (DEPRECATED_REG_STRUCT_HAS_ADDR_P ()
 338       && DEPRECATED_REG_STRUCT_HAS_ADDR (processing_gcc_compilation, type))
 339     {
 340       CHECK_TYPEDEF (type);
 341
 342       return (TYPE_CODE (type) == TYPE_CODE_STRUCT
 343               || TYPE_CODE (type) == TYPE_CODE_UNION
 344               || TYPE_CODE (type) == TYPE_CODE_SET
 345               || TYPE_CODE (type) == TYPE_CODE_BITSTRING);
 346     }
 347
 348   return 0;
 349 }
 350
 351 \f
 352 /* Functions to manipulate the endianness of the target.  */
 353
 354 /* ``target_byte_order'' is only used when non- multi-arch.
 355    Multi-arch targets obtain the current byte order using the
 356    TARGET_BYTE_ORDER gdbarch method.
 357
 358    The choice of initial value is entirely arbitrary.  During startup,
 359    the function initialize_current_architecture() updates this value
 360    based on default byte-order information extracted from BFD.  */
 361 static int target_byte_order = BFD_ENDIAN_BIG;
 362 static int target_byte_order_auto = 1;
 363
 364 enum bfd_endian
 365 selected_byte_order (void)
 366 {
 367   if (target_byte_order_auto)
 368     return BFD_ENDIAN_UNKNOWN;
 369   else
 370     return target_byte_order;
 371 }
 372
 373 static const char endian_big[] = "big";
 374 static const char endian_little[] = "little";
 375 static const char endian_auto[] = "auto";
 376 static const char *endian_enum[] =
 377 {
 378   endian_big,
 379   endian_little,
 380   endian_auto,
 381   NULL,
 382 };
 383 static const char *set_endian_string;
 384
 385 /* Called by ``show endian''.  */
 386
 387 static void
 388 show_endian (char *args, int from_tty)
 389 {
 390   if (target_byte_order_auto)
 391     printf_unfiltered ("The target endianness is set automatically (currently %s endian)\n",
 392                        (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG ? "big" : "little"));
 393   else
 394     printf_unfiltered ("The target is assumed to be %s endian\n",
 395                        (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG ? "big" : "little"));
 396 }
 397
 398 static void
 399 set_endian (char *ignore_args, int from_tty, struct cmd_list_element *c)
 400 {
 401   if (set_endian_string == endian_auto)
 402     {
 403       target_byte_order_auto = 1;
 404     }
 405   else if (set_endian_string == endian_little)
 406     {
 407       struct gdbarch_info info;
 408       target_byte_order_auto = 0;
 409       gdbarch_info_init (&info);
 410       info.byte_order = BFD_ENDIAN_LITTLE;
 411       if (! gdbarch_update_p (info))
 412         printf_unfiltered ("Little endian target not supported by GDB\n");
 413     }
 414   else if (set_endian_string == endian_big)
 415     {
 416       struct gdbarch_info info;
 417       target_byte_order_auto = 0;
 418       gdbarch_info_init (&info);
 419       info.byte_order = BFD_ENDIAN_BIG;
 420       if (! gdbarch_update_p (info))
 421         printf_unfiltered ("Big endian target not supported by GDB\n");
 422     }
 423   else
 424     internal_error (__FILE__, __LINE__,
 425                     "set_endian: bad value");
 426   show_endian (NULL, from_tty);
 427 }
 428
 429 /* Functions to manipulate the architecture of the target */
 430
 431 enum set_arch { set_arch_auto, set_arch_manual };
 432
 433 static int target_architecture_auto = 1;
 434
 435 static const char *set_architecture_string;
 436
 437 const char *
 438 selected_architecture_name (void)
 439 {
 440   if (target_architecture_auto)
 441     return NULL;
 442   else
 443     return set_architecture_string;
 444 }
 445
 446 /* Called if the user enters ``show architecture'' without an
 447    argument. */
 448
 449 static void
 450 show_architecture (char *args, int from_tty)
 451 {
 452   const char *arch;
 453   arch = TARGET_ARCHITECTURE->printable_name;
 454   if (target_architecture_auto)
 455     printf_filtered ("The target architecture is set automatically (currently %s)\n", arch);
 456   else
 457     printf_filtered ("The target architecture is assumed to be %s\n", arch);
 458 }
 459
 460
 461 /* Called if the user enters ``set architecture'' with or without an
 462    argument. */
 463
 464 static void
 465 set_architecture (char *ignore_args, int from_tty, struct cmd_list_element *c)
 466 {
 467   if (strcmp (set_architecture_string, "auto") == 0)
 468     {
 469       target_architecture_auto = 1;
 470     }
 471   else
 472     {
 473       struct gdbarch_info info;
 474       gdbarch_info_init (&info);
 475       info.bfd_arch_info = bfd_scan_arch (set_architecture_string);
 476       if (info.bfd_arch_info == NULL)
 477         internal_error (__FILE__, __LINE__,
 478                         "set_architecture: bfd_scan_arch failed");
 479       if (gdbarch_update_p (info))
 480         target_architecture_auto = 0;
 481       else
 482         printf_unfiltered ("Architecture `%s' not recognized.\n",
 483                            set_architecture_string);
 484     }
 485   show_architecture (NULL, from_tty);
 486 }
 487
 488 /* Try to select a global architecture that matches "info".  Return
 489    non-zero if the attempt succeds.  */
 490 int
 491 gdbarch_update_p (struct gdbarch_info info)
 492 {
 493   struct gdbarch *new_gdbarch = gdbarch_find_by_info (info);
 494
 495   /* If there no architecture by that name, reject the request.  */
 496   if (new_gdbarch == NULL)
 497     {
 498       if (gdbarch_debug)
 499         fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
 500                             "Architecture not found\n");
 501       return 0;
 502     }
 503
 504   /* If it is the same old architecture, accept the request (but don't
 505      swap anything).  */
 506   if (new_gdbarch == current_gdbarch)
 507     {
 508       if (gdbarch_debug)
 509         fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
 510                             "Architecture 0x%08lx (%s) unchanged\n",
 511                             (long) new_gdbarch,
 512                             gdbarch_bfd_arch_info (new_gdbarch)->printable_name);
 513       return 1;
 514     }
 515
 516   /* It's a new architecture, swap it in.  */
 517   if (gdbarch_debug)
 518     fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
 519                         "New architecture 0x%08lx (%s) selected\n",
 520                         (long) new_gdbarch,
 521                         gdbarch_bfd_arch_info (new_gdbarch)->printable_name);
 522   deprecated_current_gdbarch_select_hack (new_gdbarch);
 523
 524   return 1;
 525 }
 526
 527 /* Return the architecture for ABFD.  If no suitable architecture
 528    could be find, return NULL.  */
 529
 530 struct gdbarch *
 531 gdbarch_from_bfd (bfd *abfd)
 532 {
 533   struct gdbarch *old_gdbarch = current_gdbarch;
 534   struct gdbarch *new_gdbarch;
 535   struct gdbarch_info info;
 536
 537   gdbarch_info_init (&info);
 538   info.abfd = abfd;
 539   return gdbarch_find_by_info (info);
 540 }
 541
 542 /* Set the dynamic target-system-dependent parameters (architecture,
 543    byte-order) using information found in the BFD */
 544
 545 void
 546 set_gdbarch_from_file (bfd *abfd)
 547 {
 548   struct gdbarch *gdbarch;
 549
 550   gdbarch = gdbarch_from_bfd (abfd);
 551   if (gdbarch == NULL)
 552     error ("Architecture of file not recognized.\n");
 553   deprecated_current_gdbarch_select_hack (gdbarch);
 554 }
 555
 556 /* Initialize the current architecture.  Update the ``set
 557    architecture'' command so that it specifies a list of valid
 558    architectures.  */
 559
 560 #ifdef DEFAULT_BFD_ARCH
 561 extern const bfd_arch_info_type DEFAULT_BFD_ARCH;
 562 static const bfd_arch_info_type *default_bfd_arch = &DEFAULT_BFD_ARCH;
 563 #else
 564 static const bfd_arch_info_type *default_bfd_arch;
 565 #endif
 566
 567 #ifdef DEFAULT_BFD_VEC
 568 extern const bfd_target DEFAULT_BFD_VEC;
 569 static const bfd_target *default_bfd_vec = &DEFAULT_BFD_VEC;
 570 #else
 571 static const bfd_target *default_bfd_vec;
 572 #endif
 573
 574 void
 575 initialize_current_architecture (void)
 576 {
 577   const char **arches = gdbarch_printable_names ();
 578
 579   /* determine a default architecture and byte order. */
 580   struct gdbarch_info info;
 581   gdbarch_info_init (&info);
 582
 583   /* Find a default architecture. */
 584   if (info.bfd_arch_info == NULL
 585       && default_bfd_arch != NULL)
 586     info.bfd_arch_info = default_bfd_arch;
 587   if (info.bfd_arch_info == NULL)
 588     {
 589       /* Choose the architecture by taking the first one
 590          alphabetically. */
 591       const char *chosen = arches[0];
 592       const char **arch;
 593       for (arch = arches; *arch != NULL; arch++)
 594         {
 595           if (strcmp (*arch, chosen) < 0)
 596             chosen = *arch;
 597         }
 598       if (chosen == NULL)
 599         internal_error (__FILE__, __LINE__,
 600                         "initialize_current_architecture: No arch");
 601       info.bfd_arch_info = bfd_scan_arch (chosen);
 602       if (info.bfd_arch_info == NULL)
 603         internal_error (__FILE__, __LINE__,
 604                         "initialize_current_architecture: Arch not found");
 605     }
 606
 607   /* Take several guesses at a byte order.  */
 608   if (info.byte_order == BFD_ENDIAN_UNKNOWN
 609       && default_bfd_vec != NULL)
 610     {
 611       /* Extract BFD's default vector's byte order. */
 612       switch (default_bfd_vec->byteorder)
 613         {
 614         case BFD_ENDIAN_BIG:
 615           info.byte_order = BFD_ENDIAN_BIG;
 616           break;
 617         case BFD_ENDIAN_LITTLE:
 618           info.byte_order = BFD_ENDIAN_LITTLE;
 619           break;
 620         default:
 621           break;
 622         }
 623     }
 624   if (info.byte_order == BFD_ENDIAN_UNKNOWN)
 625     {
 626       /* look for ``*el-*'' in the target name. */
 627       const char *chp;
 628       chp = strchr (target_name, '-');
 629       if (chp != NULL
 630           && chp - 2 >= target_name
 631           && strncmp (chp - 2, "el", 2) == 0)
 632         info.byte_order = BFD_ENDIAN_LITTLE;
 633     }
 634   if (info.byte_order == BFD_ENDIAN_UNKNOWN)
 635     {
 636       /* Wire it to big-endian!!! */
 637       info.byte_order = BFD_ENDIAN_BIG;
 638     }
 639
 640   if (! gdbarch_update_p (info))
 641     internal_error (__FILE__, __LINE__,
 642                     "initialize_current_architecture: Selection of initial architecture failed");
 643
 644   /* Create the ``set architecture'' command appending ``auto'' to the
 645      list of architectures. */
 646   {
 647     struct cmd_list_element *c;
 648     /* Append ``auto''. */
 649     int nr;
 650     for (nr = 0; arches[nr] != NULL; nr++);
 651     arches = xrealloc (arches, sizeof (char*) * (nr + 2));
 652     arches[nr + 0] = "auto";
 653     arches[nr + 1] = NULL;
 654     /* FIXME: add_set_enum_cmd() uses an array of ``char *'' instead
 655        of ``const char *''.  We just happen to know that the casts are
 656        safe. */
 657     c = add_set_enum_cmd ("architecture", class_support,
 658                           arches, &set_architecture_string,
 659                           "Set architecture of target.",
 660                           &setlist);
 661     set_cmd_sfunc (c, set_architecture);
 662     add_alias_cmd ("processor", "architecture", class_support, 1, &setlist);
 663     /* Don't use set_from_show - need to print both auto/manual and
 664        current setting. */
 665     add_cmd ("architecture", class_support, show_architecture,
 666              "Show the current target architecture", &showlist);
 667   }
 668 }
 669
 670
 671 /* Initialize a gdbarch info to values that will be automatically
 672    overridden.  Note: Originally, this ``struct info'' was initialized
 673    using memset(0).  Unfortunately, that ran into problems, namely
 674    BFD_ENDIAN_BIG is zero.  An explicit initialization function that
 675    can explicitly set each field to a well defined value is used.  */
 676
 677 void
 678 gdbarch_info_init (struct gdbarch_info *info)
 679 {
 680   memset (info, 0, sizeof (struct gdbarch_info));
 681   info->byte_order = BFD_ENDIAN_UNKNOWN;
 682   info->osabi = GDB_OSABI_UNINITIALIZED;
 683 }
 684
 685 /* Similar to init, but this time fill in the blanks.  Information is
 686    obtained from the specified architecture, global "set ..." options,
 687    and explicitly initialized INFO fields.  */
 688
 689 void
 690 gdbarch_info_fill (struct gdbarch *gdbarch, struct gdbarch_info *info)
 691 {
 692   /* "(gdb) set architecture ...".  */
 693   if (info->bfd_arch_info == NULL
 694       && !target_architecture_auto
 695       && gdbarch != NULL)
 696     info->bfd_arch_info = gdbarch_bfd_arch_info (gdbarch);
 697   if (info->bfd_arch_info == NULL
 698       && info->abfd != NULL
 699       && bfd_get_arch (info->abfd) != bfd_arch_unknown
 700       && bfd_get_arch (info->abfd) != bfd_arch_obscure)
 701     info->bfd_arch_info = bfd_get_arch_info (info->abfd);
 702   if (info->bfd_arch_info == NULL
 703       && gdbarch != NULL)
 704     info->bfd_arch_info = gdbarch_bfd_arch_info (gdbarch);
 705
 706   /* "(gdb) set byte-order ...".  */
 707   if (info->byte_order == BFD_ENDIAN_UNKNOWN
 708       && !target_byte_order_auto
 709       && gdbarch != NULL)
 710     info->byte_order = gdbarch_byte_order (gdbarch);
 711   /* From the INFO struct.  */
 712   if (info->byte_order == BFD_ENDIAN_UNKNOWN
 713       && info->abfd != NULL)
 714     info->byte_order = (bfd_big_endian (info->abfd) ? BFD_ENDIAN_BIG
 715                        : bfd_little_endian (info->abfd) ? BFD_ENDIAN_LITTLE
 716                        : BFD_ENDIAN_UNKNOWN);
 717   /* From the current target.  */
 718   if (info->byte_order == BFD_ENDIAN_UNKNOWN
 719       && gdbarch != NULL)
 720     info->byte_order = gdbarch_byte_order (gdbarch);
 721
 722   /* "(gdb) set osabi ...".  Handled by gdbarch_lookup_osabi.  */
 723   if (info->osabi == GDB_OSABI_UNINITIALIZED)
 724     info->osabi = gdbarch_lookup_osabi (info->abfd);
 725   if (info->osabi == GDB_OSABI_UNINITIALIZED
 726       && gdbarch != NULL)
 727     info->osabi = gdbarch_osabi (gdbarch);
 728
 729   /* Must have at least filled in the architecture.  */
 730   gdb_assert (info->bfd_arch_info != NULL);
 731 }
 732
 733 /* */
 734
 735 extern initialize_file_ftype _initialize_gdbarch_utils; /* -Wmissing-prototypes */
 736
 737 void
 738 _initialize_gdbarch_utils (void)
 739 {
 740   struct cmd_list_element *c;
 741   c = add_set_enum_cmd ("endian", class_support,
 742                         endian_enum, &set_endian_string,
 743                         "Set endianness of target.",
 744                         &setlist);
 745   set_cmd_sfunc (c, set_endian);
 746   /* Don't use set_from_show - need to print both auto/manual and
 747      current setting. */
 748   add_cmd ("endian", class_support, show_endian,
 749            "Show the current byte-order", &showlist);
 750 }