1 /* 2 * Copyright (c) 2021 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 #ifndef _UBSAN_MINIMAL_H_ 30 #define _UBSAN_MINIMAL_H_ 31 32 #if CONFIG_UBSAN_MINIMAL 33 /* 34 * This minimal runtime contains the handlers for checks that are suitable 35 * at runtime. To minimize codegen impact, the handlers simply act as a shim 36 * to a brk instruction, which gets then inlined by the compiler+LTO. 37 * This is similar to UBSAN trapping mode, but guarantees that we can fix 38 * and continue by simply stepping to the next instruction during the exception 39 * handler. 40 * 41 * UBSAN Minimal runtime is currently available only for iOS and only for 42 * signed overflow checks. It is only used on RELEASE and DEVELOPMENT kernels. 43 */ 44 45 #pragma GCC visibility push(hidden) 46 enum ubsan_minimal_trap_idx { 47 UBSAN_MINIMAL_SIGNED_OVERFLOW = 0x1206, 48 UBSAN_MINIMAL_TRAPS_END 49 }; 50 #define UBSAN_MINIMAL_TRAPS_START UBSAN_MINIMAL_SIGNED_OVERFLOW 51 #define UBSAN_MINIMAL_TRAPS_TOTAL (UBSAN_MINIMAL_TRAPS_END - UBSAN_MINIMAL_TRAPS_START) 52 53 /* Trap handler for telemetry */ 54 void ubsan_handle_brk_trap(uint16_t, uintptr_t, uintptr_t); 55 56 /* Setup ubsan minimal runtime */ 57 void ubsan_minimal_init(void); 58 59 /* 60 * signed-integer-overflow ABI 61 */ 62 void __ubsan_handle_divrem_overflow_minimal(void); 63 void __ubsan_handle_negate_overflow_minimal(void); 64 void __ubsan_handle_mul_overflow_minimal(void); 65 void __ubsan_handle_sub_overflow_minimal(void); 66 void __ubsan_handle_add_overflow_minimal(void); 67 68 #pragma GCC visibility pop 69 70 #endif /* CONFIG_UBSAN_MINIMAL */ 71 #endif /* _UBSAN_MINIMAL_H_ */ 72