Debugging Aids

Storage Manager Methods for Debugging

The storage manager contains a few methods that are useful for debugging purposes. Some of these should be used for not other purpose, as they are not thread-safe, or might be very expensive. See Storage Manager API Methods for Debugging.

Build-time Debugging Options

At configure time, you can control which debugger-related options (symbols, inlining, etc) with the debug-level options. See Configuration Options.

Tracing (--enable-trace)

When this build option is used, additional code is included in the build to enable some limited tracing. These C Preprocessor macros apply: -W_TRACE --enable-trace defines this. -FUNC Outputs the function name when the function is entered. -DBG Outputs the arguments. -DBGTHRD Outputs the arguments.

The tracing is controlled by these environment variables: -DEBUG_FLAGS: a list of file names to trace, e.g. "smfile.cpp log.cpp" -DEBUG_FILE: name of destination for the output. If not defined, the output is sent to cerr/stderr.

See Configuration Options.

Note:

This tracing is not thread-safe, as it uses streams output.

Return Code Checking (--enable-checkrc)

If a w_rc_t is set but not checked with method is_error(), upon destruction the w_rc_t will print a message to the effect "error not checked". See Configuration Options.

---