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([email protected]) at U.Wisconsin
   4    and by Alessandro Forin([email protected]) at CMU
   5
   6 This file is part of GDB.
   7
   8 This program is free software; you can redistribute it and/or modify
   9 it under the terms of the GNU General Public License as published by
  10 the Free Software Foundation; either version 2 of the License, or
  11 (at your option) any later version.
  12
  13 This program is distributed in the hope that it will be useful,
  14 but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 GNU General Public License for more details.
  17
  18 You should have received a copy of the GNU General Public License
  19 along with this program; if not, write to the Free Software
  20 Foundation, Inc., 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, fp) mips_do_registers_info(_regnum, fp)
 138
 139 /* Total amount of space needed to store our copies of the machine's
 140    register state, the array `registers'.  */
 141 #define REGISTER_BYTES (NUM_REGS*4)
 142
 143 /* Index within `registers' of the first byte of the space for
 144    register N.  */
 145
 146 #define REGISTER_BYTE(N) ((N) * 4)
 147
 148 /* Number of bytes of storage in the actual machine representation
 149    for register N.  On mips, all regs are 4 bytes.  */
 150
 151 #define REGISTER_RAW_SIZE(N) 4
 152
 153 /* Number of bytes of storage in the program's representation
 154    for register N.  On mips, all regs are 4 bytes.  */
 155
 156 #define REGISTER_VIRTUAL_SIZE(N) 4
 157
 158 /* Largest value REGISTER_RAW_SIZE can have.  */
 159
 160 #define MAX_REGISTER_RAW_SIZE 4
 161
 162 /* Largest value REGISTER_VIRTUAL_SIZE can have.  */
 163
 164 #define MAX_REGISTER_VIRTUAL_SIZE 4
 165
 166 /* Nonzero if register N requires conversion
 167    from raw format to virtual format.  */
 168
 169 #define REGISTER_CONVERTIBLE(N) 0
 170
 171 /* Convert data from raw format for register REGNUM
 172    to virtual format for register REGNUM.  */
 173
 174 #define REGISTER_CONVERT_TO_VIRTUAL(REGNUM,FROM,TO)     \
 175   bcopy ((FROM), (TO), 4);
 176
 177 /* Convert data from virtual format for register REGNUM
 178    to raw format for register REGNUM.  */
 179
 180 #define REGISTER_CONVERT_TO_RAW(REGNUM,FROM,TO) \
 181   bcopy ((FROM), (TO), 4);
 182
 183 /* Return the GDB type object for the "standard" data type
 184    of data in register N.  */
 185
 186 #define REGISTER_VIRTUAL_TYPE(N) builtin_type_int
 187 /* Store the address of the place in which to copy the structure the
 188    subroutine will return.  This is called from call_function. */
 189
 190 #define STORE_STRUCT_RETURN(addr, sp) \
 191   { sp = push_word(sp, addr);}
 192
 193 /* Extract from an array REGBUF containing the (raw) register state
 194    a function return value of type TYPE, and copy that, in virtual format,
 195    into VALBUF.  XXX floats */
 196
 197 #define EXTRACT_RETURN_VALUE(TYPE,REGBUF,VALBUF) \
 198   bcopy (REGBUF+REGISTER_BYTE (TYPE_CODE (TYPE) == TYPE_CODE_FLT ? FP0_REGNUM : 2), VALBUF, TYPE_LENGTH (TYPE))
 199
 200 /* Write into appropriate registers a function return value
 201    of type TYPE, given in virtual format.  */
 202
 203 #define STORE_RETURN_VALUE(TYPE,VALBUF) \
 204   write_register_bytes (REGISTER_BYTE (TYPE_CODE (TYPE) == TYPE_CODE_FLT ? FP0_REGNUM : 2), VALBUF, TYPE_LENGTH (TYPE))
 205
 206 /* Extract from an array REGBUF containing the (raw) register state
 207    the address in which a function should return its structure value,
 208    as a CORE_ADDR (or an expression that can be used as one).  */
 209
 210 #define EXTRACT_STRUCT_VALUE_ADDRESS(REGBUF) (*(int *)(REGBUF+16))
 211
 212 /* Structures are returned by ref in extra arg0 */
 213 #define USE_STRUCT_CONVENTION(gcc_p, type)      1
 214
 215 \f
 216 /* Describe the pointer in each stack frame to the previous stack frame
 217    (its caller).  */
 218
 219 /* FRAME_CHAIN takes a frame's nominal address
 220    and produces the frame's chain-pointer.
 221
 222    FRAME_CHAIN_COMBINE takes the chain pointer and the frame's nominal address
 223    and produces the nominal address of the caller frame.
 224
 225    However, if FRAME_CHAIN_VALID returns zero,
 226    it means the given frame is the outermost one and has no caller.
 227    In that case, FRAME_CHAIN_COMBINE is not used.  */
 228
 229 #define FRAME_CHAIN(thisframe) (FRAME_ADDR)mips_frame_chain(thisframe)
 230
 231 #define FRAME_CHAIN_VALID(chain, thisframe) \
 232   (chain != 0 && (outside_startup_file (FRAME_SAVED_PC (thisframe))))
 233
 234 #define FRAME_CHAIN_COMBINE(chain, thisframe) (chain)
 235
 236 /* Define other aspects of the stack frame.  */
 237
 238
 239 /* A macro that tells us whether the function invocation represented
 240    by FI does not have a frame on the stack associated with it.  If it
 241    does not, FRAMELESS is set to 1, else 0.  */
 242 /* We handle this differently for mips, and maybe we should not */
 243
 244 #define FRAMELESS_FUNCTION_INVOCATION(FI, FRAMELESS)  {(FRAMELESS) = 0;}
 245
 246 /* Saved Pc.  */
 247
 248 #define FRAME_SAVED_PC(FRAME)   (mips_frame_saved_pc(FRAME))
 249
 250 #define FRAME_ARGS_ADDRESS(fi)  (fi)->frame
 251
 252 #define FRAME_LOCALS_ADDRESS(fi) (fi)->frame
 253
 254 /* Return number of args passed to a frame.
 255    Can return -1, meaning no way to tell.  */
 256
 257 #define FRAME_NUM_ARGS(num, fi) (num = mips_frame_num_args(fi))
 258
 259 /* Return number of bytes at start of arglist that are not really args.  */
 260
 261 #define FRAME_ARGS_SKIP 0
 262
 263 /* Put here the code to store, into a struct frame_saved_regs,
 264    the addresses of the saved registers of frame described by FRAME_INFO.
 265    This includes special registers such as pc and fp saved in special
 266    ways in the stack frame.  sp is even more special:
 267    the address we return for it IS the sp for the next frame.  */
 268
 269 #define FRAME_FIND_SAVED_REGS(frame_info, frame_saved_regs) ( \
 270   (frame_saved_regs) = *(frame_info)->saved_regs, \
 271   (frame_saved_regs).regs[SP_REGNUM] = (frame_info)->frame)
 272
 273 \f
 274 /* Things needed for making the inferior call functions.  */
 275
 276 /* Stack has strict alignment. However, use PUSH_ARGUMENTS
 277    to take care of it. */
 278 /*#define STACK_ALIGN(addr)     (((addr)+3)&~3)*/
 279
 280 #define PUSH_ARGUMENTS(nargs, args, sp, struct_return, struct_addr) \
 281     sp = mips_push_arguments(nargs, args, sp, struct_return, struct_addr)
 282
 283 /* Push an empty stack frame, to record the current PC, etc.  */
 284
 285 #define PUSH_DUMMY_FRAME        mips_push_dummy_frame()
 286
 287 /* Discard from the stack the innermost frame, restoring all registers.  */
 288
 289 #define POP_FRAME               mips_pop_frame()
 290
 291 #define MK_OP(op,rs,rt,offset) (((op)<<26)|((rs)<<21)|((rt)<<16)|(offset))
 292 #define CALL_DUMMY_SIZE (16*4)
 293 #define Dest_Reg 2
 294 #define CALL_DUMMY {\
 295  MK_OP(0,RA_REGNUM,0,8),        /* jr $ra # Fake ABOUT_TO_RETURN ...*/\
 296  0,                             /* nop    #  ... to stop raw backtrace*/\
 297  0x27bd0000,                    /* addu sp,?0 # Pseudo prologue */\
 298 /* Start here: */\
 299  MK_OP(061,SP_REGNUM,12,0),     /* lwc1 $f12,0(sp) # Reload first 4 args*/\
 300  MK_OP(061,SP_REGNUM,13,4),     /* lwc1 $f13,4(sp) */\
 301  MK_OP(061,SP_REGNUM,14,8),     /* lwc1 $f14,8(sp) */\
 302  MK_OP(061,SP_REGNUM,15,12),    /* lwc1 $f15,12(sp) */\
 303  MK_OP(043,SP_REGNUM,4,0),      /* lw $r4,0(sp) # Re-load FP regs*/\
 304  MK_OP(043,SP_REGNUM,5,4),      /* lw $r5,4(sp) */\
 305  MK_OP(043,SP_REGNUM,6,8),      /* lw $r6,8(sp) */\
 306  MK_OP(043,SP_REGNUM,7,12),     /* lw $r7,12(sp) */\
 307  (017<<26)| (Dest_Reg << 16),   /* lui $r31,<target upper 16 bits>*/\
 308  MK_OP(13,Dest_Reg,Dest_Reg,0), /* ori $r31,$r31,<lower 16 bits>*/ \
 309  (Dest_Reg<<21) | (31<<11) | 9, /* jalr $r31 */\
 310  MK_OP(043,SP_REGNUM,7,12),     /* lw $r7,12(sp) */\
 311  0x5000d,                       /* bpt */\
 312 }
 313
 314 #define CALL_DUMMY_START_OFFSET 12
 315
 316 /* Insert the specified number of args and function address
 317    into a call sequence of the above form stored at DUMMYNAME.  */
 318
 319 #define FIX_CALL_DUMMY(dummyname, start_sp, fun, nargs, args, rettype, gcc_p)\
 320   (((int*)dummyname)[11] |= (((unsigned long)(fun)) >> 16), \
 321    ((int*)dummyname)[12] |= (unsigned short)(fun))
 322
 323 /* Specific information about a procedure.
 324    This overlays the MIPS's PDR records,
 325    mipsread.c (ab)uses this to save memory */
 326
 327 typedef struct mips_extra_func_info {
 328         unsigned long   adr;    /* memory address of start of procedure */
 329         long    isym;           /* pointer to procedure symbol */
 330         long    pad2;           /* iline: start of line number entries*/
 331         long    regmask;        /* save register mask */
 332         long    regoffset;      /* save register offset */
 333         long    numargs;        /* number of args to procedure (was iopt) */
 334         long    fregmask;       /* save floating point register mask */
 335         long    fregoffset;     /* save floating point register offset */
 336         long    framesize;      /* frameoffset: frame size */
 337         short   framereg;       /* frame pointer register */
 338         short   pcreg;          /* offset or reg of return pc */
 339         long    lnLow;          /* lowest line in the procedure */
 340         long    lnHigh;         /* highest line in the procedure */
 341         long    pad3;           /* cbLineOffset: byte offset for this procedure from the fd base */
 342 } *mips_extra_func_info_t;
 343
 344 #define EXTRA_FRAME_INFO \
 345   char *proc_desc; /* actually, a mips_extra_func_info_t */\
 346   int num_args;\
 347   struct frame_saved_regs *saved_regs;
 348
 349 #define INIT_EXTRA_FRAME_INFO(fromleaf, fci) init_extra_frame_info(fci)