syscall_sw.c
1 /* 2 * Copyright (c) 2000-2005, 2020 Apple Computer, 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,1989,1988,1987 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 #include <mach/mach_types.h> 60 #include <mach/mach_traps.h> 61 62 #include <kern/syscall_sw.h> 63 #if CONFIG_REQUIRES_U32_MUNGING || (__arm__ && (__BIGGEST_ALIGNMENT__ > 4)) 64 #include <sys/munge.h> 65 #endif 66 67 /* Forwards */ 68 69 70 /* 71 * To add a new entry: 72 * Add an "MACH_TRAP(routine, arg_count, num_32_bit_words, munge_routine)" to the table below. 73 * where, 74 * - routine: The trap handling routine in the kernel 75 * - arg_count: The number of arguments for the mach trap (independant of arch/arg size). 76 * This value also defines the number of 64-bit words copied in for a U64 process. 77 * - num_32_bit_words: The number of 32-bit words to be copied in for a U32 process. 78 * - munge_routine: The argument munging routine to align input args correctly. 79 * 80 * Also, add trap definition to mach/syscall_sw.h and 81 * recompile user library. 82 * 83 * 84 * WARNING: If you add a trap which requires more than 7 85 * parameters, mach/{machine}/syscall_sw.h and {machine}/trap.c 86 * and/or {machine}/locore.s may need to be modified for it 87 * to work successfully. 88 * 89 * WARNING: Don't use numbers 0 through -9. They (along with 90 * the positive numbers) are reserved for Unix. 91 */ 92 93 int kern_invalid_debug = 0; 94 95 /* Include declarations of the trap functions. */ 96 97 #include <mach/mach_traps.h> 98 #include <mach/mach_syscalls.h> 99 #include <kern/syscall_subr.h> 100 101 #include <kern/clock.h> 102 #include <mach/mk_timer.h> 103 104 const mach_trap_t mach_trap_table[MACH_TRAP_TABLE_COUNT] = { 105 /* 0 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 106 /* 1 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 107 /* 2 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 108 /* 3 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 109 /* 4 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 110 /* 5 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 111 /* 6 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 112 /* 7 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 113 /* 8 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 114 /* 9 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 115 /* 10 */ MACH_TRAP(_kernelrpc_mach_vm_allocate_trap, 4, 5, munge_wwlw), 116 /* 11 */ MACH_TRAP(_kernelrpc_mach_vm_purgable_control_trap, 4, 5, munge_wlww), 117 /* 12 */ MACH_TRAP(_kernelrpc_mach_vm_deallocate_trap, 3, 5, munge_wll), 118 /* 13 */ MACH_TRAP(task_dyld_process_info_notify_get_trap, 2, 4, munge_ll), 119 /* 14 */ MACH_TRAP(_kernelrpc_mach_vm_protect_trap, 5, 7, munge_wllww), 120 /* 15 */ MACH_TRAP(_kernelrpc_mach_vm_map_trap, 6, 8, munge_wwllww), 121 /* 16 */ MACH_TRAP(_kernelrpc_mach_port_allocate_trap, 3, 3, munge_www), 122 /* 17 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 123 /* 18 */ MACH_TRAP(_kernelrpc_mach_port_deallocate_trap, 2, 2, munge_ww), 124 /* 19 */ MACH_TRAP(_kernelrpc_mach_port_mod_refs_trap, 4, 4, munge_wwww), 125 /* 20 */ MACH_TRAP(_kernelrpc_mach_port_move_member_trap, 3, 3, munge_www), 126 /* 21 */ MACH_TRAP(_kernelrpc_mach_port_insert_right_trap, 4, 4, munge_wwww), 127 /* 22 */ MACH_TRAP(_kernelrpc_mach_port_insert_member_trap, 3, 3, munge_www), 128 /* 23 */ MACH_TRAP(_kernelrpc_mach_port_extract_member_trap, 3, 3, munge_www), 129 /* 24 */ MACH_TRAP(_kernelrpc_mach_port_construct_trap, 4, 5, munge_wwlw), 130 /* 25 */ MACH_TRAP(_kernelrpc_mach_port_destruct_trap, 4, 5, munge_wwwl), 131 /* 26 */ MACH_TRAP(mach_reply_port, 0, 0, NULL), 132 /* 27 */ MACH_TRAP(thread_self_trap, 0, 0, NULL), 133 /* 28 */ MACH_TRAP(task_self_trap, 0, 0, NULL), 134 /* 29 */ MACH_TRAP(host_self_trap, 0, 0, NULL), 135 /* 30 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 136 /* 31 */ MACH_TRAP(mach_msg_trap, 7, 7, munge_wwwwwww), 137 /* 32 */ MACH_TRAP(mach_msg_overwrite_trap, 8, 8, munge_wwwwwwww), 138 /* 33 */ MACH_TRAP(semaphore_signal_trap, 1, 1, munge_w), 139 /* 34 */ MACH_TRAP(semaphore_signal_all_trap, 1, 1, munge_w), 140 /* 35 */ MACH_TRAP(semaphore_signal_thread_trap, 2, 2, munge_ww), 141 /* 36 */ MACH_TRAP(semaphore_wait_trap, 1, 1, munge_w), 142 /* 37 */ MACH_TRAP(semaphore_wait_signal_trap, 2, 2, munge_ww), 143 /* 38 */ MACH_TRAP(semaphore_timedwait_trap, 3, 3, munge_www), 144 /* 39 */ MACH_TRAP(semaphore_timedwait_signal_trap, 4, 4, munge_wwww), 145 /* 40 */ MACH_TRAP(_kernelrpc_mach_port_get_attributes_trap, 5, 5, munge_wwwww), 146 /* 41 */ MACH_TRAP(_kernelrpc_mach_port_guard_trap, 4, 5, munge_wwlw), 147 /* 42 */ MACH_TRAP(_kernelrpc_mach_port_unguard_trap, 3, 4, munge_wwl), 148 /* 43 */ MACH_TRAP(mach_generate_activity_id, 3, 3, munge_www), 149 /* 44 */ MACH_TRAP(task_name_for_pid, 3, 3, munge_www), 150 /* 45 */ MACH_TRAP(task_for_pid, 3, 3, munge_www), 151 /* 46 */ MACH_TRAP(pid_for_task, 2, 2, munge_ww), 152 /* 47 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 153 /* 48 */ MACH_TRAP(macx_swapon, 4, 5, munge_lwww), 154 /* 49 */ MACH_TRAP(macx_swapoff, 2, 3, munge_lw), 155 /* 50 */ MACH_TRAP(thread_get_special_reply_port, 0, 0, NULL), 156 /* 51 */ MACH_TRAP(macx_triggers, 4, 4, munge_wwww), 157 /* 52 */ MACH_TRAP(macx_backing_store_suspend, 1, 1, munge_w), 158 /* 53 */ MACH_TRAP(macx_backing_store_recovery, 1, 1, munge_w), 159 /* 54 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 160 /* 55 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 161 /* 56 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 162 /* 57 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 163 /* 58 */ MACH_TRAP(pfz_exit, 0, 0, NULL), 164 /* 59 */ MACH_TRAP(swtch_pri, 0, 0, NULL), 165 /* 60 */ MACH_TRAP(swtch, 0, 0, NULL), 166 /* 61 */ MACH_TRAP(thread_switch, 3, 3, munge_www), 167 /* 62 */ MACH_TRAP(clock_sleep_trap, 5, 5, munge_wwwww), 168 /* 63 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 169 /* 64 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 170 /* 65 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 171 /* 66 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 172 /* 67 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 173 /* 68 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 174 /* 69 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 175 /* 70 */ MACH_TRAP(host_create_mach_voucher_trap, 4, 4, munge_wwww), 176 /* 71 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 177 /* 72 */ MACH_TRAP(mach_voucher_extract_attr_recipe_trap, 4, 4, munge_wwww), 178 /* 73 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 179 /* 74 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 180 /* 75 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 181 /* 76 */ MACH_TRAP(_kernelrpc_mach_port_type_trap, 3, 3, munge_wwww), 182 /* 77 */ MACH_TRAP(_kernelrpc_mach_port_request_notification_trap, 7, 7, munge_wwwwwww), 183 /* 78 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 184 /* 79 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 185 /* 80 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 186 /* 81 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 187 /* 82 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 188 /* 83 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 189 /* 84 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 190 /* 85 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 191 /* 86 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 192 /* 87 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 193 /* 88 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 194 /* 89 */ MACH_TRAP(mach_timebase_info_trap, 1, 1, munge_w), 195 /* 90 */ MACH_TRAP(mach_wait_until_trap, 1, 2, munge_l), 196 /* 91 */ MACH_TRAP(mk_timer_create_trap, 0, 0, NULL), 197 /* 92 */ MACH_TRAP(mk_timer_destroy_trap, 1, 1, munge_w), 198 /* 93 */ MACH_TRAP(mk_timer_arm_trap, 2, 3, munge_wl), 199 /* 94 */ MACH_TRAP(mk_timer_cancel_trap, 2, 2, munge_ww), 200 /* 95 */ MACH_TRAP(mk_timer_arm_leeway_trap, 4, 6, munge_wlll), 201 /* 96 */ MACH_TRAP(debug_control_port_for_pid, 3, 3, munge_www), 202 /* 97 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 203 /* 98 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 204 /* 99 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 205 /* traps 100-107 reserved for IOKit */ 206 /* 100 */ MACH_TRAP(iokit_user_client_trap, 8, 8, munge_wwwwwwww), 207 /* 101 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 208 /* 102 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 209 /* 103 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 210 /* 104 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 211 /* 105 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 212 /* 106 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 213 /* 107 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 214 /* 108 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 215 /* 109 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 216 /* 110 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 217 /* 111 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 218 /* 112 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 219 /* 113 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 220 /* 114 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 221 /* 115 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 222 /* 116 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 223 /* 117 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 224 /* 118 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 225 /* 119 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 226 /* 120 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 227 /* 121 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 228 /* 122 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 229 /* 123 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 230 /* 124 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 231 /* 125 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 232 /* 126 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 233 /* 127 */ MACH_TRAP(kern_invalid, 0, 0, NULL), 234 }; 235 236 const char * const mach_syscall_name_table[MACH_TRAP_TABLE_COUNT] = { 237 /* 0 */ "kern_invalid", 238 /* 1 */ "kern_invalid", 239 /* 2 */ "kern_invalid", 240 /* 3 */ "kern_invalid", 241 /* 4 */ "kern_invalid", 242 /* 5 */ "kern_invalid", 243 /* 6 */ "kern_invalid", 244 /* 7 */ "kern_invalid", 245 /* 8 */ "kern_invalid", 246 /* 9 */ "kern_invalid", 247 /* 10 */ "_kernelrpc_mach_vm_allocate_trap", 248 /* 11 */ "kern_invalid", 249 /* 12 */ "_kernelrpc_mach_vm_deallocate_trap", 250 /* 13 */ "task_dyld_process_info_notify_get_trap", 251 /* 14 */ "_kernelrpc_mach_vm_protect_trap", 252 /* 15 */ "_kernelrpc_mach_vm_map_trap", 253 /* 16 */ "_kernelrpc_mach_port_allocate_trap", 254 /* 17 */ "kern_invalid", 255 /* 18 */ "_kernelrpc_mach_port_deallocate_trap", 256 /* 19 */ "_kernelrpc_mach_port_mod_refs_trap", 257 /* 20 */ "_kernelrpc_mach_port_move_member_trap", 258 /* 21 */ "_kernelrpc_mach_port_insert_right_trap", 259 /* 22 */ "_kernelrpc_mach_port_insert_member_trap", 260 /* 23 */ "_kernelrpc_mach_port_extract_member_trap", 261 /* 24 */ "_kernelrpc_mach_port_construct_trap", 262 /* 25 */ "_kernelrpc_mach_port_destruct_trap", 263 /* 26 */ "mach_reply_port", 264 /* 27 */ "thread_self_trap", 265 /* 28 */ "task_self_trap", 266 /* 29 */ "host_self_trap", 267 /* 30 */ "kern_invalid", 268 /* 31 */ "mach_msg_trap", 269 /* 32 */ "mach_msg_overwrite_trap", 270 /* 33 */ "semaphore_signal_trap", 271 /* 34 */ "semaphore_signal_all_trap", 272 /* 35 */ "semaphore_signal_thread_trap", 273 /* 36 */ "semaphore_wait_trap", 274 /* 37 */ "semaphore_wait_signal_trap", 275 /* 38 */ "semaphore_timedwait_trap", 276 /* 39 */ "semaphore_timedwait_signal_trap", 277 /* 40 */ "kern_invalid", 278 /* 41 */ "_kernelrpc_mach_port_guard_trap", 279 /* 42 */ "_kernelrpc_mach_port_unguard_trap", 280 /* 43 */ "mach_generate_activity_id", 281 /* 44 */ "task_name_for_pid", 282 /* 45 */ "task_for_pid", 283 /* 46 */ "pid_for_task", 284 /* 47 */ "kern_invalid", 285 /* 48 */ "macx_swapon", 286 /* 49 */ "macx_swapoff", 287 /* 50 */ "thread_get_special_reply_port", 288 /* 51 */ "macx_triggers", 289 /* 52 */ "macx_backing_store_suspend", 290 /* 53 */ "macx_backing_store_recovery", 291 /* 54 */ "kern_invalid", 292 /* 55 */ "kern_invalid", 293 /* 56 */ "kern_invalid", 294 /* 57 */ "kern_invalid", 295 /* 58 */ "pfz_exit", 296 /* 59 */ "swtch_pri", 297 /* 60 */ "swtch", 298 /* 61 */ "thread_switch", 299 /* 62 */ "clock_sleep_trap", 300 /* 63 */ "kern_invalid", 301 /* traps 64 - 95 reserved (debo) */ 302 /* 64 */ "kern_invalid", 303 /* 65 */ "kern_invalid", 304 /* 66 */ "kern_invalid", 305 /* 67 */ "kern_invalid", 306 /* 68 */ "kern_invalid", 307 /* 69 */ "kern_invalid", 308 /* 70 */ "host_create_mach_voucher_trap", 309 /* 71 */ "kern_invalid", 310 /* 72 */ "mach_voucher_extract_attr_recipe_trap", 311 /* 73 */ "kern_invalid", 312 /* 74 */ "kern_invalid", 313 /* 75 */ "kern_invalid", 314 /* 76 */ "_kernelrpc_mach_port_type_trap", 315 /* 77 */ "_kernelrpc_mach_port_request_notification_trap", 316 /* 78 */ "kern_invalid", 317 /* 79 */ "kern_invalid", 318 /* 80 */ "kern_invalid", 319 /* 81 */ "kern_invalid", 320 /* 82 */ "kern_invalid", 321 /* 83 */ "kern_invalid", 322 /* 84 */ "kern_invalid", 323 /* 85 */ "kern_invalid", 324 /* 86 */ "kern_invalid", 325 /* 87 */ "kern_invalid", 326 /* 88 */ "kern_invalid", 327 /* 89 */ "mach_timebase_info_trap", 328 /* 90 */ "mach_wait_until_trap", 329 /* 91 */ "mk_timer_create_trap", 330 /* 92 */ "mk_timer_destroy_trap", 331 /* 93 */ "mk_timer_arm_trap", 332 /* 94 */ "mk_timer_cancel_trap", 333 /* 95 */ "kern_invalid", 334 /* traps 64 - 95 reserved (debo) */ 335 /* 96 */ "debug_control_port_for_pid", 336 /* 97 */ "kern_invalid", 337 /* 98 */ "kern_invalid", 338 /* 99 */ "kern_invalid", 339 /* traps 100-107 reserved for iokit (esb) */ 340 /* 100 */ "iokit_user_client_trap", 341 /* 101 */ "kern_invalid", 342 /* 102 */ "kern_invalid", 343 /* 103 */ "kern_invalid", 344 /* 104 */ "kern_invalid", 345 /* 105 */ "kern_invalid", 346 /* 106 */ "kern_invalid", 347 /* 107 */ "kern_invalid", 348 /* traps 108-127 unused */ 349 /* 108 */ "kern_invalid", 350 /* 109 */ "kern_invalid", 351 /* 110 */ "kern_invalid", 352 /* 111 */ "kern_invalid", 353 /* 112 */ "kern_invalid", 354 /* 113 */ "kern_invalid", 355 /* 114 */ "kern_invalid", 356 /* 115 */ "kern_invalid", 357 /* 116 */ "kern_invalid", 358 /* 117 */ "kern_invalid", 359 /* 118 */ "kern_invalid", 360 /* 119 */ "kern_invalid", 361 /* 120 */ "kern_invalid", 362 /* 121 */ "kern_invalid", 363 /* 122 */ "kern_invalid", 364 /* 123 */ "kern_invalid", 365 /* 124 */ "kern_invalid", 366 /* 125 */ "kern_invalid", 367 /* 126 */ "kern_invalid", 368 /* 127 */ "kern_invalid", 369 }; 370 371 const int mach_trap_count = (sizeof(mach_trap_table) / sizeof(mach_trap_table[0])); 372 373 kern_return_t 374 kern_invalid( 375 __unused struct kern_invalid_args *args) 376 { 377 if (kern_invalid_debug) { 378 Debugger("kern_invalid mach trap"); 379 } 380 return KERN_INVALID_ARGUMENT; 381 }