debugging

Define debugging levels that can be used to include extra debugging steps

Provides a bunch of macros (see the macronames Vector) that can be used to surround code in other modules so that it only runs if the 'debug level' passed to the --debug or -d command line argument is high enough.

Also provides macro *_ifelse whose names are taken from macronames, which can be used to switch definitions, etc. For example, if debug_shared_array is in macronames, then

const MPISharedArray = @debug_shared_array_ifelse(DebugMPISharedArray, Array)

can be used to make the type represented by MPISharedArray depend on the debug level.

Check blocksynchronize() was called from the same place on every process, checking the full backtrace of each call. Activated at _debug_level >= 4 Currently inactive (_debug_level = 0).

Evaluate first expression if debugblocksynchronizebacktrace is active, second expression if not debugblocksynchronizebacktrace is inactive (_debug_level = 0 < 4).

Check blocksynchronize() was called from the same place on every process, with quick check of call site. Activated at _debug_level >= 1 Currently inactive (_debug_level = 0).

Evaluate first expression if debugblocksynchronizequick is active, second expression if not debugblocksynchronizequick is inactive (_debug_level = 0 < 1).

Some extra checks that we do not want in production runs. Activated at _debug_level >= 1 Currently inactive (_debug_level = 0).

Evaluate first expression if debugconsistencychecks is active, second expression if not debugconsistencychecks is inactive (_debug_level = 0 < 1).

Check if any blocksynchronize() call could have been skipped without resulting in an error. Activated at _debug_level >= 5 Currently inactive (_debug_level = 0).

Evaluate first expression if debugdetectredundantblocksynchronize is active, second expression if not debugdetectredundantblocksynchronize is inactive (_debug_level = 0 < 5).

Initialize arrays with NaN. Activated at _debug_level >= 1 Currently inactive (_debug_level = 0).

Evaluate first expression if debuginitializeNaN is active, second expression if not debuginitializeNaN is inactive (_debug_level = 0 < 1).

Check for incorrect reads/writes to shared-memory arrays Activated at _debug_level >= 2 Currently inactive (_debug_level = 0).

Check that allocateshared() was called from the same place on every process. Activated at `debuglevel >= 4Currently inactive (debug_level = 0`).

Evaluate first expression if debugsharedarrayallocate is active, second expression if not debugsharedarrayallocate is inactive (_debug_level = 0 < 4).

Evaluate first expression if debugsharedarray is active, second expression if not debugsharedarray is inactive (_debug_level = 0 < 2).

Record where every array was allocated. Activated at _debug_level >= 3 Currently inactive (_debug_level = 0).

Evaluate first expression if debugtrackarrayallocatelocation is active, second expression if not debugtrackarrayallocatelocation is inactive (_debug_level = 0 < 3).

Check that every array is initialized before being used. Activated at _debug_level >= 3 Currently inactive (_debug_level = 0).

Evaluate first expression if debugtrackinitialized is active, second expression if not debugtrackinitialized is inactive (_debug_level = 0 < 3).