]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blob - gdb/config/alpha/tm-alpha.h
Initial creation of sourceware repository
[thirdparty/binutils-gdb.git] / 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.
4
5 This file is part of GDB.
6
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.
11
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.
16
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, Boston, MA 02111-1307, USA. */
20
21 #ifndef TM_ALPHA_H
22 #define TM_ALPHA_H
23
24 #include "bfd.h"
25 #include "coff/sym.h" /* Needed for PDR below. */
26 #include "coff/symconst.h"
27
28 #ifdef __STDC__
29 struct frame_info;
30 struct type;
31 struct value;
32 struct symbol;
33 #endif
34
35 #if !defined (TARGET_BYTE_ORDER)
36 #define TARGET_BYTE_ORDER LITTLE_ENDIAN
37 #endif
38
39 /* Redefine some target bit sizes from the default. */
40
41 #define TARGET_LONG_BIT 64
42 #define TARGET_LONG_LONG_BIT 64
43 #define TARGET_PTR_BIT 64
44
45 /* Floating point is IEEE compliant */
46 #define IEEE_FLOAT
47
48 /* Number of traps that happen between exec'ing the shell
49 * to run an inferior, and when we finally get to
50 * the inferior code. This is 2 on most implementations.
51 */
52 #define START_INFERIOR_TRAPS_EXPECTED 3
53
54 /* Offset from address of function to start of its code.
55 Zero on most machines. */
56
57 #define FUNCTION_START_OFFSET 0
58
59 /* Advance PC across any function entry prologue instructions
60 to reach some "real" code. */
61
62 #define SKIP_PROLOGUE(pc) pc = alpha_skip_prologue(pc, 0)
63 extern CORE_ADDR alpha_skip_prologue PARAMS ((CORE_ADDR addr, int lenient));
64
65 /* Immediately after a function call, return the saved pc.
66 Can't always go through the frames for this because on some machines
67 the new frame is not set up until the new function executes
68 some instructions. */
69
70 #define SAVED_PC_AFTER_CALL(frame) alpha_saved_pc_after_call(frame)
71 extern CORE_ADDR
72 alpha_saved_pc_after_call PARAMS ((struct frame_info *));
73
74 /* Are we currently handling a signal ? */
75
76 #define IN_SIGTRAMP(pc, name) ((name) && STREQ ("__sigtramp", (name)))
77
78 /* Stack grows downward. */
79
80 #define INNER_THAN(lhs,rhs) ((lhs) < (rhs))
81
82 #define BREAKPOINT {0x80, 0, 0, 0} /* call_pal bpt */
83
84 /* Amount PC must be decremented by after a breakpoint.
85 This is often the number of bytes in BREAKPOINT
86 but not always. */
87
88 #ifndef DECR_PC_AFTER_BREAK
89 #define DECR_PC_AFTER_BREAK 4
90 #endif
91
92 /* Say how long (ordinary) registers are. This is a piece of bogosity
93 used in push_word and a few other places; REGISTER_RAW_SIZE is the
94 real way to know how big a register is. */
95
96 #define REGISTER_SIZE 8
97
98 /* Number of machine registers */
99
100 #define NUM_REGS 66
101
102 /* Initializer for an array of names of registers.
103 There should be NUM_REGS strings in this initializer. */
104
105 #define REGISTER_NAMES \
106 { "v0", "t0", "t1", "t2", "t3", "t4", "t5", "t6", \
107 "t7", "s0", "s1", "s2", "s3", "s4", "s5", "fp", \
108 "a0", "a1", "a2", "a3", "a4", "a5", "t8", "t9", \
109 "t10", "t11", "ra", "t12", "at", "gp", "sp", "zero", \
110 "f0", "f1", "f2", "f3", "f4", "f5", "f6", "f7", \
111 "f8", "f9", "f10", "f11", "f12", "f13", "f14", "f15", \
112 "f16", "f17", "f18", "f19", "f20", "f21", "f22", "f23",\
113 "f24", "f25", "f26", "f27", "f28", "f29", "f30", "f31",\
114 "pc", "vfp", \
115 }
116
117 /* Register numbers of various important registers.
118 Note that most of these values are "real" register numbers,
119 and correspond to the general registers of the machine,
120 and FP_REGNUM is a "phony" register number which is too large
121 to be an actual register number as far as the user is concerned
122 but serves to get the desired value when passed to read_register. */
123
124 #define V0_REGNUM 0 /* Function integer return value */
125 #define T7_REGNUM 8 /* Return address register for OSF/1 __add* */
126 #define GCC_FP_REGNUM 15 /* Used by gcc as frame register */
127 #define A0_REGNUM 16 /* Loc of first arg during a subr call */
128 #define T9_REGNUM 23 /* Return address register for OSF/1 __div* */
129 #define T12_REGNUM 27 /* Contains start addr of current proc */
130 #define SP_REGNUM 30 /* Contains address of top of stack */
131 #define RA_REGNUM 26 /* Contains return address value */
132 #define ZERO_REGNUM 31 /* Read-only register, always 0 */
133 #define FP0_REGNUM 32 /* Floating point register 0 */
134 #define FPA0_REGNUM 48 /* First float arg during a subr call */
135 #define PC_REGNUM 64 /* Contains program counter */
136 #define FP_REGNUM 65 /* Virtual frame pointer */
137
138 #define CANNOT_FETCH_REGISTER(regno) \
139 ((regno) == FP_REGNUM || (regno) == ZERO_REGNUM)
140 #define CANNOT_STORE_REGISTER(regno) \
141 ((regno) == FP_REGNUM || (regno) == ZERO_REGNUM)
142
143 /* Total amount of space needed to store our copies of the machine's
144 register state, the array `registers'. */
145 #define REGISTER_BYTES (NUM_REGS * 8)
146
147 /* Index within `registers' of the first byte of the space for
148 register N. */
149
150 #define REGISTER_BYTE(N) ((N) * 8)
151
152 /* Number of bytes of storage in the actual machine representation
153 for register N. On Alphas, all regs are 8 bytes. */
154
155 #define REGISTER_RAW_SIZE(N) 8
156
157 /* Number of bytes of storage in the program's representation
158 for register N. On Alphas, all regs are 8 bytes. */
159
160 #define REGISTER_VIRTUAL_SIZE(N) 8
161
162 /* Largest value REGISTER_RAW_SIZE can have. */
163
164 #define MAX_REGISTER_RAW_SIZE 8
165
166 /* Largest value REGISTER_VIRTUAL_SIZE can have. */
167
168 #define MAX_REGISTER_VIRTUAL_SIZE 8
169
170 /* Nonzero if register N requires conversion
171 from raw format to virtual format.
172 The alpha needs a conversion between register and memory format if
173 the register is a floating point register and
174 memory format is float, as the register format must be double
175 or
176 memory format is an integer with 4 bytes or less, as the representation
177 of integers in floating point registers is different. */
178
179 #define REGISTER_CONVERTIBLE(N) ((N) >= FP0_REGNUM && (N) < FP0_REGNUM + 32)
180
181 /* Convert data from raw format for register REGNUM in buffer FROM
182 to virtual format with type TYPE in buffer TO. */
183
184 #define REGISTER_CONVERT_TO_VIRTUAL(REGNUM, TYPE, FROM, TO) \
185 alpha_register_convert_to_virtual (REGNUM, TYPE, FROM, TO)
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 \f
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) (CORE_ADDR) alpha_frame_chain (thisframe)
249 extern CORE_ADDR alpha_frame_chain PARAMS ((struct frame_info *));
250
251 /* Define other aspects of the stack frame. */
252
253
254 /* A macro that tells us whether the function invocation represented
255 by FI does not have a frame on the stack associated with it. If it
256 does not, FRAMELESS is set to 1, else 0. */
257 /* We handle this differently for alpha, and maybe we should not */
258
259 #define FRAMELESS_FUNCTION_INVOCATION(FI, FRAMELESS) {(FRAMELESS) = 0;}
260
261 /* Saved Pc. */
262
263 #define FRAME_SAVED_PC(FRAME) (alpha_frame_saved_pc(FRAME))
264 extern CORE_ADDR
265 alpha_frame_saved_pc PARAMS ((struct frame_info *));
266
267 /* The alpha has two different virtual pointers for arguments and locals.
268
269 The virtual argument pointer is pointing to the bottom of the argument
270 transfer area, which is located immediately below the virtual frame
271 pointer. Its size is fixed for the native compiler, it is either zero
272 (for the no arguments case) or large enough to hold all argument registers.
273 gcc uses a variable sized argument transfer area. As it has
274 to stay compatible with the native debugging tools it has to use the same
275 virtual argument pointer and adjust the argument offsets accordingly.
276
277 The virtual local pointer is localoff bytes below the virtual frame
278 pointer, the value of localoff is obtained from the PDR. */
279
280 #define ALPHA_NUM_ARG_REGS 6
281
282 #define FRAME_ARGS_ADDRESS(fi) ((fi)->frame - (ALPHA_NUM_ARG_REGS * 8))
283
284 #define FRAME_LOCALS_ADDRESS(fi) ((fi)->frame - (fi)->localoff)
285
286 /* Return number of args passed to a frame.
287 Can return -1, meaning no way to tell. */
288
289 #define FRAME_NUM_ARGS(num, fi) ((num) = -1)
290
291 /* Return number of bytes at start of arglist that are not really args. */
292
293 #define FRAME_ARGS_SKIP 0
294
295 /* Put here the code to store, into a struct frame_saved_regs,
296 the addresses of the saved registers of frame described by FRAME_INFO.
297 This includes special registers such as pc and fp saved in special
298 ways in the stack frame. sp is even more special:
299 the address we return for it IS the sp for the next frame. */
300
301 extern void alpha_find_saved_regs PARAMS ((struct frame_info *));
302
303 #define FRAME_INIT_SAVED_REGS(frame_info) \
304 do { \
305 if ((frame_info)->saved_regs == NULL) \
306 alpha_find_saved_regs (frame_info); \
307 (frame_info)->saved_regs[SP_REGNUM] = (frame_info)->frame; \
308 } while (0)
309
310 \f
311 /* Things needed for making the inferior call functions. */
312
313 #define PUSH_ARGUMENTS(nargs, args, sp, struct_return, struct_addr) \
314 sp = alpha_push_arguments((nargs), (args), (sp), (struct_return), (struct_addr))
315 extern CORE_ADDR
316 alpha_push_arguments PARAMS ((int, struct value **, CORE_ADDR, int, CORE_ADDR));
317
318 /* Push an empty stack frame, to record the current PC, etc. */
319
320 #define PUSH_DUMMY_FRAME alpha_push_dummy_frame()
321 extern void
322 alpha_push_dummy_frame PARAMS ((void));
323
324 /* Discard from the stack the innermost frame, restoring all registers. */
325
326 #define POP_FRAME alpha_pop_frame()
327 extern void
328 alpha_pop_frame PARAMS ((void));
329
330 /* Alpha OSF/1 inhibits execution of code on the stack.
331 But there is no need for a dummy on the alpha. PUSH_ARGUMENTS
332 takes care of all argument handling and bp_call_dummy takes care
333 of stopping the dummy. */
334
335 #define CALL_DUMMY_LOCATION AT_ENTRY_POINT
336
337 /* On the Alpha the call dummy code is never copied to user space,
338 stopping the user call is achieved via a bp_call_dummy breakpoint.
339 But we need a fake CALL_DUMMY definition to enable the proper
340 call_function_by_hand and to avoid zero length array warnings
341 in valops.c */
342
343 #define CALL_DUMMY { 0 } /* Content doesn't matter. */
344
345 #define CALL_DUMMY_START_OFFSET (0)
346
347 #define CALL_DUMMY_BREAKPOINT_OFFSET (0)
348
349 extern CORE_ADDR alpha_call_dummy_address PARAMS ((void));
350 #define CALL_DUMMY_ADDRESS() alpha_call_dummy_address()
351
352 /* Insert the specified number of args and function address
353 into a call sequence of the above form stored at DUMMYNAME.
354 We only have to set RA_REGNUM to the dummy breakpoint address
355 and T12_REGNUM (the `procedure value register') to the function address. */
356
357 #define FIX_CALL_DUMMY(dummyname, pc, fun, nargs, args, type, gcc_p) \
358 { \
359 CORE_ADDR bp_address = CALL_DUMMY_ADDRESS (); \
360 if (bp_address == 0) \
361 error ("no place to put call"); \
362 write_register (RA_REGNUM, bp_address); \
363 write_register (T12_REGNUM, fun); \
364 }
365
366 /* There's a mess in stack frame creation. See comments in blockframe.c
367 near reference to INIT_FRAME_PC_FIRST. */
368
369 #define INIT_FRAME_PC(fromleaf, prev) /* nada */
370
371 #define INIT_FRAME_PC_FIRST(fromleaf, prev) \
372 (prev)->pc = ((fromleaf) ? SAVED_PC_AFTER_CALL ((prev)->next) : \
373 (prev)->next ? FRAME_SAVED_PC ((prev)->next) : read_pc ());
374
375 /* Special symbol found in blocks associated with routines. We can hang
376 alpha_extra_func_info_t's off of this. */
377
378 #define MIPS_EFI_SYMBOL_NAME "__GDB_EFI_INFO__"
379 extern void ecoff_relocate_efi PARAMS ((struct symbol *, CORE_ADDR));
380
381 /* Specific information about a procedure.
382 This overlays the ALPHA's PDR records,
383 alpharead.c (ab)uses this to save memory */
384
385 typedef struct alpha_extra_func_info {
386 long numargs; /* number of args to procedure (was iopt) */
387 PDR pdr; /* Procedure descriptor record */
388 } *alpha_extra_func_info_t;
389
390 /* Define the extra_func_info that mipsread.c needs.
391 FIXME: We should define our own PDR interface, perhaps in a separate
392 header file. This would get rid of the <bfd.h> inclusion in all sources
393 and would abstract the mips/alpha interface from ecoff. */
394 #define mips_extra_func_info alpha_extra_func_info
395 #define mips_extra_func_info_t alpha_extra_func_info_t
396
397 #define EXTRA_FRAME_INFO \
398 int localoff; \
399 int pc_reg; \
400 alpha_extra_func_info_t proc_desc;
401
402 #define INIT_EXTRA_FRAME_INFO(fromleaf, fci) init_extra_frame_info(fci)
403 extern void
404 init_extra_frame_info PARAMS ((struct frame_info *));
405
406 #define PRINT_EXTRA_FRAME_INFO(fi) \
407 { \
408 if (fi && fi->proc_desc && fi->proc_desc->pdr.framereg < NUM_REGS) \
409 printf_filtered (" frame pointer is at %s+%d\n", \
410 REGISTER_NAME (fi->proc_desc->pdr.framereg), \
411 fi->proc_desc->pdr.frameoffset); \
412 }
413
414 /* It takes two values to specify a frame on the ALPHA. Sigh.
415
416 In fact, at the moment, the *PC* is the primary value that sets up
417 a frame. The PC is looked up to see what function it's in; symbol
418 information from that function tells us which register is the frame
419 pointer base, and what offset from there is the "virtual frame pointer".
420 (This is usually an offset from SP.) FIXME -- this should be cleaned
421 up so that the primary value is the SP, and the PC is used to disambiguate
422 multiple functions with the same SP that are at different stack levels. */
423
424 #define SETUP_ARBITRARY_FRAME(argc, argv) setup_arbitrary_frame (argc, argv)
425 extern struct frame_info *setup_arbitrary_frame PARAMS ((int, CORE_ADDR *));
426
427 /* This is used by heuristic_proc_start. It should be shot it the head. */
428 #ifndef VM_MIN_ADDRESS
429 #define VM_MIN_ADDRESS (CORE_ADDR)0x120000000
430 #endif
431
432 /* If PC is in a shared library trampoline code, return the PC
433 where the function itself actually starts. If not, return 0. */
434 #define SKIP_TRAMPOLINE_CODE(pc) find_solib_trampoline_target (pc)
435
436 /* If the current gcc for for this target does not produce correct debugging
437 information for float parameters, both prototyped and unprototyped, then
438 define this macro. This forces gdb to always assume that floats are
439 passed as doubles and then converted in the callee.
440
441 For the alpha, it appears that the debug info marks the parameters as
442 floats regardless of whether the function is prototyped, but the actual
443 values are always passed in as doubles. Thus by setting this to 1, both
444 types of calls will work. */
445
446 #define COERCE_FLOAT_TO_DOUBLE 1
447
448 /* Return TRUE if procedure descriptor PROC is a procedure descriptor
449 that refers to a dynamically generated sigtramp function.
450
451 OSF/1 doesn't use dynamic sigtramp functions, so this is always
452 FALSE. */
453
454 #define PROC_DESC_IS_DYN_SIGTRAMP(proc) (0)
455 #define SET_PROC_DESC_IS_DYN_SIGTRAMP(proc)
456
457 /* If PC is inside a dynamically generated sigtramp function, return
458 how many bytes the program counter is beyond the start of that
459 function. Otherwise, return a negative value.
460
461 OSF/1 doesn't use dynamic sigtramp functions, so this always
462 returns -1. */
463
464 #define DYNAMIC_SIGTRAMP_OFFSET(pc) (-1)
465
466 /* Translate a signal handler frame into the address of the sigcontext
467 structure. */
468
469 #define SIGCONTEXT_ADDR(frame) \
470 (read_memory_integer ((frame)->next ? frame->next->frame : frame->frame, 8))
471
472 /* If FRAME refers to a sigtramp frame, return the address of the next
473 frame. */
474
475 #define FRAME_PAST_SIGTRAMP_FRAME(frame, pc) \
476 (alpha_osf_skip_sigtramp_frame (frame, pc))
477 extern CORE_ADDR alpha_osf_skip_sigtramp_frame PARAMS ((struct frame_info *, CORE_ADDR));
478
479 #endif /* TM_ALPHA_H */