1/*
2 * Copyright (c) 2000-2012 Apple Inc. All rights reserved.
3 *
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5 *
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
14 *
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
17 *
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
25 *
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27 */
28/*
29 * @OSF_COPYRIGHT@
30 */
31/*
32 * Mach Operating System
33 * Copyright (c) 1991,1990 Carnegie Mellon University
34 * All Rights Reserved.
35 *
36 * Permission to use, copy, modify and distribute this software and its
37 * documentation is hereby granted, provided that both the copyright
38 * notice and this permission notice appear in all copies of the
39 * software, derivative works or modified versions, and any portions
40 * thereof, and that both notices appear in supporting documentation.
41 *
42 * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
43 * CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
44 * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
45 *
46 * Carnegie Mellon requests users of this software to return to
47 *
48 * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
49 * School of Computer Science
50 * Carnegie Mellon University
51 * Pittsburgh PA 15213-3890
52 *
53 * any improvements or extensions that they make and grant Carnegie Mellon
54 * the rights to redistribute these changes.
55 */
56/*
57 */
58
59#ifndef _I386_TRAP_H_
60#define _I386_TRAP_H_
61
62/*
63 * Hardware trap vectors for i386.
64 */
65#define T_DIVIDE_ERROR 0
66#define T_DEBUG 1
67#define T_NMI 2 /* non-maskable interrupt */
68#define T_INT3 3 /* int 3 instruction */
69#define T_OVERFLOW 4 /* overflow test */
70#define T_OUT_OF_BOUNDS 5 /* bounds check */
71#define T_INVALID_OPCODE 6 /* invalid op code */
72#define T_NO_FPU 7 /* no floating point */
73#define T_DOUBLE_FAULT 8 /* double fault */
74#define T_FPU_FAULT 9
75#define T_INVALID_TSS 10
76#define T_SEGMENT_NOT_PRESENT 11
77#define T_STACK_FAULT 12
78#define T_GENERAL_PROTECTION 13
79#define T_PAGE_FAULT 14
80/* 15 */
81#define T_FLOATING_POINT_ERROR 16
82#define T_WATCHPOINT 17
83#define T_MACHINE_CHECK 18
84#define T_SSE_FLOAT_ERROR 19
85/* 20-126 */
86#define T_DTRACE_RET 127
87
88/* The SYSENTER and SYSCALL trap numbers are software constructs.
89 * These exceptions are dispatched directly to the system call handlers.
90 * See also the "software interrupt codes" section of
91 * osfmk/mach/i386/syscall_sw.h
92 */
93#define T_SYSENTER 0x84
94#define T_SYSCALL 0x85
95
96#define T_PREEMPT 255
97
98#define TRAP_NAMES "divide error", "debug trap", "NMI", "breakpoint", \
99 "overflow", "bounds check", "invalid opcode", \
100 "no coprocessor", "double fault", "coprocessor overrun", \
101 "invalid TSS", "segment not present", "stack bounds", \
102 "general protection", "page fault", "(reserved)", \
103 "coprocessor error", "watchpoint", "machine check", "SSE floating point"
104
105/*
106 * Page-fault trap codes.
107 */
108#define T_PF_PROT 0x1 /* protection violation */
109#define T_PF_WRITE 0x2 /* write access */
110#define T_PF_USER 0x4 /* from user state */
111
112#define T_PF_RSVD 0x8 /* reserved bit set to 1 */
113#define T_PF_EXECUTE 0x10 /* instruction fetch when NX */
114
115#if !defined(ASSEMBLER) && defined(MACH_KERNEL)
116
117#include <i386/thread.h>
118
119extern void i386_exception(
120 int exc,
121 mach_exception_code_t code,
122 mach_exception_subcode_t subcode);
123
124extern void sync_iss_to_iks(x86_saved_state_t *regs);
125
126extern void sync_iss_to_iks_unconditionally(
127 x86_saved_state_t *regs);
128
129extern void kernel_trap(x86_saved_state_t *regs, uintptr_t *lo_spp);
130
131extern void user_trap(x86_saved_state_t *regs);
132
133extern void interrupt(x86_saved_state_t *regs);
134
135extern void panic_double_fault64(x86_saved_state_t *regs);
136extern void panic_machine_check64(x86_saved_state_t *regs);
137
138typedef kern_return_t (*perfCallback)(
139 int trapno,
140 void *regs,
141 uintptr_t *lo_spp,
142 int);
143
144extern void panic_i386_backtrace(void *, int, const char *, boolean_t, x86_saved_state_t *);
145extern void print_one_backtrace(pmap_t pmap, vm_offset_t topfp, const char *cur_marker, boolean_t is_64_bit);
146extern void print_thread_num_that_crashed(task_t task);
147extern void print_tasks_user_threads(task_t task);
148extern void print_threads_registers(thread_t thread);
149extern void print_uuid_info(task_t task);
150extern void print_launchd_info(void);
151
152#if MACH_KDP
153extern boolean_t kdp_i386_trap(
154 unsigned int,
155 x86_saved_state64_t *,
156 kern_return_t,
157 vm_offset_t);
158#endif /* MACH_KDP */
159#endif /* !ASSEMBLER && MACH_KERNEL */
160
161#endif /* _I386_TRAP_H_ */
162