1 //===-- interception_linux.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 AddressSanitizer, an address sanity checker. 10 // 11 // Windows-specific interception methods. 12 //===----------------------------------------------------------------------===// 13 14 #if SANITIZER_WINDOWS 15 16 #if !defined(INCLUDED_FROM_INTERCEPTION_LIB) 17 # error "interception_win.h should be included from interception library only" 18 #endif 19 20 #ifndef INTERCEPTION_WIN_H 21 #define INTERCEPTION_WIN_H 22 23 namespace __interception { 24 // All the functions in the OverrideFunction() family return true on success, 25 // false on failure (including "couldn't find the function"). 26 27 // Overrides a function by its address. 28 bool OverrideFunction(uptr old_func, uptr new_func, uptr *orig_old_func = 0); 29 30 // Overrides a function in a system DLL or DLL CRT by its exported name. 31 bool OverrideFunction(const char *name, uptr new_func, uptr *orig_old_func = 0); 32 33 // Windows-only replacement for GetProcAddress. Useful for some sanitizers. 34 uptr InternalGetProcAddress(void *module, const char *func_name); 35 36 // Overrides a function only when it is called from a specific DLL. For example, 37 // this is used to override calls to HeapAlloc/HeapFree from ucrtbase without 38 // affecting other third party libraries. 39 bool OverrideImportedFunction(const char *module_to_patch, 40 const char *imported_module, 41 const char *function_name, uptr new_function, 42 uptr *orig_old_func); 43 44 #if !SANITIZER_WINDOWS64 45 // Exposed for unittests 46 bool OverrideFunctionWithDetour( 47 uptr old_func, uptr new_func, uptr *orig_old_func); 48 #endif 49 50 // Exposed for unittests 51 bool OverrideFunctionWithRedirectJump( 52 uptr old_func, uptr new_func, uptr *orig_old_func); 53 bool OverrideFunctionWithHotPatch( 54 uptr old_func, uptr new_func, uptr *orig_old_func); 55 bool OverrideFunctionWithTrampoline( 56 uptr old_func, uptr new_func, uptr *orig_old_func); 57 58 // Exposed for unittests 59 void TestOnlyReleaseTrampolineRegions(); 60 61 } // namespace __interception 62 63 #if defined(INTERCEPTION_DYNAMIC_CRT) 64 #define INTERCEPT_FUNCTION_WIN(func) \ 65 ::__interception::OverrideFunction(#func, \ 66 (::__interception::uptr)WRAP(func), \ 67 (::__interception::uptr *)&REAL(func)) 68 #else 69 #define INTERCEPT_FUNCTION_WIN(func) \ 70 ::__interception::OverrideFunction((::__interception::uptr)func, \ 71 (::__interception::uptr)WRAP(func), \ 72 (::__interception::uptr *)&REAL(func)) 73 #endif 74 75 #define INTERCEPT_FUNCTION_VER_WIN(func, symver) INTERCEPT_FUNCTION_WIN(func) 76 77 #define INTERCEPT_FUNCTION_DLLIMPORT(user_dll, provider_dll, func) \ 78 ::__interception::OverrideImportedFunction( \ 79 user_dll, provider_dll, #func, (::__interception::uptr)WRAP(func), \ 80 (::__interception::uptr *)&REAL(func)) 81 82 #endif // INTERCEPTION_WIN_H 83 #endif // SANITIZER_WINDOWS 84