WDB GUI Help

Contents

Keyword Index

Using the WDB GUI

Reference Information


	Main Window

	Menus

	Toolbar Icons and Shortcut Keys

Views

	Source View

	Disassembly View

	Command View

	Watch View

	Local Variables View

	Call Stack View

	Threads View

	Registers View

	Memory Usage View

	Build View


Dialog Boxes

	Load Program Dialog Box

	Open File Dialog Box

	Save/Restore Debug Session Dialog Box

	Breakpoints Dialog Box

	Source File Paths Dialog Box

	Object File Paths Dialog Box

	Signals Dialog Box

	Find Dialog Box

	Debugger Preferences Dialog Box

	Quick Watch Dialog Box

	Fix List Dialog Box

	Memory Check Dialog Box

Troubleshooting

Using Help

	Overview
	Command View Description
	Key Combinations for the Command History Drop-Down List
	Key Combinations for Editing Commands
	Pop-Up Menu
	Saving Commandline History
	Tips
	See Also

Overview

The Command view lets you send commands directly to WDB and view the output from these commands. It also displays messages and warnings associated with the debug process. If you issue a command that has a corresponding GUI action, the command results are reflected in the GUI. For exceptions to this rule, see Using the Command View.

You can access the Command view from the main WDB GUI window by clicking the Command tab in the lower tabbed area.

Command View Description

Area	Description
Input area	Contains a `(gdb)` prompt followed by a single line for entering WDB commands. A history of the commands executed during the current session is available from a drop-down list or by scrolling with the keyboard.
Output area (Directly above the input area)	Echoes WDB commands you enter and displays output from these commands. Also displays messages and warnings associated with the debug process.

Key Combinations for the Command History Drop-Down List

The following key combinations can be used to traverse the command history drop-down list:

Key	Action
Ctrl +Down Arrow	Opens the drop-down list.
Down Arrow	Moves down the list.
Up Arrow	Moves up the list.
Enter	Executes the selected command.
Esc	Cancels the drop-down list.

Key Combinations for Editing Commands

The following key combinations are available for scrolling through the command history and editing a command in the Command view input area. These include:

Key	Action
Ctrl+P or Up Arrow	Selects the previous command.
Ctrl+N or Down Arrow	Selects the next command.
Ctrl+A	Moves to the beginning of the line.
Ctrl+E	Moves to the end of the line.
Ctrl+F	Moves forward one character.
Ctrl+B	Moves backward one character.
Meta+F or Ctrl+J	Moves forward one word.
Meta+B or Meta+J	Moves backward one word.
Ctrl+D	Deletes next character.
Meta+D	Deletes next word.
Ctrl+H	Deletes previous character.
Meta+G	Deletes previous word.
Ctrl+K	Deletes to end of line.
Ctrl+U	Selects all.
Ctrl+W	Cuts to clipboard.
Meta+W	Copies to clipboard.
Meta+Y or Ctrl+Y	Pastes from the clipboard.

NOTE: If the Meta modifier is not active, you can use Ctrl+Alt instead of the Meta key. For information on enabling the Meta modifier, refer to the xmodmap(1) man page.

Pop-Up Menu

In the Command view, click the right mouse button to display a pop-up menu that contains the following commands:

Command	Action
Clear	Clears the text in the output area.

Saving Commandline History

The commandline history is stored in a file, ".wdbguihistory" in the home directory ($HOME) by default. You can name the history file by specifying the following command,

$ export WDBGUIHIST = myhistfile

at the shell prompt. This command will create a file called "myhistfile" in the home directory, when the WDB GUI is invoked.

If a path is specified while exporting the WDBGUIHIST environment variable, the file gets created in that specified path.

$ export WDBGUIHIST = /tmp/histfile

creates the history file, 'myhistfile' in /tmp. If path is not specified, the history file, by default, is created in the user's home directory. All the commandline debugger commands are appended in the history file.

If, an history file exists when WDB GUI is invoked, the contents of the existing history file will be displayed in the dropdown box of the WDB GUI command window.

To Save session contents along with commandline history, check the "History File" check box in the 'Save Session' dialog box.The session history will be saved in a file, "sessionn ame.wgs.wdbguihistory".

To Restore a session with its history, select the 'Restore Session' option from the menu and check the "History File" check box. The history details will be displayed in the dropdownbox of the WDB GUI command window.

Tips

You cannot display the Command view in a separate window.
On the View menu, click Command to quickly bring the Command view to the top.
For more information about WDB commands, refer to the WDB documentation.

	Reference Information · Command View