gdb/tm-mips.h

   1 /* Definitions to make GDB run on a mips box under 4.3bsd.
   2    Copyright (C) 1986, 1987, 1989 Free Software Foundation, Inc.
   3    Contributed by Per Bothner(bothner@cs.wisc.edu) at U.Wisconsin
   4    and by Alessandro Forin(af@cs.cmu.edu) at CMU
   5
   6 This file is part of GDB.
   7
   8 GDB 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 1, or (at your option)
  11 any later version.
  12
  13 GDB 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 GDB; see the file COPYING.  If not, write to
  20 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
  21
  22 #if !defined (TARGET_BYTE_ORDER)
  23 #define TARGET_BYTE_ORDER LITTLE_ENDIAN
  24 #endif
  25
  26 /* Floating point is IEEE compliant */
  27 #define IEEE_FLOAT
  28
  29 /* Define this if the C compiler puts an underscore at the front
  30    of external names before giving them to the linker.  */
  31
  32 /*#define NAMES_HAVE_UNDERSCORE*/
  33
  34 /* Debugger information will be in mips' format */
  35
  36 #define READ_MIPS_FORMAT
  37
  38 /* File format is coff, but with additions */
  39
  40 #define COFF_FORMAT
  41
  42 /* Offset from address of function to start of its code.
  43    Zero on most machines.  */
  44
  45 #define FUNCTION_START_OFFSET 0
  46
  47 /* Advance PC across any function entry prologue instructions
  48    to reach some "real" code.  */
  49
  50 #define SKIP_PROLOGUE(pc)       pc = mips_skip_prologue(pc)
  51
  52 /* Immediately after a function call, return the saved pc.
  53    Can't always go through the frames for this because on some machines
  54    the new frame is not set up until the new function executes
  55    some instructions.  */
  56
  57 #define SAVED_PC_AFTER_CALL(frame)      read_register(RA_REGNUM)
  58
  59 /* Are we currently handling a signal */
  60
  61 #define IN_SIGTRAMP(pc, name)   in_sigtramp(pc, name)
  62
  63 /* Address of end of stack space.  */
  64
  65 #define STACK_END_ADDR (0x7ffff000)
  66
  67 /* Stack grows downward.  */
  68
  69 #define INNER_THAN <
  70
  71 #define BIG_ENDIAN 4321
  72 #if TARGET_BYTE_ORDER == BIG_ENDIAN
  73 #define BREAKPOINT {0, 0x5, 0, 0xd}
  74 #else
  75 #define BREAKPOINT {0xd, 0, 0x5, 0}
  76 #endif
  77
  78 /* Amount PC must be decremented by after a breakpoint.
  79    This is often the number of bytes in BREAKPOINT
  80    but not always.  */
  81
  82 #define DECR_PC_AFTER_BREAK 0
  83
  84 /* Nonzero if instruction at PC is a return instruction. "j ra" on mips. */
  85
  86 #define ABOUT_TO_RETURN(pc) (read_memory_integer (pc, 4) == 0x3e00008)
  87
  88 /* Return 1 if P points to an invalid floating point value. */
  89
  90 #define INVALID_FLOAT(p,l)      isa_NAN(p,l)
  91
  92 /* Say how long (all) registers are.  */
  93
  94 #define REGISTER_TYPE long
  95
  96 /* Number of machine registers */
  97
  98 #define NUM_REGS 73
  99
 100 /* Initializer for an array of names of registers.
 101    There should be NUM_REGS strings in this initializer.  */
 102
 103 #define REGISTER_NAMES  \
 104     {   "zero", "at",   "v0",   "v1",   "a0",   "a1",   "a2",   "a3", \
 105         "t0",   "t1",   "t2",   "t3",   "t4",   "t5",   "t6",   "t7", \
 106         "s0",   "s1",   "s2",   "s3",   "s4",   "s5",   "s6",   "s7", \
 107         "t8",   "t9",   "k0",   "k1",   "gp",   "sp",   "s8",   "ra", \
 108         "sr",   "lo",   "hi",   "bad",  "cause","pc",    \
 109         "f0",   "f1",   "f2",   "f3",   "f4",   "f5",   "f6",   "f7", \
 110         "f8",   "f9",   "f10",   "f11",   "f12",   "f13",   "f14",   "f15", \
 111         "f16",   "f17",   "f18",   "f19",   "f20",   "f21",   "f22",   "f23",\
 112         "f24",   "f25",   "f26",   "f27",   "f28",   "f29",   "f30",   "f31",\
 113         "fsr",   "fir", "fp" \
 114     }
 115
 116 /* Register numbers of various important registers.
 117    Note that some of these values are "real" register numbers,
 118    and correspond to the general registers of the machine,
 119    and some are "phony" register numbers which are too large
 120    to be actual register numbers as far as the user is concerned
 121    but do serve to get the desired values when passed to read_register.  */
 122
 123 #define SP_REGNUM 29            /* Contains address of top of stack */
 124 #define PC_REGNUM 37            /* Contains program counter */
 125 #define RA_REGNUM 31            /* Contains return address value */
 126 #define PS_REGNUM 32            /* Contains processor status */
 127 #define HI_REGNUM 34            /* Multiple/divide temp */
 128 #define LO_REGNUM 33            /* ... */
 129 #define FP0_REGNUM 38           /* Floating point register 0 (single float) */
 130 #define FCRCS_REGNUM 70         /* FP control/status */
 131 #define FCRIR_REGNUM 71         /* FP implementation/revision */
 132 #define FP_REGNUM 72            /* Pseudo register that contains true address of executing stack frame */
 133
 134 /* Define DO_REGISTERS_INFO() to do machine-specific formatting
 135    of register dumps. */
 136
 137 #define DO_REGISTERS_INFO(_regnum) mips_do_registers_info(_regnum)
 138
 139 #define REGISTER_U_ADDR(addr, blockend, regno)          \
 140    if (blockend == 0) {                                 \
 141         if (regno < 38) addr = (NBPG*UPAGES) + (regno - 38)*sizeof(int);\
 142         else addr = 0; /* ..somewhere in the pcb */     \
 143    } else if (regno < 32) addr = regno;                 \
 144    else if (regno == PC_REGNUM) addr = 96;              \
 145    else if (regno == 36) addr = 97;                     \
 146    else if (regno == HI_REGNUM) addr = 98;              \
 147    else if (regno == LO_REGNUM) addr = 99;              \
 148    else if (regno == FCRCS_REGNUM) addr = 100;          \
 149    else if (regno == FCRIR_REGNUM) addr = 101;          \
 150    else if (regno >= FP0_REGNUM) addr = regno - (FP0_REGNUM-32);\
 151    else addr = 0;
 152
 153 /* Total amount of space needed to store our copies of the machine's
 154    register state, the array `registers'.  */
 155 #define REGISTER_BYTES (NUM_REGS*4)
 156
 157 /* Index within `registers' of the first byte of the space for
 158    register N.  */
 159
 160 #define REGISTER_BYTE(N) ((N) * 4)
 161
 162 /* Number of bytes of storage in the actual machine representation
 163    for register N.  On mips, all regs are 4 bytes.  */
 164
 165 #define REGISTER_RAW_SIZE(N) 4
 166
 167 /* Number of bytes of storage in the program's representation
 168    for register N.  On mips, all regs are 4 bytes.  */
 169
 170 #define REGISTER_VIRTUAL_SIZE(N) 4
 171
 172 /* Largest value REGISTER_RAW_SIZE can have.  */
 173
 174 #define MAX_REGISTER_RAW_SIZE 4
 175
 176 /* Largest value REGISTER_VIRTUAL_SIZE can have.  */
 177
 178 #define MAX_REGISTER_VIRTUAL_SIZE 4
 179
 180 /* Nonzero if register N requires conversion
 181    from raw format to virtual format.  */
 182
 183 #define REGISTER_CONVERTIBLE(N) 0
 184
 185 /* Convert data from raw format for register REGNUM
 186    to virtual format for register REGNUM.  */
 187
 188 #define REGISTER_CONVERT_TO_VIRTUAL(REGNUM,FROM,TO)     \
 189   bcopy ((FROM), (TO), 4);
 190
 191 /* Convert data from virtual format for register REGNUM
 192    to raw format for register REGNUM.  */
 193
 194 #define REGISTER_CONVERT_TO_RAW(REGNUM,FROM,TO) \
 195   bcopy ((FROM), (TO), 4);
 196
 197 /* Return the GDB type object for the "standard" data type
 198    of data in register N.  */
 199
 200 #define REGISTER_VIRTUAL_TYPE(N) builtin_type_int
 201 /* Store the address of the place in which to copy the structure the
 202    subroutine will return.  This is called from call_function. */
 203
 204 #define STORE_STRUCT_RETURN(addr, sp) \
 205   { sp = push_word(sp, addr);}
 206
 207 /* Extract from an array REGBUF containing the (raw) register state
 208    a function return value of type TYPE, and copy that, in virtual format,
 209    into VALBUF.  XXX floats */
 210
 211 #define EXTRACT_RETURN_VALUE(TYPE,REGBUF,VALBUF) \
 212   bcopy (REGBUF+REGISTER_BYTE (TYPE_CODE (TYPE) == TYPE_CODE_FLT ? FP0_REGNUM : 2), VALBUF, TYPE_LENGTH (TYPE))
 213
 214 /* Write into appropriate registers a function return value
 215    of type TYPE, given in virtual format.  */
 216
 217 #define STORE_RETURN_VALUE(TYPE,VALBUF) \
 218   write_register_bytes (REGISTER_BYTE (TYPE_CODE (TYPE) == TYPE_CODE_FLT ? FP0_REGNUM : 2), VALBUF, TYPE_LENGTH (TYPE))
 219
 220 /* Extract from an array REGBUF containing the (raw) register state
 221    the address in which a function should return its structure value,
 222    as a CORE_ADDR (or an expression that can be used as one).  */
 223
 224 #define EXTRACT_STRUCT_VALUE_ADDRESS(REGBUF) (*(int *)(REGBUF+16))
 225
 226 /* Structures are returned by ref in extra arg0 */
 227 #define USE_STRUCT_CONVENTION(gcc_p, type)      1
 228
 229 \f
 230 /* Describe the pointer in each stack frame to the previous stack frame
 231    (its caller).  */
 232
 233 /* FRAME_CHAIN takes a frame's nominal address
 234    and produces the frame's chain-pointer.
 235
 236    FRAME_CHAIN_COMBINE takes the chain pointer and the frame's nominal address
 237    and produces the nominal address of the caller frame.
 238
 239    However, if FRAME_CHAIN_VALID returns zero,
 240    it means the given frame is the outermost one and has no caller.
 241    In that case, FRAME_CHAIN_COMBINE is not used.  */
 242
 243 #define FRAME_CHAIN(thisframe) (FRAME_ADDR)mips_frame_chain(thisframe)
 244
 245 #define FRAME_CHAIN_VALID(chain, thisframe) \
 246   (chain != 0 && (outside_startup_file (FRAME_SAVED_PC (thisframe))))
 247
 248 #define FRAME_CHAIN_COMBINE(chain, thisframe) (chain)
 249
 250 /* Define other aspects of the stack frame.  */
 251
 252
 253 /* A macro that tells us whether the function invocation represented
 254    by FI does not have a frame on the stack associated with it.  If it
 255    does not, FRAMELESS is set to 1, else 0.  */
 256 /* We handle this differently for mips, and maybe we should not */
 257
 258 #define FRAMELESS_FUNCTION_INVOCATION(FI, FRAMELESS)  {(FRAMELESS) = 0;}
 259
 260 /* Saved Pc.  */
 261
 262 #define FRAME_SAVED_PC(FRAME)   (mips_frame_saved_pc(FRAME))
 263
 264 #define FRAME_ARGS_ADDRESS(fi)  (fi)->frame
 265
 266 #define FRAME_LOCALS_ADDRESS(fi) (fi)->frame
 267
 268 /* Return number of args passed to a frame.
 269    Can return -1, meaning no way to tell.  */
 270
 271 #define FRAME_NUM_ARGS(num, fi) (num = mips_frame_num_args(fi))
 272
 273 /* Return number of bytes at start of arglist that are not really args.  */
 274
 275 #define FRAME_ARGS_SKIP 0
 276
 277 /* Put here the code to store, into a struct frame_saved_regs,
 278    the addresses of the saved registers of frame described by FRAME_INFO.
 279    This includes special registers such as pc and fp saved in special
 280    ways in the stack frame.  sp is even more special:
 281    the address we return for it IS the sp for the next frame.  */
 282
 283 #define FRAME_FIND_SAVED_REGS(frame_info, frame_saved_regs) ( \
 284   (frame_saved_regs) = *(frame_info)->saved_regs, \
 285   (frame_saved_regs).regs[SP_REGNUM] = (frame_info)->frame)
 286
 287 \f
 288 /* Things needed for making the inferior call functions.  */
 289
 290 /* Stack has strict alignment. However, use PUSH_ARGUMENTS
 291    to take care of it. */
 292 /*#define STACK_ALIGN(addr)     (((addr)+3)&~3)*/
 293
 294 #define PUSH_ARGUMENTS(nargs, args, sp, struct_return, struct_addr) \
 295     sp = mips_push_arguments(nargs, args, sp, struct_return, struct_addr)
 296
 297 /* Push an empty stack frame, to record the current PC, etc.  */
 298
 299 #define PUSH_DUMMY_FRAME        mips_push_dummy_frame()
 300
 301 /* Discard from the stack the innermost frame, restoring all registers.  */
 302
 303 #define POP_FRAME               mips_pop_frame()
 304
 305 #define MK_OP(op,rs,rt,offset) (((op)<<26)|((rs)<<21)|((rt)<<16)|(offset))
 306 #define CALL_DUMMY_SIZE (16*4)
 307 #define Dest_Reg 2
 308 #define CALL_DUMMY {\
 309  MK_OP(0,RA_REGNUM,0,8),        /* jr $ra # Fake ABOUT_TO_RETURN ...*/\
 310  0,                             /* nop    #  ... to stop raw backtrace*/\
 311  0x27bd0000,                    /* addu sp,?0 # Pseudo prologue */\
 312 /* Start here: */\
 313  MK_OP(061,SP_REGNUM,12,0),     /* lwc1 $f12,0(sp) # Reload first 4 args*/\
 314  MK_OP(061,SP_REGNUM,13,4),     /* lwc1 $f13,4(sp) */\
 315  MK_OP(061,SP_REGNUM,14,8),     /* lwc1 $f14,8(sp) */\
 316  MK_OP(061,SP_REGNUM,15,12),    /* lwc1 $f15,12(sp) */\
 317  MK_OP(043,SP_REGNUM,4,0),      /* lw $r4,0(sp) # Re-load FP regs*/\
 318  MK_OP(043,SP_REGNUM,5,4),      /* lw $r5,4(sp) */\
 319  MK_OP(043,SP_REGNUM,6,8),      /* lw $r6,8(sp) */\
 320  MK_OP(043,SP_REGNUM,7,12),     /* lw $r7,12(sp) */\
 321  (017<<26)| (Dest_Reg << 16),   /* lui $r31,<target upper 16 bits>*/\
 322  MK_OP(13,Dest_Reg,Dest_Reg,0), /* ori $r31,$r31,<lower 16 bits>*/ \
 323  (Dest_Reg<<21) | (31<<11) | 9, /* jalr $r31 */\
 324  MK_OP(043,SP_REGNUM,7,12),     /* lw $r7,12(sp) */\
 325  0x5000d,                       /* bpt */\
 326 }
 327
 328 #define CALL_DUMMY_START_OFFSET 12
 329
 330 /* Insert the specified number of args and function address
 331    into a call sequence of the above form stored at DUMMYNAME.  */
 332
 333 #define FIX_CALL_DUMMY(dummyname, start_sp, fun, nargs, args, rettype, gcc_p)\
 334   (((int*)dummyname)[11] |= (((unsigned long)(fun)) >> 16), \
 335    ((int*)dummyname)[12] |= (unsigned short)(fun))
 336
 337 /* Specific information about a procedure.
 338    This overlays the MIPS's PDR records,
 339    mipsread.c (ab)uses this to save memory */
 340
 341 typedef struct mips_extra_func_info {
 342         unsigned long   adr;    /* memory address of start of procedure */
 343         long    isym;           /* pointer to procedure symbol */
 344         long    pad2;           /* iline: start of line number entries*/
 345         long    regmask;        /* save register mask */
 346         long    regoffset;      /* save register offset */
 347         long    numargs;        /* number of args to procedure (was iopt) */
 348         long    fregmask;       /* save floating point register mask */
 349         long    fregoffset;     /* save floating point register offset */
 350         long    framesize;      /* frameoffset: frame size */
 351         short   framereg;       /* frame pointer register */
 352         short   pcreg;          /* offset or reg of return pc */
 353         long    lnLow;          /* lowest line in the procedure */
 354         long    lnHigh;         /* highest line in the procedure */
 355         long    pad3;           /* cbLineOffset: byte offset for this procedure from the fd base */
 356 } *mips_extra_func_info_t;
 357
 358 #define EXTRA_FRAME_INFO \
 359   char *proc_desc; /* actually, a mips_extra_func_info_t */\
 360   int num_args;\
 361   struct frame_saved_regs *saved_regs;
 362
 363 #define INIT_EXTRA_FRAME_INFO(fci) init_extra_frame_info(fci)