xref: /netbsd-src/sys/arch/i386/include/segments.h (revision e5548b402ae4c44fb816de42c7bba9581ce23ef5)
1 /*	$NetBSD: segments.h,v 1.41 2004/03/05 11:33:27 junyoung Exp $	*/
2 
3 /*-
4  * Copyright (c) 1990 The Regents of the University of California.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to Berkeley by
8  * William Jolitz.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. Neither the name of the University nor the names of its contributors
19  *    may be used to endorse or promote products derived from this software
20  *    without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  *
34  *	@(#)segments.h	7.1 (Berkeley) 5/9/91
35  */
36 
37 /*-
38  * Copyright (c) 1995, 1997
39  *	Charles M. Hannum.  All rights reserved.
40  * Copyright (c) 1989, 1990 William F. Jolitz
41  *
42  * This code is derived from software contributed to Berkeley by
43  * William Jolitz.
44  *
45  * Redistribution and use in source and binary forms, with or without
46  * modification, are permitted provided that the following conditions
47  * are met:
48  * 1. Redistributions of source code must retain the above copyright
49  *    notice, this list of conditions and the following disclaimer.
50  * 2. Redistributions in binary form must reproduce the above copyright
51  *    notice, this list of conditions and the following disclaimer in the
52  *    documentation and/or other materials provided with the distribution.
53  * 3. All advertising materials mentioning features or use of this software
54  *    must display the following acknowledgement:
55  *	This product includes software developed by the University of
56  *	California, Berkeley and its contributors.
57  * 4. Neither the name of the University nor the names of its contributors
58  *    may be used to endorse or promote products derived from this software
59  *    without specific prior written permission.
60  *
61  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
62  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
63  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
64  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
65  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
66  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
67  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
68  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
69  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
70  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
71  * SUCH DAMAGE.
72  *
73  *	@(#)segments.h	7.1 (Berkeley) 5/9/91
74  */
75 
76 /*
77  * 386 Segmentation Data Structures and definitions
78  *	William F. Jolitz (william@ernie.berkeley.edu) 6/20/1989
79  */
80 
81 #ifndef _I386_SEGMENTS_H_
82 #define _I386_SEGMENTS_H_
83 
84 /*
85  * Selectors
86  */
87 
88 #define	ISPL(s)		((s) & SEL_RPL)	/* what is the priority level of a selector */
89 #define	SEL_KPL		0		/* kernel privilege level */
90 #define	SEL_UPL		3		/* user privilege level */
91 #define	SEL_RPL		3		/* requester's privilege level mask */
92 #define	ISLDT(s)	((s) & SEL_LDT)	/* is it local or global */
93 #define	SEL_LDT		4		/* local descriptor table */
94 #define	IDXSEL(s)	(((s) >> 3) & 0x1fff)		/* index of selector */
95 #define	GSEL(s,r)	(((s) << 3) | r)		/* a global selector */
96 #define	LSEL(s,r)	(((s) << 3) | r | SEL_LDT)	/* a local selector */
97 
98 #if defined(_KERNEL_OPT)
99 #include "opt_vm86.h"
100 #endif
101 
102 #ifdef VM86
103 #define	USERMODE(c, f)		(ISPL(c) == SEL_UPL || ((f) & PSL_VM) != 0)
104 #define	KERNELMODE(c, f)	(ISPL(c) == SEL_KPL && ((f) & PSL_VM) == 0)
105 #else
106 #define	USERMODE(c, f)		(ISPL(c) == SEL_UPL)
107 #define	KERNELMODE(c, f)	(ISPL(c) == SEL_KPL)
108 #endif
109 
110 #ifndef _LOCORE
111 
112 #if __GNUC__ == 2 && __GNUC_MINOR__ < 7
113 #pragma pack(1)
114 #endif
115 
116 /*
117  * Memory and System segment descriptors
118  */
119 struct segment_descriptor {
120 	unsigned sd_lolimit:16;		/* segment extent (lsb) */
121 	unsigned sd_lobase:24;		/* segment base address (lsb) */
122 	unsigned sd_type:5;		/* segment type */
123 	unsigned sd_dpl:2;		/* segment descriptor priority level */
124 	unsigned sd_p:1;		/* segment descriptor present */
125 	unsigned sd_hilimit:4;		/* segment extent (msb) */
126 	unsigned sd_xx:2;		/* unused */
127 	unsigned sd_def32:1;		/* default 32 vs 16 bit size */
128 	unsigned sd_gran:1;		/* limit granularity (byte/page) */
129 	unsigned sd_hibase:8;		/* segment base address (msb) */
130 } __attribute__((packed));
131 
132 /*
133  * Gate descriptors (e.g. indirect descriptors)
134  */
135 struct gate_descriptor {
136 	unsigned gd_looffset:16;	/* gate offset (lsb) */
137 	unsigned gd_selector:16;	/* gate segment selector */
138 	unsigned gd_stkcpy:5;		/* number of stack wds to cpy */
139 	unsigned gd_xx:3;		/* unused */
140 	unsigned gd_type:5;		/* segment type */
141 	unsigned gd_dpl:2;		/* segment descriptor priority level */
142 	unsigned gd_p:1;		/* segment descriptor present */
143 	unsigned gd_hioffset:16;	/* gate offset (msb) */
144 } __attribute__((packed));
145 
146 /*
147  * Generic descriptor
148  */
149 union descriptor {
150 	struct segment_descriptor sd;
151 	struct gate_descriptor gd;
152 } __attribute__((packed));
153 
154 /*
155  * region descriptors, used to load gdt/idt tables before segments yet exist.
156  */
157 struct region_descriptor {
158 	unsigned rd_limit:16;		/* segment extent */
159 	unsigned rd_base:32;		/* base address  */
160 } __attribute__((packed));
161 
162 #if __GNUC__ == 2 && __GNUC_MINOR__ < 7
163 #pragma pack(4)
164 #endif
165 
166 #ifdef _KERNEL
167 extern union descriptor *gdt, *ldt;
168 extern struct gate_descriptor *idt;
169 
170 void setgate(struct gate_descriptor *, void *, int, int, int, int);
171 void setregion(struct region_descriptor *, void *, size_t);
172 void setsegment(struct segment_descriptor *, void *, size_t, int, int,
173     int, int);
174 void setgdt(int, void *, size_t, int, int, int, int);
175 void unsetgate(struct gate_descriptor *);
176 void cpu_init_idt(void);
177 
178 int idt_vec_alloc(int, int);
179 void idt_vec_set(int, void (*)(void));
180 void idt_vec_free(int);
181 
182 #endif /* _KERNEL */
183 
184 #endif /* !_LOCORE */
185 
186 /* system segments and gate types */
187 #define	SDT_SYSNULL	 0	/* system null */
188 #define	SDT_SYS286TSS	 1	/* system 286 TSS available */
189 #define	SDT_SYSLDT	 2	/* system local descriptor table */
190 #define	SDT_SYS286BSY	 3	/* system 286 TSS busy */
191 #define	SDT_SYS286CGT	 4	/* system 286 call gate */
192 #define	SDT_SYSTASKGT	 5	/* system task gate */
193 #define	SDT_SYS286IGT	 6	/* system 286 interrupt gate */
194 #define	SDT_SYS286TGT	 7	/* system 286 trap gate */
195 #define	SDT_SYSNULL2	 8	/* system null again */
196 #define	SDT_SYS386TSS	 9	/* system 386 TSS available */
197 #define	SDT_SYSNULL3	10	/* system null again */
198 #define	SDT_SYS386BSY	11	/* system 386 TSS busy */
199 #define	SDT_SYS386CGT	12	/* system 386 call gate */
200 #define	SDT_SYSNULL4	13	/* system null again */
201 #define	SDT_SYS386IGT	14	/* system 386 interrupt gate */
202 #define	SDT_SYS386TGT	15	/* system 386 trap gate */
203 
204 /* memory segment types */
205 #define	SDT_MEMRO	16	/* memory read only */
206 #define	SDT_MEMROA	17	/* memory read only accessed */
207 #define	SDT_MEMRW	18	/* memory read write */
208 #define	SDT_MEMRWA	19	/* memory read write accessed */
209 #define	SDT_MEMROD	20	/* memory read only expand dwn limit */
210 #define	SDT_MEMRODA	21	/* memory read only expand dwn limit accessed */
211 #define	SDT_MEMRWD	22	/* memory read write expand dwn limit */
212 #define	SDT_MEMRWDA	23	/* memory read write expand dwn limit acessed */
213 #define	SDT_MEME	24	/* memory execute only */
214 #define	SDT_MEMEA	25	/* memory execute only accessed */
215 #define	SDT_MEMER	26	/* memory execute read */
216 #define	SDT_MEMERA	27	/* memory execute read accessed */
217 #define	SDT_MEMEC	28	/* memory execute only conforming */
218 #define	SDT_MEMEAC	29	/* memory execute only accessed conforming */
219 #define	SDT_MEMERC	30	/* memory execute read conforming */
220 #define	SDT_MEMERAC	31	/* memory execute read accessed conforming */
221 
222 /* is memory segment descriptor pointer ? */
223 #define ISMEMSDP(s)	((s->d_type) >= SDT_MEMRO && \
224 			 (s->d_type) <= SDT_MEMERAC)
225 
226 /* is 286 gate descriptor pointer ? */
227 #define IS286GDP(s)	((s->d_type) >= SDT_SYS286CGT && \
228 			 (s->d_type) < SDT_SYS286TGT)
229 
230 /* is 386 gate descriptor pointer ? */
231 #define IS386GDP(s)	((s->d_type) >= SDT_SYS386CGT && \
232 			 (s->d_type) < SDT_SYS386TGT)
233 
234 /* is gate descriptor pointer ? */
235 #define ISGDP(s)	(IS286GDP(s) || IS386GDP(s))
236 
237 /* is segment descriptor pointer ? */
238 #define ISSDP(s)	(ISMEMSDP(s) || !ISGDP(s))
239 
240 /* is system segment descriptor pointer ? */
241 #define ISSYSSDP(s)	(!ISMEMSDP(s) && !ISGDP(s))
242 
243 /*
244  * Segment Protection Exception code bits
245  */
246 #define	SEGEX_EXT	0x01	/* recursive or externally induced */
247 #define	SEGEX_IDT	0x02	/* interrupt descriptor table */
248 #define	SEGEX_TI	0x04	/* local descriptor table */
249 
250 /*
251  * Entries in the Interrupt Descriptor Table (IDT)
252  */
253 #define	NIDT	256
254 #define	NRSVIDT	32		/* reserved entries for CPU exceptions */
255 
256 /*
257  * Entries in the Global Descriptor Table (GDT).
258  *
259  * NB: If you change GBIOSCODE/GBIOSDATA, you *must* rebuild arch/i386/
260  * bioscall/biostramp.inc, as that relies on GBIOSCODE/GBIOSDATA and a
261  * normal kernel build does not rebuild it (it's merely included whole-
262  * sale from i386/bioscall.s)
263  *
264  * Also, note that the GEXTBIOSDATA_SEL selector is special, as it maps
265  * to the value 0x0040 (when created as a KPL global selector).  Some
266  * BIOSes reference the extended BIOS data area at segment 0040 in a non
267  * relocatable fashion (even when in protected mode); mapping the zero page
268  * via the GEXTBIOSDATA_SEL allows these buggy BIOSes to continue to work
269  * under NetBSD.
270  */
271 #define	GNULL_SEL	0	/* Null descriptor */
272 #define	GCODE_SEL	1	/* Kernel code descriptor */
273 #define	GDATA_SEL	2	/* Kernel data descriptor */
274 #define	GLDT_SEL	3	/* Default LDT descriptor */
275 #define	GUCODE_SEL	4	/* User code descriptor */
276 #define	GUDATA_SEL	5	/* User data descriptor */
277 #define GCPU_SEL	6	/* per-CPU segment */
278 #define	GMACHCALLS_SEL	7	/* Darwin (mach trap) system call gate */
279 #define	GEXTBIOSDATA_SEL 8	/* magic to catch BIOS refs to EBDA */
280 #define	GAPM32CODE_SEL	9	/* 3 APM segments must be consecutive */
281 #define	GAPM16CODE_SEL	10	/* and in the specified order: code32 */
282 #define	GAPMDATA_SEL	11	/* code16 and then data per APM spec */
283 #define	GBIOSCODE_SEL	12
284 #define	GBIOSDATA_SEL	13
285 #define	GPNPBIOSCODE_SEL 14
286 #define	GPNPBIOSDATA_SEL 15
287 #define	GPNPBIOSSCRATCH_SEL 16
288 #define	GPNPBIOSTRAMP_SEL 17
289 #define GTRAPTSS_SEL	18
290 #define GIPITSS_SEL	19
291 #define GUCODEBIG_SEL	20	/* User code with executable stack */
292 #define	NGDT		21
293 
294 /*
295  * Entries in the Local Descriptor Table (LDT)
296  */
297 #define	LSYS5CALLS_SEL	0	/* iBCS system call gate */
298 #define	LSYS5SIGR_SEL	1	/* iBCS sigreturn gate */
299 #define	LUCODE_SEL	2	/* User code descriptor */
300 #define	LUDATA_SEL	3	/* User data descriptor */
301 #define	LSOL26CALLS_SEL	4	/* Solaris 2.6 system call gate */
302 #define	LUCODEBIG_SEL	5	/* User code with executable stack */
303 #define	LBSDICALLS_SEL	16	/* BSDI system call gate */
304 #define	NLDT		17
305 
306 #endif /* _I386_SEGMENTS_H_ */
307