Index
Symbols
- .dbxinit file, 235
- .dbxrc, 161
- .sbinit
- disk space, saving, 344
- include files, 344
- .sbinit file, 342
- :: (double-colon) C++ operator, 21
A
- adb command, 176
- address
- examining contents at, 167
- address display format, 169
- alias, 8
- array
- bounds, exceeding, 208
- Fortran, 211
- arrays
- evaluating, 56
- slicing, 56
- striding, 56
- syntax for slicing, striding, 57
- assembly language
- debugging, 167
- assign command, 56, 230
- attaching a process to dbx, 36
- automounted path, 347
- Auto-Read
- and archive files, 30
- and executable file, 30
- disabling at compile time (-xs), 30
- Auto-Read facility
- and .o files, 29
- default behavior, 29
B
- bcheck command, 123
- bounds of arrays
- checking, 208
- break_lock option, 336
- breakpoints
- conditional
- setting, 68
- deleting
- using Handler ID, 68
- event efficiency, 72
- listing, 68
- overview, 63
- reaching, 238
- setting
- at a line, 64
- in dynamically linked library, 65, 226
- machine level, 175
- multiple breaks in C++ code, 65
- setting at template instantiations, 194
- setting conditional breaks, 69
- setting filters, 70
- stop type, 64
- trace type, 64
- watchpoints, 68
- when type, 64
- browsing
- from multiple machines, 347
- in an automounted path, 347
- uncompiled programs, 349
C
- C++
- ambiguous or overloaded functions, 19
- array slicing, 57
- class declarations, looking up, 25
- class definition lookup, 27
- double colon operator, 21
- double-colon scope operator, 21
- exception handling, 192
- inherited members, 28
- mangled names, 22
- missing type, 239
- printing, 53
- setting multiple breakpoints, 65
- template debugging, 194
- tracing member functions, 67
- unnamed arguments, 53
- using -g, 10
- using with dbx, 191
- call command, 38, 200, 231
- call stack, 3, 47
- walking, 20, 48
- calling a function, 38
- calling member template functions, 194
- cancel command, 95
- catch blocks, 192
- catch command, 187
- catch commanddbx command
- catch, 187
- check command, 130
- child processes
- follow exec, 184
- follow fork under dbx, 184
- interaction, 184
- class
- seeing inherited members, 28
- clear command, 96
- Collector, 151
- multithreaded programs, 152
- profiling, 152
- using, 152
- collector command, 153
- command-line
- issuing queries from, 335
- viewing options, 336
- command-line options
- break_lock, 336
- comparing files, 353
- o, 337
- reg_expr, 338
- symbols_only, 337
- version, 337
- compiler switch
- LockLint
- -Zll, 266
- -loopinfo, 252
- -O4, 249
- -parallel, 249
- -Zlp, 249
- compiling
- in an automounted path, 347
- compiling for dbx
- disabling Auto-Read (-xs), 30
- optimized code (-O -g), 8
- cont at command, 232
- cont command, 39, 42
- continue command, 145
- core file
- debugging, 6
- customizing dbx, 161
D
- database
- locked, 336
- dbx
- .dbxrc, 161
- adjusting default settings, 161
- and GDB commands, 233
- and Korn shell, 227
- current procedure and file, 204
- locating floating-point exceptions, 240
- multithreaded programs, 241
- overview, 3
- quitting a session, 10
- scope, 238
- starting, 6
- core file, 6
- with process_id only, 7
- startup options, 15
- stopping execution, 10
- syntax, 15
- dbx command
- adb, 176
- alias, 8
- assign, 56, 230
- bcheck, 123
- call, 38, 200, 231
- check, 130
- collector, 153
- cont, 39, 42
- cont at, 232
- continue, 145
- dbxenv, 8, 162
- debug, 44
- detach, 37, 45
- dis, 172
- display command, 55
- down, 48
- examine, 168
- exception, 196
- fix, 144, 148, 232
- frame, 49
- func, 19
- handler -enable, 76
- hide, 50
- ignore, 186, 187
- intercept, 197
- kill, 11
- list, 201
- listi, 172
- modify, 70
- module, 30
- modules, 30
- next, 41
- nexti, 174
- pathmap, 7, 18, 149
- pop, 231
- print, 201, 231
- regs, 176
- restore, 11
- run, 36, 41
- save, 11
- showblock, 133
- showleaks, 133
- showmemuse, 133
- step, 43
- stepi, 174
- stop, 75
- stop at, 64
- stop in, 199
- suppress, 134
- thread, 157, 158
- threads, 157, 159
- trace, 67, 75
- uncheck, 130
- undisplay, 55
- unhide, 50
- unintercept, 197
- unsuppress, 134
- up, 48
- whatis, 198
- when, 64, 74, 232
- where, 48, 49
- whereis, 198
- which, 24
- whocatches, 197
- x, 168
- dbx command cancel, 95
- dbx command clear, 96
- dbx command delete, 96
- dbx command handler, 96
- dbx command print, 60
- dbx command status, 95
- dbx command step, 95
- dbx command stop, 94
- dbx command when, 75, 93
- dbxenv command, 8, 162
- dbxenv variable
- rtc_auto_continue, 141
- rtc_auto_suppress, 141
- rtc_autocontinue, 124
- rtc_biu_at_exit, 141
- rtc_error_limit, 142
- rtc_error_log_file, 141
- rtc_error_log_file_name, 124
- rtc_mel_at_exit, 142
- setting, 162
- trace_speed, 67
- dbxenv variable rtc_biu_at_exit, 112
- debug
- Fortran arrays, 211
- pointer, 220
- debug command, 44
- debugging
- assembly language, 167
- code compiled without -g, 9
- compiling, 9
- machine-instruction level, 167, 173
- optimized code, 8
- stripped programs, 10
- debugging a running process, 36
- debugging optimized programs, 204
- debugging run
- replaying, 14
- restoring, 13
- saving, 11
- debugging support
- shared objects, 224
- declarations, looking up (displaying), 25
- delete command, 96
- dereferencing
- expressions, 51
- pointers(print *), 54
- variables, 51
- destructors, 192
- detach command, 10
- detach command, 37, 45
- detaching a process from dbx, 37
- dis command, 172
- display command, 55
- displaying
- symbols, occurences of, 24
- displaying declarations, 25
- displaying variables and expressions, 55
- dlopen()
- restrictions on breakpoints, 65, 226
- setting a breakpoint, 65, 226
- down command, 48
E
- editing
- enabling, 237
- embedded slash command, 237
- environment variable
- LD_LIBRARY_PATH, 248
- error suppression, 113
- evaluating
- arrays, 56
- evaluating (printing)
- variables and expressions, 52
- event management
- event counters, 76
- handler, defined, 73
- event specification, 73
- using predefined variables, 87
- event specifications
- keywords, defined, 76
- machine-instruction level, 175
- modifiers, defined, 84
- setting, 76
- events
- ambiguity, 86
- event specifications, 76
- manipulating handlers, 75
- parsing, 86
- watchpoints, 68
- event-specific variables, 88
- examine command, 168
- examining
- contents of memory, 167
- exception command, 196
- exception handling, 192
- exception handling commands, 196
- exceptions
- catching, 192
- throwing, 192
- executing a program, 38
- explicit parallelization, 251
- expressions
- displaying, 55
- evaluating (printing), 52
- monitoring changes, 55
F
- fflush(stdout)
- after dbx calls, 39
- file
- archive files and Auto-Read, 30
- qualifying name, 21
- visiting, 18
- fix and continue, 143
- changing variables, 147
- modifying source, 144
- restrictions, 144
- fix command, 144, 148, 232
- follow exec, see child processes, 184
- Fortran
- allocated arrays, 212
- complex expressions, 216
- generic functions, 221
- intrinsic functions, 215
- logical operators, 217
- structures, 218
- FPE signal, catching, 187
- frame command, 49
- func command, 19
- functions
- ambiguous or overloaded, 19
- calling, 38
- qualifying name, 21
- setting breakpoints in C++ code, 66
G
- -g compiler option, 9
- GDB commands, 233
H
- handler
- defined, 73
- id, defined, 74
- handler command, 96
- hide command, 50
- history facility, 226
I
- ignore command, 186, 187
- ignore signal list; see also catch, 187
- index check of arrays, 208
- inherited members, seeing, 28
- inlining, 260
- Intel registers, 179
- intercept command, 197
K
- kill command, 11
- Korn shell
- extensions, 228
- features not implemented, 227
- renamed commands, 228
L
- libraries
- compiling for dbx, 9
- dynamically linked
- setting breakpoints in, 65, 226
- line number of
- exception, 209
- linker names, 22
- list command, 201
- listi command, 172
- locating source files, 7
- locked database, 336
- LockLint
- .ll file, 266
- analysis phase, 265, 303
- assertions,types of, 275
- asterisk in display, 329
- call graph, 273
- collecting information, 266
- cover, definition of, 308
- data race
- definition of, 263
- database, 274
- deadlock, definition of, 264
- declare root subcommand, 274
- formal name
- function, 299
- members of a structure, 300
- members of union, 301
- reference to member of structure without tag, 301
- variable, 300
- funcs, 273
- function pointers, references to, 274
- initialization file for, 268
- inversion
- definition of, 331
- libthread API, 264
- LL_CONTEXT, 327
- makefile rules
- multithreading model, 263
- mutex lock, 264
- note interface, 285
- NOTEPATH, 282
- POSIX routines, recognized, 264
- preprocessor macro, 278
- process, definition of, 263
- prompt, 268
- references to function pointers, 274
- report
- assertion violations, 265
- root functions, 274
- shell exit, 271
- side effect,definition of, 306
- source code annotations, 281 to ??
- starting
- execute csh command file, 327
- state
- set of databases loaded, 271
- specified assertions, 271
- subcommands, 271, ?? to 331
- analyze, 276, 302
- assert, 305
- declare, 309
- declare ... targets, 274
- declare root, 274
- disallow, 274, 304, 311
- disallows, 274, 311
- files, 273, 311
- funcptrs, 274, 312
- funcs, 313
- help, 317
- ignore, 274, 318
- load, 319
- locks, 319
- members, 321
- order, 322
- pointer ... calls, 274
- pointer calls, 323
- reallow, 274, 324
- reallows, 274, 324
- refresh, 325
- restore, 325
- save, 325
- saves, 326
- start, 326
- sym, 328
- unassert, 328
- vars, 274, 329
- subcommands, exit status of, 298
- symbols
- unambiguous identification, 300
- thread types recognized, 265
- upgraded locks, 290
- user-specified shell, 271
- view call graph for loaded sources, 273
- LoopReport
- automatic parallelization
- -parallel compiler switch, 249
- -depend (perform data dependency analysis), 252
- -explicitpar, 251
- fields in the loop report, 254
- inlining, 260
- loading timing file, 250
- loop transformations, 261
- loopreport command, 249
- ncpus utility, 248
- nested parallel loop, 261
- optimization hints, 256
- -p option, 250
- -parallel (automatic parellelization), 251
- PARALLEL environment variable, 248
- phantom loops, 260
- starting, 249
- timing file, 250
- loopreport command, 249
- LoopTool
- LD_LIBRARY_PATH, 248
- loading timing file, 250
- -p option, 250
- starting, 249
- XUSERFILESEARCHPATH, 248
- LWP, 158
M
- machine-instruction level
- address, setting breakpoint at, 176
- debugging, 167
- Intel registers, 179
- PowerPC registers, 181
- setting breakpoint at address, 175
- single-stepping, 173
- SPARC registers, 178
- tracing, 174
- makefile rules, 269
- Makefile, see makefile
- member functions
- setting multiple breakpoints in, 65
- tracing, 67
- member template functions, 194
- memory
- display modes, 167
- examining contents at address, 167
- memory address display formats, 170
- modify command, 70
- module command, 30
- modules command, 30
- multithreaded debugging
- introduction, 156
- LWP information displayed, 158
- thread information displayed, 156
- viewing another thread, 157
- viewing the threads list, 157
- multithreaded programs
- and the Collector, 152
- mutex, 306
N
- next command, 41
- nexti command, 174
O
- o option, 337
- operator
- C++ double-colon scope, 21
P
- Pascal
- calling a function, 52
- printing a character string, 52
- scope resolution, 23
- pathmap command, 7, 18, 149
- pointers
- dereferencing (print *), 54
- pop command, 231
- PowerPC registers, 181
- print command, 60, 201, 231
- printing
- arrays, 56
- Pascal character strings, 52
- printing (evaluating)
- variables and expressions, 52
- process
- detaching, 10
- process control commands, definition, 35
- process, stopping, 40
- program
- continuing, 39
- killing, 11
Q
- qualifying symbol names, 21
- query
- using sbquery, 335
R
- reg_expr option, 338
- registers
- Intel, 179
- Power PC, 181
- SPARC, 178
- regs command, 176
- regular expressions, 338
- replay command, 11
- replaying a debugging run, 14
- restore command, 11
- restoring a debugging run, 13
- rules for makefiles, 269
- run command, 36, 41
- Run Time ld
- definition, 223
- runtime checking
- 8 megabyte limit, 125
- access checking, 103
- access error types, 105
- and fix and continue, 121
- API, 122
- attached process, 120
- batch mode, 123
- child processes, 116
- command syntax, 130
- dbxenv variables, 140
- error suppression, 113
- errors, 136
- fixing memory leaks, 111
- memory access error reporting, 104
- memory leak checking, 105
- memory leak error reporting, 109
- memory use checking, 112
- possible leaks, 107
- requirements, 98
- suppressing errors, 113
- troubleshooting tips, 125
S
- save command, 11
- saving a debugging run, 11
- sbinit file, 342
- sbquery, 335
- -break_lock option, 336
- filter options, 336
- focus options, 336
- -help_focus option, 339
- -max_memory option, 337
- -o option, 337
- options, 336
- -version option, 337
- sbtags, 349
- generating database, 350
- with sbtags, 349
- scope, 238
- scope resolution operators, 21
- segmentation fault, 208
- some causes, 208
- session, dbx
- killing program only, 11
- quitting, 10
- starting, 5
- shared libraries, compiling for dbx, 9
- shared objects, support, 224
- shell-style expressions, 338
- showblock command, 133
- showleaks command, 133
- showmemuse command, 133
- signal
- catching, 187
- handling automatically, 189
- sending to a program, 188
- signals
- using events, 185
- single-step
- at machine-instruction level, 173
- SPARC registers, 178
- start, 326
- startup options, 15
- status command, 95
- step command, 43, 95
- stepi command, 174
- stop at command, 64
- stop command, 75, 94
- stop in command, 199
- stopping a process, 40
- suppress command, 134
- symbol names, qualifying scope, 21
- symbols_only option, 337
T
- templates
- class, 194
- function, 194
- instantiations, 194
- templates, looking up declarations of, 27
- thread command, 157, 158
- threads command, 157, 159
- trace command, 67, 75
- traces
- listing, 68
- tracing
- controlling speed, 67
- machine-instruction level, 174
- tracing code, 66
- setting tracepoints, 67
- troubleshooting tips, runtime checking, 125
- twmerge, 353
- ancestor file
- loading at startup, 355
- automatic merging, 357
- command-line options, 358
- difference, defined, 356
- differences
- moving between, 356
- resolving, 356
- file
- loading from list, 355
- loading two files at startup, 354
- saving, 358
- glyphs, understanding, 357
- loading
- three files at startup, 355
- starting, 354
- twmerge command, 358
- types, looking up declarations of, 25
U
- uncheck command, 130
- undisplay command, 55
- undisplaying variables and expressions, 55
- unhide command, 50
- unintercept command, 197
- unsuppress command, 134
- up command, 48
- uppercase
- debug, 204
V
- variable
- assigning a value, 56
- variables
- and conditional breakpoint, 69
- evaluating (printing), 52
- monitoring changes, 55
- outside of scope, 52
- qualifying names, 21
- version option, 337
- visiting
- file, 18
- functions, 19
- walking the stack, 20
W
- whatis command, 198
- when command, 64, 74, 75, 93, 232
- where
- execution stopped, 210
- where command, 48, 49
- whereis command, 198
- which command, 24
- whocatches command, 197
- wildcards, 338
- WorkShop, documentation, xxiii
X
- x command, 168
- XUSERFILESEARCHPATH, 248