1 //===-- msan_interface_internal.h -------------------------------*- C++ -*-===// 2 // 3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4 // See https://llvm.org/LICENSE.txt for license information. 5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6 // 7 //===----------------------------------------------------------------------===// 8 // 9 // This file is a part of MemorySanitizer. 10 // 11 // Private MSan interface header. 12 //===----------------------------------------------------------------------===// 13 14 #ifndef MSAN_INTERFACE_INTERNAL_H 15 #define MSAN_INTERFACE_INTERNAL_H 16 17 #include "sanitizer_common/sanitizer_internal_defs.h" 18 19 extern "C" { 20 // FIXME: document all interface functions. 21 22 SANITIZER_INTERFACE_ATTRIBUTE 23 int __msan_get_track_origins(); 24 25 SANITIZER_INTERFACE_ATTRIBUTE 26 void __msan_init(); 27 28 // Print a warning and maybe return. 29 // This function can die based on common_flags()->exitcode. 30 SANITIZER_INTERFACE_ATTRIBUTE 31 void __msan_warning(); 32 33 // Print a warning and die. 34 // Instrumentation inserts calls to this function when building in "fast" mode 35 // (i.e. -mllvm -msan-keep-going) 36 SANITIZER_INTERFACE_ATTRIBUTE __attribute__((noreturn)) 37 void __msan_warning_noreturn(); 38 39 using __sanitizer::uptr; 40 using __sanitizer::sptr; 41 using __sanitizer::uu64; 42 using __sanitizer::uu32; 43 using __sanitizer::uu16; 44 using __sanitizer::u64; 45 using __sanitizer::u32; 46 using __sanitizer::u16; 47 using __sanitizer::u8; 48 49 // Versions of the above which take Origin as a parameter 50 SANITIZER_INTERFACE_ATTRIBUTE 51 void __msan_warning_with_origin(u32 origin); 52 SANITIZER_INTERFACE_ATTRIBUTE __attribute__((noreturn)) void 53 __msan_warning_with_origin_noreturn(u32 origin); 54 55 SANITIZER_INTERFACE_ATTRIBUTE 56 void __msan_maybe_warning_1(u8 s, u32 o); 57 SANITIZER_INTERFACE_ATTRIBUTE 58 void __msan_maybe_warning_2(u16 s, u32 o); 59 SANITIZER_INTERFACE_ATTRIBUTE 60 void __msan_maybe_warning_4(u32 s, u32 o); 61 SANITIZER_INTERFACE_ATTRIBUTE 62 void __msan_maybe_warning_8(u64 s, u32 o); 63 SANITIZER_INTERFACE_ATTRIBUTE 64 void __msan_maybe_warning_N(void *shadow, u64 size, u32 o); 65 66 SANITIZER_INTERFACE_ATTRIBUTE 67 void __msan_maybe_store_origin_1(u8 s, void *p, u32 o); 68 SANITIZER_INTERFACE_ATTRIBUTE 69 void __msan_maybe_store_origin_2(u16 s, void *p, u32 o); 70 SANITIZER_INTERFACE_ATTRIBUTE 71 void __msan_maybe_store_origin_4(u32 s, void *p, u32 o); 72 SANITIZER_INTERFACE_ATTRIBUTE 73 void __msan_maybe_store_origin_8(u64 s, void *p, u32 o); 74 75 SANITIZER_INTERFACE_ATTRIBUTE 76 void __msan_unpoison(const void *a, uptr size); 77 SANITIZER_INTERFACE_ATTRIBUTE 78 void __msan_unpoison_string(const char *s); 79 SANITIZER_INTERFACE_ATTRIBUTE 80 void __msan_unpoison_param(uptr n); 81 SANITIZER_INTERFACE_ATTRIBUTE 82 void __msan_clear_and_unpoison(void *a, uptr size); 83 SANITIZER_INTERFACE_ATTRIBUTE 84 void* __msan_memcpy(void *dst, const void *src, uptr size); 85 SANITIZER_INTERFACE_ATTRIBUTE 86 void* __msan_memset(void *s, int c, uptr n); 87 SANITIZER_INTERFACE_ATTRIBUTE 88 void* __msan_memmove(void* dest, const void* src, uptr n); 89 SANITIZER_INTERFACE_ATTRIBUTE 90 void __msan_poison(const void *a, uptr size); 91 SANITIZER_INTERFACE_ATTRIBUTE 92 void __msan_poison_stack(void *a, uptr size); 93 94 // Copy size bytes from src to dst and unpoison the result. 95 // Useful to implement unsafe loads. 96 SANITIZER_INTERFACE_ATTRIBUTE 97 void __msan_load_unpoisoned(void *src, uptr size, void *dst); 98 99 // Returns the offset of the first (at least partially) poisoned byte, 100 // or -1 if the whole range is good. 101 SANITIZER_INTERFACE_ATTRIBUTE 102 sptr __msan_test_shadow(const void *x, uptr size); 103 104 SANITIZER_INTERFACE_ATTRIBUTE 105 void __msan_check_mem_is_initialized(const void *x, uptr size); 106 107 SANITIZER_INTERFACE_ATTRIBUTE 108 void __msan_set_origin(const void *a, uptr size, u32 origin); 109 SANITIZER_INTERFACE_ATTRIBUTE 110 void __msan_set_alloca_origin(void *a, uptr size, char *descr); 111 SANITIZER_INTERFACE_ATTRIBUTE 112 void __msan_set_alloca_origin4(void *a, uptr size, char *descr, uptr pc); 113 SANITIZER_INTERFACE_ATTRIBUTE 114 void __msan_set_alloca_origin_with_descr(void *a, uptr size, u32 *id_ptr, 115 char *descr); 116 SANITIZER_INTERFACE_ATTRIBUTE 117 void __msan_set_alloca_origin_no_descr(void *a, uptr size, u32 *id_ptr); 118 SANITIZER_INTERFACE_ATTRIBUTE 119 u32 __msan_chain_origin(u32 id); 120 SANITIZER_INTERFACE_ATTRIBUTE 121 u32 __msan_get_origin(const void *a); 122 123 // Test that this_id is a descendant of prev_id (or they are simply equal). 124 // "descendant" here means that are part of the same chain, created with 125 // __msan_chain_origin. 126 SANITIZER_INTERFACE_ATTRIBUTE 127 int __msan_origin_is_descendant_or_same(u32 this_id, u32 prev_id); 128 129 130 SANITIZER_INTERFACE_ATTRIBUTE 131 void __msan_clear_on_return(); 132 133 SANITIZER_INTERFACE_ATTRIBUTE 134 void __msan_set_keep_going(int keep_going); 135 136 SANITIZER_INTERFACE_ATTRIBUTE 137 int __msan_set_poison_in_malloc(int do_poison); 138 139 SANITIZER_INTERFACE_ATTRIBUTE 140 const char *__msan_default_options(); 141 142 // For testing. 143 SANITIZER_INTERFACE_ATTRIBUTE 144 void __msan_set_expect_umr(int expect_umr); 145 SANITIZER_INTERFACE_ATTRIBUTE 146 void __msan_print_shadow(const void *x, uptr size); 147 SANITIZER_INTERFACE_ATTRIBUTE 148 void __msan_dump_shadow(const void *x, uptr size); 149 SANITIZER_INTERFACE_ATTRIBUTE 150 int __msan_has_dynamic_component(); 151 152 // For testing. 153 SANITIZER_INTERFACE_ATTRIBUTE 154 u32 __msan_get_umr_origin(); 155 SANITIZER_INTERFACE_ATTRIBUTE 156 void __msan_partial_poison(const void* data, void* shadow, uptr size); 157 158 // Tell MSan about newly allocated memory (ex.: custom allocator). 159 // Memory will be marked uninitialized, with origin at the call site. 160 SANITIZER_INTERFACE_ATTRIBUTE 161 void __msan_allocated_memory(const void* data, uptr size); 162 163 // Tell MSan about newly destroyed memory. Memory will be marked 164 // uninitialized. 165 SANITIZER_INTERFACE_ATTRIBUTE 166 void __sanitizer_dtor_callback(const void* data, uptr size); 167 SANITIZER_INTERFACE_ATTRIBUTE 168 void __sanitizer_dtor_callback_fields(const void *data, uptr size); 169 SANITIZER_INTERFACE_ATTRIBUTE 170 void __sanitizer_dtor_callback_vptr(const void *data); 171 172 SANITIZER_INTERFACE_ATTRIBUTE 173 u16 __sanitizer_unaligned_load16(const uu16 *p); 174 175 SANITIZER_INTERFACE_ATTRIBUTE 176 u32 __sanitizer_unaligned_load32(const uu32 *p); 177 178 SANITIZER_INTERFACE_ATTRIBUTE 179 u64 __sanitizer_unaligned_load64(const uu64 *p); 180 181 SANITIZER_INTERFACE_ATTRIBUTE 182 void __sanitizer_unaligned_store16(uu16 *p, u16 x); 183 184 SANITIZER_INTERFACE_ATTRIBUTE 185 void __sanitizer_unaligned_store32(uu32 *p, u32 x); 186 187 SANITIZER_INTERFACE_ATTRIBUTE 188 void __sanitizer_unaligned_store64(uu64 *p, u64 x); 189 190 SANITIZER_INTERFACE_ATTRIBUTE 191 void __msan_set_death_callback(void (*callback)(void)); 192 193 SANITIZER_INTERFACE_ATTRIBUTE 194 void __msan_copy_shadow(void *dst, const void *src, uptr size); 195 196 SANITIZER_INTERFACE_ATTRIBUTE 197 void __msan_scoped_disable_interceptor_checks(); 198 199 SANITIZER_INTERFACE_ATTRIBUTE 200 void __msan_scoped_enable_interceptor_checks(); 201 202 SANITIZER_INTERFACE_ATTRIBUTE 203 void __msan_start_switch_fiber(const void *bottom, uptr size); 204 205 SANITIZER_INTERFACE_ATTRIBUTE 206 void __msan_finish_switch_fiber(const void **bottom_old, uptr *size_old); 207 } // extern "C" 208 209 #endif // MSAN_INTERFACE_INTERNAL_H 210