Diagnostics

Readme

Game diagnostics.

Environment Variables

Variable Name	Value	Notes
NWNX_DIAGNOSTICS_MEMORY_SANITIZER	true/false	Enables the memory sanitizer

Memory Sanitizer

The memory sanitizer catches a few classes of memory corruptions in NWN and NWNX:

• Buffer overrun for heap buffers (writing outside the bounds of allocation)
• Use after free
• Double free

To use, in addition to the environment variable, you must preload NWNX_Diagnostics.so along with NWNX_Core.so, like:

LD_PRELOAD=/path/to/NWNX_Core.so:/path/to/NWNX_Diagnostics.so

NOTE: Enabling the sanitizer will make it impossible to cleanly shut down the server. When the plugins unload, the server will crash. This is an unavoidable side effect.