godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2025-12-31 17:49:03 +03:00
Code Issues Packages Projects Releases Wiki Activity

Add ThreadSanitizer usage note under Linux (#8908)

Browse Source 
* Add ThreadSanitizer usage note under Linux

---------

Co-authored-by: Max Hilbrunner <mhilbrunner@users.noreply.github.com>
This commit is contained in:
Wilson E. Alvarez
2024-11-17 08:50:17 -05:00
committed by GitHub
parent 5e8062d0bd
commit feeea91cdf
1 changed files with 34 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
contributing/development/debugging/using_sanitizers.rst
View File

@@ -140,6 +140,40 @@ slower, while also multiplying memory usage by an approximately 8× factor.
the address, memory and thread sanitizers are mutually exclusive. This means
you can only use one of those sanitizers in a given binary.
.. note::
On Linux, if you stumble upon the following error:
``FATAL: ThreadSanitizer: unexpected memory mapping``
You may need to temporarily lower the Address Space Layout Randomization (ASLR) entropy in your system with:
.. code:: sh
sudo sysctl vm.mmap_rnd_bits=28
Or preferably disable it entirely with:
.. code:: sh
sudo sysctl kernel.randomize_va_space=0
And as soon as you are done with the thread sanitizer, increase the ASLR entropy with:
.. code:: sh
sudo sysctl vm.mmap_rnd_bits=32
Or re-enable ASLR with:
.. code:: sh
sudo sysctl kernel.randomize_va_space=2
Rebooting your machine will also revert the ASLR state to its default values.
It's important to revert the changes as soon as possible because lowering the ASLR entropy or disabling ASLR entirely can be a security risk.
Undefined behavior sanitizer (UBSAN)
------------------------------------