Debugging

These debugging values are intended only for host processing. They can be used under the test harness or by using the --noparallel registration option. For more information, see Debugging analytic executables.

NZAE_TERMINAL

Redirects standard input, output, and errors to a terminal. By default, this variable is not set. To use, set it to the name of a running terminal. Use the Linux tty command to get a terminal name, which is in the form /dev/pts/1. Before debugging, run sleep 1000000 on the terminal to keep the terminal's running shell from interfering with standard IO.

NZAE_TERMINAL=<terminal name>

NZAE_GDB_PATH

Runs GDB on the AE process. Use this feature along with NZAE_TERMINAL. The variable should be a full path to GDB or a debugger with GDB command line semantics. By default, this is not set. This feature works well with C, C++, and Fortran.

NZAE_GDB_PATH=<full path to GDB>

NZAE_SPIN_FILE_NAME

Attaches a debugger to the AE process while the program is "spinning" and then removes or renames the spin file. By default, this feature is not set. If set to an existing file name path, the AE initialization continually loops and sleeps until the named file is deleted or renamed. If it does not exist, the AE continues normal execution. For more information, see Local AE and Spin Files.

NZAE_SPIN_FILE_NAME=<spin file path>