doylet/ASANManualPoisoning
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge header codeblock from <sanitizer/asan_interface.h>

Browse Source
This commit is contained in:
doyle 2023-08-28 23:31:21 +10:00
parent 1aa3728a55
commit 4ffbaf815a
1 changed files with 3 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
asan_example.cpp
View File

@ -85,25 +85,21 @@ int main()
"\n" "\n"
"ASAN provides a way to manually markup ranges of bytes to\n" "ASAN provides a way to manually markup ranges of bytes to\n"
"prohibit or permit reads to those addresses. In\n" "prohibit or permit reads to those addresses. In\n"
"`<sanitizer/asan_interface.h>` there's a brief mention for the poison\n" "`<sanitizer/asan_interface.h>` there's a vague brief mention to\n"
"and unpoison API respectively:\n" "alignment requirements for the poison API:\n"
"\n" "\n"
"```cpp\n" "```cpp\n"
"/// ... This function is not guaranteed to poison the entire region -\n" "/// ... This function is not guaranteed to poison the entire region -\n"
"/// it could poison only a subregion of <c>[addr, addr+size)</c> due to ASan\n" "/// it could poison only a subregion of <c>[addr, addr+size)</c> due to ASan\n"
"/// alignment restrictions.\n" "/// alignment restrictions.\n"
"void __asan_poison_memory_region(void const volatile *addr, size_t size);\n" "void __asan_poison_memory_region(void const volatile *addr, size_t size);\n"
"```\n"
"\n" "\n"
"and:\n"
"\n"
"```cpp\n"
"/// ... This function could unpoison a super-region of <c>[addr, addr+size)</c> due\n" "/// ... This function could unpoison a super-region of <c>[addr, addr+size)</c> due\n"
"/// to ASan alignment restrictions.\n" "/// to ASan alignment restrictions.\n"
"void __asan_unpoison_memory_region(void const volatile *addr, size_t size);\n" "void __asan_unpoison_memory_region(void const volatile *addr, size_t size);\n"
"```\n" "```\n"
"\n" "\n"
"There's another brief foot-note in Google's " "There's another small foot-note in Google's "
"[AddressSanitizerManualPoisoning](https://github.com/google/" "[AddressSanitizerManualPoisoning](https://github.com/google/"
"sanitizers/wiki/AddressSanitizerManualPoisoning)\n" "sanitizers/wiki/AddressSanitizerManualPoisoning)\n"
"documentation that states:\n" "documentation that states:\n"