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:

(ladebug) alias  
F1	print
F2	print 'F2 executes the command "F2 selected-text" - define alias F2'
F3	print 'F3 executes the command "F3 selected-text" - define alias F3'
S	next
Si	nexti
W	list $curline - 10:20
a	assign
att	attach
b	stop at
bp	stop in
c	cont
d	delete
det	detach
e	file
exit	quit
f	func
g	goto
h	history
j	status
l	list
li	($cursrcpc)/10 i; set $cursrcpc = $cursrcpc + 40
n	next
ni	nexti
p	print
pd	printd
pi	playback input
plist	show process all
po	printo
pr	printregs
ps	printf "%s",
px	printx
q	quit
r	rerun
ri	record input
ro	record output
s	step
si	stepi
source	playback input
sw	switch
switch	process
t	where
tlist	show thread
ts	where thread all
tset	thread
tstack	where thread all
u	list $curline - 9:10
w	list $curline - 5:10
wi	($curpc - 20)/10 i
wm	watch memory
wv	watch variable

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.