1 /* Target-dependent code for the Motorola 68000 series.
3 Copyright (C) 1990-2017 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
21 #include "dwarf2-frame.h"
23 #include "frame-base.h"
24 #include "frame-unwind.h"
31 #include "arch-utils.h"
34 #include "target-descriptions.h"
35 #include "floatformat.h"
36 #include "target-float.h"
38 #include "m68k-tdep.h"
41 #define P_LINKL_FP 0x480e
42 #define P_LINKW_FP 0x4e56
43 #define P_PEA_FP 0x4856
44 #define P_MOVEAL_SP_FP 0x2c4f
45 #define P_ADDAW_SP 0xdefc
46 #define P_ADDAL_SP 0xdffc
47 #define P_SUBQW_SP 0x514f
48 #define P_SUBQL_SP 0x518f
49 #define P_LEA_SP_SP 0x4fef
50 #define P_LEA_PC_A5 0x4bfb0170
51 #define P_FMOVEMX_SP 0xf227
52 #define P_MOVEL_SP 0x2f00
53 #define P_MOVEML_SP 0x48e7
55 /* Offset from SP to first arg on stack at first instruction of a function. */
56 #define SP_ARG0 (1 * 4)
58 #if !defined (BPT_VECTOR)
59 #define BPT_VECTOR 0xf
62 constexpr gdb_byte m68k_break_insn[] = {0x4e, (0x40 | BPT_VECTOR)};
64 typedef BP_MANIPULATION (m68k_break_insn) m68k_breakpoint;
67 /* Construct types for ISA-specific registers. */
69 m68k_ps_type (struct gdbarch *gdbarch)
71 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
73 if (!tdep->m68k_ps_type)
77 type = arch_flags_type (gdbarch, "builtin_type_m68k_ps", 32);
78 append_flags_type_flag (type, 0, "C");
79 append_flags_type_flag (type, 1, "V");
80 append_flags_type_flag (type, 2, "Z");
81 append_flags_type_flag (type, 3, "N");
82 append_flags_type_flag (type, 4, "X");
83 append_flags_type_flag (type, 8, "I0");
84 append_flags_type_flag (type, 9, "I1");
85 append_flags_type_flag (type, 10, "I2");
86 append_flags_type_flag (type, 12, "M");
87 append_flags_type_flag (type, 13, "S");
88 append_flags_type_flag (type, 14, "T0");
89 append_flags_type_flag (type, 15, "T1");
91 tdep->m68k_ps_type = type;
94 return tdep->m68k_ps_type;
98 m68881_ext_type (struct gdbarch *gdbarch)
100 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
102 if (!tdep->m68881_ext_type)
103 tdep->m68881_ext_type
104 = arch_float_type (gdbarch, -1, "builtin_type_m68881_ext",
105 floatformats_m68881_ext);
107 return tdep->m68881_ext_type;
110 /* Return the GDB type object for the "standard" data type of data in
111 register N. This should be int for D0-D7, SR, FPCONTROL and
112 FPSTATUS, long double for FP0-FP7, and void pointer for all others
113 (A0-A7, PC, FPIADDR). Note, for registers which contain
114 addresses return pointer to void, not pointer to char, because we
115 don't want to attempt to print the string after printing the
119 m68k_register_type (struct gdbarch *gdbarch, int regnum)
121 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
123 if (tdep->fpregs_present)
125 if (regnum >= gdbarch_fp0_regnum (gdbarch)
126 && regnum <= gdbarch_fp0_regnum (gdbarch) + 7)
128 if (tdep->flavour == m68k_coldfire_flavour)
129 return builtin_type (gdbarch)->builtin_double;
131 return m68881_ext_type (gdbarch);
134 if (regnum == M68K_FPI_REGNUM)
135 return builtin_type (gdbarch)->builtin_func_ptr;
137 if (regnum == M68K_FPC_REGNUM || regnum == M68K_FPS_REGNUM)
138 return builtin_type (gdbarch)->builtin_int32;
142 if (regnum >= M68K_FP0_REGNUM && regnum <= M68K_FPI_REGNUM)
143 return builtin_type (gdbarch)->builtin_int0;
146 if (regnum == gdbarch_pc_regnum (gdbarch))
147 return builtin_type (gdbarch)->builtin_func_ptr;
149 if (regnum >= M68K_A0_REGNUM && regnum <= M68K_A0_REGNUM + 7)
150 return builtin_type (gdbarch)->builtin_data_ptr;
152 if (regnum == M68K_PS_REGNUM)
153 return m68k_ps_type (gdbarch);
155 return builtin_type (gdbarch)->builtin_int32;
158 static const char *m68k_register_names[] = {
159 "d0", "d1", "d2", "d3", "d4", "d5", "d6", "d7",
160 "a0", "a1", "a2", "a3", "a4", "a5", "fp", "sp",
162 "fp0", "fp1", "fp2", "fp3", "fp4", "fp5", "fp6", "fp7",
163 "fpcontrol", "fpstatus", "fpiaddr"
166 /* Function: m68k_register_name
167 Returns the name of the standard m68k register regnum. */
170 m68k_register_name (struct gdbarch *gdbarch, int regnum)
172 if (regnum < 0 || regnum >= ARRAY_SIZE (m68k_register_names))
173 internal_error (__FILE__, __LINE__,
174 _("m68k_register_name: illegal register number %d"),
176 else if (regnum >= M68K_FP0_REGNUM && regnum <= M68K_FPI_REGNUM
177 && gdbarch_tdep (gdbarch)->fpregs_present == 0)
180 return m68k_register_names[regnum];
183 /* Return nonzero if a value of type TYPE stored in register REGNUM
184 needs any special handling. */
187 m68k_convert_register_p (struct gdbarch *gdbarch,
188 int regnum, struct type *type)
190 if (!gdbarch_tdep (gdbarch)->fpregs_present)
192 return (regnum >= M68K_FP0_REGNUM && regnum <= M68K_FP0_REGNUM + 7
193 /* We only support floating-point values. */
194 && TYPE_CODE (type) == TYPE_CODE_FLT
195 && type != register_type (gdbarch, M68K_FP0_REGNUM));
198 /* Read a value of type TYPE from register REGNUM in frame FRAME, and
199 return its contents in TO. */
202 m68k_register_to_value (struct frame_info *frame, int regnum,
203 struct type *type, gdb_byte *to,
204 int *optimizedp, int *unavailablep)
206 struct gdbarch *gdbarch = get_frame_arch (frame);
207 gdb_byte from[M68K_MAX_REGISTER_SIZE];
208 struct type *fpreg_type = register_type (gdbarch, M68K_FP0_REGNUM);
210 gdb_assert (TYPE_CODE (type) == TYPE_CODE_FLT);
212 /* Convert to TYPE. */
213 if (!get_frame_register_bytes (frame, regnum, 0,
214 register_size (gdbarch, regnum),
215 from, optimizedp, unavailablep))
218 target_float_convert (from, fpreg_type, to, type);
219 *optimizedp = *unavailablep = 0;
223 /* Write the contents FROM of a value of type TYPE into register
224 REGNUM in frame FRAME. */
227 m68k_value_to_register (struct frame_info *frame, int regnum,
228 struct type *type, const gdb_byte *from)
230 gdb_byte to[M68K_MAX_REGISTER_SIZE];
231 struct type *fpreg_type = register_type (get_frame_arch (frame),
234 /* We only support floating-point values. */
235 if (TYPE_CODE (type) != TYPE_CODE_FLT)
237 warning (_("Cannot convert non-floating-point type "
238 "to floating-point register value."));
242 /* Convert from TYPE. */
243 target_float_convert (from, type, to, fpreg_type);
244 put_frame_register (frame, regnum, to);
248 /* There is a fair number of calling conventions that are in somewhat
249 wide use. The 68000/08/10 don't support an FPU, not even as a
250 coprocessor. All function return values are stored in %d0/%d1.
251 Structures are returned in a static buffer, a pointer to which is
252 returned in %d0. This means that functions returning a structure
253 are not re-entrant. To avoid this problem some systems use a
254 convention where the caller passes a pointer to a buffer in %a1
255 where the return values is to be stored. This convention is the
256 default, and is implemented in the function m68k_return_value.
258 The 68020/030/040/060 do support an FPU, either as a coprocessor
259 (68881/2) or built-in (68040/68060). That's why System V release 4
260 (SVR4) instroduces a new calling convention specified by the SVR4
261 psABI. Integer values are returned in %d0/%d1, pointer return
262 values in %a0 and floating values in %fp0. When calling functions
263 returning a structure the caller should pass a pointer to a buffer
264 for the return value in %a0. This convention is implemented in the
265 function m68k_svr4_return_value, and by appropriately setting the
266 struct_value_regnum member of `struct gdbarch_tdep'.
268 GNU/Linux returns values in the same way as SVR4 does, but uses %a1
269 for passing the structure return value buffer.
271 GCC can also generate code where small structures are returned in
272 %d0/%d1 instead of in memory by using -freg-struct-return. This is
273 the default on NetBSD a.out, OpenBSD and GNU/Linux and several
274 embedded systems. This convention is implemented by setting the
275 struct_return member of `struct gdbarch_tdep' to reg_struct_return. */
277 /* Read a function return value of TYPE from REGCACHE, and copy that
281 m68k_extract_return_value (struct type *type, struct regcache *regcache,
284 int len = TYPE_LENGTH (type);
285 gdb_byte buf[M68K_MAX_REGISTER_SIZE];
289 regcache_raw_read (regcache, M68K_D0_REGNUM, buf);
290 memcpy (valbuf, buf + (4 - len), len);
294 regcache_raw_read (regcache, M68K_D0_REGNUM, buf);
295 memcpy (valbuf, buf + (8 - len), len - 4);
296 regcache_raw_read (regcache, M68K_D1_REGNUM, valbuf + (len - 4));
299 internal_error (__FILE__, __LINE__,
300 _("Cannot extract return value of %d bytes long."), len);
304 m68k_svr4_extract_return_value (struct type *type, struct regcache *regcache,
307 gdb_byte buf[M68K_MAX_REGISTER_SIZE];
308 struct gdbarch *gdbarch = regcache->arch ();
309 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
311 if (tdep->float_return && TYPE_CODE (type) == TYPE_CODE_FLT)
313 struct type *fpreg_type = register_type (gdbarch, M68K_FP0_REGNUM);
314 regcache_raw_read (regcache, M68K_FP0_REGNUM, buf);
315 target_float_convert (buf, fpreg_type, valbuf, type);
317 else if (TYPE_CODE (type) == TYPE_CODE_PTR && TYPE_LENGTH (type) == 4)
318 regcache_raw_read (regcache, M68K_A0_REGNUM, valbuf);
320 m68k_extract_return_value (type, regcache, valbuf);
323 /* Write a function return value of TYPE from VALBUF into REGCACHE. */
326 m68k_store_return_value (struct type *type, struct regcache *regcache,
327 const gdb_byte *valbuf)
329 int len = TYPE_LENGTH (type);
332 regcache_raw_write_part (regcache, M68K_D0_REGNUM, 4 - len, len, valbuf);
335 regcache_raw_write_part (regcache, M68K_D0_REGNUM, 8 - len,
337 regcache_raw_write (regcache, M68K_D1_REGNUM, valbuf + (len - 4));
340 internal_error (__FILE__, __LINE__,
341 _("Cannot store return value of %d bytes long."), len);
345 m68k_svr4_store_return_value (struct type *type, struct regcache *regcache,
346 const gdb_byte *valbuf)
348 struct gdbarch *gdbarch = regcache->arch ();
349 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
351 if (tdep->float_return && TYPE_CODE (type) == TYPE_CODE_FLT)
353 struct type *fpreg_type = register_type (gdbarch, M68K_FP0_REGNUM);
354 gdb_byte buf[M68K_MAX_REGISTER_SIZE];
355 target_float_convert (valbuf, type, buf, fpreg_type);
356 regcache_raw_write (regcache, M68K_FP0_REGNUM, buf);
358 else if (TYPE_CODE (type) == TYPE_CODE_PTR && TYPE_LENGTH (type) == 4)
360 regcache_raw_write (regcache, M68K_A0_REGNUM, valbuf);
361 regcache_raw_write (regcache, M68K_D0_REGNUM, valbuf);
364 m68k_store_return_value (type, regcache, valbuf);
367 /* Return non-zero if TYPE, which is assumed to be a structure, union or
368 complex type, should be returned in registers for architecture
372 m68k_reg_struct_return_p (struct gdbarch *gdbarch, struct type *type)
374 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
375 enum type_code code = TYPE_CODE (type);
376 int len = TYPE_LENGTH (type);
378 gdb_assert (code == TYPE_CODE_STRUCT || code == TYPE_CODE_UNION
379 || code == TYPE_CODE_COMPLEX);
381 if (tdep->struct_return == pcc_struct_return)
384 return (len == 1 || len == 2 || len == 4 || len == 8);
387 /* Determine, for architecture GDBARCH, how a return value of TYPE
388 should be returned. If it is supposed to be returned in registers,
389 and READBUF is non-zero, read the appropriate value from REGCACHE,
390 and copy it into READBUF. If WRITEBUF is non-zero, write the value
391 from WRITEBUF into REGCACHE. */
393 static enum return_value_convention
394 m68k_return_value (struct gdbarch *gdbarch, struct value *function,
395 struct type *type, struct regcache *regcache,
396 gdb_byte *readbuf, const gdb_byte *writebuf)
398 enum type_code code = TYPE_CODE (type);
400 /* GCC returns a `long double' in memory too. */
401 if (((code == TYPE_CODE_STRUCT || code == TYPE_CODE_UNION
402 || code == TYPE_CODE_COMPLEX)
403 && !m68k_reg_struct_return_p (gdbarch, type))
404 || (code == TYPE_CODE_FLT && TYPE_LENGTH (type) == 12))
406 /* The default on m68k is to return structures in static memory.
407 Consequently a function must return the address where we can
408 find the return value. */
414 regcache_raw_read_unsigned (regcache, M68K_D0_REGNUM, &addr);
415 read_memory (addr, readbuf, TYPE_LENGTH (type));
418 return RETURN_VALUE_ABI_RETURNS_ADDRESS;
422 m68k_extract_return_value (type, regcache, readbuf);
424 m68k_store_return_value (type, regcache, writebuf);
426 return RETURN_VALUE_REGISTER_CONVENTION;
429 static enum return_value_convention
430 m68k_svr4_return_value (struct gdbarch *gdbarch, struct value *function,
431 struct type *type, struct regcache *regcache,
432 gdb_byte *readbuf, const gdb_byte *writebuf)
434 enum type_code code = TYPE_CODE (type);
436 if ((code == TYPE_CODE_STRUCT || code == TYPE_CODE_UNION
437 || code == TYPE_CODE_COMPLEX)
438 && !m68k_reg_struct_return_p (gdbarch, type))
440 /* The System V ABI says that:
442 "A function returning a structure or union also sets %a0 to
443 the value it finds in %a0. Thus when the caller receives
444 control again, the address of the returned object resides in
447 So the ABI guarantees that we can always find the return
448 value just after the function has returned. */
454 regcache_raw_read_unsigned (regcache, M68K_A0_REGNUM, &addr);
455 read_memory (addr, readbuf, TYPE_LENGTH (type));
458 return RETURN_VALUE_ABI_RETURNS_ADDRESS;
461 /* This special case is for structures consisting of a single
462 `float' or `double' member. These structures are returned in
463 %fp0. For these structures, we call ourselves recursively,
464 changing TYPE into the type of the first member of the structure.
465 Since that should work for all structures that have only one
466 member, we don't bother to check the member's type here. */
467 if (code == TYPE_CODE_STRUCT && TYPE_NFIELDS (type) == 1)
469 type = check_typedef (TYPE_FIELD_TYPE (type, 0));
470 return m68k_svr4_return_value (gdbarch, function, type, regcache,
475 m68k_svr4_extract_return_value (type, regcache, readbuf);
477 m68k_svr4_store_return_value (type, regcache, writebuf);
479 return RETURN_VALUE_REGISTER_CONVENTION;
483 /* Always align the frame to a 4-byte boundary. This is required on
484 coldfire and harmless on the rest. */
487 m68k_frame_align (struct gdbarch *gdbarch, CORE_ADDR sp)
489 /* Align the stack to four bytes. */
494 m68k_push_dummy_call (struct gdbarch *gdbarch, struct value *function,
495 struct regcache *regcache, CORE_ADDR bp_addr, int nargs,
496 struct value **args, CORE_ADDR sp, int struct_return,
497 CORE_ADDR struct_addr)
499 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
500 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
504 /* Push arguments in reverse order. */
505 for (i = nargs - 1; i >= 0; i--)
507 struct type *value_type = value_enclosing_type (args[i]);
508 int len = TYPE_LENGTH (value_type);
509 int container_len = (len + 3) & ~3;
512 /* Non-scalars bigger than 4 bytes are left aligned, others are
514 if ((TYPE_CODE (value_type) == TYPE_CODE_STRUCT
515 || TYPE_CODE (value_type) == TYPE_CODE_UNION
516 || TYPE_CODE (value_type) == TYPE_CODE_ARRAY)
520 offset = container_len - len;
522 write_memory (sp + offset, value_contents_all (args[i]), len);
525 /* Store struct value address. */
528 store_unsigned_integer (buf, 4, byte_order, struct_addr);
529 regcache_cooked_write (regcache, tdep->struct_value_regnum, buf);
532 /* Store return address. */
534 store_unsigned_integer (buf, 4, byte_order, bp_addr);
535 write_memory (sp, buf, 4);
537 /* Finally, update the stack pointer... */
538 store_unsigned_integer (buf, 4, byte_order, sp);
539 regcache_cooked_write (regcache, M68K_SP_REGNUM, buf);
541 /* ...and fake a frame pointer. */
542 regcache_cooked_write (regcache, M68K_FP_REGNUM, buf);
544 /* DWARF2/GCC uses the stack address *before* the function call as a
549 /* Convert a dwarf or dwarf2 regnumber to a GDB regnum. */
552 m68k_dwarf_reg_to_regnum (struct gdbarch *gdbarch, int num)
556 return (num - 0) + M68K_D0_REGNUM;
559 return (num - 8) + M68K_A0_REGNUM;
560 else if (num < 24 && gdbarch_tdep (gdbarch)->fpregs_present)
562 return (num - 16) + M68K_FP0_REGNUM;
565 return M68K_PC_REGNUM;
571 struct m68k_frame_cache
578 /* Saved registers. */
579 CORE_ADDR saved_regs[M68K_NUM_REGS];
582 /* Stack space reserved for local variables. */
586 /* Allocate and initialize a frame cache. */
588 static struct m68k_frame_cache *
589 m68k_alloc_frame_cache (void)
591 struct m68k_frame_cache *cache;
594 cache = FRAME_OBSTACK_ZALLOC (struct m68k_frame_cache);
598 cache->sp_offset = -4;
601 /* Saved registers. We initialize these to -1 since zero is a valid
602 offset (that's where %fp is supposed to be stored). */
603 for (i = 0; i < M68K_NUM_REGS; i++)
604 cache->saved_regs[i] = -1;
606 /* Frameless until proven otherwise. */
612 /* Check whether PC points at a code that sets up a new stack frame.
613 If so, it updates CACHE and returns the address of the first
614 instruction after the sequence that sets removes the "hidden"
615 argument from the stack or CURRENT_PC, whichever is smaller.
616 Otherwise, return PC. */
619 m68k_analyze_frame_setup (struct gdbarch *gdbarch,
620 CORE_ADDR pc, CORE_ADDR current_pc,
621 struct m68k_frame_cache *cache)
623 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
626 if (pc >= current_pc)
629 op = read_memory_unsigned_integer (pc, 2, byte_order);
631 if (op == P_LINKW_FP || op == P_LINKL_FP || op == P_PEA_FP)
633 cache->saved_regs[M68K_FP_REGNUM] = 0;
634 cache->sp_offset += 4;
635 if (op == P_LINKW_FP)
637 /* link.w %fp, #-N */
638 /* link.w %fp, #0; adda.l #-N, %sp */
639 cache->locals = -read_memory_integer (pc + 2, 2, byte_order);
641 if (pc + 4 < current_pc && cache->locals == 0)
643 op = read_memory_unsigned_integer (pc + 4, 2, byte_order);
644 if (op == P_ADDAL_SP)
646 cache->locals = read_memory_integer (pc + 6, 4, byte_order);
653 else if (op == P_LINKL_FP)
655 /* link.l %fp, #-N */
656 cache->locals = -read_memory_integer (pc + 2, 4, byte_order);
661 /* pea (%fp); movea.l %sp, %fp */
664 if (pc + 2 < current_pc)
666 op = read_memory_unsigned_integer (pc + 2, 2, byte_order);
668 if (op == P_MOVEAL_SP_FP)
670 /* move.l %sp, %fp */
678 else if ((op & 0170777) == P_SUBQW_SP || (op & 0170777) == P_SUBQL_SP)
680 /* subq.[wl] #N,%sp */
681 /* subq.[wl] #8,%sp; subq.[wl] #N,%sp */
682 cache->locals = (op & 07000) == 0 ? 8 : (op & 07000) >> 9;
683 if (pc + 2 < current_pc)
685 op = read_memory_unsigned_integer (pc + 2, 2, byte_order);
686 if ((op & 0170777) == P_SUBQW_SP || (op & 0170777) == P_SUBQL_SP)
688 cache->locals += (op & 07000) == 0 ? 8 : (op & 07000) >> 9;
694 else if (op == P_ADDAW_SP || op == P_LEA_SP_SP)
697 /* lea (-N,%sp),%sp */
698 cache->locals = -read_memory_integer (pc + 2, 2, byte_order);
701 else if (op == P_ADDAL_SP)
704 cache->locals = -read_memory_integer (pc + 2, 4, byte_order);
711 /* Check whether PC points at code that saves registers on the stack.
712 If so, it updates CACHE and returns the address of the first
713 instruction after the register saves or CURRENT_PC, whichever is
714 smaller. Otherwise, return PC. */
717 m68k_analyze_register_saves (struct gdbarch *gdbarch, CORE_ADDR pc,
718 CORE_ADDR current_pc,
719 struct m68k_frame_cache *cache)
721 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
723 if (cache->locals >= 0)
729 offset = -4 - cache->locals;
730 while (pc < current_pc)
732 op = read_memory_unsigned_integer (pc, 2, byte_order);
733 if (op == P_FMOVEMX_SP
734 && gdbarch_tdep (gdbarch)->fpregs_present)
736 /* fmovem.x REGS,-(%sp) */
737 op = read_memory_unsigned_integer (pc + 2, 2, byte_order);
738 if ((op & 0xff00) == 0xe000)
741 for (i = 0; i < 16; i++, mask >>= 1)
745 cache->saved_regs[i + M68K_FP0_REGNUM] = offset;
754 else if ((op & 0177760) == P_MOVEL_SP)
756 /* move.l %R,-(%sp) */
758 cache->saved_regs[regno] = offset;
762 else if (op == P_MOVEML_SP)
764 /* movem.l REGS,-(%sp) */
765 mask = read_memory_unsigned_integer (pc + 2, 2, byte_order);
766 for (i = 0; i < 16; i++, mask >>= 1)
770 cache->saved_regs[15 - i] = offset;
785 /* Do a full analysis of the prologue at PC and update CACHE
786 accordingly. Bail out early if CURRENT_PC is reached. Return the
787 address where the analysis stopped.
789 We handle all cases that can be generated by gcc.
791 For allocating a stack frame:
795 pea (%fp); move.l %sp,%fp
796 link.w %a6,#0; add.l #-N,%sp
799 subq.w #8,%sp; subq.w #N-8,%sp
804 For saving registers:
808 move.l R1,-(%sp); move.l R2,-(%sp)
811 For setting up the PIC register:
818 m68k_analyze_prologue (struct gdbarch *gdbarch, CORE_ADDR pc,
819 CORE_ADDR current_pc, struct m68k_frame_cache *cache)
821 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
824 pc = m68k_analyze_frame_setup (gdbarch, pc, current_pc, cache);
825 pc = m68k_analyze_register_saves (gdbarch, pc, current_pc, cache);
826 if (pc >= current_pc)
829 /* Check for GOT setup. */
830 op = read_memory_unsigned_integer (pc, 4, byte_order);
831 if (op == P_LEA_PC_A5)
833 /* lea (%pc,N),%a5 */
840 /* Return PC of first real instruction. */
843 m68k_skip_prologue (struct gdbarch *gdbarch, CORE_ADDR start_pc)
845 struct m68k_frame_cache cache;
849 pc = m68k_analyze_prologue (gdbarch, start_pc, (CORE_ADDR) -1, &cache);
850 if (cache.locals < 0)
856 m68k_unwind_pc (struct gdbarch *gdbarch, struct frame_info *next_frame)
860 frame_unwind_register (next_frame, gdbarch_pc_regnum (gdbarch), buf);
861 return extract_typed_address (buf, builtin_type (gdbarch)->builtin_func_ptr);
866 static struct m68k_frame_cache *
867 m68k_frame_cache (struct frame_info *this_frame, void **this_cache)
869 struct gdbarch *gdbarch = get_frame_arch (this_frame);
870 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
871 struct m68k_frame_cache *cache;
876 return (struct m68k_frame_cache *) *this_cache;
878 cache = m68k_alloc_frame_cache ();
881 /* In principle, for normal frames, %fp holds the frame pointer,
882 which holds the base address for the current stack frame.
883 However, for functions that don't need it, the frame pointer is
884 optional. For these "frameless" functions the frame pointer is
885 actually the frame pointer of the calling frame. Signal
886 trampolines are just a special case of a "frameless" function.
887 They (usually) share their frame pointer with the frame that was
888 in progress when the signal occurred. */
890 get_frame_register (this_frame, M68K_FP_REGNUM, buf);
891 cache->base = extract_unsigned_integer (buf, 4, byte_order);
892 if (cache->base == 0)
895 /* For normal frames, %pc is stored at 4(%fp). */
896 cache->saved_regs[M68K_PC_REGNUM] = 4;
898 cache->pc = get_frame_func (this_frame);
900 m68k_analyze_prologue (get_frame_arch (this_frame), cache->pc,
901 get_frame_pc (this_frame), cache);
903 if (cache->locals < 0)
905 /* We didn't find a valid frame, which means that CACHE->base
906 currently holds the frame pointer for our calling frame. If
907 we're at the start of a function, or somewhere half-way its
908 prologue, the function's frame probably hasn't been fully
909 setup yet. Try to reconstruct the base address for the stack
910 frame by looking at the stack pointer. For truly "frameless"
911 functions this might work too. */
913 get_frame_register (this_frame, M68K_SP_REGNUM, buf);
914 cache->base = extract_unsigned_integer (buf, 4, byte_order)
918 /* Now that we have the base address for the stack frame we can
919 calculate the value of %sp in the calling frame. */
920 cache->saved_sp = cache->base + 8;
922 /* Adjust all the saved registers such that they contain addresses
923 instead of offsets. */
924 for (i = 0; i < M68K_NUM_REGS; i++)
925 if (cache->saved_regs[i] != -1)
926 cache->saved_regs[i] += cache->base;
932 m68k_frame_this_id (struct frame_info *this_frame, void **this_cache,
933 struct frame_id *this_id)
935 struct m68k_frame_cache *cache = m68k_frame_cache (this_frame, this_cache);
937 /* This marks the outermost frame. */
938 if (cache->base == 0)
941 /* See the end of m68k_push_dummy_call. */
942 *this_id = frame_id_build (cache->base + 8, cache->pc);
945 static struct value *
946 m68k_frame_prev_register (struct frame_info *this_frame, void **this_cache,
949 struct m68k_frame_cache *cache = m68k_frame_cache (this_frame, this_cache);
951 gdb_assert (regnum >= 0);
953 if (regnum == M68K_SP_REGNUM && cache->saved_sp)
954 return frame_unwind_got_constant (this_frame, regnum, cache->saved_sp);
956 if (regnum < M68K_NUM_REGS && cache->saved_regs[regnum] != -1)
957 return frame_unwind_got_memory (this_frame, regnum,
958 cache->saved_regs[regnum]);
960 return frame_unwind_got_register (this_frame, regnum, regnum);
963 static const struct frame_unwind m68k_frame_unwind =
966 default_frame_unwind_stop_reason,
968 m68k_frame_prev_register,
970 default_frame_sniffer
974 m68k_frame_base_address (struct frame_info *this_frame, void **this_cache)
976 struct m68k_frame_cache *cache = m68k_frame_cache (this_frame, this_cache);
981 static const struct frame_base m68k_frame_base =
984 m68k_frame_base_address,
985 m68k_frame_base_address,
986 m68k_frame_base_address
989 static struct frame_id
990 m68k_dummy_id (struct gdbarch *gdbarch, struct frame_info *this_frame)
994 fp = get_frame_register_unsigned (this_frame, M68K_FP_REGNUM);
996 /* See the end of m68k_push_dummy_call. */
997 return frame_id_build (fp + 8, get_frame_pc (this_frame));
1001 /* Figure out where the longjmp will land. Slurp the args out of the stack.
1002 We expect the first arg to be a pointer to the jmp_buf structure from which
1003 we extract the pc (JB_PC) that we will land at. The pc is copied into PC.
1004 This routine returns true on success. */
1007 m68k_get_longjmp_target (struct frame_info *frame, CORE_ADDR *pc)
1010 CORE_ADDR sp, jb_addr;
1011 struct gdbarch *gdbarch = get_frame_arch (frame);
1012 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
1013 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
1015 if (tdep->jb_pc < 0)
1017 internal_error (__FILE__, __LINE__,
1018 _("m68k_get_longjmp_target: not implemented"));
1022 buf = (gdb_byte *) alloca (gdbarch_ptr_bit (gdbarch) / TARGET_CHAR_BIT);
1023 sp = get_frame_register_unsigned (frame, gdbarch_sp_regnum (gdbarch));
1025 if (target_read_memory (sp + SP_ARG0, /* Offset of first arg on stack. */
1026 buf, gdbarch_ptr_bit (gdbarch) / TARGET_CHAR_BIT))
1029 jb_addr = extract_unsigned_integer (buf, gdbarch_ptr_bit (gdbarch)
1030 / TARGET_CHAR_BIT, byte_order);
1032 if (target_read_memory (jb_addr + tdep->jb_pc * tdep->jb_elt_size, buf,
1033 gdbarch_ptr_bit (gdbarch) / TARGET_CHAR_BIT),
1037 *pc = extract_unsigned_integer (buf, gdbarch_ptr_bit (gdbarch)
1038 / TARGET_CHAR_BIT, byte_order);
1043 /* This is the implementation of gdbarch method
1044 return_in_first_hidden_param_p. */
1047 m68k_return_in_first_hidden_param_p (struct gdbarch *gdbarch,
1053 /* System V Release 4 (SVR4). */
1056 m68k_svr4_init_abi (struct gdbarch_info info, struct gdbarch *gdbarch)
1058 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
1060 /* SVR4 uses a different calling convention. */
1061 set_gdbarch_return_value (gdbarch, m68k_svr4_return_value);
1063 /* SVR4 uses %a0 instead of %a1. */
1064 tdep->struct_value_regnum = M68K_A0_REGNUM;
1068 /* Function: m68k_gdbarch_init
1069 Initializer function for the m68k gdbarch vector.
1070 Called by gdbarch. Sets up the gdbarch vector(s) for this target. */
1072 static struct gdbarch *
1073 m68k_gdbarch_init (struct gdbarch_info info, struct gdbarch_list *arches)
1075 struct gdbarch_tdep *tdep = NULL;
1076 struct gdbarch *gdbarch;
1077 struct gdbarch_list *best_arch;
1078 struct tdesc_arch_data *tdesc_data = NULL;
1080 enum m68k_flavour flavour = m68k_no_flavour;
1082 const struct floatformat **long_double_format = floatformats_m68881_ext;
1084 /* Check any target description for validity. */
1085 if (tdesc_has_registers (info.target_desc))
1087 const struct tdesc_feature *feature;
1090 feature = tdesc_find_feature (info.target_desc,
1091 "org.gnu.gdb.m68k.core");
1093 if (feature == NULL)
1095 feature = tdesc_find_feature (info.target_desc,
1096 "org.gnu.gdb.coldfire.core");
1097 if (feature != NULL)
1098 flavour = m68k_coldfire_flavour;
1101 if (feature == NULL)
1103 feature = tdesc_find_feature (info.target_desc,
1104 "org.gnu.gdb.fido.core");
1105 if (feature != NULL)
1106 flavour = m68k_fido_flavour;
1109 if (feature == NULL)
1112 tdesc_data = tdesc_data_alloc ();
1115 for (i = 0; i <= M68K_PC_REGNUM; i++)
1116 valid_p &= tdesc_numbered_register (feature, tdesc_data, i,
1117 m68k_register_names[i]);
1121 tdesc_data_cleanup (tdesc_data);
1125 feature = tdesc_find_feature (info.target_desc,
1126 "org.gnu.gdb.coldfire.fp");
1127 if (feature != NULL)
1130 for (i = M68K_FP0_REGNUM; i <= M68K_FPI_REGNUM; i++)
1131 valid_p &= tdesc_numbered_register (feature, tdesc_data, i,
1132 m68k_register_names[i]);
1135 tdesc_data_cleanup (tdesc_data);
1143 /* The mechanism for returning floating values from function
1144 and the type of long double depend on whether we're
1145 on ColdFire or standard m68k. */
1147 if (info.bfd_arch_info && info.bfd_arch_info->mach != 0)
1149 const bfd_arch_info_type *coldfire_arch =
1150 bfd_lookup_arch (bfd_arch_m68k, bfd_mach_mcf_isa_a_nodiv);
1153 && ((*info.bfd_arch_info->compatible)
1154 (info.bfd_arch_info, coldfire_arch)))
1155 flavour = m68k_coldfire_flavour;
1158 /* If there is already a candidate, use it. */
1159 for (best_arch = gdbarch_list_lookup_by_info (arches, &info);
1161 best_arch = gdbarch_list_lookup_by_info (best_arch->next, &info))
1163 if (flavour != gdbarch_tdep (best_arch->gdbarch)->flavour)
1166 if (has_fp != gdbarch_tdep (best_arch->gdbarch)->fpregs_present)
1172 if (best_arch != NULL)
1174 if (tdesc_data != NULL)
1175 tdesc_data_cleanup (tdesc_data);
1176 return best_arch->gdbarch;
1179 tdep = XCNEW (struct gdbarch_tdep);
1180 gdbarch = gdbarch_alloc (&info, tdep);
1181 tdep->fpregs_present = has_fp;
1182 tdep->flavour = flavour;
1184 if (flavour == m68k_coldfire_flavour || flavour == m68k_fido_flavour)
1185 long_double_format = floatformats_ieee_double;
1186 set_gdbarch_long_double_format (gdbarch, long_double_format);
1187 set_gdbarch_long_double_bit (gdbarch, long_double_format[0]->totalsize);
1189 set_gdbarch_skip_prologue (gdbarch, m68k_skip_prologue);
1190 set_gdbarch_breakpoint_kind_from_pc (gdbarch, m68k_breakpoint::kind_from_pc);
1191 set_gdbarch_sw_breakpoint_from_kind (gdbarch, m68k_breakpoint::bp_from_kind);
1193 /* Stack grows down. */
1194 set_gdbarch_inner_than (gdbarch, core_addr_lessthan);
1195 set_gdbarch_frame_align (gdbarch, m68k_frame_align);
1197 set_gdbarch_believe_pcc_promotion (gdbarch, 1);
1198 if (flavour == m68k_coldfire_flavour || flavour == m68k_fido_flavour)
1199 set_gdbarch_decr_pc_after_break (gdbarch, 2);
1201 set_gdbarch_frame_args_skip (gdbarch, 8);
1202 set_gdbarch_dwarf2_reg_to_regnum (gdbarch, m68k_dwarf_reg_to_regnum);
1204 set_gdbarch_register_type (gdbarch, m68k_register_type);
1205 set_gdbarch_register_name (gdbarch, m68k_register_name);
1206 set_gdbarch_num_regs (gdbarch, M68K_NUM_REGS);
1207 set_gdbarch_sp_regnum (gdbarch, M68K_SP_REGNUM);
1208 set_gdbarch_pc_regnum (gdbarch, M68K_PC_REGNUM);
1209 set_gdbarch_ps_regnum (gdbarch, M68K_PS_REGNUM);
1210 set_gdbarch_convert_register_p (gdbarch, m68k_convert_register_p);
1211 set_gdbarch_register_to_value (gdbarch, m68k_register_to_value);
1212 set_gdbarch_value_to_register (gdbarch, m68k_value_to_register);
1215 set_gdbarch_fp0_regnum (gdbarch, M68K_FP0_REGNUM);
1217 /* Try to figure out if the arch uses floating registers to return
1218 floating point values from functions. */
1221 /* On ColdFire, floating point values are returned in D0. */
1222 if (flavour == m68k_coldfire_flavour)
1223 tdep->float_return = 0;
1225 tdep->float_return = 1;
1229 /* No floating registers, so can't use them for returning values. */
1230 tdep->float_return = 0;
1233 /* Function call & return. */
1234 set_gdbarch_push_dummy_call (gdbarch, m68k_push_dummy_call);
1235 set_gdbarch_return_value (gdbarch, m68k_return_value);
1236 set_gdbarch_return_in_first_hidden_param_p (gdbarch,
1237 m68k_return_in_first_hidden_param_p);
1239 #if defined JB_PC && defined JB_ELEMENT_SIZE
1240 tdep->jb_pc = JB_PC;
1241 tdep->jb_elt_size = JB_ELEMENT_SIZE;
1245 tdep->struct_value_regnum = M68K_A1_REGNUM;
1246 tdep->struct_return = reg_struct_return;
1248 /* Frame unwinder. */
1249 set_gdbarch_dummy_id (gdbarch, m68k_dummy_id);
1250 set_gdbarch_unwind_pc (gdbarch, m68k_unwind_pc);
1252 /* Hook in the DWARF CFI frame unwinder. */
1253 dwarf2_append_unwinders (gdbarch);
1255 frame_base_set_default (gdbarch, &m68k_frame_base);
1257 /* Hook in ABI-specific overrides, if they have been registered. */
1258 gdbarch_init_osabi (info, gdbarch);
1260 /* Now we have tuned the configuration, set a few final things,
1261 based on what the OS ABI has told us. */
1263 if (tdep->jb_pc >= 0)
1264 set_gdbarch_get_longjmp_target (gdbarch, m68k_get_longjmp_target);
1266 frame_unwind_append_unwinder (gdbarch, &m68k_frame_unwind);
1269 tdesc_use_registers (gdbarch, info.target_desc, tdesc_data);
1276 m68k_dump_tdep (struct gdbarch *gdbarch, struct ui_file *file)
1278 struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
1285 _initialize_m68k_tdep (void)
1287 gdbarch_register (bfd_arch_m68k, m68k_gdbarch_init, m68k_dump_tdep);