]>
git.ipfire.org Git - thirdparty/binutils-gdb.git/blob - gdb/config/alpha/tm-alpha.h
1 /* Definitions to make GDB run on an Alpha box under OSF1. This is
2 also used by the Alpha/Netware and Alpha/Linux targets.
3 Copyright 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
26 #include "coff/sym.h" /* Needed for PDR below. */
27 #include "coff/symconst.h"
34 #if !defined (TARGET_BYTE_ORDER)
35 #define TARGET_BYTE_ORDER LITTLE_ENDIAN
38 /* Redefine some target bit sizes from the default. */
40 #define TARGET_LONG_BIT 64
41 #define TARGET_LONG_LONG_BIT 64
42 #define TARGET_PTR_BIT 64
44 /* Floating point is IEEE compliant */
45 #define IEEE_FLOAT (1)
47 /* Number of traps that happen between exec'ing the shell
48 * to run an inferior, and when we finally get to
49 * the inferior code. This is 2 on most implementations.
51 #define START_INFERIOR_TRAPS_EXPECTED 3
53 /* Offset from address of function to start of its code.
54 Zero on most machines. */
56 #define FUNCTION_START_OFFSET 0
58 /* Advance PC across any function entry prologue instructions
59 to reach some "real" code. */
61 #define SKIP_PROLOGUE(pc) (alpha_skip_prologue(pc, 0))
62 extern CORE_ADDR
alpha_skip_prologue (CORE_ADDR addr
, int lenient
);
64 /* Immediately after a function call, return the saved pc.
65 Can't always go through the frames for this because on some machines
66 the new frame is not set up until the new function executes
69 #define SAVED_PC_AFTER_CALL(frame) alpha_saved_pc_after_call(frame)
70 extern CORE_ADDR
alpha_saved_pc_after_call (struct frame_info
*);
72 /* Are we currently handling a signal ? */
74 #define IN_SIGTRAMP(pc, name) ((name) && STREQ ("__sigtramp", (name)))
76 /* Stack grows downward. */
78 #define INNER_THAN(lhs,rhs) ((lhs) < (rhs))
80 #define BREAKPOINT {0x80, 0, 0, 0} /* call_pal bpt */
82 /* Amount PC must be decremented by after a breakpoint.
83 This is often the number of bytes in BREAKPOINT
86 #ifndef DECR_PC_AFTER_BREAK
87 #define DECR_PC_AFTER_BREAK 4
90 /* Say how long (ordinary) registers are. This is a piece of bogosity
91 used in push_word and a few other places; REGISTER_RAW_SIZE is the
92 real way to know how big a register is. */
94 #define REGISTER_SIZE 8
96 /* Number of machine registers */
100 /* Initializer for an array of names of registers.
101 There should be NUM_REGS strings in this initializer. */
103 #define REGISTER_NAMES \
104 { "v0", "t0", "t1", "t2", "t3", "t4", "t5", "t6", \
105 "t7", "s0", "s1", "s2", "s3", "s4", "s5", "fp", \
106 "a0", "a1", "a2", "a3", "a4", "a5", "t8", "t9", \
107 "t10", "t11", "ra", "t12", "at", "gp", "sp", "zero", \
108 "f0", "f1", "f2", "f3", "f4", "f5", "f6", "f7", \
109 "f8", "f9", "f10", "f11", "f12", "f13", "f14", "f15", \
110 "f16", "f17", "f18", "f19", "f20", "f21", "f22", "f23",\
111 "f24", "f25", "f26", "f27", "f28", "f29", "f30", "fpcr",\
115 /* Register numbers of various important registers.
116 Note that most of these values are "real" register numbers,
117 and correspond to the general registers of the machine,
118 and FP_REGNUM is a "phony" register number which is too large
119 to be an actual register number as far as the user is concerned
120 but serves to get the desired value when passed to read_register. */
122 #define V0_REGNUM 0 /* Function integer return value */
123 #define T7_REGNUM 8 /* Return address register for OSF/1 __add* */
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 T9_REGNUM 23 /* Return address register for OSF/1 __div* */
127 #define T12_REGNUM 27 /* Contains start addr of current proc */
128 #define SP_REGNUM 30 /* Contains address of top of stack */
129 #define RA_REGNUM 26 /* Contains return address value */
130 #define ZERO_REGNUM 31 /* Read-only register, always 0 */
131 #define FP0_REGNUM 32 /* Floating point register 0 */
132 #define FPA0_REGNUM 48 /* First float arg during a subr call */
133 #define FPCR_REGNUM 63 /* Floating point control register */
134 #define PC_REGNUM 64 /* Contains program counter */
135 #define FP_REGNUM 65 /* Virtual frame pointer */
137 #define CANNOT_FETCH_REGISTER(regno) \
138 ((regno) == FP_REGNUM || (regno) == ZERO_REGNUM)
139 #define CANNOT_STORE_REGISTER(regno) \
140 ((regno) == FP_REGNUM || (regno) == ZERO_REGNUM)
142 /* Total amount of space needed to store our copies of the machine's
143 register state, the array `registers'. */
144 #define REGISTER_BYTES (NUM_REGS * 8)
146 /* Index within `registers' of the first byte of the space for
149 #define REGISTER_BYTE(N) ((N) * 8)
151 /* Number of bytes of storage in the actual machine representation
152 for register N. On Alphas, all regs are 8 bytes. */
154 #define REGISTER_RAW_SIZE(N) 8
156 /* Number of bytes of storage in the program's representation
157 for register N. On Alphas, all regs are 8 bytes. */
159 #define REGISTER_VIRTUAL_SIZE(N) 8
161 /* Largest value REGISTER_RAW_SIZE can have. */
163 #define MAX_REGISTER_RAW_SIZE 8
165 /* Largest value REGISTER_VIRTUAL_SIZE can have. */
167 #define MAX_REGISTER_VIRTUAL_SIZE 8
169 /* Nonzero if register N requires conversion
170 from raw format to virtual format.
171 The alpha needs a conversion between register and memory format if
172 the register is a floating point register and
173 memory format is float, as the register format must be double
175 memory format is an integer with 4 bytes or less, as the representation
176 of integers in floating point registers is different. */
178 #define REGISTER_CONVERTIBLE(N) ((N) >= FP0_REGNUM && (N) < FP0_REGNUM + 31)
180 /* Convert data from raw format for register REGNUM in buffer FROM
181 to virtual format with type TYPE in buffer TO. */
183 #define REGISTER_CONVERT_TO_VIRTUAL(REGNUM, TYPE, FROM, TO) \
184 alpha_register_convert_to_virtual (REGNUM, TYPE, FROM, TO)
186 alpha_register_convert_to_virtual (int, struct type
*, char *, char *);
188 /* Convert data from virtual format with type TYPE in buffer FROM
189 to raw format for register REGNUM in buffer TO. */
191 #define REGISTER_CONVERT_TO_RAW(TYPE, REGNUM, FROM, TO) \
192 alpha_register_convert_to_raw (TYPE, REGNUM, FROM, TO)
194 alpha_register_convert_to_raw (struct type
*, int, char *, char *);
196 /* Return the GDB type object for the "standard" data type
197 of data in register N. */
199 #define REGISTER_VIRTUAL_TYPE(N) \
200 (((N) >= FP0_REGNUM && (N) < FP0_REGNUM+31) \
201 ? builtin_type_double : builtin_type_long) \
203 /* Store the address of the place in which to copy the structure the
204 subroutine will return. Handled by alpha_push_arguments. */
206 #define STORE_STRUCT_RETURN(addr, sp)
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,
213 #define EXTRACT_RETURN_VALUE(TYPE,REGBUF,VALBUF) \
214 alpha_extract_return_value(TYPE, REGBUF, VALBUF)
215 extern void alpha_extract_return_value (struct type
*, char *, char *);
217 /* Write into appropriate registers a function return value
218 of type TYPE, given in virtual format. */
220 #define STORE_RETURN_VALUE(TYPE,VALBUF) \
221 alpha_store_return_value(TYPE, VALBUF)
222 extern void alpha_store_return_value (struct type
*, char *);
224 /* Extract from an array REGBUF containing the (raw) register state
225 the address in which a function should return its structure value,
226 as a CORE_ADDR (or an expression that can be used as one). */
227 /* The address is passed in a0 upon entry to the function, but when
228 the function exits, the compiler has copied the value to v0. This
229 convention is specified by the System V ABI, so I think we can rely
232 #define EXTRACT_STRUCT_VALUE_ADDRESS(REGBUF) \
233 (extract_address (REGBUF + REGISTER_BYTE (V0_REGNUM), \
234 REGISTER_RAW_SIZE (V0_REGNUM)))
236 /* Structures are returned by ref in extra arg0 */
237 #define USE_STRUCT_CONVENTION(gcc_p, type) 1
240 /* Describe the pointer in each stack frame to the previous stack frame
243 /* FRAME_CHAIN takes a frame's nominal address
244 and produces the frame's chain-pointer. */
246 #define FRAME_CHAIN(thisframe) (CORE_ADDR) alpha_frame_chain (thisframe)
247 extern CORE_ADDR
alpha_frame_chain (struct frame_info
*);
249 /* Define other aspects of the stack frame. */
252 /* An expression that tells us whether the function invocation represented
253 by FI does not have a frame on the stack associated with it. */
254 /* We handle this differently for alpha, and maybe we should not */
256 #define FRAMELESS_FUNCTION_INVOCATION(FI) (0)
260 #define FRAME_SAVED_PC(FRAME) (alpha_frame_saved_pc(FRAME))
261 extern CORE_ADDR
alpha_frame_saved_pc (struct frame_info
*);
263 /* The alpha has two different virtual pointers for arguments and locals.
265 The virtual argument pointer is pointing to the bottom of the argument
266 transfer area, which is located immediately below the virtual frame
267 pointer. Its size is fixed for the native compiler, it is either zero
268 (for the no arguments case) or large enough to hold all argument registers.
269 gcc uses a variable sized argument transfer area. As it has
270 to stay compatible with the native debugging tools it has to use the same
271 virtual argument pointer and adjust the argument offsets accordingly.
273 The virtual local pointer is localoff bytes below the virtual frame
274 pointer, the value of localoff is obtained from the PDR. */
276 #define ALPHA_NUM_ARG_REGS 6
278 #define FRAME_ARGS_ADDRESS(fi) ((fi)->frame - (ALPHA_NUM_ARG_REGS * 8))
280 #define FRAME_LOCALS_ADDRESS(fi) ((fi)->frame - (fi)->localoff)
282 /* Return number of args passed to a frame.
283 Can return -1, meaning no way to tell. */
285 #define FRAME_NUM_ARGS(fi) (-1)
287 /* Return number of bytes at start of arglist that are not really args. */
289 #define FRAME_ARGS_SKIP 0
291 /* Put here the code to store, into a struct frame_saved_regs,
292 the addresses of the saved registers of frame described by FRAME_INFO.
293 This includes special registers such as pc and fp saved in special
294 ways in the stack frame. sp is even more special:
295 the address we return for it IS the sp for the next frame. */
297 extern void alpha_find_saved_regs (struct frame_info
*);
299 #define FRAME_INIT_SAVED_REGS(frame_info) \
301 if ((frame_info)->saved_regs == NULL) \
302 alpha_find_saved_regs (frame_info); \
303 (frame_info)->saved_regs[SP_REGNUM] = (frame_info)->frame; \
307 /* Things needed for making the inferior call functions. */
309 #define PUSH_ARGUMENTS(nargs, args, sp, struct_return, struct_addr) \
310 (alpha_push_arguments((nargs), (args), (sp), (struct_return), (struct_addr)))
312 alpha_push_arguments (int, struct value
**, CORE_ADDR
, int, CORE_ADDR
);
314 /* Push an empty stack frame, to record the current PC, etc. */
316 #define PUSH_DUMMY_FRAME alpha_push_dummy_frame()
317 extern void alpha_push_dummy_frame (void);
319 /* Discard from the stack the innermost frame, restoring all registers. */
321 #define POP_FRAME alpha_pop_frame()
322 extern void alpha_pop_frame (void);
324 /* Alpha OSF/1 inhibits execution of code on the stack.
325 But there is no need for a dummy on the alpha. PUSH_ARGUMENTS
326 takes care of all argument handling and bp_call_dummy takes care
327 of stopping the dummy. */
329 #define CALL_DUMMY_LOCATION AT_ENTRY_POINT
331 /* On the Alpha the call dummy code is never copied to user space,
332 stopping the user call is achieved via a bp_call_dummy breakpoint.
333 But we need a fake CALL_DUMMY definition to enable the proper
334 call_function_by_hand and to avoid zero length array warnings
337 #define CALL_DUMMY { 0 } /* Content doesn't matter. */
339 #define CALL_DUMMY_START_OFFSET (0)
341 #define CALL_DUMMY_BREAKPOINT_OFFSET (0)
343 extern CORE_ADDR
alpha_call_dummy_address (void);
344 #define CALL_DUMMY_ADDRESS() alpha_call_dummy_address()
346 /* Insert the specified number of args and function address
347 into a call sequence of the above form stored at DUMMYNAME.
348 We only have to set RA_REGNUM to the dummy breakpoint address
349 and T12_REGNUM (the `procedure value register') to the function address. */
351 #define FIX_CALL_DUMMY(dummyname, pc, fun, nargs, args, type, gcc_p) \
353 CORE_ADDR bp_address = CALL_DUMMY_ADDRESS (); \
354 if (bp_address == 0) \
355 error ("no place to put call"); \
356 write_register (RA_REGNUM, bp_address); \
357 write_register (T12_REGNUM, fun); \
360 /* There's a mess in stack frame creation. See comments in blockframe.c
361 near reference to INIT_FRAME_PC_FIRST. */
363 #define INIT_FRAME_PC(fromleaf, prev) /* nada */
365 #define INIT_FRAME_PC_FIRST(fromleaf, prev) \
366 (prev)->pc = ((fromleaf) ? SAVED_PC_AFTER_CALL ((prev)->next) : \
367 (prev)->next ? FRAME_SAVED_PC ((prev)->next) : read_pc ());
369 /* Special symbol found in blocks associated with routines. We can hang
370 alpha_extra_func_info_t's off of this. */
372 #define MIPS_EFI_SYMBOL_NAME "__GDB_EFI_INFO__"
373 extern void ecoff_relocate_efi (struct symbol
*, CORE_ADDR
);
375 /* Specific information about a procedure.
376 This overlays the ALPHA's PDR records,
377 alpharead.c (ab)uses this to save memory */
379 typedef struct alpha_extra_func_info
381 long numargs
; /* number of args to procedure (was iopt) */
382 PDR pdr
; /* Procedure descriptor record */
384 *alpha_extra_func_info_t
;
386 /* Define the extra_func_info that mipsread.c needs.
387 FIXME: We should define our own PDR interface, perhaps in a separate
388 header file. This would get rid of the <bfd.h> inclusion in all sources
389 and would abstract the mips/alpha interface from ecoff. */
390 #define mips_extra_func_info alpha_extra_func_info
391 #define mips_extra_func_info_t alpha_extra_func_info_t
393 #define EXTRA_FRAME_INFO \
396 alpha_extra_func_info_t proc_desc;
398 #define INIT_EXTRA_FRAME_INFO(fromleaf, fci) init_extra_frame_info(fci)
399 extern void init_extra_frame_info (struct frame_info
*);
401 #define PRINT_EXTRA_FRAME_INFO(fi) \
403 if (fi && fi->proc_desc && fi->proc_desc->pdr.framereg < NUM_REGS) \
404 printf_filtered (" frame pointer is at %s+%ld\n", \
405 REGISTER_NAME (fi->proc_desc->pdr.framereg), \
406 fi->proc_desc->pdr.frameoffset); \
409 /* It takes two values to specify a frame on the ALPHA. Sigh.
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. */
419 #define SETUP_ARBITRARY_FRAME(argc, argv) setup_arbitrary_frame (argc, argv)
420 extern struct frame_info
*setup_arbitrary_frame (int, CORE_ADDR
*);
422 /* This is used by heuristic_proc_start. It should be shot it the head. */
423 #ifndef VM_MIN_ADDRESS
424 #define VM_MIN_ADDRESS (CORE_ADDR)0x120000000
427 /* If PC is in a shared library trampoline code, return the PC
428 where the function itself actually starts. If not, return 0. */
429 #define SKIP_TRAMPOLINE_CODE(pc) find_solib_trampoline_target (pc)
431 /* If the current gcc for for this target does not produce correct debugging
432 information for float parameters, both prototyped and unprototyped, then
433 define this macro. This forces gdb to always assume that floats are
434 passed as doubles and then converted in the callee.
436 For the alpha, it appears that the debug info marks the parameters as
437 floats regardless of whether the function is prototyped, but the actual
438 values are always passed in as doubles. Thus by setting this to 1, both
439 types of calls will work. */
441 #define COERCE_FLOAT_TO_DOUBLE(formal, actual) (1)
443 /* Return TRUE if procedure descriptor PROC is a procedure descriptor
444 that refers to a dynamically generated sigtramp function.
446 OSF/1 doesn't use dynamic sigtramp functions, so this is always
449 #define PROC_DESC_IS_DYN_SIGTRAMP(proc) (0)
450 #define SET_PROC_DESC_IS_DYN_SIGTRAMP(proc)
452 /* If PC is inside a dynamically generated sigtramp function, return
453 how many bytes the program counter is beyond the start of that
454 function. Otherwise, return a negative value.
456 OSF/1 doesn't use dynamic sigtramp functions, so this always
459 #define DYNAMIC_SIGTRAMP_OFFSET(pc) (-1)
461 /* Translate a signal handler frame into the address of the sigcontext
464 #define SIGCONTEXT_ADDR(frame) \
465 (read_memory_integer ((frame)->next ? frame->next->frame : frame->frame, 8))
467 /* If FRAME refers to a sigtramp frame, return the address of the next
470 #define FRAME_PAST_SIGTRAMP_FRAME(frame, pc) \
471 (alpha_osf_skip_sigtramp_frame (frame, pc))
472 extern CORE_ADDR
alpha_osf_skip_sigtramp_frame (struct frame_info
*,
475 #endif /* TM_ALPHA_H */