xref: /netbsd-src/sys/arch/sparc/include/cpu.h (revision df0caa2637da0538ecdf6b878c4d08e684b43d8f)
1 /*	$NetBSD: cpu.h,v 1.72 2005/06/16 04:17:49 briggs 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  *	@(#)cpu.h	8.4 (Berkeley) 1/5/94
41  */
42 
43 #ifndef _CPU_H_
44 #define _CPU_H_
45 
46 /*
47  * CTL_MACHDEP definitions.
48  */
49 #define	CPU_BOOTED_KERNEL	1	/* string: booted kernel name */
50 #define	CPU_BOOTED_DEVICE	2	/* string: device booted from */
51 #define	CPU_BOOT_ARGS		3	/* string: args booted with */
52 #define	CPU_ARCH		4	/* integer: cpu architecture version */
53 #define	CPU_MAXID		5	/* number of valid machdep ids */
54 
55 #define	CTL_MACHDEP_NAMES {			\
56 	{ 0, 0 },				\
57 	{ "booted_kernel", CTLTYPE_STRING },	\
58 	{ "booted_device", CTLTYPE_STRING },	\
59 	{ "boot_args", CTLTYPE_STRING },	\
60 	{ "cpu_arch", CTLTYPE_INT },		\
61 }
62 
63 #ifdef _KERNEL
64 /*
65  * Exported definitions unique to SPARC cpu support.
66  */
67 
68 #if defined(_KERNEL_OPT)
69 #include "opt_multiprocessor.h"
70 #include "opt_lockdebug.h"
71 #include "opt_sparc_arch.h"
72 #endif
73 
74 #include <machine/intr.h>
75 #include <machine/psl.h>
76 #include <sparc/sparc/cpuvar.h>
77 #include <sparc/sparc/intreg.h>
78 
79 /*
80  * definitions of cpu-dependent requirements
81  * referenced in generic code
82  */
83 #define	curcpu()		(cpuinfo.ci_self)
84 #define	curlwp			(cpuinfo.ci_curlwp)
85 #define	CPU_IS_PRIMARY(ci)	((ci)->master)
86 
87 #define	cpu_swapin(p)		/* nothing */
88 #define	cpu_swapout(p)		/* nothing */
89 #define	cpu_number()		(cpuinfo.ci_cpuid)
90 #define	cpu_proc_fork(p1, p2)	/* nothing */
91 
92 #if defined(MULTIPROCESSOR)
93 void	cpu_boot_secondary_processors __P((void));
94 #endif
95 
96 /*
97  * Arguments to hardclock, softclock and statclock encapsulate the
98  * previous machine state in an opaque clockframe.  The ipl is here
99  * as well for strayintr (see locore.s:interrupt and intr.c:strayintr).
100  * Note that CLKF_INTR is valid only if CLKF_USERMODE is false.
101  */
102 struct clockframe {
103 	u_int	psr;		/* psr before interrupt, excluding PSR_ET */
104 	u_int	pc;		/* pc at interrupt */
105 	u_int	npc;		/* npc at interrupt */
106 	u_int	ipl;		/* actual interrupt priority level */
107 	u_int	fp;		/* %fp at interrupt */
108 };
109 typedef struct clockframe clockframe;
110 
111 extern int eintstack[];
112 
113 #define	CLKF_USERMODE(framep)	(((framep)->psr & PSR_PS) == 0)
114 #define	CLKF_BASEPRI(framep)	(((framep)->psr & PSR_PIL) == 0)
115 #define	CLKF_LOPRI(framep,n)	(((framep)->psr & PSR_PIL) < (n) << 8)
116 #define	CLKF_PC(framep)		((framep)->pc)
117 #if defined(MULTIPROCESSOR)
118 #define	CLKF_INTR(framep)						\
119 	((framep)->fp > (u_int)cpuinfo.eintstack - INT_STACK_SIZE &&	\
120 	 (framep)->fp < (u_int)cpuinfo.eintstack)
121 #else
122 #define	CLKF_INTR(framep)	((framep)->fp < (u_int)eintstack)
123 #endif
124 
125 void	softintr_init __P((void));
126 void	*softnet_cookie;
127 
128 #define setsoftnet()	softintr_schedule(softnet_cookie);
129 
130 /*
131  * Preempt the current process on the target CPU if in interrupt from
132  * user mode, or after the current trap/syscall if in system mode.
133  */
134 #define need_resched(ci) do {						\
135 	(ci)->want_resched = 1;						\
136 	(ci)->want_ast = 1;						\
137 									\
138 	/* Just interrupt the target CPU, so it can notice its AST */	\
139 	if ((ci)->ci_cpuid != cpu_number())				\
140 		XCALL0(sparc_noop, 1U << (ci)->ci_cpuid);		\
141 } while(0)
142 
143 /*
144  * Give a profiling tick to the current process when the user profiling
145  * buffer pages are invalid.  On the sparc, request an ast to send us
146  * through trap(), marking the proc as needing a profiling tick.
147  */
148 #define	need_proftick(p)	((p)->p_flag |= P_OWEUPC, cpuinfo.want_ast = 1)
149 
150 /*
151  * Notify the current process (p) that it has a signal pending,
152  * process as soon as possible.
153  */
154 #define	signotify(p)		(cpuinfo.want_ast = 1)
155 
156 /* CPU architecture version */
157 extern int cpu_arch;
158 
159 /* Number of CPUs in the system */
160 extern int sparc_ncpus;
161 
162 /*
163  * Interrupt handler chains.  Interrupt handlers should return 0 for
164  * ``not me'' or 1 (``I took care of it'').  intr_establish() inserts a
165  * handler into the list.  The handler is called with its (single)
166  * argument, or with a pointer to a clockframe if ih_arg is NULL.
167  */
168 extern struct intrhand {
169 	int	(*ih_fun)(void *);
170 	void	*ih_arg;
171 	struct	intrhand *ih_next;
172 	int	ih_classipl;
173 } *intrhand[15];
174 
175 void	intr_establish(int level, int classipl, struct intrhand *,
176 			void (*fastvec)(void));
177 void	intr_disestablish(int level, struct intrhand *);
178 
179 void	intr_lock_kernel(void);
180 void	intr_unlock_kernel(void);
181 
182 /* disksubr.c */
183 struct dkbad;
184 int isbad(struct dkbad *bt, int, int, int);
185 /* machdep.c */
186 int	ldcontrolb(caddr_t);
187 void	dumpconf(void);
188 caddr_t	reserve_dumppages(caddr_t);
189 /* clock.c */
190 struct timeval;
191 void	lo_microtime(struct timeval *);
192 void	schedintr(void *);
193 /* locore.s */
194 struct fpstate;
195 void	savefpstate(struct fpstate *);
196 void	loadfpstate(struct fpstate *);
197 int	probeget(caddr_t, int);
198 void	write_all_windows(void);
199 void	write_user_windows(void);
200 void 	proc_trampoline(void);
201 struct pcb;
202 void	snapshot(struct pcb *);
203 struct frame *getfp(void);
204 int	xldcontrolb(caddr_t, struct pcb *);
205 void	copywords(const void *, void *, size_t);
206 void	qcopy(const void *, void *, size_t);
207 void	qzero(void *, size_t);
208 /* trap.c */
209 void	kill_user_windows(struct lwp *);
210 int	rwindow_save(struct lwp *);
211 /* cons.c */
212 int	cnrom(void);
213 /* zs.c */
214 void zsconsole(struct tty *, int, int, void (**)(struct tty *, int));
215 #ifdef KGDB
216 void zs_kgdb_init(void);
217 #endif
218 /* fb.c */
219 void	fb_unblank(void);
220 /* kgdb_stub.c */
221 #ifdef KGDB
222 void kgdb_attach(int (*)(void *), void (*)(void *, int), void *);
223 void kgdb_connect(int);
224 void kgdb_panic(void);
225 #endif
226 /* emul.c */
227 struct trapframe;
228 int fixalign(struct lwp *, struct trapframe *);
229 int emulinstr(int, struct trapframe *);
230 /* cpu.c */
231 void mp_pause_cpus(void);
232 void mp_resume_cpus(void);
233 void mp_halt_cpus(void);
234 #ifdef DDB
235 void mp_pause_cpus_ddb(void);
236 void mp_resume_cpus_ddb(void);
237 #endif
238 /* msiiep.c */
239 void msiiep_swap_endian(int);
240 /* intr.c */
241 u_int setitr(u_int);
242 u_int getitr(void);
243 
244 /*
245  *
246  * The SPARC has a Trap Base Register (TBR) which holds the upper 20 bits
247  * of the trap vector table.  The next eight bits are supplied by the
248  * hardware when the trap occurs, and the bottom four bits are always
249  * zero (so that we can shove up to 16 bytes of executable code---exactly
250  * four instructions---into each trap vector).
251  *
252  * The hardware allocates half the trap vectors to hardware and half to
253  * software.
254  *
255  * Traps have priorities assigned (lower number => higher priority).
256  */
257 
258 struct trapvec {
259 	int	tv_instr[4];		/* the four instructions */
260 };
261 extern struct trapvec *trapbase;	/* the 256 vectors */
262 
263 extern void wzero __P((void *, u_int));
264 extern void wcopy __P((const void *, void *, u_int));
265 
266 #endif /* _KERNEL */
267 #endif /* _CPU_H_ */
268