home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / gnu / gdb-4.12-src.lha / gdb-4.12 / gdb / config / alpha / tm-alpha.h < prev    next >
Encoding:
C/C++ Source or Header  |  1994-02-03  |  15.3 KB  |  423 lines
  1. /* Definitions to make GDB run on an Alpha box under OSF1.
  2.    Copyright 1993 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. #include "bfd.h"
  21. #include "coff/sym.h"        /* Needed for PDR below.  */
  22. #include "coff/symconst.h"
  23.  
  24. #if !defined (TARGET_BYTE_ORDER)
  25. #define TARGET_BYTE_ORDER LITTLE_ENDIAN
  26. #endif
  27.  
  28. /* Redefine some target bit sizes from the default.  */
  29.  
  30. #define TARGET_LONG_BIT 64
  31. #define TARGET_LONG_LONG_BIT 64
  32. #define TARGET_PTR_BIT 64
  33.  
  34. /* Floating point is IEEE compliant */
  35. #define IEEE_FLOAT
  36.  
  37. /* Number of traps that happen between exec'ing the shell 
  38.  * to run an inferior, and when we finally get to 
  39.  * the inferior code.  This is 2 on most implementations.
  40.  */
  41. #define START_INFERIOR_TRAPS_EXPECTED 3
  42.  
  43. /* Offset from address of function to start of its code.
  44.    Zero on most machines.  */
  45.  
  46. #define FUNCTION_START_OFFSET 0
  47.  
  48. /* Advance PC across any function entry prologue instructions
  49.    to reach some "real" code.  */
  50.  
  51. #define SKIP_PROLOGUE(pc)    pc = alpha_skip_prologue(pc, 0)
  52. extern CORE_ADDR alpha_skip_prologue PARAMS ((CORE_ADDR addr, int lenient));
  53.  
  54. /* Immediately after a function call, return the saved pc.
  55.    Can't always go through the frames for this because on some machines
  56.    the new frame is not set up until the new function executes
  57.    some instructions.  */
  58.  
  59. #define SAVED_PC_AFTER_CALL(frame)    alpha_saved_pc_after_call(frame)
  60. #ifdef __STDC__
  61. struct frame_info;
  62. #endif
  63. extern CORE_ADDR
  64. alpha_saved_pc_after_call PARAMS ((struct frame_info *));
  65.  
  66. /* Are we currently handling a signal ?  */
  67.  
  68. #define IN_SIGTRAMP(pc, name)    ((name) && STREQ ("__sigtramp", (name)))
  69.  
  70. /* Stack grows downward.  */
  71.  
  72. #define INNER_THAN <
  73.  
  74. #define BREAKPOINT {0x80, 0, 0, 0} /* call_pal bpt */
  75.  
  76. /* Amount PC must be decremented by after a breakpoint.
  77.    This is often the number of bytes in BREAKPOINT
  78.    but not always.  */
  79.  
  80. #define DECR_PC_AFTER_BREAK 4
  81.  
  82. /* Nonzero if instruction at PC is a return instruction.
  83.    "ret $zero,($ra),1" on alpha. */
  84.  
  85. #define ABOUT_TO_RETURN(pc) (read_memory_integer (pc, 4) == 0x6bfa8001)
  86.  
  87. /* Return 1 if P points to an invalid floating point value. */
  88.  
  89. #define INVALID_FLOAT(p,l) 0
  90.  
  91. /* Say how long (ordinary) registers are.  This is a piece of bogosity
  92.    used in push_word and a few other places; REGISTER_RAW_SIZE is the
  93.    real way to know how big a register is.  */
  94.  
  95. #define REGISTER_SIZE 8
  96.  
  97. /* Number of machine registers */
  98.  
  99. #define NUM_REGS 66
  100.  
  101. /* Initializer for an array of names of registers.
  102.    There should be NUM_REGS strings in this initializer.  */
  103.  
  104. #define REGISTER_NAMES     \
  105.     {    "v0",    "t0",    "t1",    "t2",    "t3",    "t4",    "t5",    "t6", \
  106.     "t7",    "s0",    "s1",    "s2",    "s3",    "s4",    "s5",    "fp", \
  107.     "a0",    "a1",    "a2",    "a3",    "a4",    "a5",    "t8",    "t9", \
  108.     "t10",    "t11",    "ra",    "t12",    "at",    "gp",    "sp",    "zero", \
  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.     "pc",    "vfp",                        \
  114.     }
  115.  
  116. /* Register numbers of various important registers.
  117.    Note that most of these values are "real" register numbers,
  118.    and correspond to the general registers of the machine,
  119.    and FP_REGNUM is a "phony" register number which is too large
  120.    to be an actual register number as far as the user is concerned
  121.    but serves to get the desired value when passed to read_register.  */
  122.  
  123. #define V0_REGNUM 0        /* Function integer return value */
  124. #define GCC_FP_REGNUM 15    /* Used by gcc as frame register */
  125. #define A0_REGNUM 16        /* Loc of first arg during a subr call */
  126. #define T12_REGNUM 27        /* Contains start addr of current proc */
  127. #define SP_REGNUM 30        /* Contains address of top of stack */
  128. #define RA_REGNUM 26        /* Contains return address value */
  129. #define ZERO_REGNUM 31        /* Read-only register, always 0 */
  130. #define FP0_REGNUM 32           /* Floating point register 0 */
  131. #define FPA0_REGNUM 48          /* First float arg during a subr call */
  132. #define PC_REGNUM 64        /* Contains program counter */
  133. #define FP_REGNUM 65        /* Virtual frame pointer */
  134.  
  135. #define CANNOT_FETCH_REGISTER(regno) \
  136.   ((regno) == FP_REGNUM || (regno) == ZERO_REGNUM)
  137. #define CANNOT_STORE_REGISTER(regno) \
  138.   ((regno) == FP_REGNUM || (regno) == ZERO_REGNUM)
  139.  
  140. /* Total amount of space needed to store our copies of the machine's
  141.    register state, the array `registers'.  */
  142. #define REGISTER_BYTES (NUM_REGS * 8)
  143.  
  144. /* Index within `registers' of the first byte of the space for
  145.    register N.  */
  146.  
  147. #define REGISTER_BYTE(N) ((N) * 8)
  148.  
  149. /* Number of bytes of storage in the actual machine representation
  150.    for register N.  On Alphas, all regs are 8 bytes.  */
  151.  
  152. #define REGISTER_RAW_SIZE(N) 8
  153.  
  154. /* Number of bytes of storage in the program's representation
  155.    for register N.  On Alphas, all regs are 8 bytes.  */
  156.  
  157. #define REGISTER_VIRTUAL_SIZE(N) 8
  158.  
  159. /* Largest value REGISTER_RAW_SIZE can have.  */
  160.  
  161. #define MAX_REGISTER_RAW_SIZE 8
  162.  
  163. /* Largest value REGISTER_VIRTUAL_SIZE can have.  */
  164.  
  165. #define MAX_REGISTER_VIRTUAL_SIZE 8
  166.  
  167. /* Nonzero if register N requires conversion
  168.    from raw format to virtual format.
  169.    The alpha needs a conversion between register and memory format if
  170.    the register is a floating point register and
  171.       memory format is float, as the register format must be double
  172.    or
  173.       memory format is an integer with 4 bytes or less, as the representation
  174.       of integers in floating point registers is different. */
  175.  
  176. #define REGISTER_CONVERTIBLE(N) ((N) >= FP0_REGNUM && (N) < FP0_REGNUM + 32)
  177.  
  178. /* Convert data from raw format for register REGNUM in buffer FROM
  179.    to virtual format with type TYPE in buffer TO.  */
  180.  
  181. #define REGISTER_CONVERT_TO_VIRTUAL(REGNUM, TYPE, FROM, TO) \
  182.   alpha_register_convert_to_virtual (REGNUM, TYPE, FROM, TO)
  183. #ifdef __STDC__
  184. struct type;
  185. #endif
  186. extern void
  187. alpha_register_convert_to_virtual PARAMS ((int, struct type *, char *, char *));
  188.  
  189. /* Convert data from virtual format with type TYPE in buffer FROM
  190.    to raw format for register REGNUM in buffer TO.  */
  191.  
  192. #define REGISTER_CONVERT_TO_RAW(TYPE, REGNUM, FROM, TO)    \
  193.   alpha_register_convert_to_raw (TYPE, REGNUM, FROM, TO)
  194. extern void
  195. alpha_register_convert_to_raw PARAMS ((struct type *, int, char *, char *));
  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) \
  201.     (((N) >= FP0_REGNUM && (N) < FP0_REGNUM+32)  \
  202.      ? builtin_type_double : builtin_type_long) \
  203.  
  204. /* Store the address of the place in which to copy the structure the
  205.    subroutine will return.  Handled by alpha_push_arguments.  */
  206.  
  207. #define STORE_STRUCT_RETURN(addr, sp)    /**/
  208.  
  209. /* Extract from an array REGBUF containing the (raw) register state
  210.    a function return value of type TYPE, and copy that, in virtual format,
  211.    into VALBUF.  */
  212.  
  213. #define EXTRACT_RETURN_VALUE(TYPE,REGBUF,VALBUF) \
  214.   alpha_extract_return_value(TYPE, REGBUF, VALBUF)
  215. extern void
  216. alpha_extract_return_value PARAMS ((struct type *, char *, char *));
  217.  
  218. /* Write into appropriate registers a function return value
  219.    of type TYPE, given in virtual format.  */
  220.  
  221. #define STORE_RETURN_VALUE(TYPE,VALBUF) \
  222.   alpha_store_return_value(TYPE, VALBUF)
  223. extern void
  224. alpha_store_return_value PARAMS ((struct type *, char *));
  225.  
  226. /* Extract from an array REGBUF containing the (raw) register state
  227.    the address in which a function should return its structure value,
  228.    as a CORE_ADDR (or an expression that can be used as one).  */
  229. /* The address is passed in a0 upon entry to the function, but when
  230.    the function exits, the compiler has copied the value to v0.  This
  231.    convention is specified by the System V ABI, so I think we can rely
  232.    on it.  */
  233.  
  234. #define EXTRACT_STRUCT_VALUE_ADDRESS(REGBUF) \
  235.   (extract_address (REGBUF + REGISTER_BYTE (V0_REGNUM), \
  236.             REGISTER_RAW_SIZE (V0_REGNUM)))
  237.  
  238. /* Structures are returned by ref in extra arg0 */
  239. #define USE_STRUCT_CONVENTION(gcc_p, type)    1
  240.  
  241.  
  242. /* Describe the pointer in each stack frame to the previous stack frame
  243.    (its caller).  */
  244.  
  245. /* FRAME_CHAIN takes a frame's nominal address
  246.    and produces the frame's chain-pointer. */
  247.  
  248. #define FRAME_CHAIN(thisframe) (FRAME_ADDR)alpha_frame_chain(thisframe)
  249. extern CORE_ADDR
  250. alpha_frame_chain PARAMS ((struct frame_info *));
  251.  
  252. /* Define other aspects of the stack frame.  */
  253.  
  254.  
  255. /* A macro that tells us whether the function invocation represented
  256.    by FI does not have a frame on the stack associated with it.  If it
  257.    does not, FRAMELESS is set to 1, else 0.  */
  258. /* We handle this differently for alpha, and maybe we should not */
  259.  
  260. #define FRAMELESS_FUNCTION_INVOCATION(FI, FRAMELESS)  {(FRAMELESS) = 0;}
  261.  
  262. /* Saved Pc.  */
  263.  
  264. #define FRAME_SAVED_PC(FRAME)    (alpha_frame_saved_pc(FRAME))
  265. extern CORE_ADDR
  266. alpha_frame_saved_pc PARAMS ((struct frame_info *));
  267.  
  268. /* The alpha has two different virtual pointers for arguments and locals.
  269.  
  270.    The virtual argument pointer is pointing to the bottom of the argument
  271.    transfer area, which is located immediately below the virtual frame
  272.    pointer. Its size is fixed for the native compiler, it is either zero
  273.    (for the no arguments case) or large enough to hold all argument registers.
  274.    gcc uses a variable sized argument transfer area. As it has
  275.    to stay compatible with the native debugging tools it has to use the same
  276.    virtual argument pointer and adjust the argument offsets accordingly.
  277.  
  278.    The virtual local pointer is localoff bytes below the virtual frame
  279.    pointer, the value of localoff is obtained from the PDR.  */
  280.  
  281. #define ALPHA_NUM_ARG_REGS    6
  282.  
  283. #define FRAME_ARGS_ADDRESS(fi)    ((fi)->frame - (ALPHA_NUM_ARG_REGS * 8))
  284.  
  285. #define FRAME_LOCALS_ADDRESS(fi) ((fi)->frame - (fi)->localoff)
  286.  
  287. /* Return number of args passed to a frame.
  288.    Can return -1, meaning no way to tell.  */
  289.  
  290. #define FRAME_NUM_ARGS(num, fi)    ((num) = -1)
  291.  
  292. /* Return number of bytes at start of arglist that are not really args.  */
  293.  
  294. #define FRAME_ARGS_SKIP 0
  295.  
  296. /* Put here the code to store, into a struct frame_saved_regs,
  297.    the addresses of the saved registers of frame described by FRAME_INFO.
  298.    This includes special registers such as pc and fp saved in special
  299.    ways in the stack frame.  sp is even more special:
  300.    the address we return for it IS the sp for the next frame.  */
  301.  
  302. #define FRAME_FIND_SAVED_REGS(fi, frame_saved_regs) ( \
  303.   (frame_saved_regs) = *(fi)->saved_regs, \
  304.   (frame_saved_regs).regs[SP_REGNUM] = (fi)->frame)
  305.  
  306.  
  307. /* Things needed for making the inferior call functions.  */
  308.  
  309. #define PUSH_ARGUMENTS(nargs, args, sp, struct_return, struct_addr) \
  310.     sp = alpha_push_arguments(nargs, args, sp, struct_return, struct_addr)
  311. #ifdef __STDC__
  312. struct value;
  313. #endif
  314. extern CORE_ADDR
  315. alpha_push_arguments PARAMS ((int, struct value **, CORE_ADDR, int, CORE_ADDR));
  316.  
  317. /* Push an empty stack frame, to record the current PC, etc.  */
  318.  
  319. #define PUSH_DUMMY_FRAME     alpha_push_dummy_frame()
  320. extern void
  321. alpha_push_dummy_frame PARAMS ((void));
  322.  
  323. /* Discard from the stack the innermost frame, restoring all registers.  */
  324.  
  325. #define POP_FRAME        alpha_pop_frame()
  326. extern void
  327. alpha_pop_frame PARAMS ((void));
  328.  
  329. /* Alpha OSF/1 inhibits execution of code on the stack.
  330.    But there is no need for a dummy on the alpha. PUSH_ARGUMENTS
  331.    takes care of all argument handling and bp_call_dummy takes care
  332.    of stopping the dummy.  */
  333.  
  334. #define CALL_DUMMY_LOCATION AT_ENTRY_POINT
  335.  
  336. /* On the Alpha the call dummy code is never copied to user space,
  337.    stopping the user call is achieved via a bp_call_dummy breakpoint.
  338.    But we need a fake CALL_DUMMY definition to enable the proper
  339.    call_function_by_hand and to avoid zero length array warnings
  340.    in valops.c  */
  341.  
  342. #define CALL_DUMMY { 0 }    /* Content doesn't matter. */
  343.  
  344. #define CALL_DUMMY_START_OFFSET (0)
  345.  
  346. #define CALL_DUMMY_BREAKPOINT_OFFSET (0)
  347.  
  348. /* Insert the specified number of args and function address
  349.    into a call sequence of the above form stored at DUMMYNAME.
  350.    We only have to set RA_REGNUM to the dummy breakpoint address
  351.    and T12_REGNUM (the `procedure value register') to the function address.  */
  352.  
  353. #define FIX_CALL_DUMMY(dummyname, pc, fun, nargs, args, type, gcc_p)    \
  354. {                                    \
  355.   CORE_ADDR bp_address = entry_point_address ();            \
  356.   if (bp_address == 0)                            \
  357.     error ("no place to put call");                    \
  358.   write_register (RA_REGNUM, bp_address);                \
  359.   write_register (T12_REGNUM, fun);                    \
  360. }
  361.  
  362. /* There's a mess in stack frame creation.  See comments in blockframe.c
  363.    near reference to INIT_FRAME_PC_FIRST.  */
  364.  
  365. #define    INIT_FRAME_PC(fromleaf, prev) /* nada */
  366.  
  367. #define INIT_FRAME_PC_FIRST(fromleaf, prev) \
  368.   (prev)->pc = ((fromleaf) ? SAVED_PC_AFTER_CALL ((prev)->next) : \
  369.           (prev)->next ? FRAME_SAVED_PC ((prev)->next) : read_pc ());
  370.  
  371. /* Special symbol found in blocks associated with routines.  We can hang
  372.    alpha_extra_func_info_t's off of this.  */
  373.  
  374. #define MIPS_EFI_SYMBOL_NAME "__GDB_EFI_INFO__"
  375.  
  376. /* Specific information about a procedure.
  377.    This overlays the ALPHA's PDR records, 
  378.    alpharead.c (ab)uses this to save memory */
  379.  
  380. typedef struct alpha_extra_func_info {
  381.     long    numargs;    /* number of args to procedure (was iopt) */
  382.     PDR    pdr;        /* Procedure descriptor record */
  383. } *alpha_extra_func_info_t;
  384.  
  385. /* Define the extra_func_info that mipsread.c needs.
  386.    FIXME: We should define our own PDR interface, perhaps in a separate
  387.    header file. This would get rid of the <bfd.h> inclusion in all sources
  388.    and would abstract the mips/alpha interface from ecoff.  */
  389. #define mips_extra_func_info alpha_extra_func_info
  390. #define mips_extra_func_info_t alpha_extra_func_info_t
  391.  
  392. #define EXTRA_FRAME_INFO \
  393.   int localoff; \
  394.   alpha_extra_func_info_t proc_desc; \
  395.   struct frame_saved_regs *saved_regs;
  396.  
  397. #define INIT_EXTRA_FRAME_INFO(fromleaf, fci) init_extra_frame_info(fci)
  398. extern void
  399. init_extra_frame_info PARAMS ((struct frame_info *));
  400.  
  401. #define    PRINT_EXTRA_FRAME_INFO(fi) \
  402.   { \
  403.     if (fi && fi->proc_desc && fi->proc_desc->pdr.framereg < NUM_REGS) \
  404.       printf_filtered (" frame pointer is at %s+%d\n", \
  405.                        reg_names[fi->proc_desc->pdr.framereg], \
  406.                                  fi->proc_desc->pdr.frameoffset); \
  407.   }
  408.  
  409. /* It takes two values to specify a frame on the ALPHA.  Sigh.
  410.  
  411.    In fact, at the moment, the *PC* is the primary value that sets up
  412.    a frame.  The PC is looked up to see what function it's in; symbol
  413.    information from that function tells us which register is the frame
  414.    pointer base, and what offset from there is the "virtual frame pointer".
  415.    (This is usually an offset from SP.)  FIXME -- this should be cleaned
  416.    up so that the primary value is the SP, and the PC is used to disambiguate
  417.    multiple functions with the same SP that are at different stack levels. */
  418.  
  419. #define SETUP_ARBITRARY_FRAME(argc, argv) setup_arbitrary_frame (argc, argv)
  420. /* FIXME:  Depends on equivalence between FRAME and "struct frame_info *",
  421.    and equivalence between CORE_ADDR and FRAME_ADDR. */
  422. extern struct frame_info *setup_arbitrary_frame PARAMS ((int, CORE_ADDR *));
  423.