gdb/config/sparc/tm-sparc.h

   1 /* Target machine sub-parameters for SPARC, for GDB, the GNU debugger.
   2    This is included by other tm-*.h files to define SPARC cpu-related info.
   3    Copyright 1986, 1987, 1989, 1991, 1992, 1993, 1994, 1995, 1996, 1997,
   4    1998, 1999, 2000, 2001, 2002, 2003
   5    Free Software Foundation, Inc.
   6    Contributed by Michael Tiemann (tiemann@mcc.com)
   7
   8    This file is part of GDB.
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 2 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program; if not, write to the Free Software
  22    Foundation, Inc., 59 Temple Place - Suite 330,
  23    Boston, MA 02111-1307, USA.  */
  24
  25 #include "regcache.h"
  26
  27 struct type;
  28 struct value;
  29 struct frame_info;
  30
  31 /*
  32  * The following enums are purely for the convenience of the GDB
  33  * developer, when debugging GDB.
  34  */
  35
  36 enum {  /* Sparc general registers, for all sparc versions.  */
  37   G0_REGNUM, G1_REGNUM, G2_REGNUM, G3_REGNUM,
  38   G4_REGNUM, G5_REGNUM, G6_REGNUM, G7_REGNUM,
  39   O0_REGNUM, O1_REGNUM, O2_REGNUM, O3_REGNUM,
  40   O4_REGNUM, O5_REGNUM, O6_REGNUM, O7_REGNUM,
  41   L0_REGNUM, L1_REGNUM, L2_REGNUM, L3_REGNUM,
  42   L4_REGNUM, L5_REGNUM, L6_REGNUM, L7_REGNUM,
  43   I0_REGNUM, I1_REGNUM, I2_REGNUM, I3_REGNUM,
  44   I4_REGNUM, I5_REGNUM, I6_REGNUM, I7_REGNUM,
  45   FP0_REGNUM            /* Floating point register 0 */
  46 };
  47
  48 enum {  /* Sparc general registers, alternate names.  */
  49   R0_REGNUM,  R1_REGNUM,  R2_REGNUM,  R3_REGNUM,
  50   R4_REGNUM,  R5_REGNUM,  R6_REGNUM,  R7_REGNUM,
  51   R8_REGNUM,  R9_REGNUM,  R10_REGNUM, R11_REGNUM,
  52   R12_REGNUM, R13_REGNUM, R14_REGNUM, R15_REGNUM,
  53   R16_REGNUM, R17_REGNUM, R18_REGNUM, R19_REGNUM,
  54   R20_REGNUM, R21_REGNUM, R22_REGNUM, R23_REGNUM,
  55   R24_REGNUM, R25_REGNUM, R26_REGNUM, R27_REGNUM,
  56   R28_REGNUM, R29_REGNUM, R30_REGNUM, R31_REGNUM
  57 };
  58
  59 enum {                  /* Sparc32 control registers.  */
  60   PS_REGNUM  = 65,      /* PC, NPC, and Y are omitted because */
  61   WIM_REGNUM = 66,      /* they have different values depending on */
  62   TBR_REGNUM = 67,      /* 32-bit / 64-bit mode.  */
  63   FPS_REGNUM = 70,
  64   CPS_REGNUM = 71
  65 };
  66
  67 /* v9 misc. and priv. regs */
  68
  69 /* Note: specifying values explicitly for documentation purposes.  */
  70 enum {  /* Sparc64 control registers, excluding Y, PC, and NPC.  */
  71   CCR_REGNUM = 82,              /* Condition Code Register (%xcc,%icc) */
  72   FSR_REGNUM = 83,              /* Floating Point State */
  73   FPRS_REGNUM = 84,             /* Floating Point Registers State */
  74   ASI_REGNUM = 86,              /* Alternate Space Identifier */
  75   VER_REGNUM = 87,              /* Version register */
  76   TICK_REGNUM = 88,             /* Tick register */
  77   PIL_REGNUM = 89,              /* Processor Interrupt Level */
  78   PSTATE_REGNUM = 90,           /* Processor State */
  79   TSTATE_REGNUM = 91,           /* Trap State */
  80   TBA_REGNUM = 92,              /* Trap Base Address */
  81   TL_REGNUM = 93,               /* Trap Level */
  82   TT_REGNUM = 94,               /* Trap Type */
  83   TPC_REGNUM = 95,              /* Trap pc */
  84   TNPC_REGNUM = 96,             /* Trap npc */
  85   WSTATE_REGNUM = 97,           /* Window State */
  86   CWP_REGNUM = 98,              /* Current Window Pointer */
  87   CANSAVE_REGNUM = 99,          /* Savable Windows */
  88   CANRESTORE_REGNUM = 100,      /* Restorable Windows */
  89   CLEANWIN_REGNUM = 101,        /* Clean Windows */
  90   OTHERWIN_REGNUM = 102,        /* Other Windows */
  91   ASR16_REGNUM = 103,           /* Ancillary State Registers */
  92   ASR17_REGNUM = 104,
  93   ASR18_REGNUM = 105,
  94   ASR19_REGNUM = 106,
  95   ASR20_REGNUM = 107,
  96   ASR21_REGNUM = 108,
  97   ASR22_REGNUM = 109,
  98   ASR23_REGNUM = 110,
  99   ASR24_REGNUM = 111,
 100   ASR25_REGNUM = 112,
 101   ASR26_REGNUM = 113,
 102   ASR27_REGNUM = 114,
 103   ASR28_REGNUM = 115,
 104   ASR29_REGNUM = 116,
 105   ASR30_REGNUM = 117,
 106   ASR31_REGNUM = 118,
 107   ICC_REGNUM   = 119,           /* 32 bit condition codes */
 108   XCC_REGNUM   = 120,           /* 64 bit condition codes */
 109   FCC0_REGNUM  = 121,           /* fp cc reg 0 */
 110   FCC1_REGNUM  = 122,           /* fp cc reg 1 */
 111   FCC2_REGNUM  = 123,           /* fp cc reg 2 */
 112   FCC3_REGNUM  = 124            /* fp cc reg 3 */
 113 };
 114
 115 /*
 116  * Make sparc target multi-archable: April 2000
 117  */
 118
 119 #if defined (GDB_MULTI_ARCH) && (GDB_MULTI_ARCH > 0)
 120
 121 /* Multi-arch definition of TARGET_IS_SPARC64, TARGET_ELF64 */
 122 #undef  GDB_TARGET_IS_SPARC64
 123 #define GDB_TARGET_IS_SPARC64 \
 124      (sparc_intreg_size () == 8)
 125 #undef  TARGET_ELF64
 126 #define TARGET_ELF64 \
 127      (sparc_intreg_size () == 8)
 128 extern int sparc_intreg_size (void);
 129 #else
 130
 131 /* Non-multi-arch: if it isn't defined, define it to zero.  */
 132 #ifndef GDB_TARGET_IS_SPARC64
 133 #define GDB_TARGET_IS_SPARC64 0
 134 #endif
 135 #ifndef TARGET_ELF64
 136 #define TARGET_ELF64 0
 137 #endif
 138 #endif
 139
 140 #if !defined (GDB_MULTI_ARCH) || (GDB_MULTI_ARCH == 0)
 141 /*
 142  * The following defines must go away for MULTI_ARCH
 143  */
 144
 145 /* Initializer for an array of names of registers.
 146    There should be NUM_REGS strings in this initializer.  */
 147
 148 #define REGISTER_NAMES  \
 149 { "g0", "g1", "g2", "g3", "g4", "g5", "g6", "g7",               \
 150   "o0", "o1", "o2", "o3", "o4", "o5", "sp", "o7",               \
 151   "l0", "l1", "l2", "l3", "l4", "l5", "l6", "l7",               \
 152   "i0", "i1", "i2", "i3", "i4", "i5", "fp", "i7",               \
 153                                                                 \
 154   "f0", "f1", "f2", "f3", "f4", "f5", "f6", "f7",               \
 155   "f8", "f9", "f10", "f11", "f12", "f13", "f14", "f15",         \
 156   "f16", "f17", "f18", "f19", "f20", "f21", "f22", "f23",       \
 157   "f24", "f25", "f26", "f27", "f28", "f29", "f30", "f31",       \
 158                                                                 \
 159   "y", "psr", "wim", "tbr", "pc", "npc", "fpsr", "cpsr"         \
 160 }
 161
 162 /* Offset from address of function to start of its code.
 163    Zero on most machines.  */
 164
 165 #define FUNCTION_START_OFFSET 0
 166
 167 /* Amount PC must be decremented by after a breakpoint.  This is often
 168    the number of bytes returned by BREAKPOINT_FROM_PC but not always.  */
 169
 170 #define DECR_PC_AFTER_BREAK 0
 171
 172 /* Say how long (ordinary) registers are.  This is a piece of bogosity
 173    used in push_word and a few other places; REGISTER_RAW_SIZE is the
 174    real way to know how big a register is.  */
 175
 176 #define DEPRECATED_REGISTER_SIZE 4
 177
 178 /* Number of machine registers */
 179
 180 #define NUM_REGS 72
 181
 182 #define SP_REGNUM 14            /* Contains address of top of stack, \
 183                                    which is also the bottom of the frame.  */
 184 #define DEPRECATED_FP_REGNUM 30         /* Contains address of executing stack frame */
 185
 186 #define FP0_REGNUM 32           /* Floating point register 0 */
 187
 188 #define Y_REGNUM 64             /* Temp register for multiplication, etc.  */
 189
 190 #define PC_REGNUM 68            /* Contains program counter */
 191
 192 #define NPC_REGNUM 69           /* Contains next PC */
 193
 194
 195 /* Total amount of space needed to store our copies of the machine's
 196    register state, the array `registers'.  On the sparc, `registers'
 197    contains the ins and locals, even though they are saved on the
 198    stack rather than with the other registers, and this causes hair
 199    and confusion in places like pop_frame.  It might be better to
 200    remove the ins and locals from `registers', make sure that
 201    frame_register() can get them from the stack (even in the innermost
 202    frame), and make this the way to access them.  For the frame
 203    pointer we would do that via DEPRECATED_TARGET_READ_FP.  On the
 204    other hand, that is likely to be confusing or worse for flat
 205    frames.  */
 206
 207 #define REGISTER_BYTES (32*4+32*4+8*4)
 208
 209 /* Index within `registers' of the first byte of the space for
 210    register N.  */
 211
 212 #define REGISTER_BYTE(N)  ((N)*4)
 213
 214 /* Number of bytes of storage in the actual machine representation for
 215    register N.  */
 216
 217 /* On the SPARC, all regs are 4 bytes (except Sparc64, where they're 8).  */
 218
 219 #define REGISTER_RAW_SIZE(N) (4)
 220
 221 /* Number of bytes of storage in the program's representation
 222    for register N.  */
 223
 224 /* On the SPARC, all regs are 4 bytes (except Sparc64, where they're 8).  */
 225
 226 #define REGISTER_VIRTUAL_SIZE(N) (4)
 227
 228 /* Largest value REGISTER_RAW_SIZE can have.  */
 229
 230 #define DEPRECATED_MAX_REGISTER_RAW_SIZE 8
 231
 232 /* Largest value REGISTER_VIRTUAL_SIZE can have.  */
 233
 234 #define DEPRECATED_MAX_REGISTER_VIRTUAL_SIZE 8
 235
 236 /* Return the GDB type object for the "standard" data type
 237    of data in register N.  */
 238
 239 #define REGISTER_VIRTUAL_TYPE(N) \
 240      ((N) < 32 ? builtin_type_int : (N) < 64 ? builtin_type_float : \
 241       builtin_type_int)
 242
 243 /* Sun /bin/cc gets this right as of SunOS 4.1.x.  We need to define
 244    BELIEVE_PCC_PROMOTION to get this right now that the code which
 245    detects gcc2_compiled. is broken.  This loses for SunOS 4.0.x and
 246    earlier.  */
 247
 248 #define BELIEVE_PCC_PROMOTION 1
 249
 250 /* Advance PC across any function entry prologue instructions
 251    to reach some "real" code.  */
 252
 253 extern CORE_ADDR sparc_skip_prologue (CORE_ADDR);
 254 #define SKIP_PROLOGUE(PC) sparc_skip_prologue (PC)
 255
 256 /* Immediately after a function call, return the saved pc.
 257    Can't go through the frames for this because on some machines
 258    the new frame is not set up until the new function executes
 259    some instructions.  */
 260
 261 #define DEPRECATED_SAVED_PC_AFTER_CALL(FRAME) PC_ADJUST (read_register (RP_REGNUM))
 262
 263 /* Stack grows downward.  */
 264
 265 #define INNER_THAN(LHS,RHS) ((LHS) < (RHS))
 266
 267 /* Write into appropriate registers a function return value of type
 268    TYPE, given in virtual format.  */
 269
 270 #define DEPRECATED_STORE_RETURN_VALUE(TYPE, VALBUF) \
 271      sparc_store_return_value (TYPE, VALBUF)
 272 extern void sparc_store_return_value (struct type *, char *);
 273
 274 /* Extract from an array REGBUF containing the (raw) register state
 275    the address in which a function should return its structure value,
 276    as a CORE_ADDR (or an expression that can be used as one).  */
 277
 278 #define DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS(REGBUF) \
 279      sparc_extract_struct_value_address (REGBUF)
 280
 281 extern CORE_ADDR sparc_extract_struct_value_address (char *);
 282
 283 /* Stack must be aligned on 64-bit boundaries when synthesizing
 284    function calls (128-bit for sparc64).  */
 285
 286 #define STACK_ALIGN(ADDR) sparc32_stack_align (ADDR)
 287 extern CORE_ADDR sparc32_stack_align (CORE_ADDR addr);
 288
 289 /* The Sparc returns long doubles on the stack.  */
 290
 291 #define RETURN_VALUE_ON_STACK(TYPE) \
 292   (TYPE_CODE(TYPE) == TYPE_CODE_FLT \
 293    && TYPE_LENGTH(TYPE) > 8)
 294
 295 /* When passing a structure to a function, Sun cc passes the address
 296    not the structure itself.  It (under SunOS4) creates two symbols,
 297    which we need to combine to a LOC_REGPARM.  Gcc version two (as of
 298    1.92) behaves like sun cc.  REG_STRUCT_HAS_ADDR is smart enough to
 299    distinguish between Sun cc, gcc version 1 and gcc version 2.  */
 300
 301 #define REG_STRUCT_HAS_ADDR(GCC_P, TYPE) \
 302      sparc_reg_struct_has_addr (GCC_P, TYPE)
 303 extern int sparc_reg_struct_has_addr (int, struct type *);
 304
 305 /* Is the prologue at PC frameless?  */
 306 #define PROLOGUE_FRAMELESS_P(PC) sparc_prologue_frameless_p (PC)
 307 extern int sparc_prologue_frameless_p (CORE_ADDR);
 308
 309 #endif /* GDB_MULTI_ARCH */
 310
 311 #if defined (GDB_MULTI_ARCH) && (GDB_MULTI_ARCH > 0)
 312 /*
 313  * The following defines should ONLY appear for MULTI_ARCH.
 314  */
 315
 316 /* Multi-arch the nPC and Y registers.  */
 317 #define Y_REGNUM              (sparc_y_regnum ())
 318 extern int sparc_npc_regnum (void);
 319 extern int sparc_y_regnum (void);
 320
 321 #endif /* GDB_MULTI_ARCH */
 322
 323 /* On the Sun 4 under SunOS, the compile will leave a fake insn which
 324    encodes the structure size being returned.  If we detect such
 325    a fake insn, step past it.  */
 326
 327 #define PC_ADJUST(PC) sparc_pc_adjust (PC)
 328 extern CORE_ADDR sparc_pc_adjust (CORE_ADDR);
 329
 330 /* If an argument is declared "register", Sun cc will keep it in a register,
 331    never saving it onto the stack.  So we better not believe the "p" symbol
 332    descriptor stab.  */
 333
 334 #define USE_REGISTER_NOT_ARG
 335
 336 /* For acc, there's no need to correct LBRAC entries by guessing how
 337    they should work.  In fact, this is harmful because the LBRAC
 338    entries now all appear at the end of the function, not intermixed
 339    with the SLINE entries.  n_opt_found detects acc for Solaris binaries;
 340    function_stab_type detects acc for SunOS4 binaries.
 341
 342    For binary from SunOS4 /bin/cc, need to correct LBRAC's.
 343
 344    For gcc, like acc, don't correct.  */
 345
 346 #define SUN_FIXED_LBRAC_BUG \
 347   (n_opt_found \
 348    || function_stab_type == N_STSYM \
 349    || function_stab_type == N_GSYM \
 350    || processing_gcc_compilation)
 351
 352 /* Do variables in the debug stabs occur after the N_LBRAC or before it?
 353    acc: after, gcc: before, SunOS4 /bin/cc: before.  */
 354
 355 #define VARIABLES_INSIDE_BLOCK(desc, gcc_p) \
 356   (!(gcc_p) \
 357    && (n_opt_found \
 358        || function_stab_type == N_STSYM \
 359        || function_stab_type == N_GSYM))
 360
 361 /* Sequence of bytes for breakpoint instruction (ta 1). */
 362
 363 extern const unsigned char *sparc_breakpoint_from_pc (CORE_ADDR *pc, int *len);
 364 #define BREAKPOINT_FROM_PC(PC,LEN) sparc_breakpoint_from_pc ((PC), (LEN))
 365
 366 /* Register numbers of various important registers.
 367    Note that some of these values are "real" register numbers,
 368    and correspond to the general registers of the machine,
 369    and some are "phony" register numbers which are too large
 370    to be actual register numbers as far as the user is concerned
 371    but do serve to get the desired values when passed to read_register.  */
 372
 373 #define G0_REGNUM 0             /* %g0 */
 374 #define G1_REGNUM 1             /* %g1 */
 375 #define O0_REGNUM 8             /* %o0 */
 376 #define RP_REGNUM 15            /* Contains return address value, *before* \
 377                                    any windows get switched.  */
 378 #define O7_REGNUM 15            /* Last local reg not saved on stack frame */
 379 #define L0_REGNUM 16            /* First local reg that's saved on stack frame
 380                                    rather than in machine registers */
 381 #define I0_REGNUM 24            /* %i0 */
 382 #define I7_REGNUM 31            /* Last local reg saved on stack frame */
 383 #define PS_REGNUM 65            /* Contains processor status */
 384 #define PS_FLAG_CARRY 0x100000  /* Carry bit in PS */
 385 #define WIM_REGNUM 66           /* Window Invalid Mask (not really supported) */
 386 #define TBR_REGNUM 67           /* Trap Base Register (not really supported) */
 387 #define FPS_REGNUM 70           /* Floating point status register */
 388 #define CPS_REGNUM 71           /* Coprocessor status register */
 389
 390 /* Writing to %g0 is a noop (not an error or exception or anything like
 391    that, however).  */
 392
 393 #define CANNOT_STORE_REGISTER(regno) ((regno) == G0_REGNUM)
 394
 395 /*
 396  * DEPRECATED_FRAME_CHAIN and FRAME_INFO definitions, collected here
 397  * for convenience.  */
 398
 399 #if !defined (GDB_MULTI_ARCH) || (GDB_MULTI_ARCH == 0)
 400 /*
 401  * The following defines must go away for MULTI_ARCH.
 402  */
 403
 404 /* Describe the pointer in each stack frame to the previous stack frame
 405    (its caller).  */
 406
 407 /* DEPRECATED_FRAME_CHAIN takes a frame's nominal address and produces
 408    the frame's chain-pointer. */
 409
 410 /* We need to override DEPRECATED_GET_SAVED_REGISTER so that we can
 411    deal with the way outs change into ins in different frames.  */
 412
 413 void sparc_get_saved_register (char *raw_buffer,
 414                                int *optimized,
 415                                CORE_ADDR * addrp,
 416                                struct frame_info *frame,
 417                                int regnum, enum lval_type *lvalp);
 418
 419 #define DEPRECATED_GET_SAVED_REGISTER(RAW_BUFFER, OPTIMIZED, ADDRP, FRAME, REGNUM, LVAL) \
 420      sparc_get_saved_register (RAW_BUFFER, OPTIMIZED, ADDRP, \
 421                                FRAME, REGNUM, LVAL)
 422
 423 #define DEPRECATED_FRAME_INIT_SAVED_REGS(FP)    /*no-op */
 424
 425 #define DEPRECATED_INIT_EXTRA_FRAME_INFO(FROMLEAF, FCI) \
 426      sparc_init_extra_frame_info (FROMLEAF, FCI)
 427 extern void sparc_init_extra_frame_info (int, struct frame_info *);
 428
 429 #define DEPRECATED_FRAME_CHAIN(THISFRAME) (sparc_frame_chain (THISFRAME))
 430 extern CORE_ADDR sparc_frame_chain (struct frame_info *);
 431
 432 /* A macro that tells us whether the function invocation represented
 433    by FI does not have a frame on the stack associated with it.  If it
 434    does not, FRAMELESS is set to 1, else 0.  */
 435
 436 #define FRAMELESS_FUNCTION_INVOCATION(FI) \
 437      frameless_look_for_prologue (FI)
 438
 439 /* Where is the PC for a specific frame */
 440
 441 #define DEPRECATED_FRAME_SAVED_PC(FRAME) sparc_frame_saved_pc (FRAME)
 442 extern CORE_ADDR sparc_frame_saved_pc (struct frame_info *);
 443
 444 /* If the argument is on the stack, it will be here.  */
 445 #define FRAME_ARGS_ADDRESS(FI) (get_frame_base (FI))
 446
 447 #define FRAME_LOCALS_ADDRESS(FI) (get_frame_base (FI))
 448
 449 /* Set VAL to the number of args passed to frame described by FI.
 450    Can set VAL to -1, meaning no way to tell.  */
 451
 452 /* We can't tell how many args there are
 453    now that the C compiler delays popping them.  */
 454 #define FRAME_NUM_ARGS(FI) (-1)
 455
 456 /* Return number of bytes at start of arglist that are not really args.  */
 457
 458 #define FRAME_ARGS_SKIP 68
 459
 460 #endif /* GDB_MULTI_ARCH */
 461
 462 #define PRINT_EXTRA_FRAME_INFO(FI) \
 463      sparc_print_extra_frame_info (FI)
 464 extern void sparc_print_extra_frame_info (struct frame_info *);
 465
 466 /* DEPRECATED_INIT_EXTRA_FRAME_INFO needs the PC to detect flat
 467    frames.  */
 468
 469 /* NOTE: cagney/2002-12-08: Add local declaration of
 470    init_frame_pc_noop() because it isn't possible to include
 471    "arch-utils.h" here.  */
 472 extern CORE_ADDR init_frame_pc_noop (int fromleaf, struct frame_info *prev);
 473 #define DEPRECATED_INIT_FRAME_PC(FROMLEAF, PREV)        (init_frame_pc_noop (FROMLEAF, PREV))
 474 #define DEPRECATED_INIT_FRAME_PC_FIRST(FROMLEAF, PREV) \
 475   ((FROMLEAF) ? DEPRECATED_SAVED_PC_AFTER_CALL ((PREV)->next) : \
 476               (PREV)->next ? DEPRECATED_FRAME_SAVED_PC ((PREV)->next) : read_pc ())
 477
 478 /* Define other aspects of the stack frame.  */
 479
 480 /* The location of I0 w.r.t SP.  This is actually dependent on how the
 481    system's window overflow/underflow routines are written.  Most
 482    vendors save the L regs followed by the I regs (at the higher
 483    address).  Some vendors get it wrong.  */
 484
 485 #define FRAME_SAVED_L0  0
 486 #define FRAME_SAVED_I0  (8 * REGISTER_RAW_SIZE (L0_REGNUM))
 487
 488 #define FRAME_STRUCT_ARGS_ADDRESS(FI) (get_frame_base (FI))
 489
 490 /* Things needed for making the inferior call functions.  */
 491 /*
 492  * First of all, let me give my opinion of what the DUMMY_FRAME
 493  * actually looks like.
 494  *
 495  *               |                                 |
 496  *               |                                 |
 497  *               + - - - - - - - - - - - - - - - - +<-- fp (level 0)
 498  *               |                                 |
 499  *               |                                 |
 500  *               |                                 |
 501  *               |                                 |
 502  *               |  Frame of innermost program     |
 503  *               |           function              |
 504  *               |                                 |
 505  *               |                                 |
 506  *               |                                 |
 507  *               |                                 |
 508  *               |                                 |
 509  *               |---------------------------------|<-- sp (level 0), fp (c)
 510  *               |                                 |
 511  *     DUMMY     |             fp0-31              |
 512  *               |                                 |
 513  *               |             ------              |<-- fp - 0x80
 514  *     FRAME     |              g0-7               |<-- fp - 0xa0
 515  *               |              i0-7               |<-- fp - 0xc0
 516  *               |             other               |<-- fp - 0xe0
 517  *               |               ?                 |
 518  *               |               ?                 |
 519  *               |---------------------------------|<-- sp' = fp - 0x140
 520  *               |                                 |
 521  * xcution start |                                 |
 522  * sp' + 0x94 -->|        CALL_DUMMY (x code)      |
 523  *               |                                 |
 524  *               |                                 |
 525  *               |---------------------------------|<-- sp'' = fp - 0x200
 526  *               |  align sp to 8 byte boundary    |
 527  *               |     ==> args to fn <==          |
 528  *  Room for     |                                 |
 529  * i & l's + agg | CALL_DUMMY_STACK_ADJUST = 0x0x44|
 530  *               |---------------------------------|<-- final sp (variable)
 531  *               |                                 |
 532  *               |   Where function called will    |
 533  *               |           build frame.          |
 534  *               |                                 |
 535  *               |                                 |
 536  *
 537  *   I understand everything in this picture except what the space
 538  * between fp - 0xe0 and fp - 0x140 is used for.  Oh, and I don't
 539  * understand why there's a large chunk of CALL_DUMMY that never gets
 540  * executed (its function is superceeded by
 541  * DEPRECATED_PUSH_DUMMY_FRAME; they are designed to do the same
 542  * thing).
 543  *
 544  *   DEPRECATED_PUSH_DUMMY_FRAME saves the registers above sp' and
 545  * pushes the * register file stack down one.
 546  *
 547  *   call_function then writes CALL_DUMMY, pushes the args onto the
 548  * stack, and adjusts the stack pointer.
 549
 550    call_function_by_hand then starts execution (in the middle of
 551    CALL_DUMMY, as directed by call_function).  */
 552
 553 #ifndef CALL_DUMMY
 554 /* This sequence of words is the instructions
 555
 556    00:   bc 10 00 01     mov  %g1, %fp
 557    04:   9d e3 80 00     save  %sp, %g0, %sp
 558    08:   bc 10 00 02     mov  %g2, %fp
 559    0c:   be 10 00 03     mov  %g3, %i7
 560    10:   da 03 a0 58     ld  [ %sp + 0x58 ], %o5
 561    14:   d8 03 a0 54     ld  [ %sp + 0x54 ], %o4
 562    18:   d6 03 a0 50     ld  [ %sp + 0x50 ], %o3
 563    1c:   d4 03 a0 4c     ld  [ %sp + 0x4c ], %o2
 564    20:   d2 03 a0 48     ld  [ %sp + 0x48 ], %o1
 565    24:   40 00 00 00     call  <fun>
 566    28:   d0 03 a0 44     ld  [ %sp + 0x44 ], %o0
 567    2c:   01 00 00 00     nop
 568    30:   91 d0 20 01     ta  1
 569    34:   01 00 00 00     nop
 570
 571    NOTES:
 572    * the first four instructions are necessary only on the simulator.
 573    * this is a multiple of 8 (not only 4) bytes.
 574    * the `call' insn is a relative, not an absolute call.
 575    * the `nop' at the end is needed to keep the trap from
 576      clobbering things (if NPC pointed to garbage instead).
 577  */
 578
 579 #if !defined (GDB_MULTI_ARCH) || (GDB_MULTI_ARCH == 0)
 580 /*
 581  * The following defines must go away for MULTI_ARCH.
 582  */
 583
 584 #define CALL_DUMMY { 0xbc100001, 0x9de38000, 0xbc100002, 0xbe100003,    \
 585                      0xda03a058, 0xd803a054, 0xd603a050, 0xd403a04c,    \
 586                      0xd203a048, 0x40000000, 0xd003a044, 0x01000000,    \
 587                      0x91d02001, 0x01000000 }
 588
 589
 590 /* Size of the call dummy in bytes. */
 591
 592 #define DEPRECATED_CALL_DUMMY_LENGTH 0x38
 593
 594 /* Offset within call dummy of first instruction to execute. */
 595
 596 #define DEPRECATED_CALL_DUMMY_START_OFFSET 0
 597
 598 /* Offset within CALL_DUMMY of the 'call' instruction. */
 599
 600 #define CALL_DUMMY_CALL_OFFSET (DEPRECATED_CALL_DUMMY_START_OFFSET + 0x24)
 601
 602 /* Offset within CALL_DUMMY of the 'ta 1' trap instruction. */
 603
 604 #define DEPRECATED_CALL_DUMMY_BREAKPOINT_OFFSET (DEPRECATED_CALL_DUMMY_START_OFFSET + 0x30)
 605
 606 #define DEPRECATED_CALL_DUMMY_STACK_ADJUST 68
 607
 608 /* Call dummy method (eg. on stack, at entry point, etc.) */
 609
 610 #define CALL_DUMMY_LOCATION ON_STACK
 611
 612 /* Method for detecting dummy frames.  */
 613
 614 #define DEPRECATED_PC_IN_CALL_DUMMY(PC, SP, FRAME_ADDRESS) \
 615      deprecated_pc_in_call_dummy_on_stack (PC, SP, FRAME_ADDRESS)
 616
 617 #endif /* GDB_MULTI_ARCH */
 618
 619 #endif /* CALL_DUMMY */
 620
 621 #if !defined (GDB_MULTI_ARCH) || (GDB_MULTI_ARCH == 0)
 622 /*
 623  * The following defines must go away for MULTI_ARCH.
 624  */
 625
 626 /* Insert the specified number of args and function address
 627    into a call sequence of the above form stored at DUMMYNAME.  */
 628
 629 #define DEPRECATED_FIX_CALL_DUMMY(DUMMYNAME, PC, FUN, NARGS, ARGS, TYPE, GCC_P) \
 630      sparc_fix_call_dummy (DUMMYNAME, PC, FUN, TYPE, GCC_P)
 631 void sparc_fix_call_dummy (char *dummy, CORE_ADDR pc, CORE_ADDR fun,
 632                            struct type *value_type, int using_gcc);
 633
 634 /* Arguments smaller than an int must be promoted to ints when
 635    synthesizing function calls.  */
 636
 637 /* Push an empty stack frame, to record the current PC, etc.  */
 638
 639 #define DEPRECATED_PUSH_DUMMY_FRAME     sparc_push_dummy_frame ()
 640 #define DEPRECATED_POP_FRAME            sparc_pop_frame ()
 641
 642 void sparc_push_dummy_frame (void);
 643 void sparc_pop_frame (void);
 644
 645 #define DEPRECATED_PUSH_ARGUMENTS(NARGS, ARGS, SP, STRUCT_RETURN, STRUCT_ADDR) \
 646      sparc32_push_arguments (NARGS, ARGS, SP, STRUCT_RETURN, STRUCT_ADDR)
 647
 648 extern CORE_ADDR sparc32_push_arguments (int, struct value **, CORE_ADDR, int,
 649                                          CORE_ADDR);
 650
 651 /* Store the address of the place in which to copy the structure the
 652    subroutine will return.  This is called from call_function_by_hand.
 653    The ultimate mystery is, tho, what is the value "16"?  */
 654
 655 #define STORE_STRUCT_RETURN(ADDR, SP) \
 656   { char val[4]; \
 657     store_unsigned_integer (val, 4, (ADDR)); \
 658     write_memory ((SP)+(16*4), val, 4); }
 659
 660 /* Default definition of USE_STRUCT_CONVENTION.  */
 661
 662 #ifndef USE_STRUCT_CONVENTION
 663 #define USE_STRUCT_CONVENTION(GCC_P, TYPE) \
 664      generic_use_struct_convention (GCC_P, TYPE)
 665 #endif
 666
 667 /* Extract from an array REGBUF containing the (raw) register state a
 668    function return value of type TYPE, and copy that, in virtual
 669    format, into VALBUF.  */
 670
 671 #define DEPRECATED_EXTRACT_RETURN_VALUE(TYPE, REGBUF, VALBUF) \
 672      sparc32_extract_return_value (TYPE, REGBUF, VALBUF)
 673 extern void sparc32_extract_return_value (struct type *, char[], char *);
 674
 675 #endif /* GDB_MULTI_ARCH */
 676
 677 \f
 678 /* Sparc has no reliable single step ptrace call */
 679
 680 #define SOFTWARE_SINGLE_STEP_P() 1
 681 extern void sparc_software_single_step (enum target_signal, int);
 682 #define SOFTWARE_SINGLE_STEP(sig,bp_p) sparc_software_single_step (sig,bp_p)
 683
 684 /* We need more arguments in a frame specification for the
 685    "frame" or "info frame" command.  */
 686
 687 #define SETUP_ARBITRARY_FRAME(argc, argv) setup_arbitrary_frame (argc, argv)
 688 extern struct frame_info *setup_arbitrary_frame (int, CORE_ADDR *);
 689
 690 extern void sparc_do_registers_info (int regnum, int all);
 691 #undef DEPRECATED_DO_REGISTERS_INFO
 692 #define DEPRECATED_DO_REGISTERS_INFO(REGNUM,ALL) sparc_do_registers_info (REGNUM, ALL)
 693
 694 /* Optimization for storing registers to the inferior.  The hook
 695    DO_DEFERRED_STORES
 696    actually executes any deferred stores.  It is called any time
 697    we are going to proceed the child, or read its registers.
 698    The hook CLEAR_DEFERRED_STORES is called when we want to throw
 699    away the inferior process, e.g. when it dies or we kill it.
 700    FIXME, this does not handle remote debugging cleanly.  */
 701
 702 extern int deferred_stores;
 703 #define DO_DEFERRED_STORES      \
 704   if (deferred_stores)          \
 705     target_store_registers (-2);
 706 #define CLEAR_DEFERRED_STORES   \
 707   deferred_stores = 0;
 708
 709 /* Select the sparc disassembler */
 710
 711 #define TM_PRINT_INSN_MACH bfd_mach_sparc
 712
 713 #define DEPRECATED_EXTRA_STACK_ALIGNMENT_NEEDED 1