Allinea Tools Environment Variables

Commonly Used

Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
DDT_EDITOR
MAP_EDITOR
External editor program. This program will be launched when the "Open in Editor" context menu item is used. ddt,map
ALLINEA_LICENCE_FILE
ALLINEA_LICENSE_FILE
Location of the licence file ${ALLINEA_TOOLS_PATH}/Licence
${ALLINEA_TOOLS_PATH}/License
ddt,map
ALLINEA_LICENCE_DIR
ALLINEA_LICENCE_DIR
Location of the licences directory ${ALLINEA_TOOLS_PATH}/licences ddt,map
ALLINEA_LICENCE_LOGFILE Location of the licenceserver log file licenceserver

Warning Suppression

Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
DDT_IGNORE_MPI_RANK_ERRORS
MAP_IGNORE_MPI_RANK_ERRORS
Don't show an error if DDT / MAP can't get the rank of a process ddt,map
DDT_IGNORE_NO_DEBUG
MAP_IGNORE_NO_DEBUG
Don't show an error if DDT / MAP can't find debug symbols ddt,map
DDT_IGNORE_VERSION_MISMATCH
MAP_IGNORE_VERSION_MISMATCH
Don't show an error when DDT / MAP's frontend and backend versions do not match. ddt,map
DDT_NO_APPLICATION_PROBE
MAP_NO_APPLICATION_PROBE
Don't attempt to auto-detect MPI or CUDA executables ddt,map
DDT_NO_CUDA_AUTODETECT Don't attempt to auto-detect CUDA executables ddt
DDT_NO_MPI_AUTODETECT
MAP_NO_MPI_AUTODETECT
Turn off automatic detection of MPI programs (use this if DDT / MAP keeps complaining your program isn't an MPI program) ddt,map
DDT_NO_OPENMP_AUTODETECT
MAP_NO_OPENMP_AUTODETECT
Don't attempt to auto-detect OpenMP executables ddt
DDT_NO_STATIC_DDTSIM_AUTODETECT Don't attempt to auto-detect ddtsim-linked executables (use this if DDT attempts to preload ddtsim with a executable already linked with ddtsim) ddt
DDT_ALLOW_CRAY_DMALLOC_PRELOAD Allow the memory debugging (dmalloc) library to be preloaded when using Cray MPT.
Note: this environment variable is unsupported and requires the Allinea tools installation directory to be visible on the compute nodes.
ddt

Input/Output

Override default output handling behaviour.
Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
DDT_ALWAYS_USE_OWN_STDIN
MAP_ALWAYS_USE_OWN_STDIN
Always enable stdin view ddt,map
DDT_IGNORE_MPI_OUTPUT
MAP_IGNORE_MPI_OUTPUT
Ignore output from mpirun (default: ignored if using queues) ddt,map
DDT_KEEP_MPI_OUTPUT
MAP_KEEP_MPI_OUTPUT
Show output from mpirun as coming from Process 0 (default: ignored if using queues) ddt,map
DDT_NEVER_USE_OWN_STDIN
MAP_NEVER_USE_OWN_STDIN
Disable the stdin view ddt,map
DDT_OFFLINE_NO_STDOUT
MAP_OFFLINE_NO_STDOUT
Disable printing standard output and error of program to standard out in offline mode, it will be still in the generated log file ddt,map

Licensing

Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
ALLINEA_LICENCE_FILE Location of the licence file ${ALLINEA_TOOLS_PATH}/Licence ddt,map
ALLINEA_LICENSE_FILE Location of the licence file ${ALLINEA_TOOLS_PATH}/License ddt,map
ALLINEA_LICENCE_LOGFILE Location of log file licenceserver
ALLINEA_LICENCE_LOGLEVEL Level of log output licenceserver
ALLINEA_MAC_INTERFACE Specify the host name of the network interface the licence is tied to host ddt,map,licenceserver

Troubleshooting

Simple troubleshooting environment variables.
Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
DDT_FORCE_CUDA_VERSION Bypass CUDA toolkit version detection, assuming the version specified instead. e.g. DDT_FORCE_CUDA_VERSION=3.2 ddt-debugger
DDT_NO_TIMEOUT
MAP_NO_TIMEOUT
Don't time out if nodes don't connect after a certain amout of time. May be necessary if the MPI subsystem takes unusually long to start processes. ddt,map
DDT_PROCESS_TIMEOUT
MAP_PROCESS_TIMEOUT
Amount of time (ms) to wait for a process to connect to the front end ddt,map
DDT_DONT_GET_RANK
MAP_DONT_GET_RANK
Don't automatically get the rank of MPI processes ddt-debugger
DDT_MPI_COMM_WORLD
MAP_MPI_COMM_WORLD
Override value of MPI_Comm_World. The correct value for your MPI implementation can be found in the mpi.h header. ddt,map
DDT_NO_STACK_ARGS
MAP_NO_STACK_ARGS
Don't show arguments in stack back traces. Increases performance in some cases. gdb ddt-debugger
DDT_QUEUE_DLL Location of message queue debugging library ddt
DDT_READ_SYMBOLS_LATER
MAP_READ_SYMBOLS_LATER
Read symbols on demand. This may mean some Fortran module information is missing. AIX gdb ddt-debugger
DDT_READ_SYMBOLS_NOW
MAP_READ_SYMBOLS_NOW
Read symbols before starting program. This may increase startup time and memory usage. not AIX gdb ddt-debugger

Advanced Troubleshooting

More advanced startup troubleshooting environment variables. Should only be used under direction from Allinea.
Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
DDT_DEFAULT_HOSTNAME
MAP_DEFAULT_HOSTNAME
Host name of the frontend as visible from the nodes. Cray XT and Blue Gene ddt,map
DDT_HOST
MAP_HOST
MAP_HOST
MAP_HOST
Name of host front end is listening on as visible from the nodes. ddt-debugger
DDT_SEASTAR_INTERFACE
MAP_SEASTAR_INTERFACE
Name of the Cray SeaStar interface ss Cray XT ddt,map
DDT_SESSION_FILE
MAP_SESSION_FILE
Path to the session file ~/.allinea/session/latest ddt-debugger
DDT_MPI_INIT
MAP_MPI_INIT
Name of MPI_Init symbol MPI_Init ddt-debugger
DDT_ENTRY_POINT
MAP_ENTRY_POINT
Name of 'main' symbol main gdb ddt-debugger
DDT_NO_FINISH_MPI
MAP_NO_FINISH_MPI
Don't step out of MPI_Init. Setting this may prevent startup working on some systems. ddt,map
DDT_DEBUGGER_MPI_INIT_TIMEOUT
MAP_DEBUGGER_MPI_INIT_TIMEOUT
Maximum time (milliseconds) to wait for MPI_Init to return none ddt-debugger
DDT_DEBUGGER_STARTER_TIMEOUT
MAP_DEBUGGER_STARTER_TIMEOUT
Maximum time (milliseconds) to wait for mpirun (or equivalent) to spawn all processes none ddt-debugger
DDT_IGNORE_MPI_INIT_ERRORS
MAP_IGNORE_MPI_INIT_ERRORS
Ignore errors that occur in MPI_Init ddt,map
DDT_FORCE_LOCAL_MQS Force the use of local message queue debugging library. This will significantly reduce performance. ddt
DDT_ALWAYS_USE_OWN_STDIN
MAP_ALWAYS_USE_OWN_STDIN
Always enable stdin view, even if -stdin was specified as an mpirun argument. ddt,map
DDT_DISABLE_AUTO_FILE_LOADING
MAP_DISABLE_AUTO_FILE_LOADING
Don't automatically open source files after a stop ddt,map
DDT_DISABLE_GET_FILES_AFTER_STOP
MAP_DISABLE_GET_FILES_AFTER_STOP
Don't update source file list after a stop. ddt,map
DDT_OFFLINE_LAUNCHER_LOG
MAP_OFFLINE_LAUNCHER_LOG
Configure logging of offline launcher by comma separated list of values. Valid values are auth (displays X authority information to connect to Xvfb), xvfb (displays standard output/error of Xvfb), debug and verbose (activates everything). ddt,map
DDT_OFFLINE_SUPPRESS_EXTRA_MESSAGES
MAP_OFFLINE_SUPPRESS_EXTRA_MESSAGES
Supress all messages beside those which the user has selected (Menu: Control -> Messages). ddt,map
DDT_SLOW_VALUE_PRINT
MAP_SLOW_VALUE_PRINT
Use a slower but possibly more stable variable printing method. May be recommended if parsing errors occur. ddt-debugger
DDT_LEGACY_SMP_STARTUP
MAP_LEGACY_SMP_STARTUP
Use legacy SMP startup for mpich 1 gm mpich 1 gm ddt,map
DDT_NODE_SCAN_TIMEOUT Maximum time (seconds) to wait for a process list from a host in the Attach window ddt
DDT_DEBUGGER_MAX_WAIT
MAP_DEBUGGER_MAX_WAIT
Maximum time (seconds) ddt-debugger should wait to connect to the tree 300 ddt-debugger

Timeouts

Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
DDT_DEBUGGER_MPI_INIT_TIMEOUT
MAP_DEBUGGER_MPI_INIT_TIMEOUT
Maximum time (milliseconds) to wait for MPI_Init to return none ddt-debugger
DDT_DEBUGGER_STARTER_TIMEOUT
MAP_DEBUGGER_STARTER_TIMEOUT
Maximum time (milliseconds) to wait for mpirun (or equivalent) to spawn all processes none ddt-debugger
DDT_DEBUGGER_MAX_WAIT
MAP_DEBUGGER_MAX_WAIT
Maximum time (seconds) ddt-debugger should wait to connect to the tree 300 ddt-debugger
DDT_NO_TIMEOUT
MAP_NO_TIMEOUT
Don't time out if nodes don't connect after a certain amout of time ddt,map
DDT_NODE_SCAN_TIMEOUT Maximum time (seconds) to wait for a process list from a host in the Attach window ddt
DDT_OFFLINE_CONNECT_TIMEOUT
MAP_OFFLINE_CONNECT_TIMEOUT
Additional time (milliseconds) to wait if nodes don't connect after a certain amount (see DDT_NO_TIMEOUT) in offline mode. 30000 ddt,map
DDT_OFFLINE_LICENCE_TIMEOUT
MAP_OFFLINE_LICENCE_TIMEOUT
Additional time (milliseconds) to wait for licence server or necessary licences (if currently unavailable) in offline mode. 30000 ddt,map
DDT_OFFLINE_PLAY_AFTER_STOP_TIMEOUT
MAP_OFFLINE_PLAY_AFTER_STOP_TIMEOUT
Maximum time (milliseconds) to wait before playing/continuing process after a stop (e.g. breakpoint hit, signal received, etc.) in offline mode. 2500 ddt,map
DDT_PROCESS_TIMEOUT
MAP_PROCESS_TIMEOUT
Amount of time (ms) to wait for a process to connect to the front end ddt,map

Networking

There is usually no need to specify these as DDT will do so automatically.
Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
DDT_DEFAULT_HOSTNAME
MAP_DEFAULT_HOSTNAME
Host name of the frontend Cray XT and Blue Gene ddt,map
DDT_HOST
MAP_HOST
Name of host front end is listening on ddt-debugger
DDT_NO_EXTRA_CONNECTIONS Don't allow more connections to the frontend than expected ddt
DDT_PORT
MAP_PORT
Port front end is listening on ddt-debugger
DDT_SEASTAR_INTERFACE
MAP_SEASTAR_INTERFACE
Name of the Cray SeaStar interface ss Cray XT ddt,map
DDT_DEBUGGER_MAX_WAIT
MAP_DEBUGGER_MAX_WAIT
Maximum time (seconds) ddt-debugger should wait to connect to the tree 300 ddt-debugger
HOSTNAME Name of the local host ddt-debugger
DDT_LOCALHOST_IPV6
MAP_LOCALHOST_IPV6
Use ::1 to connect to localhost instead of 127.0.0.1 ddt-debugger

Syntax Highlighting

Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
DDT_FORCE_C_INCLUDES
MAP_FORCE_C_INCLUDES
Always parse header files as C ddt,map
DDT_FORCE_CPLUSPLUS_INCLUDES
MAP_FORCE_CPLUSPLUS_INCLUDES
Always parse header files as C++ ddt,map
DDT_FORCE_FIXED_FORMAT_INCLUDES
MAP_FORCE_FIXED_FORMAT_INCLUDES
Always parse header files as fixed format Fortran ddt,map
DDT_FORCE_FIXED_FORMAT_PARSER
MAP_FORCE_FIXED_FORMAT_PARSER
Force use of fixed format Fortran parser ddt,map
DDT_FORCE_FORMAT_INCLUDES
MAP_FORCE_FORMAT_INCLUDES
Always parse header files as Fortran ddt,map
DDT_FORCE_FREE_FORMAT_INCLUDES
MAP_FORCE_FREE_FORMAT_INCLUDES
Always parse header files as free format Fortran ddt,map
DDT_FORCE_FREE_FORMAT_PARSER
MAP_FORCE_FREE_FORMAT_PARSER
Force use of free format Fortran parser ddt,map

External

Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
HOME Current user's home directory ddt,map,ddt-debugger,dmalloc,gdb
LD_PRELOAD Shared objects to preload ddt-debugger
LOGNAME Login name of the current user ddt,map
MP_CHILD Rank of child process ibm-pe ddt-debugger
MPI_COMPILER Name of MPI compiler ddt,map
MPI_ENVIRONMENT Name of MPI environment ddt,map
OMP_NUM_THREADS Number of OpenMP threads ddt,map,OpenMP
PATH Path to search for programs ddt,map,ddt-debugger
PWD Current working directory dbx ddt,map-debugger
SHELL Current user's shell program ddt-debugger
TMP Location of /tmp ddt,map
TMPDIR Location of /tmp ddt-debugger
USER Name of current user ddt-debugger

Unclassified

Name Description Default Platform(s) Debugger(s) MPI(s) Program(s)
DDT_ALLOW_NEWLINE_IN_ARGS
MAP_ALLOW_NEWLINE_IN_ARGS
Allow newlines in program arguments ddt,map
DDT_ALPS_LIB
MAP_ALPS_LIB
Name of ALPS helper library libalps Cray XT ddt,map,ddt-debugger
DDT_ALPS_LIB_DISABLE
MAP_ALPS_LIB_DISABLE
Disable use of ALPS helper library Cray XT ddt,map,ddt-debugger
DDT_ALPS_RPC_LIB
MAP_ALPS_RPC_LIB
Name of ALPS RPC library libxmlrpc Cray XT ddt,map,ddt-debugger
DDT_BLUEGENE_NO_COPY_FILES
MAP_BLUEGENE_NO_COPY_FILES
Don't copy DDT files to the I/O node ram disk Bluegene ddt-debugger
DDT_DEBUGGER_USER_FILE
MAP_DEBUGGER_USER_FILE
Location of file containing commands to send to the debugger upon initialisation ddt-debugger
DDT_DISABLE_AUTO_SESSIONS
MAP_DISABLE_AUTO_SESSIONS
Don't automatically save certain settings (e.g. list of search paths) ddt,map
DDT_DISABLE_FILE_AUTO_ADD
MAP_DISABLE_FILE_AUTO_ADD
Don't automatically add files that don't appear in the initial source file list to the source browser. ddt,map
DDT_DISABLE_MEMORY_DEBUGGING Disable memory debugging ddt
DDT_DISABLE_PRETTY_PRINT Disable Python pretty printing gdb ddt-debugger
DDT_ENABLE_REMOTE_ATTACH Enable remote attach page in Attach window (experimental, not supported) ddt,map
DDT_GDB_SOLIBS Stop program when a shared library is loaded gdb ddt-debugger
DDT_MANUAL_LAUNCH Turn on manual launch mode (e.g. errors reported to stderr) ddt-debugger
DDT_MPIRUN_ARGUMENTS
MAP_MPIRUN_ARGUMENTS
Value to supply to the mpirun arguments field: equivalent to -mpiargs "{value}". ddt,map
DDT_NO_INIT_TARGET
MAP_NO_INIT_TARGET
Don't send the file name of the target executable to ddt-debugger ddt,map
DDT_NO_SESSION_COOKIE
MAP_NO_SESSION_COOKIE
Don't check session cookies ddt,map,ddt-debugger
DDT_NO_SPLASH
MAP_NO_SPLASH
Don't show the spash screen (helps when forwarding X over a slow connection) ddt,map
DDT_NO_STYLE
MAP_NO_STYLE
Don't override the default visual style ddt,map
DDT_NO_TREESERVER_KILL_TARGET
MAP_NO_TREESERVER_KILL_TARGET
Don't kill any remaining processes after the job finishes ddt-treeserver
DDT_NO_USE_PROCESS_TARGET
MAP_NO_USE_PROCESS_TARGET
Don't attempt to get the file name of an executable from /proc//exe ddt-treeserver
DDT_OLD_STYLE_STACK
MAP_OLD_STYLE_STACK
Don't modify the stack output from the debugger ddt,map
DDT_PASS_THROUGH_ARGUMENTS
MAP_PASS_THROUGH_ARGUMENTS
Arguments to pass through to the program ddt,map
DDT_REMOTE_TARGET_MPIRUN_RESUME_DELAY
MAP_REMOTE_TARGET_MPIRUN_RESUME_DELAY
Time to wait (seconds) after a remote attach before responding to other commands ddt-debugger
DDT_RESTART_ON_CRASH
MAP_RESTART_ON_CRASH
Automatically restart if the frontend crashes ddt,map
DDT_RUN_WITHOUT_DEBUGGER
MAP_RUN_WITHOUT_DEBUGGER
Don't run ddt-debugger ddt,map
DDT_SESSION
MAP_SESSION
Session number of front end (determines the port front end is listening on) ddt-debugger
DDT_SESSION_COOKIE
MAP_SESSION_COOKIE
Session cookie for connection to front end ddt-debugger
DDT_SESSION_PATH
MAP_SESSION_PATH
Path to store session files (default: ~/.allinea/session) ddt,map,ddt-debugger
DDT_SET_BACKTRACE_LIMIT
MAP_SET_BACKTRACE_LIMIT
Maximum number of back trace stack frames gdb ddt-debugger
DDT_SHOW_CONSOLE_EXCEPTIONS
MAP_SHOW_CONSOLE_EXCEPTIONS
Duplicate errors on stderr ddt,map
DDT_SHOW_STARTUP_PAUSE_BUTTON
MAP_SHOW_STARTUP_PAUSE_BUTTON
Show a pause button on the Startup window ddt,map
DDT_SKIP_DEBUGGER_PIPES
MAP_SKIP_DEBUGGER_PIPES
Skip initialisation of debugger pipes ddt,map
DDT_TREE_DEPTH
MAP_TREE_DEPTH
Override the default tree depth ddt,map
DDT_USE_SLOW_MEM_FUNC Use slower memory leak gathering algorithmn dbx,gdb ddt-debugger
ALLINEA_TOOLS_CONFIG_DIR Location of DDT / MAP configuration files (default: ~/.allinea) ddt,map
ALLINEA_TOOLS_DEFAULT_SYSTEM_CONFIG Location of default DDT / MAP system configure file (default: $ALLINEA_TOOLS_PATH/system.config)
The defaults from this configuration file will be used if a user has no existing configuration.
When using the remote client this file is stored on the remote system.
ddt,map
ALLINEA_TOOLS_SYSTEM_CONFIG Location of DDT / MAP system configure file (default: ~/.allinea/system.config)
When using the remote client this file is stored on the remote system.
ddt,map
ALLINEA_TOOLS_USER_CONFIG Location of DDT / MAP system configure file (default: ~/.allinea/user.config)
When using the remote client this file is stored on the local system.
ddt,map
DDT_LOG
MAP_LOG
Location of log file ddt,map
DDT_LOGS
MAP_LOGS
Location of detailed log files ddt,map
DDT_MPIRUN
MAP_MPIRUN
Location of mpirun ddt,map
ALLINEA_TOOLS_PATH Path to Allinea tools root directory ddt,map,ddt-debugger
DEPRECATED_INFO_SOURCES Use old source file search algorithmn gdb ddt-debugger
DMALLOC_OPTIONS Options used by dmalloc (set by DDT from Memory Debugging settings) dmalloc
DDT_VISIT_PATH Location of toplevel VisIt directory (containing bin/visit) ddt,map,ddt-debugger
DDT_SOCKET Location of a socket file to which third-party programs can connect in order to send commands to DDT ddt,map
MAP_INTERVAL Initial time between samples in milliseconds 20 map
MAP_KEEP_SAMPLES_FILES Directory path to move samples file into map
MAP_MPI_WRAPPER Location of MPI wrapper library map
MAP_NUM_SAMPLES Number of samples per process to be gathered 1000 map
MAP_PRESERVE_WRAPPER Don't delete generated wrapper source or libraries map
MAP_SAMPLER_NO_TIME_MPI_CALLS Don't time MPI calls map
MAP_SAMPLER_TRY_USE_SMAPS Use /proc/[pid]/smaps for memory usage data map
DDT_VCS_TRACEPOINT_HIT_LIMIT Number of times version control tracepoints may be hit before being removed (0 for no limit) 20 ddt
MPICC Location of MPI compiler map