Debugging

Debugging overview

oqsprovider has various debugging capabilities built in that are not enabled by default. This page documents how to enable them.

Background

oqsprovider can be made to output extensive traces of its operation when built in "Debug" configuration.

Setup

Run cmake with "-DCMAKE_BUILD_TYPE=Debug" set. See fullbuild.sh script for an example how/where to add this option.

Environment variables

Debug output level can be controlled by (selectively) setting one or several of the following environment variables, e.g., via export OQSPROV=1.

• OQSPROV: General provider (registration) output
• OQSKM: Key management operations
• OQSKEY: Operations on key material
• OQSSIG: Signature operations
• OQSKEM: KEM operations
• OQSDEC: Decode operations
• OQSENC: Encode operations