TOC PREV NEXT INDEX DOC LIST MASTER INDEX



A - B - C - D - E - F - G - H - I - J - K - L - M - N - O - P - Q - R - S - T - U - V - W - X - Y - Z

Using the Apex Debugger Index

A

activate
breakpoint 89
breakpoints 76
Add debugger option 183
'ADDRESS 151
address
display 166, 167
specify address for sync command 121
advance
after exception 69
after signal 69
instruction 69
advance command
debugger 68
alert_freq
debugger parameter 186
all
debugger parameter 186
apply
type to an address 171
assembly language
display 155
Assembly mode 5
assign
values 152
assign values
debugger 152
floating point coprocessor 153
asterisk (*) in screen mode debugger 19
attach 235
attributes 151
'ADDRESS 151
'BODY 151
'Body 42
'EPILOG 151
'FIRST 151
'FIRST(N) 151
'FIRST_INST 151
'LAST 151
'LAST(N) 151
'LAST_INST 151
'N() 151
'PROLOG 151
'RANGE 151
'RANGE(N) 151
'SPEC 151
'Spec 42
'TAG 151
'TYPE 151
Auto Expand Pointer debugger option 184
Automatic debugger windows 32
automatic download
do not perform 9

B

b off 90
b on 89
bb
debugger parameter 187
bd
debugger command 81
bi
debugger command 83
Block on Signal debugger option 185
'BODY 151
'Body attribute 42
body debugger pathname 42
br
debugger command 85
break
at instruction 83
at return 85
break at procedure (B) 11
Break on Signal debugger option 185
Break Spots
debugger option 183
break spots
toggle 187
breakpoint 73, 96
activate 76, 89
classes 96
commands 75
conditional 74, 79
deactivate 90
delete 91
disable 90
enable 89
in generics 80
list 94
maximum number (64) 73
memory location 86
number 91
remove 76
set 78
set after current subprogram 81
set at instruction 83
set at return 85
set when exception occurs 103, 107
states 73
visit 132
breakpoint submode 187
Breakpoints 32
deleting 33
setting 32
Breakpoints menu
Activate command 89
Deactivate command 90
New command 39, 77
Remove command 91
Breakpoints window 6, 77, 89, 90, 91
button
Visit Editor 5
bw
set watchpoint 86

C

C++
name scopes 124
c_types
debugger parameter 188
cache
control in debugger 190
call stack
cb (call bottom) command 139
cd (call down) command 139
ct (call top) command 141
cu (call up) command 141
display 136
hexadecimal dump information 136
move down 139
move down frame(s) 139
move to bottom of 139
move to top frame 141
move up 141
call stack commands 11
calling
member functions 97
case
debugger parameter 187
Case Sensitive Searches debugger option 183
catch
debugger command 103
cb
debugger command 139
cd
debugger command 139
change
current position 124, 125
debugger prompt 191
memory 174
PC 59, 60
register value 153
signal settings 192
target environment 208
task priority 227
class
constructors 96
virtual functions 97
classes
breakpoints 96
constructors 96
debugger 96
command
attach 235
set lines 127, 128
command history
debugger 12
Command Pane
debugger 4
command syntax
debugger 11
line mode 12
command window
debugger 17
paging 18
commands
(B) break at procedure 11
call stack 11
immediate debugger 22
lt 215
read from a file 117
searching 130
set alert_freq 19
set all 186
set case 130
window control debugger 20
compilation unit 43
conditional breakpoint 74, 79
configuration file
debug multiple programs 231
constructors 96
class 96
context, debugger 37
control characters
debugger 12
Control-C 12
core file
debugging 49
cs
debugger command 136
ct
debugger command 141
cu
debugger command 141
current context 37
current position 134
change 125
definition 134
move to new file 131
current state of target
synchronize 121

D

d
debugger command 91
.dbrc 10
deactivate
breakpoint 90
Debug
Activate All 89
Break 77
Break Here 77
Deactivate All 90
Keep 3
Modify Data 149, 174
Modify Memory 174
Modify Register 164
multiple programs 231
Show 38, 143, 163, 184
Stop 135
Window submenu 6
Memory command 165
Registers 161
Stack 135
Tasks command 213
Debugger
automatic windows 32
displaying
objects 34
starting execution 32
tutorial setup 31
debugger 179
$eval capability 122
activate breakpoint 89
advance after signal/exception 69
assign values 152
attach 235
b (breakpoint) command 78
b off 90
b on 89
bd (break down) command 81
bi (break instruction) command 83
br (break return) command 85
break after current subprogram 81
breakpoint command blocks 11
catch (catch exception) command 103
cb (call bottom) command 139
cd (call down) command 139
class constructors 96
class member functions 97
classes 96
command history 13
Command Pane 4
command syntax 11
command window 17
command window paging 18
comment syntax 11
conditional breakpoints 74
configuration 186
context 37
core file 49
cs (call stack) command 136
ct (call top) command 141
cu (call up) command 141
d (delete) command 91
deactivate breakpoint 90
debugger variables 195
default output device pty 191
delete macros 208
display raw memory 166
display stack usage and location 222
display thread and lightweight process info 225
dm command 208
edit command 133
edit macro 206
em command 206
entering numbers 12
entering screen mode commands 18
env command 208
error window 17
exit 63
exit command 62
frame references 38
g (go) command 56
gs (go signal) command 57
gw (go while) command 58
halting the program 180
help 6
history buffer 17
home position 124
ii (step instruction) command 67
immediate commands 22
instruction submode 19
interrupt key 12
introduction 1
invocation arguments 8
invocation file 10
invocation syntax 8
invoke screen mode 17
is (step into with signal) command 67
jump command 59
jumpi command 60
keywords 11
l (list) command 126
lb (list breakpoints) command 94
li (list instructions) command 157
line editing 13
line mode command syntax 12
line numbers 129
list disassembled instructions 157
list macros 207
list UNIX processes 226
lm command 207
load 118
Log window 4
lp (list programs) command 237
lu 226
machine level 155
macro support 202
macros 202
member functions 97
modify memory 152
multiprogramming 230
name resolution 38
names 152
o (step over) command 68
oi (step over instruction) command 69
operators 152
Options dialog box 182
os command 69
p (display) command 166
p (print) command 147
parameters 186
pathnames 39
pm command 206
print macro 206
propagate (propagate exception) command 107
pseudo-functions 197
quit command 63
r (run) command 60
raise command 113
read command 117
read commands from a file 117
redirecting input/output 11
reexecute command 62
referenceobjects 38
reg (register) command 163
Return 62
return command 116
s (step) command 70
screen interface 23
screen mode 17
screen mode help 19
screen mode invocation 17
screen mode windows 17
search 130
set breakpoint 78
set output 23
set parameters 186
set watchpoint 86
si (step instruction) command 71
signals 94
Source pane 5
source submode 19
source window 17
special type display 200
specify new position 129
ss (step signal) command 72
start-up environment 10
state 175, 180
state files 176
stop execution 180
sync command 119
terminal control 209
unsupported expression forms 152
user-specific program-state files 180
v (visit) command 131
vb (visit breakpoint) command 132
virtual functions 97
visibility rules 123
visit breakpoint 132
w (window) command 127
wi (window instruction) command 158
window control commands 20
debugger options
Add 183
Auto Expand Pointer 184
Block on Signal 185
Break on Signal 185
Break Spots 183
Case Sensitive Searches 183
Display 183
Display_Levels 184
Element_Count 184
Expand Pointers 184
Ignore Signal 185
Log 185
Log File 185
Output Base 184
Show Parameters 184
Signal 185
Source 183
Source File Lookup Path 183
Stack Display 184
Stack_Depth 184
Tab Size 183
Type Display 184
debugger variables 195
$declare_column 197
$declare_file 197
$declare_line 197
$display_levels 195
$element_count 196
$expand_pointers 196
$name 198
$nested_type_display 196
$pathname 197
$show_location 196
$string 198
$type_display 196
$type_of 198
$variable 197
debugger-state files
program-state files 179
user-specific program-state files 180
$declare_column 197
$declare_file 197
$declare_line 197
default
macro parameters 205
definition
current position 134
home position 134
macros 202
delete
macros 208
Deleting breakpoints 33
detach 235
disable
breakpoint 90
disambiguate an overloaded name 23
disassembled code
display 155
disassembly window 155
display
address 166
address in hexadecimal notation 167
address of operand 150
all debugger parameters 186
assembly language 155
call stack 136
exceptions 148
expanded names 189
floating point registers 163
input/output in screen mode 23
lightweight process information 225
lines 126
memory 166
memory given address 171
parameter list 189
raw memory using p command 167
register contents 163
signals 192
single task status 221
special types 200
stack depth 193
stack usage and location 222
status for all active tasks 216
subprogram parameters 189
thread information 225
variable or expression 147
window 127
window of disassembled code 158
Display Options
debugger 183
$display_levels 195
Display_Levels debugger option 184
Displaying
objects in the debugger 34
dm
delete macros 208
dontbreakwhensignaloccurs 94
download
memory image to target 118

E

edit
debugger command 133
macro 206
subprogram or file 133
$element_count 196
Element_Count debugger option 184
em
edit macro 206
enable
breakpoint 89
env 208
environment
customize 208
'EPILOG 151
error window
debugger 17
$eval 122
event
debugger parameter 189
except_stack
debugger parameter 188
exception
display 148
raise 113
set breakpoint 103, 107
exception handling 98
commands 101
Exceptions window 6
Execution
starting (debugger) 32
execution
continue 56
continue after signal 57
continue until a variable changes 58
resume 228, 239
Exercises
delete a breakpoint 33
set a breakpoint 32
start execution for debugging 32
start to debug a program 31
exit
debugger command 62
Expand Pointers debugger option 184
$expand_pointers 196
expanded names 189
expressions
display 147
in debugger 149
names 152
qualified names 152
scope resolution operator 151

F

file
edit from debugger 133
File menu
Debugger State submenu
Clear command 178
Read command 178
Reset command 178
Save command 178, 179, 182
Run command 6
file names
restrictions in v (visit) command 132
'FIRST 151
'FIRST(N) 151
'FIRST_INST 151
Floating Point Registers
command 162
window 6, 161, 162
frame references, debugger 38

G

g
debugger command 56
generics
breakpoints 80
gs
debugger command 57
gw
debugger command 58

H

halting the program
Control-C 180
help
debugger 6
screen mode debugger 19
Help menu
Manuals command 7
On Context command 6
Tutorial command 7
hexadecimal dump
call stack 136
hexadecimal notation
display address 167
home position 134
debugger 124
definition 134

I

i
debugger command 66
Ignore Signal debugger option 185
ignoring signals 94
ii
debugger command 67
immediate commands 18, 22
infinite loop
exit from in debugger 180
input
debugger parameter 189
set debugger 210
Input/Output window 6
instruction
set breakpoint at 83
single step 67, 71
instruction submode
debugger 19
instructions
list 157
interrupt key 12
debugger 12
Intr 12
invocation
debugger arguments 8
debugger file 10
macros 204
screen mode 17
is
debugger command 67

J

jump
debugger command 59
jumpi
debugger command 60

K

Keep command 3
kill 229, 237

L

l
debugger command 126
language
debugger parameter 189
'LAST 151
'LAST(N) 151
'LAST_INST 151
lb
debugger command 94
li
debugger command 157
library unit 43
lightweight process
display using lt 225
line editing
debugger 12
edit mode 13
insert mode 13
line numbers
debugger 129
line-mode debugger 8
lines
debugger parameter 189
list
breakpoints 94
instructions 157
macros 207
program 126
programs 237
UNIX processes 226
lm
list macros 207
load
download memory image to target 118
locations
specify debugger 42
log
debugger parameter 189
Log File debugger option 185
Log Options
debugger 185
Log window 6
lp
debugger command 237
lt
debugger command 215
lt thread
display thread information 225
lt use
display stack usage and location 222
lu
list UNIX processes 226

M

machine level debugging 155
macros
default parameters 205
definition 202
delete 208
edit 206
invocation 204
list 207
overview 202
parameters 204
print 206
support in debugger 202
manage
debugger state 180
Manuals command 7
member function visibility 97
member functions 97
calling 97
this 97
memory
display using p command 166
modify 174
modify contents 174
modify with debugger 152
set permissions 190
Memory Bounds dialog box 165
Memory command 165
debugger 165
memory image
download to target 118
Memory window 6, 165, 166, 174
modify
debugger configuration 186
memory 152
memory contents 174
memory locations 174
register value 153
Modify Data dialog box 149
Modify Memory command 174
Modify Register command 164
Modify Register dialog box 164
Modules
Using the Apex Debugger
Displaying Objects 34
Setting Breakpoints 32
Setting Up the Debugger Tutorial 31
Stepping Through the Program 33
move
to breakpoint 132
to new file/subprogram 131
multiple programs
debug 231
multiprogram support
list programs (lp) 237
multiprogramming
commands 233
debugger 230

N

'N() 151
$name 198
name
qualified 152
name expressions
display 147
name resolution
debugger 38
name scopes
C++ 124
names 152
display expanded 189
navigate
to declaration, subprogram, source file 131
Navigate menu
Visit Editor command 5
$nested_type_display 196
nocache 190
number
debugger parameter 191
trace events to display 189

O

o command
procedure calls 69
obase
debugger parameter 191
object
specify 42
Object Display window 144, 234
oi
step over instruction 69
On Context command 6
operations
virtual function 98
operators
C 189
debugger 152
options
debugger display 183
debugger log 185
debugger signal 185
debugger source 183
debugger stack display 184
Options command 183
Options dialog box
debugger 183
os
debugger command 69
output
debugger parameter 191
set debugger 209
Output Base debugger option 184
overloaded_names
debugger parameter 191
turn on/off 191

P

p 147
debugger command 147
p command
display memory location/address 166
page
debugger parameter 191
paging
turn on/off 191
parameters
debugger 186
macros 204
pass
cautions 122
pass command
$eval 122
$pathname 197
pathname
body 42
debugger 39, 42, 43
fully qualified debugger 39, 40
relative debugger 39, 41
specification 42
PC
change 59, 60
permissions
set memory 190
persist
debugger parameter 191
pm
print macro 206
Prerequisites 29
print
macro 206
priority 227
procedure calls
nested 116
o command 69
program
attach 235
detach 235
kill 229, 237
list 237
resume execution 228, 239
run 60
select new 230, 239
suspend 228, 240
program unit 43
program_file option 231
program-state files 179
'PROLOG 151
prompt
debugger parameter 191
screen mode debugging 19
propagate
debugger command 107
pseudo-functions 197
ptrace 95
pty
debugger input/output 209
default debugger output device 191

Q

qualified name 152
quit
debugger command 63

R

r
debugger command 60
raise
debugger command 113
exception 113
'RANGE 151
'RANGE(N) 151
rdb 8
read
debugger command 117
redirection
debugger input/output 11
reexecute debugger command 62
reference
Ada constructs 44
dynamic objects 49
objects in the debugger 38
subprograms 43
task locations 46
Refresh command 174
reg
debugger command 163
registers
display contents 163
display floating point 163
modify value 153
Registers command 161
debugger 161
Registers window 6, 160, 161
remove
breakpoints 76
resume 228, 239
Return
debugger command 62
return
debugger command 116
from subprograms 116
set breakpoint at 85
root task 211
run
debugger parameter 191
program 60
Run dialog box 6

S

s
debugger command 70
safe
debugger parameter 191
scope resolution operator 151
screen interface
debugger 23
screen mode debugging 17
alert frequency 19
entering commands 18
immediate commands 22
invocation 17
prompt 19
window control commands 20
screen mode windows
debugger 17
search
debugger 130
select 230, 239
set
alert_freq 186
all 186
breakpoint 78
c_types (scope of search) 188
case sensitivity 187
cmd_log 189
debugger command 186
event 189
except_stack 188
expanded name display 189
input 189, 210
invocation arguments 191
language 189
lines 189
list_parameters 189
memory 190
number 191
obase 191
output 191, 209
overloaded_names 191
page 191
persist 191
prompt 191
run 191
safe 191
safe mode 191
signal 192
source 192
stack_depth 193
step 193
step_alert 193
tabs 193
trace options 193
type_display 194, 200
watchpoint 86
set alert_freq command 19
set all command 186
Set Breakpoint dialog box 77
set case command 130
set command
task_id 193
set lines command 127, 128
set output 23
set output option 23
Setting
breakpoints 32
Show Data dialog box 163
Show Parameters debugger option 184
Show Source command 5
Show Status command 4
$show_location 196
si
debugger command 71
signal
advance after 69
debugger parameter 192
single step 67
step and pass signal 72
while debugging 94
Signal Options
debugger 185
single step 70
Slight_Pause 73
source
debugger parameter 192
set 192
Source File Lookup Path debugger option 183
Source Options
debugger 183
Source pane
debugger 5
source submode
debugger 19
source window
debugger 17
'SPEC 151
'Spec attribute 42
special type display 200
specify
debugger pathnames 42
new position 129
object 42
ss
debugger command 72
stack
depth 193
display usage and location 222
Stack command
135
Stack Display Options
debugger 184
Stack window 6, 135, 136, 213, 214
stack_depth
debugger parameter 193
Stack_Depth debugger option 184
start
execution at designated PC 120
Starting execution (debugger) 32
start-up environment
debugger 10
state
debugger 180
statement numbering 44
rules 44, 45
states
breakpoint 73
status of active tasks
display 216
step
debugger parameter 193
instruction 67, 71
into 66
into subprogram accidentally 71
into with signal 67
pass signal to program 72
single into subprograms 70
step over calls 68
step_alert
debugger parameter 193
Stepping
through the program 33
stop
debugger execution 180
$string 198
submode
breakpoint 187
subprogram 43
edit from debugger 133
entering by mistake 83
return from 116
subunit 43
suppress signals while debugging 94
suspend 228, 240
sx
debugger command 72
sync
debugger command 119
synchronize
program 120
target 119

T

Tab Size debugger option 183
tabs
debugger parameter 193
'TAG 151
target
download memory image 118
synchronize 119
target environment
change 208
task
activation 211
detach 235
display status 221
kill 229, 237
management 211
number 211
priority 227
resume execution 228, 239
root 211
select new 230, 239
states 217
suspend 228, 240
task_id
set command 193
Tasks command 213
Tasks window 6, 213
terminal control
debugger 209
terminate debugger session 62
this 97
member function 97
thread
display using lt 225
toggle
break_spots 187
trace options
debugger parameter 193
tracing mode
set 193
tty
debugger input/output 209
Tutorial
debugger setup 31
Tutorial command 7
'TYPE 151
type
apply to address 171
display special 200
Type Display debugger option 184
$type_display 196
type_display
debugger parameter 194
set 194
$type_of 198
typecasting 173

U

unit
compilation 43
library 43
program 43
subunit 43
UNIX processes
list 226
unsupported C++ expression forms 152
unsupported expression forms
debugger 152
user procedure calls 117
nesting 117
user-specific program-state files 180

V

v
debugger command 131
$variable 197
variables
debugger 195
display 147
specify in debugger 39
vb
debugger command 132
View menu
Options command 183
Refresh command 174
Show Command Pane command
Show Command Pane command 5
Show Source command 5
Show Status command 4
virtual function
operations 98
virtual functions 97
operations 98
virtual table 97
virtual table 97
visibility
member functions 97
visibility rules
debugger 123
Visit Editor
button 5
command 5

W

w
debugger command 127
watchpoint
set 86
watchpoints
limitation 88
slow execution 88
wi
debugger command 158
window
display disassembled code 158
display source lines 127
window control commands 18, 20
windows
automatic debugger 32
screen mode debugger 17
Windows menu
Floating Point Registers command 162
Memory command 165
Registers command 161
Stack command 135
Tasks command 213
write
macros 202

Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2002, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS