Debugger toolbar

The toolbar appears just below menu bar in the main debugger window. By default, all buttons are shown as icons. If you prefer to use text button as in previous versions of the debugger, do the following:

  1. Choose Config > Options... > General Tab.
  2. Disable (uncheck) the option "Use icons for buttons".
  3. Press OK.

All these buttons are programmable, except for Quit. You can define each button's name, the corresponding icon (optional), and its command string in any of the following ways:

When you program a button, its new name (or icon) appears in the button, and the command string goes to the command pane for execution when you click the button. If no icon is specified, a character icon for the first character of the button name will be used (if the buttons are displayed as icons).

By default, the debugger defines 20 buttons. You can change any of the default buttons in a start up database or during run-time, except for Quit.

If you prefer the toolbar to be at the bottom of the debugger window instead of at the top, do the following:

  1. Choose Config > Options... > Debugger Tab.
  2. Choose "Position of buttons" > Bottom.

The following table shows the default debugger buttons, their ID numbers, their names, and their equivalent debugger commands (if any):
Debugger toolbar
Num. Button Command Description
1
Step
s
Executes one statement. If the statement is a procedure call, it steps into the called procedure. When in interlaced source/assembly mode, a machine instruction is executed instead of a source statement.
2
Next
n
Executes until the next statement of the current function (i.e. step over procedure calls). When in interlaced source/assembly mode, a machine instruction is executed instead of a source statement.
3
Return
cU
Continues to end of procedure, and stops in the calling procedure after returning to it.
4
Go
C
Begins execution of the program. If the program is stopped, it continues execution.
5
Halt
halt
Interrupts program execution.
6
Restart
restart
Restarts the program with the same arguments as before.
7
Reload
debug
Reloads the current executable.
8
Assem
assem
Toggles between displaying the source code only and source interlaced source with assembly code.
9
PC
E
Shows the position at the current Program Counter.
10
Upstack
E+
Views a procedure up one stack frame.
11
Downstk
E-
Views a procedure down one stack frame.
12
Calls
callsview
Opens a window displaying a stack trace. See also callsview and Chapter 19, "Call stack window".
13
Stops
breakpoints
Opens the Breakpoints window to add and edit breakpoints.
14
Memory
memview 0
Opens Memory View window displaying memory starting at address 0x0.
15
Regs
regview
Opens Register window displaying machine registers.
16
Locals
view $local$
Creates a data explorer displaying local variables.
17
Viewdel
viewdel
Deletes all data explorers, Register windows, Call Stack windows, Breakpoints windows, Memory View windows and Browse windows.
18
Edit
edit
Opens an Editor window on the currently active procedure.
19
Builder
builder
Invokes the Builder window.
None
Quit
quit
Quits MULTI, but if the debugged program is being debugged, MULTI gives you the choices of "Quit and kill Process" and "Detach from process". You may not re-configure this button to perform another function, but you can configure whether this button appears or not.

Related topic:


Previous

Next



Copyright © 1999, Green Hills Software. All rights reserved.