2000-12-08 Michael Snyder <msnyder@mvstp600e.cygnus.com>
[deliverable/binutils-gdb.git] / gdb / arch-utils.c
1 /* Dynamic architecture support for GDB, the GNU debugger.
2 Copyright 1998-1999, Free Software Foundation, Inc.
3
4 This file is part of GDB.
5
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place - Suite 330,
19 Boston, MA 02111-1307, USA. */
20
21 #include "defs.h"
22
23 #if GDB_MULTI_ARCH
24 #include "gdbcmd.h"
25 #include "inferior.h" /* enum CALL_DUMMY_LOCATION et.al. */
26 #else
27 /* Just include everything in sight so that the every old definition
28 of macro is visible. */
29 #include "gdb_string.h"
30 #include <ctype.h>
31 #include "symtab.h"
32 #include "frame.h"
33 #include "inferior.h"
34 #include "breakpoint.h"
35 #include "gdb_wait.h"
36 #include "gdbcore.h"
37 #include "gdbcmd.h"
38 #include "target.h"
39 #include "gdbthread.h"
40 #include "annotate.h"
41 #include "symfile.h" /* for overlay functions */
42 #endif
43
44 #include "version.h"
45
46 #include "floatformat.h"
47
48 /* Convenience macro for allocting typesafe memory. */
49
50 #ifndef XMALLOC
51 #define XMALLOC(TYPE) (TYPE*) xmalloc (sizeof (TYPE))
52 #endif
53
54
55 /* Use the program counter to determine the contents and size
56 of a breakpoint instruction. If no target-dependent macro
57 BREAKPOINT_FROM_PC has been defined to implement this function,
58 assume that the breakpoint doesn't depend on the PC, and
59 use the values of the BIG_BREAKPOINT and LITTLE_BREAKPOINT macros.
60 Return a pointer to a string of bytes that encode a breakpoint
61 instruction, stores the length of the string to *lenptr,
62 and optionally adjust the pc to point to the correct memory location
63 for inserting the breakpoint. */
64
65 unsigned char *
66 legacy_breakpoint_from_pc (CORE_ADDR * pcptr, int *lenptr)
67 {
68 /* {BIG_,LITTLE_}BREAKPOINT is the sequence of bytes we insert for a
69 breakpoint. On some machines, breakpoints are handled by the
70 target environment and we don't have to worry about them here. */
71 #ifdef BIG_BREAKPOINT
72 if (TARGET_BYTE_ORDER == BIG_ENDIAN)
73 {
74 static unsigned char big_break_insn[] = BIG_BREAKPOINT;
75 *lenptr = sizeof (big_break_insn);
76 return big_break_insn;
77 }
78 #endif
79 #ifdef LITTLE_BREAKPOINT
80 if (TARGET_BYTE_ORDER != BIG_ENDIAN)
81 {
82 static unsigned char little_break_insn[] = LITTLE_BREAKPOINT;
83 *lenptr = sizeof (little_break_insn);
84 return little_break_insn;
85 }
86 #endif
87 #ifdef BREAKPOINT
88 {
89 static unsigned char break_insn[] = BREAKPOINT;
90 *lenptr = sizeof (break_insn);
91 return break_insn;
92 }
93 #endif
94 *lenptr = 0;
95 return NULL;
96 }
97
98 int
99 generic_frameless_function_invocation_not (struct frame_info *fi)
100 {
101 return 0;
102 }
103
104 int
105 generic_return_value_on_stack_not (struct type *type)
106 {
107 return 0;
108 }
109
110 char *
111 legacy_register_name (int i)
112 {
113 #ifdef REGISTER_NAMES
114 static char *names[] = REGISTER_NAMES;
115 if (i < 0 || i >= (sizeof (names) / sizeof (*names)))
116 return NULL;
117 else
118 return names[i];
119 #else
120 internal_error ("legacy_register_name: called.");
121 return NULL;
122 #endif
123 }
124
125 #if defined (CALL_DUMMY)
126 LONGEST legacy_call_dummy_words[] = CALL_DUMMY;
127 #else
128 LONGEST legacy_call_dummy_words[1];
129 #endif
130 int legacy_sizeof_call_dummy_words = sizeof (legacy_call_dummy_words);
131
132 void
133 generic_remote_translate_xfer_address (CORE_ADDR gdb_addr, int gdb_len,
134 CORE_ADDR * rem_addr, int *rem_len)
135 {
136 *rem_addr = gdb_addr;
137 *rem_len = gdb_len;
138 }
139
140 int
141 generic_prologue_frameless_p (CORE_ADDR ip)
142 {
143 #ifdef SKIP_PROLOGUE_FRAMELESS_P
144 return ip == SKIP_PROLOGUE_FRAMELESS_P (ip);
145 #else
146 return ip == SKIP_PROLOGUE (ip);
147 #endif
148 }
149
150
151 /* Helper functions for INNER_THAN */
152
153 int
154 core_addr_lessthan (CORE_ADDR lhs, CORE_ADDR rhs)
155 {
156 return (lhs < rhs);
157 }
158
159 int
160 core_addr_greaterthan (CORE_ADDR lhs, CORE_ADDR rhs)
161 {
162 return (lhs > rhs);
163 }
164
165
166 /* Helper functions for TARGET_{FLOAT,DOUBLE}_FORMAT */
167
168 const struct floatformat *
169 default_float_format (struct gdbarch *gdbarch)
170 {
171 #if GDB_MULTI_ARCH
172 int byte_order = gdbarch_byte_order (gdbarch);
173 #else
174 int byte_order = TARGET_BYTE_ORDER;
175 #endif
176 switch (byte_order)
177 {
178 case BIG_ENDIAN:
179 return &floatformat_ieee_single_big;
180 case LITTLE_ENDIAN:
181 return &floatformat_ieee_single_little;
182 default:
183 internal_error ("default_float_format: bad byte order");
184 }
185 }
186
187
188 const struct floatformat *
189 default_double_format (struct gdbarch *gdbarch)
190 {
191 #if GDB_MULTI_ARCH
192 int byte_order = gdbarch_byte_order (gdbarch);
193 #else
194 int byte_order = TARGET_BYTE_ORDER;
195 #endif
196 switch (byte_order)
197 {
198 case BIG_ENDIAN:
199 return &floatformat_ieee_double_big;
200 case LITTLE_ENDIAN:
201 return &floatformat_ieee_double_little;
202 default:
203 internal_error ("default_double_format: bad byte order");
204 }
205 }
206
207 /* Misc helper functions for targets. */
208
209 int
210 frame_num_args_unknown (struct frame_info *fi)
211 {
212 return -1;
213 }
214
215
216 int
217 generic_register_convertible_not (int num)
218 {
219 return 0;
220 }
221
222
223 int
224 default_register_sim_regno (int num)
225 {
226 return num;
227 }
228
229
230 CORE_ADDR
231 default_convert_from_func_ptr_addr (CORE_ADDR addr)
232 {
233 return addr;
234 }
235
236 int
237 no_op_reg_to_regnum (int reg)
238 {
239 return reg;
240 }
241
242 /* Functions to manipulate the endianness of the target. */
243
244 #ifdef TARGET_BYTE_ORDER_SELECTABLE
245 /* compat - Catch old targets that expect a selectable byte-order to
246 default to BIG_ENDIAN */
247 #ifndef TARGET_BYTE_ORDER_DEFAULT
248 #define TARGET_BYTE_ORDER_DEFAULT BIG_ENDIAN
249 #endif
250 #endif
251 #if !TARGET_BYTE_ORDER_SELECTABLE_P
252 #ifndef TARGET_BYTE_ORDER_DEFAULT
253 /* compat - Catch old non byte-order selectable targets that do not
254 define TARGET_BYTE_ORDER_DEFAULT and instead expect
255 TARGET_BYTE_ORDER to be used as the default. For targets that
256 defined neither TARGET_BYTE_ORDER nor TARGET_BYTE_ORDER_DEFAULT the
257 below will get a strange compiler warning. */
258 #define TARGET_BYTE_ORDER_DEFAULT TARGET_BYTE_ORDER
259 #endif
260 #endif
261 #ifndef TARGET_BYTE_ORDER_DEFAULT
262 #define TARGET_BYTE_ORDER_DEFAULT BIG_ENDIAN /* arbitrary */
263 #endif
264 /* ``target_byte_order'' is only used when non- multi-arch.
265 Multi-arch targets obtain the current byte order using
266 TARGET_BYTE_ORDER which is controlled by gdbarch.*. */
267 int target_byte_order = TARGET_BYTE_ORDER_DEFAULT;
268 int target_byte_order_auto = 1;
269
270 static const char endian_big[] = "big";
271 static const char endian_little[] = "little";
272 static const char endian_auto[] = "auto";
273 static const char *endian_enum[] =
274 {
275 endian_big,
276 endian_little,
277 endian_auto,
278 NULL,
279 };
280 static const char *set_endian_string;
281
282 /* Called by ``show endian''. */
283
284 static void
285 show_endian (char *args, int from_tty)
286 {
287 if (TARGET_BYTE_ORDER_AUTO)
288 printf_unfiltered ("The target endianness is set automatically (currently %s endian)\n",
289 (TARGET_BYTE_ORDER == BIG_ENDIAN ? "big" : "little"));
290 else
291 printf_unfiltered ("The target is assumed to be %s endian\n",
292 (TARGET_BYTE_ORDER == BIG_ENDIAN ? "big" : "little"));
293 }
294
295 static void
296 set_endian (char *ignore_args, int from_tty, struct cmd_list_element *c)
297 {
298 if (!TARGET_BYTE_ORDER_SELECTABLE_P)
299 {
300 printf_unfiltered ("Byte order is not selectable.");
301 }
302 else if (set_endian_string == endian_auto)
303 {
304 target_byte_order_auto = 1;
305 }
306 else if (set_endian_string == endian_little)
307 {
308 target_byte_order_auto = 0;
309 if (GDB_MULTI_ARCH)
310 {
311 struct gdbarch_info info;
312 memset (&info, 0, sizeof info);
313 info.byte_order = LITTLE_ENDIAN;
314 if (! gdbarch_update_p (info))
315 {
316 printf_unfiltered ("Little endian target not supported by GDB\n");
317 }
318 }
319 else
320 {
321 target_byte_order = LITTLE_ENDIAN;
322 }
323 }
324 else if (set_endian_string == endian_big)
325 {
326 target_byte_order_auto = 0;
327 if (GDB_MULTI_ARCH)
328 {
329 struct gdbarch_info info;
330 memset (&info, 0, sizeof info);
331 info.byte_order = BIG_ENDIAN;
332 if (! gdbarch_update_p (info))
333 {
334 printf_unfiltered ("Big endian target not supported by GDB\n");
335 }
336 }
337 else
338 {
339 target_byte_order = BIG_ENDIAN;
340 }
341 }
342 else
343 internal_error ("set_endian: bad value");
344 show_endian (NULL, from_tty);
345 }
346
347 /* Set the endianness from a BFD. */
348
349 static void
350 set_endian_from_file (bfd *abfd)
351 {
352 if (GDB_MULTI_ARCH)
353 internal_error ("set_endian_from_file: not for multi-arch");
354 if (TARGET_BYTE_ORDER_SELECTABLE_P)
355 {
356 int want;
357
358 if (bfd_big_endian (abfd))
359 want = BIG_ENDIAN;
360 else
361 want = LITTLE_ENDIAN;
362 if (TARGET_BYTE_ORDER_AUTO)
363 target_byte_order = want;
364 else if (TARGET_BYTE_ORDER != want)
365 warning ("%s endian file does not match %s endian target.",
366 want == BIG_ENDIAN ? "big" : "little",
367 TARGET_BYTE_ORDER == BIG_ENDIAN ? "big" : "little");
368 }
369 else
370 {
371 if (bfd_big_endian (abfd)
372 ? TARGET_BYTE_ORDER != BIG_ENDIAN
373 : TARGET_BYTE_ORDER == BIG_ENDIAN)
374 warning ("%s endian file does not match %s endian target.",
375 bfd_big_endian (abfd) ? "big" : "little",
376 TARGET_BYTE_ORDER == BIG_ENDIAN ? "big" : "little");
377 }
378 }
379
380
381 /* Functions to manipulate the architecture of the target */
382
383 enum set_arch { set_arch_auto, set_arch_manual };
384
385 int target_architecture_auto = 1;
386
387 const char *set_architecture_string;
388
389 /* Old way of changing the current architecture. */
390
391 extern const struct bfd_arch_info bfd_default_arch_struct;
392 const struct bfd_arch_info *target_architecture = &bfd_default_arch_struct;
393 int (*target_architecture_hook) (const struct bfd_arch_info *ap);
394
395 static int
396 arch_ok (const struct bfd_arch_info *arch)
397 {
398 if (GDB_MULTI_ARCH)
399 internal_error ("arch_ok: not multi-arched");
400 /* Should be performing the more basic check that the binary is
401 compatible with GDB. */
402 /* Check with the target that the architecture is valid. */
403 return (target_architecture_hook == NULL
404 || target_architecture_hook (arch));
405 }
406
407 static void
408 set_arch (const struct bfd_arch_info *arch,
409 enum set_arch type)
410 {
411 if (GDB_MULTI_ARCH)
412 internal_error ("set_arch: not multi-arched");
413 switch (type)
414 {
415 case set_arch_auto:
416 if (!arch_ok (arch))
417 warning ("Target may not support %s architecture",
418 arch->printable_name);
419 target_architecture = arch;
420 break;
421 case set_arch_manual:
422 if (!arch_ok (arch))
423 {
424 printf_unfiltered ("Target does not support `%s' architecture.\n",
425 arch->printable_name);
426 }
427 else
428 {
429 target_architecture_auto = 0;
430 target_architecture = arch;
431 }
432 break;
433 }
434 if (gdbarch_debug)
435 gdbarch_dump (current_gdbarch, gdb_stdlog);
436 }
437
438 /* Set the architecture from arch/machine (deprecated) */
439
440 void
441 set_architecture_from_arch_mach (enum bfd_architecture arch,
442 unsigned long mach)
443 {
444 const struct bfd_arch_info *wanted = bfd_lookup_arch (arch, mach);
445 if (GDB_MULTI_ARCH)
446 internal_error ("set_architecture_from_arch_mach: not multi-arched");
447 if (wanted != NULL)
448 set_arch (wanted, set_arch_manual);
449 else
450 internal_error ("gdbarch: hardwired architecture/machine not recognized");
451 }
452
453 /* Set the architecture from a BFD (deprecated) */
454
455 static void
456 set_architecture_from_file (bfd *abfd)
457 {
458 const struct bfd_arch_info *wanted = bfd_get_arch_info (abfd);
459 if (GDB_MULTI_ARCH)
460 internal_error ("set_architecture_from_file: not multi-arched");
461 if (target_architecture_auto)
462 {
463 set_arch (wanted, set_arch_auto);
464 }
465 else if (wanted != target_architecture)
466 {
467 warning ("%s architecture file may be incompatible with %s target.",
468 wanted->printable_name,
469 target_architecture->printable_name);
470 }
471 }
472
473
474 /* Called if the user enters ``show architecture'' without an
475 argument. */
476
477 static void
478 show_architecture (char *args, int from_tty)
479 {
480 const char *arch;
481 arch = TARGET_ARCHITECTURE->printable_name;
482 if (target_architecture_auto)
483 printf_filtered ("The target architecture is set automatically (currently %s)\n", arch);
484 else
485 printf_filtered ("The target architecture is assumed to be %s\n", arch);
486 }
487
488
489 /* Called if the user enters ``set architecture'' with or without an
490 argument. */
491
492 static void
493 set_architecture (char *ignore_args, int from_tty, struct cmd_list_element *c)
494 {
495 if (strcmp (set_architecture_string, "auto") == 0)
496 {
497 target_architecture_auto = 1;
498 }
499 else if (GDB_MULTI_ARCH)
500 {
501 struct gdbarch_info info;
502 memset (&info, 0, sizeof info);
503 info.bfd_arch_info = bfd_scan_arch (set_architecture_string);
504 if (info.bfd_arch_info == NULL)
505 internal_error ("set_architecture: bfd_scan_arch failed");
506 if (gdbarch_update_p (info))
507 target_architecture_auto = 0;
508 else
509 printf_unfiltered ("Architecture `%s' not recognized.\n",
510 set_architecture_string);
511 }
512 else
513 {
514 const struct bfd_arch_info *arch
515 = bfd_scan_arch (set_architecture_string);
516 if (arch == NULL)
517 internal_error ("set_architecture: bfd_scan_arch failed");
518 set_arch (arch, set_arch_manual);
519 }
520 show_architecture (NULL, from_tty);
521 }
522
523 /* Called if the user enters ``info architecture'' without an argument. */
524
525 static void
526 info_architecture (char *args, int from_tty)
527 {
528 printf_filtered ("Available architectures are:\n");
529 if (GDB_MULTI_ARCH)
530 {
531 const char **arches = gdbarch_printable_names ();
532 const char **arch;
533 for (arch = arches; *arch != NULL; arch++)
534 {
535 printf_filtered (" %s", *arch);
536 }
537 free (arches);
538 }
539 else
540 {
541 enum bfd_architecture a;
542 for (a = bfd_arch_obscure + 1; a < bfd_arch_last; a++)
543 {
544 const struct bfd_arch_info *ap;
545 for (ap = bfd_lookup_arch (a, 0);
546 ap != NULL;
547 ap = ap->next)
548 {
549 printf_filtered (" %s", ap->printable_name);
550 ap = ap->next;
551 }
552 }
553 }
554 printf_filtered ("\n");
555 }
556
557 /* Set the dynamic target-system-dependent parameters (architecture,
558 byte-order) using information found in the BFD */
559
560 void
561 set_gdbarch_from_file (bfd *abfd)
562 {
563 if (GDB_MULTI_ARCH)
564 {
565 struct gdbarch_info info;
566 memset (&info, 0, sizeof info);
567 info.abfd = abfd;
568 if (! gdbarch_update_p (info))
569 error ("Architecture of file not recognized.\n");
570 }
571 else
572 {
573 set_architecture_from_file (abfd);
574 set_endian_from_file (abfd);
575 }
576 }
577
578 /* Initialize the current architecture. Update the ``set
579 architecture'' command so that it specifies a list of valid
580 architectures. */
581
582 #ifdef DEFAULT_BFD_ARCH
583 extern const bfd_arch_info_type DEFAULT_BFD_ARCH;
584 static const bfd_arch_info_type *default_bfd_arch = &DEFAULT_BFD_ARCH;
585 #else
586 static const bfd_arch_info_type *default_bfd_arch;
587 #endif
588
589 #ifdef DEFAULT_BFD_VEC
590 extern const bfd_target DEFAULT_BFD_VEC;
591 static const bfd_target *default_bfd_vec = &DEFAULT_BFD_VEC;
592 #else
593 static const bfd_target *default_bfd_vec;
594 #endif
595
596 void
597 initialize_current_architecture (void)
598 {
599 const char **arches = gdbarch_printable_names ();
600
601 /* determine a default architecture and byte order. */
602 struct gdbarch_info info;
603 memset (&info, 0, sizeof (info));
604
605 /* Find a default architecture. */
606 if (info.bfd_arch_info == NULL
607 && default_bfd_arch != NULL)
608 info.bfd_arch_info = default_bfd_arch;
609 if (info.bfd_arch_info == NULL)
610 {
611 /* Choose the architecture by taking the first one
612 alphabetically. */
613 const char *chosen = arches[0];
614 const char **arch;
615 for (arch = arches; *arch != NULL; arch++)
616 {
617 if (strcmp (*arch, chosen) < 0)
618 chosen = *arch;
619 }
620 if (chosen == NULL)
621 internal_error ("initialize_current_architecture: No arch");
622 info.bfd_arch_info = bfd_scan_arch (chosen);
623 if (info.bfd_arch_info == NULL)
624 internal_error ("initialize_current_architecture: Arch not found");
625 }
626
627 /* take several guesses at a byte order. */
628 /* NB: can't use TARGET_BYTE_ORDER_DEFAULT as its definition is
629 forced above. */
630 if (info.byte_order == 0
631 && default_bfd_vec != NULL)
632 {
633 /* Extract BFD's default vector's byte order. */
634 switch (default_bfd_vec->byteorder)
635 {
636 case BFD_ENDIAN_BIG:
637 info.byte_order = BIG_ENDIAN;
638 break;
639 case BFD_ENDIAN_LITTLE:
640 info.byte_order = LITTLE_ENDIAN;
641 break;
642 default:
643 break;
644 }
645 }
646 if (info.byte_order == 0)
647 {
648 /* look for ``*el-*'' in the target name. */
649 const char *chp;
650 chp = strchr (target_name, '-');
651 if (chp != NULL
652 && chp - 2 >= target_name
653 && strncmp (chp - 2, "el", 2) == 0)
654 info.byte_order = LITTLE_ENDIAN;
655 }
656 if (info.byte_order == 0)
657 {
658 /* Wire it to big-endian!!! */
659 info.byte_order = BIG_ENDIAN;
660 }
661
662 if (GDB_MULTI_ARCH)
663 {
664 if (! gdbarch_update_p (info))
665 {
666 internal_error ("initialize_current_architecture: Selection of initial architecture failed");
667 }
668 }
669
670 /* Create the ``set architecture'' command appending ``auto'' to the
671 list of architectures. */
672 {
673 struct cmd_list_element *c;
674 /* Append ``auto''. */
675 int nr;
676 for (nr = 0; arches[nr] != NULL; nr++);
677 arches = xrealloc (arches, sizeof (char*) * (nr + 2));
678 arches[nr + 0] = "auto";
679 arches[nr + 1] = NULL;
680 /* FIXME: add_set_enum_cmd() uses an array of ``char *'' instead
681 of ``const char *''. We just happen to know that the casts are
682 safe. */
683 c = add_set_enum_cmd ("architecture", class_support,
684 arches, &set_architecture_string,
685 "Set architecture of target.",
686 &setlist);
687 c->function.sfunc = set_architecture;
688 add_alias_cmd ("processor", "architecture", class_support, 1, &setlist);
689 /* Don't use set_from_show - need to print both auto/manual and
690 current setting. */
691 add_cmd ("architecture", class_support, show_architecture,
692 "Show the current target architecture", &showlist);
693 c = add_cmd ("architecture", class_support, info_architecture,
694 "List supported target architectures", &infolist);
695 deprecate_cmd (c, "set architecture");
696 }
697 }
698
699
700 /* */
701
702 extern initialize_file_ftype _initialize_gdbarch_utils;
703
704 void
705 _initialize_gdbarch_utils (void)
706 {
707 struct cmd_list_element *c;
708 c = add_set_enum_cmd ("endian", class_support,
709 endian_enum, &set_endian_string,
710 "Set endianness of target.",
711 &setlist);
712 c->function.sfunc = set_endian;
713 /* Don't use set_from_show - need to print both auto/manual and
714 current setting. */
715 add_cmd ("endian", class_support, show_endian,
716 "Show the current byte-order", &showlist);
717 }
This page took 0.043254 seconds and 4 git commands to generate.