Title and Contents

Appendixes

Appendix 1—Debugger Variables

The debugger has the following predefined variables:

Variable
Default Setting
Description
$ascii
1
Prints ASCII or all ISO Latin-1.
$beep
1
Beeps on illegal command line editing.
$catchexecs
0
Stops execution on program exec.
$catchforkinfork
0
Notifies you as soon as the forked process is created (otherwise you are notified when the call finishes).
$catchforks
0
Notifies you on program fork.
$childprocess
0
When the debugger detects a fork, it assigns the child process ID to $childprocess.
$curevent
0
Displays the current breakpoint number.
$curfile
(null)
Displays the current source file.
$curfilepath
(null)
Displays the current source file access path.
$curline
0
Displays the current source line.
$curpc
0
Displays the current point of program execution.
$curprocess
0
Displays the current process ID.
$cursrcline
0
Displays the last source line at end of most recent source.
$cursrcpc
0
Displays the PC address at end of most recent machine code listing.
$curthread
0
Displays the current thread ID.
$dbxoutputformat
0
Displays various data structures in dbx format.
$dbxuse
0
Replaces current use paths.
$decints
0
Displays integers in decimal radix.
$doverbosehelp
1
Displays the help menu front page.
$editline
1
Enables command line editing.
$eventecho
1
Echoes events with event numbers.
$exitonterminationofprocesswithpid
None
If set to process ID (pid), when that process terminates, the debugger exits.
$funcsig
1
Displays function signature at breakpoint.
$giveladebughints
1
Displays hints on Ladebug features.
$hasmeta
0
Interprets multibyte characters.
$hexints
0
Displays integers in hex radix.
$historylines
20
Defines the number of commands to show for history.
$indent
1
Prints structures with indentation.
$lang
"None"
Defines the programming language of current routine.
$lasteventmade
0
Displays the number of last (successful) breakpoint definition.
$lc_ctype
"C"
Displays the current locale information.
$listwindow
20
Displays the number of lines to show for list.
$main
"main"
Displays the name of the first routine in the program.
$maxstrlen
128
Defines the largest string to print fully.
$octints
0
Displays integers in octal radix.
$overloadmenu
1
Prompts for choice of overloaded C++ name.
$page
1
Paginates debugger terminal output.
$pagewindow
0
Defines the number of lines per output page.
$parentprocess
0
When the debugger detects a fork, it assigns the parent process ID to $parentprocess.
$pimode
0
Echoes input to log file on playback input.
$prompt
"(ladebug) "
Specifies debugger prompt.
$repeatmode
1
Repeats previous command when you press the Return key.
$showlineonstartup
0
Displays the first executable line in main.
$showwelcomemsg
1
Displays welcome message at startup time.
$stackargs
1
Shows arguments in the call stack.
$statusargs
1
Prints breakpoints without parameters.
$stepg0
0
Steps over routines with minimal symbols.
$stoponattach
0
Stops the running process on attach.
$stopparentonfork
0
Stops parent process execution on fork. When set to a nonzero value, this variable instructs the debugger to stop the parent process after it forks a child process. The child process continues to run if $catchforks is set, otherwise it does not. The default is 0.
$threadlevel
"decthreads"
Specifies POSIX threads (DECthreads) or native threads.
$usedynamictypes
1
Evaluates using C++ static or dynamic type.
$verbose
0
Produces even more output.



Appendix 2—Debugger Aliases

The debugger has the following predefined aliases: