[apple/xnu.git] / EXTERNAL_HEADERS / architecture / ppc / reg_help.h

/*
 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 * 
 * The contents of this file constitute Original Code as defined in and
 * are subject to the Apple Public Source License Version 1.1 (the
 * "License").  You may not use this file except in compliance with the
 * License.  Please obtain a copy of the License at
 * http://www.apple.com/publicsource and read it before using this file.
 * 
 * This Original Code and all software distributed under the License are
 * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
 * License for the specific language governing rights and limitations
 * under the License.
 * 
 * @APPLE_LICENSE_HEADER_END@
 */
/* Copyright (c) 1996 NeXT Software, Inc.  All rights reserved.
 *
 *	File:	architecture/ppc/reg_help.h
 *	Author:	Doug Mitchell, NeXT Computer, Inc.
 *
 *	m98k-specific macros and inlines for defining machine registers.
 *
 * HISTORY
 * 05-Nov-92  Doug Mitchell at NeXT
 *	Created.
 *
 * 29-Dec-96  Umesh Vaishampayan  (umeshv@NeXT.com)
 *	Ported from m98k. Removed dependency on nrw directory.
 *	Merged code from architecture/nrw/reg_help.h.
 *	Moved Register Usage #defines from asm_help.h in here.
 */

#ifndef _ARCH_PPC_REG_HELP_H_
#define _ARCH_PPC_REG_HELP_H_

#if defined(__ASSEMBLER__)
/*
 * GRF Register Usage Aliases
 */
#define	zt		r0		// architecturally 0 for mem refs only!
					// real reg other inst, caller-saved
#define	sp		r1		// stack pointer, callee-saved
#define	toc		r2		// tbl of contents, callee-saved
#define	a0		r3		// arg 0, return value 0, caller saved
#define	a1		r4		// arg 1, return value 1, caller saved
#define	a2		r5		// ....
#define	a3		r6
#define	a4		r7
#define	a5		r8
#define	a6		r9
#define	a7		r10		// arg 7, return value 7, caller saved
#define	ep		r11		// environment ptr, caller saved
#define	at		r12		// assembler temp, caller saved
#define	s17		r13		// callee-saved 17
#define	s16		r14
#define	s15		r15
#define	s14		r16
#define	s13		r17
#define	s12		r18
#define	s11		r19
#define	s10		r20
#define	s9		r21
#define	s8		r22
#define	s7		r23
#define	s6		r24
#define	s5		r25
#define	s4		r26
#define	s3		r27
#define	s2		r28
#define	s1		r29		// ....
#define	s0		r30		// callee-saved 0
#define	fp		r31		// frame-pointer, callee-saved

/*
 * Conversion of GRF aliases to register numbers
 */
#define	GRF_ZT		0		// architecturally 0 for mem refs only!
					// real reg other inst, caller-saved
#define	GRF_SP		1		// stack pointer, callee-saved
#define	GRF_TOC		2		// tbl of contents, callee-saved
#define	GRF_A0		3		// arg 0, return value 0, caller saved
#define	GRF_A1		4		// arg 1, return value 1, caller saved
#define	GRF_A2		5		// ....
#define	GRF_A3		6
#define	GRF_A4		7
#define	GRF_A5		8
#define	GRF_A6		9
#define	GRF_A7		10		// arg 7, return value 7, caller saved
#define	GRF_EP		11		// environment ptr, caller saved
#define	GRF_AT		12		// assembler temp, caller saved
#define	GRF_S17		13		// callee-saved 17
#define	GRF_S16		14
#define	GRF_S15		15
#define	GRF_S14		16
#define	GRF_S13		17
#define	GRF_S12		18
#define	GRF_S11		19
#define	GRF_S10		20
#define	GRF_S9		21
#define	GRF_S8		22
#define	GRF_S7		23
#define	GRF_S6		24
#define	GRF_S5		25
#define	GRF_S4		26
#define	GRF_S3		27
#define	GRF_S2		28
#define	GRF_S1		29		// ....
#define	GRF_S0		30		// callee-saved 0
#define	GRF_FP		31		// frame pointer, callee-saved

/*
 * FPF Register names
 */
#define	ft0		f0		// scratch reg, caller-saved
#define	fa0		f1		// fp arg 0, return 0, caller-saved
#define	fa1		f2		// fp arg 1, caller-saved
#define	fa2		f3		// fp arg 2, caller-saved
#define	fa3		f4
#define	fa4		f5
#define	fa5		f6
#define	fa6		f7
#define	fa7		f8
#define	fa8		f9
#define	fa9		f10
#define	fa10		f11
#define	fa11		f12
#define	fa12		f13		// fp arg 12, caller-saved
#define	fs17		f14		// callee-saved 17
#define	fs16		f15
#define	fs15		f16
#define	fs14		f17
#define	fs13		f18
#define	fs12		f19
#define	fs11		f20
#define	fs10		f21
#define	fs9		f22
#define	fs8		f23
#define	fs7		f24
#define	fs6		f25
#define	fs5		f26
#define	fs4		f27
#define	fs3		f28
#define	fs2		f29
#define	fs1		f30
#define	fs0		f31		// callee-saved 0

/*
 * Conversion of FPF aliases to register numbers
 */
#define	FPF_FT0		0		// scratch reg, caller-saved
#define	FPF_FA0		1		// fp arg 0, return 0, caller-saved
#define	FPF_FA1		2		// fp arg 1, caller-saved
#define	FPF_FA2		3		// fp arg 2, caller-saved
#define	FPF_FA3		4
#define	FPF_FA4		5
#define	FPF_FA5		6
#define	FPF_FA6		7
#define	FPF_FA7		8
#define	FPF_FA8		9
#define	FPF_FA9		10
#define	FPF_FA10	11
#define	FPF_FA11	12
#define	FPF_FA12	13		// fp arg 12, caller-saved
#define	FPF_FS17	14		// callee-saved 17
#define	FPF_FS16	15
#define	FPF_FS15	16
#define	FPF_FS14	17
#define	FPF_FS13	18
#define	FPF_FS12	19
#define	FPF_FS11	20
#define	FPF_FS10	21
#define	FPF_FS9		22
#define	FPF_FS8		23
#define	FPF_FS7		24
#define	FPF_FS6		25
#define	FPF_FS5		26
#define	FPF_FS4		27
#define	FPF_FS3		28
#define	FPF_FS2		29
#define	FPF_FS1		30
#define	FPF_FS0		31		// callee-saved 0

#endif	/* __ASSEMBLER__ */


/* Bitfield definition aid */
#define	BITS_WIDTH(msb, lsb)	((msb)-(lsb)+1)
#define	BIT_WIDTH(pos)		(1)	/* mostly to record the position */

/* Mask creation */
#define	MKMASK(width, offset)	(((unsigned)-1)>>(32-(width))<<(offset))
#define	BITSMASK(msb, lsb)	MKMASK(BITS_WIDTH(msb, lsb), lsb & 0x1f)
#define	BITMASK(pos)		MKMASK(BIT_WIDTH(pos), pos & 0x1f)

/* Register addresses */
#if	__ASSEMBLER__
# define	REG_ADDR(type, addr)	(addr)
#else	/* ! __ASSEMBLER__ */
# define	REG_ADDR(type, addr)	(*(volatile type *)(addr))
#endif	/* __ASSEMBLER__ */

/* Cast a register to be an unsigned */
/* CAUTION :	non naturally aligned foo can result into alignment traps
 *		use at own risk.
 */
#define	CONTENTS(foo)	(*(unsigned *) &(foo))

/* STRINGIFY -- perform all possible substitutions, then stringify */
#define	__STR(x)	#x		/* just a helper macro */
#define	STRINGIFY(x)	__STR(x)

/* 
 * Stack pointer must always be a multiple of 16
 */
#define	STACK_INCR	16
#define	ROUND_FRAME(x)	((((unsigned)(x)) + STACK_INCR - 1) & ~(STACK_INCR-1))

#endif /* _ARCH_PPC_REG_HELP_H_ */
Commit	Line	Data
1c79356b A	1	/*
	2	* Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
37839358 A	6	* The contents of this file constitute Original Code as defined in and
	7	* are subject to the Apple Public Source License Version 1.1 (the
	8	* "License"). You may not use this file except in compliance with the
	9	* License. Please obtain a copy of the License at
	10	* http://www.apple.com/publicsource and read it before using this file.
1c79356b	11	*
37839358 A	12	* This Original Code and all software distributed under the License are
37839358 A	13	* distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
1c79356b A	14	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
1c79356b A	15	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
37839358 A	16	* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
	17	* License for the specific language governing rights and limitations
	18	* under the License.
1c79356b A	19	*
	20	* @APPLE_LICENSE_HEADER_END@
	21	*/
	22	/* Copyright (c) 1996 NeXT Software, Inc. All rights reserved.
	23	*
	24	* File: architecture/ppc/reg_help.h
	25	* Author: Doug Mitchell, NeXT Computer, Inc.
	26	*
	27	* m98k-specific macros and inlines for defining machine registers.
	28	*
	29	* HISTORY
	30	* 05-Nov-92 Doug Mitchell at NeXT
	31	* Created.
	32	*
	33	* 29-Dec-96 Umesh Vaishampayan (umeshv@NeXT.com)
	34	* Ported from m98k. Removed dependency on nrw directory.
	35	* Merged code from architecture/nrw/reg_help.h.
	36	* Moved Register Usage #defines from asm_help.h in here.
	37	*/
	38
	39	#ifndef _ARCH_PPC_REG_HELP_H_
	40	#define _ARCH_PPC_REG_HELP_H_
	41
	42	#if defined(__ASSEMBLER__)
	43	/*
	44	* GRF Register Usage Aliases
	45	*/
	46	#define zt r0 // architecturally 0 for mem refs only!
	47	// real reg other inst, caller-saved
	48	#define sp r1 // stack pointer, callee-saved
	49	#define toc r2 // tbl of contents, callee-saved
	50	#define a0 r3 // arg 0, return value 0, caller saved
	51	#define a1 r4 // arg 1, return value 1, caller saved
	52	#define a2 r5 // ....
	53	#define a3 r6
	54	#define a4 r7
	55	#define a5 r8
	56	#define a6 r9
	57	#define a7 r10 // arg 7, return value 7, caller saved
	58	#define ep r11 // environment ptr, caller saved
	59	#define at r12 // assembler temp, caller saved
	60	#define s17 r13 // callee-saved 17
	61	#define s16 r14
	62	#define s15 r15
	63	#define s14 r16
	64	#define s13 r17
	65	#define s12 r18
	66	#define s11 r19
	67	#define s10 r20
	68	#define s9 r21
	69	#define s8 r22
	70	#define s7 r23
	71	#define s6 r24
	72	#define s5 r25
	73	#define s4 r26
	74	#define s3 r27
	75	#define s2 r28
	76	#define s1 r29 // ....
	77	#define s0 r30 // callee-saved 0
	78	#define fp r31 // frame-pointer, callee-saved
	79
	80	/*
	81	* Conversion of GRF aliases to register numbers
	82	*/
83	#define GRF_ZT 0 // architecturally 0 for mem refs only!
84	// real reg other inst, caller-saved
85	#define GRF_SP 1 // stack pointer, callee-saved
86	#define GRF_TOC 2 // tbl of contents, callee-saved
87	#define GRF_A0 3 // arg 0, return value 0, caller saved
88	#define GRF_A1 4 // arg 1, return value 1, caller saved
89	#define GRF_A2 5 // ....
90	#define GRF_A3 6
91	#define GRF_A4 7
92	#define GRF_A5 8
93	#define GRF_A6 9
94	#define GRF_A7 10 // arg 7, return value 7, caller saved
95	#define GRF_EP 11 // environment ptr, caller saved
96	#define GRF_AT 12 // assembler temp, caller saved
97	#define GRF_S17 13 // callee-saved 17
98	#define GRF_S16 14
99	#define GRF_S15 15
100	#define GRF_S14 16
101	#define GRF_S13 17
102	#define GRF_S12 18
103	#define GRF_S11 19
104	#define GRF_S10 20
105	#define GRF_S9 21
106	#define GRF_S8 22
107	#define GRF_S7 23
108	#define GRF_S6 24
109	#define GRF_S5 25
110	#define GRF_S4 26
111	#define GRF_S3 27
112	#define GRF_S2 28
113	#define GRF_S1 29 // ....
114	#define GRF_S0 30 // callee-saved 0
115	#define GRF_FP 31 // frame pointer, callee-saved
116
117	/*
118	* FPF Register names
119	*/
120	#define ft0 f0 // scratch reg, caller-saved
121	#define fa0 f1 // fp arg 0, return 0, caller-saved
122	#define fa1 f2 // fp arg 1, caller-saved
123	#define fa2 f3 // fp arg 2, caller-saved
124	#define fa3 f4
125	#define fa4 f5
126	#define fa5 f6
127	#define fa6 f7
128	#define fa7 f8
129	#define fa8 f9
130	#define fa9 f10
131	#define fa10 f11
132	#define fa11 f12
133	#define fa12 f13 // fp arg 12, caller-saved
134	#define fs17 f14 // callee-saved 17
135	#define fs16 f15
136	#define fs15 f16
137	#define fs14 f17
138	#define fs13 f18
139	#define fs12 f19
140	#define fs11 f20
141	#define fs10 f21
142	#define fs9 f22
143	#define fs8 f23
144	#define fs7 f24
145	#define fs6 f25
146	#define fs5 f26
147	#define fs4 f27
148	#define fs3 f28
149	#define fs2 f29
150	#define fs1 f30
151	#define fs0 f31 // callee-saved 0
152
153	/*
154	* Conversion of FPF aliases to register numbers
155	*/
156	#define FPF_FT0 0 // scratch reg, caller-saved
157	#define FPF_FA0 1 // fp arg 0, return 0, caller-saved
158	#define FPF_FA1 2 // fp arg 1, caller-saved
159	#define FPF_FA2 3 // fp arg 2, caller-saved
160	#define FPF_FA3 4
161	#define FPF_FA4 5
162	#define FPF_FA5 6
163	#define FPF_FA6 7
164	#define FPF_FA7 8
165	#define FPF_FA8 9
166	#define FPF_FA9 10
167	#define FPF_FA10 11
168	#define FPF_FA11 12
169	#define FPF_FA12 13 // fp arg 12, caller-saved
170	#define FPF_FS17 14 // callee-saved 17
171	#define FPF_FS16 15
172	#define FPF_FS15 16
173	#define FPF_FS14 17
174	#define FPF_FS13 18
175	#define FPF_FS12 19
176	#define FPF_FS11 20
177	#define FPF_FS10 21
178	#define FPF_FS9 22
179	#define FPF_FS8 23
180	#define FPF_FS7 24
181	#define FPF_FS6 25
182	#define FPF_FS5 26
183	#define FPF_FS4 27
184	#define FPF_FS3 28
185	#define FPF_FS2 29
186	#define FPF_FS1 30
187	#define FPF_FS0 31 // callee-saved 0
188
189	#endif /* __ASSEMBLER__ */
190
191
192	/* Bitfield definition aid */
193	#define BITS_WIDTH(msb, lsb) ((msb)-(lsb)+1)
194	#define BIT_WIDTH(pos) (1) /* mostly to record the position */
195
196	/* Mask creation */
197	#define MKMASK(width, offset) (((unsigned)-1)>>(32-(width))<<(offset))
198	#define BITSMASK(msb, lsb) MKMASK(BITS_WIDTH(msb, lsb), lsb & 0x1f)
199	#define BITMASK(pos) MKMASK(BIT_WIDTH(pos), pos & 0x1f)
200
201	/* Register addresses */
202	#if __ASSEMBLER__
203	# define REG_ADDR(type, addr) (addr)
204	#else /* ! __ASSEMBLER__ */
205	# define REG_ADDR(type, addr) ((volatile type )(addr))
206	#endif /* __ASSEMBLER__ */
207
208	/* Cast a register to be an unsigned */
209	/* CAUTION : non naturally aligned foo can result into alignment traps
210	* use at own risk.
211	*/
212	#define CONTENTS(foo) ((unsigned ) &(foo))
213
214	/* STRINGIFY -- perform all possible substitutions, then stringify */
215	#define __STR(x) #x /* just a helper macro */
216	#define STRINGIFY(x) __STR(x)
217
218	/*
219	* Stack pointer must always be a multiple of 16
220	*/
221	#define STACK_INCR 16
222	#define ROUND_FRAME(x) ((((unsigned)(x)) + STACK_INCR - 1) & ~(STACK_INCR-1))
223
224	#endif /* _ARCH_PPC_REG_HELP_H_ */