1 | /* |
2 | * Copyright (c) 2017 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 | #include <kern/ux_handler.h> |
30 | #include <sys/ux_exception.h> |
31 | |
32 | #include <mach/exception.h> |
33 | #include <mach/kern_return.h> |
34 | #include <mach/port.h> |
35 | #include <mach/mach_port.h> |
36 | #include <mach/mig_errors.h> |
37 | |
38 | #include <kern/thread.h> |
39 | #include <kern/task.h> |
40 | #include <kern/ipc_kobject.h> |
41 | #include <kern/ipc_tt.h> |
42 | |
43 | #include <ipc/ipc_port.h> |
44 | |
45 | #include <mach/host_priv.h> |
46 | #include <kern/host.h> |
47 | |
48 | #include <mach/exc_server.h> |
49 | #include <mach/mach_exc_server.h> |
50 | |
51 | #include <libkern/section_keywords.h> |
52 | |
53 | /* |
54 | * Mach kobject port to reflect Mach exceptions into Unix signals. |
55 | * |
56 | * This is the default Mach exception handler for initproc, which |
57 | * then filters to all subprocesses as the host level exception handler for |
58 | * most Mach exceptions. |
59 | */ |
60 | |
61 | static const void *ux_handler_kobject = NULL; |
62 | SECURITY_READ_ONLY_LATE(ipc_port_t) ux_handler_port = IP_NULL; |
63 | |
64 | /* |
65 | * init is called early in Mach initialization |
66 | * when we can initialize read-only memory |
67 | */ |
68 | void |
69 | ux_handler_init(void) |
70 | { |
71 | ux_handler_port = ipc_port_alloc_kernel(); |
72 | |
73 | if (ux_handler_port == IP_NULL) |
74 | panic("can't allocate unix exception port" ); |
75 | |
76 | ipc_kobject_set(ux_handler_port, (ipc_kobject_t)&ux_handler_kobject, IKOT_UX_HANDLER); |
77 | } |
78 | |
79 | /* |
80 | * setup is called late in BSD initialization from initproc's context |
81 | * so the MAC hook goo inside host_set_exception_ports will be able to |
82 | * set up labels without falling over. |
83 | */ |
84 | void |
85 | ux_handler_setup(void) |
86 | { |
87 | ipc_port_t ux_handler_send_right = ipc_port_make_send(ux_handler_port); |
88 | |
89 | if (!IP_VALID(ux_handler_send_right)) |
90 | panic("Couldn't allocate send right for ux_handler_port!\n" ); |
91 | |
92 | kern_return_t kr = KERN_SUCCESS; |
93 | |
94 | /* |
95 | * Consumes 1 send right. |
96 | * |
97 | * Instruments uses the RPC_ALERT port, so don't register for that. |
98 | */ |
99 | kr = host_set_exception_ports(host_priv_self(), |
100 | EXC_MASK_ALL & ~(EXC_MASK_RPC_ALERT), |
101 | ux_handler_send_right, |
102 | EXCEPTION_DEFAULT | MACH_EXCEPTION_CODES, |
103 | 0); |
104 | |
105 | if (kr != KERN_SUCCESS) |
106 | panic("host_set_exception_ports failed to set ux_handler! %d" , kr); |
107 | } |
108 | |
109 | /* |
110 | * Is this port the ux_handler? |
111 | * If so, it's safe to send an exception without checking labels. |
112 | */ |
113 | boolean_t |
114 | is_ux_handler_port(mach_port_t port) |
115 | { |
116 | if (ux_handler_port == port) |
117 | return TRUE; |
118 | else |
119 | return FALSE; |
120 | } |
121 | |
122 | kern_return_t |
123 | catch_mach_exception_raise( |
124 | mach_port_t exception_port, |
125 | mach_port_t thread_port, |
126 | mach_port_t task_port, |
127 | exception_type_t exception, |
128 | mach_exception_data_t code, |
129 | __unused mach_msg_type_number_t codeCnt) |
130 | { |
131 | if (exception_port != ux_handler_port) |
132 | return KERN_FAILURE; |
133 | |
134 | kern_return_t kr = KERN_SUCCESS; |
135 | |
136 | thread_t target_thread = THREAD_NULL; |
137 | task_t target_task = TASK_NULL; |
138 | |
139 | if ((target_thread = convert_port_to_thread(thread_port)) == THREAD_NULL) { |
140 | kr = KERN_INVALID_ARGUMENT; |
141 | goto out; |
142 | } |
143 | |
144 | if ((target_task = convert_port_to_task(task_port)) == TASK_NULL) { |
145 | kr = KERN_INVALID_ARGUMENT; |
146 | goto out; |
147 | } |
148 | |
149 | kr = handle_ux_exception(target_thread, exception, code[0], code[1]); |
150 | |
151 | out: |
152 | if (kr == KERN_SUCCESS) { |
153 | /* |
154 | * Following the MIG 'consume on success' protocol, |
155 | * consume references to the port arguments. |
156 | * (but NOT the exception_port, as the first argument is borrowed) |
157 | * |
158 | * If we return non-success, the kobject server will eat the port |
159 | * references for us. |
160 | */ |
161 | |
162 | ipc_port_release_send(thread_port); |
163 | ipc_port_release_send(task_port); |
164 | } |
165 | |
166 | thread_deallocate(target_thread); |
167 | task_deallocate(target_task); |
168 | |
169 | return kr; |
170 | } |
171 | |
172 | kern_return_t |
173 | catch_exception_raise( |
174 | mach_port_t exception_port, |
175 | mach_port_t thread, |
176 | mach_port_t task, |
177 | exception_type_t exception, |
178 | exception_data_t code, |
179 | mach_msg_type_number_t codeCnt) |
180 | { |
181 | if (exception_port != ux_handler_port) |
182 | return KERN_FAILURE; |
183 | |
184 | mach_exception_data_type_t big_code[EXCEPTION_CODE_MAX] = { |
185 | [0] = code[0], |
186 | [1] = code[1], |
187 | }; |
188 | |
189 | return catch_mach_exception_raise(exception_port, |
190 | thread, |
191 | task, |
192 | exception, |
193 | big_code, |
194 | codeCnt); |
195 | } |
196 | |
197 | kern_return_t |
198 | catch_exception_raise_state( |
199 | __unused mach_port_t exception_port, |
200 | __unused exception_type_t exception, |
201 | __unused const exception_data_t code, |
202 | __unused mach_msg_type_number_t codeCnt, |
203 | __unused int *flavor, |
204 | __unused const thread_state_t old_state, |
205 | __unused mach_msg_type_number_t old_stateCnt, |
206 | __unused thread_state_t new_state, |
207 | __unused mach_msg_type_number_t *new_stateCnt) |
208 | { |
209 | return(KERN_INVALID_ARGUMENT); |
210 | } |
211 | |
212 | kern_return_t |
213 | catch_mach_exception_raise_state( |
214 | __unused mach_port_t exception_port, |
215 | __unused exception_type_t exception, |
216 | __unused const mach_exception_data_t code, |
217 | __unused mach_msg_type_number_t codeCnt, |
218 | __unused int *flavor, |
219 | __unused const thread_state_t old_state, |
220 | __unused mach_msg_type_number_t old_stateCnt, |
221 | __unused thread_state_t new_state, |
222 | __unused mach_msg_type_number_t *new_stateCnt) |
223 | { |
224 | return(KERN_INVALID_ARGUMENT); |
225 | } |
226 | |
227 | kern_return_t |
228 | catch_exception_raise_state_identity( |
229 | __unused mach_port_t exception_port, |
230 | __unused mach_port_t thread, |
231 | __unused mach_port_t task, |
232 | __unused exception_type_t exception, |
233 | __unused exception_data_t code, |
234 | __unused mach_msg_type_number_t codeCnt, |
235 | __unused int *flavor, |
236 | __unused thread_state_t old_state, |
237 | __unused mach_msg_type_number_t old_stateCnt, |
238 | __unused thread_state_t new_state, |
239 | __unused mach_msg_type_number_t *new_stateCnt) |
240 | { |
241 | return(KERN_INVALID_ARGUMENT); |
242 | } |
243 | |
244 | kern_return_t |
245 | catch_mach_exception_raise_state_identity( |
246 | __unused mach_port_t exception_port, |
247 | __unused mach_port_t thread, |
248 | __unused mach_port_t task, |
249 | __unused exception_type_t exception, |
250 | __unused mach_exception_data_t code, |
251 | __unused mach_msg_type_number_t codeCnt, |
252 | __unused int *flavor, |
253 | __unused thread_state_t old_state, |
254 | __unused mach_msg_type_number_t old_stateCnt, |
255 | __unused thread_state_t new_state, |
256 | __unused mach_msg_type_number_t *new_stateCnt) |
257 | { |
258 | return(KERN_INVALID_ARGUMENT); |
259 | } |
260 | |
261 | |