Environment VariablesΒΆ

Certain environment variables can affect or tune the behavior of the library. The variables and their behavior are described here.

  • BOTAN_THREAD_POOL_SIZE controls the number of threads which will be created for a thread pool used for some purposes within the library. If not set then it defaults to the number of CPUs available on the system.

  • BOTAN_MLOCK_POOL_SIZE controls the total amount of memory which will be locked in memory using mlock or VirtualLock and managed in a memory pool. If set to 0 (or indeed any value smaller than the system page size), then the memory pool is disabled.

  • BOTAN_FFI_PRINT_EXCEPTIONS if this variable is set (to any value), then if an exception is caught by the FFI layer, before returning an error code, it will print the text message of the exception to stderr. This is primarily intended for debugging.