gdb/tm-irix3.h

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