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