xref: /netbsd-src/sys/arch/sparc/include/frame.h (revision f08a540ec9e2a44cd490aa22095270eb60f49a9b)
1 /*	$NetBSD: frame.h,v 1.11 2022/02/15 20:35:37 palle Exp $ */
2 
3 /*
4  * Copyright (c) 1992, 1993
5  *	The Regents of the University of California.  All rights reserved.
6  *
7  * This software was developed by the Computer Systems Engineering group
8  * at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
9  * contributed to Berkeley.
10  *
11  * All advertising materials mentioning features or use of this software
12  * must display the following acknowledgement:
13  *	This product includes software developed by the University of
14  *	California, Lawrence Berkeley Laboratory.
15  *
16  * Redistribution and use in source and binary forms, with or without
17  * modification, are permitted provided that the following conditions
18  * are met:
19  * 1. Redistributions of source code must retain the above copyright
20  *    notice, this list of conditions and the following disclaimer.
21  * 2. Redistributions in binary form must reproduce the above copyright
22  *    notice, this list of conditions and the following disclaimer in the
23  *    documentation and/or other materials provided with the distribution.
24  * 3. Neither the name of the University nor the names of its contributors
25  *    may be used to endorse or promote products derived from this software
26  *    without specific prior written permission.
27  *
28  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
29  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
31  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
32  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
33  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
34  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
35  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
37  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38  * SUCH DAMAGE.
39  *
40  *	@(#)frame.h	8.1 (Berkeley) 6/11/93
41  */
42 
43 #ifndef _SPARC_FRAME_H_
44 #define _SPARC_FRAME_H_
45 
46 #if defined(_KERNEL_OPT)
47 #include "opt_sparc_arch.h"
48 #endif
49 
50 /*
51  * Sparc stack frame format.
52  *
53  * Note that the contents of each stack frame may be held only in
54  * machine register windows.  In order to get an accurate picture
55  * of the frame, you must first force the kernel to write any such
56  * windows to the stack.
57  */
58 #ifndef _LOCORE
59 #ifndef __sparc_v9__
60 struct frame {
61 	int32_t	fr_local[8];	/* space to save locals (%l0..%l7) */
62 	int32_t	fr_arg[6];	/* space to save arguments (%i0..%i5) */
63 	struct	frame *fr_fp;	/* space to save frame pointer (%i6) */
64 	int32_t	fr_pc;		/* space to save return pc (%i7) */
65 	/*
66 	 * SunOS reserves another 8 words here; this is pointless
67 	 * but we do it for compatibility.
68 	 */
69 	int32_t	fr_xxx;		/* `structure return pointer' (unused) */
70 	int32_t	fr_argd[6];	/* `arg dump area' (lunacy) */
71 	int32_t	fr_argx[1];	/* arg extension (args 7..n; variable size) */
72 };
73 #else
74 struct frame32 {
75 	int32_t	fr_local[8];	/* space to save locals (%l0..%l7) */
76 	int32_t	fr_arg[6];	/* space to save arguments (%i0..%i5) */
77 	uint32_t	fr_fp;	/* space to save frame pointer (%i6) */
78 	uint32_t	fr_pc;	/* space to save return pc (%i7) */
79 	/*
80 	 * SunOS reserves another 8 words here; this is pointless
81 	 * but we do it for compatibility.
82 	 */
83 	int32_t	fr_xxx;		/* `structure return pointer' (unused) */
84 	int32_t	fr_argd[6];	/* `arg dump area' (lunacy) */
85 	int32_t	fr_argx[1];	/* arg extension (args 7..n; variable size) */
86 };
87 #endif
88 #endif
89 
90 /*
91  * CCFSZ (C Compiler Frame SiZe) is the size of a stack frame required if
92  * a function is to call C code.  It should be just 64, but Sun defined
93  * their frame with space to hold arguments 0 through 5 (plus some junk),
94  * and varargs routines (such as kprintf) demand this, and gcc uses this
95  * area at times anyway.
96  */
97 #define CCFSZ		96
98 
99 /*
100  * Sparc v9 stack frame format.
101  *
102  * Note that the contents of each stack frame may be held only in
103  * machine register windows.  In order to get an accurate picture
104  * of the frame, you must first force the kernel to write any such
105  * windows to the stack.
106  *
107  * V9 frames have an odd bias, so you can tell a v9 frame from
108  * a v8 frame by testing the stack pointer's lsb.
109  */
110 #if !defined(_LOCORE) && !defined(_LIBC)
111 struct frame64 {
112 	int64_t	fr_local[8];	/* space to save locals (%l0..%l7) */
113 	int64_t	fr_arg[6];	/* space to save arguments (%i0..%i5) */
114 	uint64_t	fr_fp;		/* space to save frame pointer (%i6) */
115 	uint64_t	fr_pc;		/* space to save return pc (%i7) */
116 	/*
117 	 * SVR4 reserves a bunch of extra stuff.
118 	 */
119 	int64_t fr_argd[6];	/* `register save area' (lunacy) */
120 	int64_t	fr_argx[0];	/* arg extension (args 7..n; variable size) */
121 };
122 
123 #define v9next_frame(f)		((struct frame64*)(f->fr_fp+BIAS))
124 #endif
125 
126 /*
127  * CC64FSZ (C Compiler 64-bit Frame SiZe) is the size of a stack frame used
128  * by the compiler in 64-bit mode (see struct frame64 above).
129  * It is 8*8 + 6*8 + 8 + 8 + 6*8 + 0*8 = 176 bytes.
130  */
131 #define CC64FSZ		176
132 
133 /*
134  * v9 stacks all have a bias of 2047 added to the %sp and %fp, so you can easily
135  * detect it by testing the register for an odd value.  Why 2K-1 I don't know.
136  */
137 #define BIAS	(2048-1)
138 
139 #endif /* _SPARC_FRAME_H_ */
140