Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

5    Palm OS Debugger Menu Reference

Palm OS® Debugger Guide

Palm OS® Developer Suite

This chapter provides reference information describing each menu command in Palm OS Debugger.

Palm OS Debugger Menu Reference Overview ^TOP^

The Palm OS Debugger menus include:

File ^TOP^

Use the File menu, shown in Figure 5.1, to perform actions related to the current file you are debugging.

Figure 5.1  File Menu

Open ^TOP^

Use the Open menu to open a new Palm OS Debugger window with an existing target file.

Save ^TOP^

Use the Save menu to save the current window's contents to a file. This menu item cannot be used with a debug target file (PRC or ELF file).

Recent File List ^TOP^

Palm OS Debugger adds each open debug target to the File menu, in chronological order, so that you can select recently used files when starting a new debug session.

The list shows the short filenames, but the path to each file is displayed in the message area at the bottom of the Palm OS Debugger window.

Exit ^TOP^

Use the Exit menu to exit Palm OS Debugger.

Edit ^TOP^

Use the Edit menu, shown in Figure 5.2, to perform standard editing functions, to search for text strings, to move through the breakpoints, and to change keyboard settings and debugger preferences.

Figure 5.2  Edit Menu

Undo ^TOP^

Use the Undo menu to undo the previously executed edit command.

Cut ^TOP^

Use the Cut menu to delete the currently selected text, copying the selected text into the operating system clipboard.

Copy ^TOP^

Use the Copy menu to copy selected text in the current window into the operating system clipboard.

Paste ^TOP^

Use the Paste menu to copy text from the clipboard into the current edit window.

Find ^TOP^

Use the Find menu to search for a text string in a window.

Find next ^TOP^

Use the Find next menu to look for a text string in a window using an advance search direction (searching forward from the current position).

Find previous ^TOP^

Use the Find previous menu to look for a text string in a window using a reverse direction search (searching backwards from the current position).

Next breakpoint ^TOP^

Use the Next breakpoint to jump to the next code line where you can place a breakpoint in the source window.

Previous breakpoint ^TOP^

Use the Previous breakpoint menu to jump back to the next prior code line where you can place a breakpoint in the source window.

Key Bindings ^TOP^

Use the Key Bindings menu to display the Key Bindings Editor, shown in Figure 5.3.

Figure 5.3  Key Bindings Editor Dialog

Preferences ^TOP^

Use the Preferences menu to display the Debugger Preferences dialog box, shown in Figure 5.4.

Figure 5.4  Debugger Preferences Dialog Box

View ^TOP^

Use the View menu, shown in Figure 5.5, to indicate whether Palm OS Debugger should show the toolbars or the status bar.

Figure 5.5  View Menu

Main Toolbar ^TOP^

Use the Main Toolbar menu to hide or show the icons in the toolbar at the top of the main window.

Window Toolbar ^TOP^

Use the Window Toolbar menu to hide or show the toolbar icons for the Window items.

Status Bar ^TOP^

Use the Status Bar menu to hide or show the status information at the bottom of the main window.

Target ^TOP^

Use the Target menu, shown in Figure 5.6, to connect and disconnect from a debug target, to use a symbolics file, or to save and load memory values.

Figure 5.6  Target Menu

Connect ^TOP^

Use the Connect menu to connect the Palm OS Debugger with a debug target.

Disconnect ^TOP^

Use the Disconnect menu to disconnect the Palm OS Debugger from a debug target.

Append Symbolics ^TOP^

A symbolics file is a file containing information that Palm OS Debugger needs in order to display the source code that corresponds to your object code.

Use the Append Symbolics menu to select a symbolics file to append. Palm OS Debugger loads the code symbolics without requiring the code to be downloaded to the debug target.

You can use the symbolics to set breakpoints in the Files view. Any breakpoints that you set prior to connecting to the debug target and running the first time are set as unresolved. When you connect to the debug target, Palm OS Debugger attempts to resolve these breakpoints.

Remove Symbolics ^TOP^

Use the Remove Symbolics menu to remove the symbolics that had been previously added using the Append Symbolics menu.

Load Memory ^TOP^

Use the Load Memory menu to load the memory contents from a previously saved file. Select the binary file to load, and enter the absolute memory location to be loaded.

You specify the memory location range as a standard ANSI C string in one of the following ways:

  • Using a low address and a high address. For example, if you specify the string "0x8000-0x9000", Palm OS Debugger loads the address range 0x00008000 to 0x00009000.
  • Using a starting address and a size. For example, if you specify the string "0x8000+0x1000", Palm OS Debugger loads the address range 0x00008000 to 0x00009000.
  • Using a starting address. If you don't specify a size for the memory range, then Palm OS Debugger loads the entire binary file into the memory starting at the starting address.

Palm OS Debugger downloads the file contents as a binary file into the specified memory location.


NOTE: The examples above show the address values and size specified as hexadecimal numbers. The address values and size can be specified in decimal, hexadecimal, octal, floating point, or binary, as described in "Registers View User Interface".

Save Memory ^TOP^

Use the Save Memory menu to save the current memory contents to a file. Enter a file name for the memory contents, and the absolute memory location to be saved.

You specify the memory location range as a standard ANSI C string in one of two ways:

  • Using a low address and a high address. For example, if you specify the string "0x8000-0x9000", Palm OS Debugger saves the address range 0x00008000 to 0x00009000.
  • Using a starting address and a size. For example, if you specify the string "0x8000+0x1000", Palm OS Debugger saves the address range 0x00008000 to 0x00009000.

    If you specify a starting address and no size, then Palm OS Debugger saves an empty file (a file of size 0).


NOTE: The examples above show the address values and size specified as hexadecimal numbers. The address values and size can be specified in decimal, hexadecimal, octal, floating point, or binary, as described in "Registers View User Interface".

Flash Memory ^TOP^

This menu is intended for licensee use.

Control ^TOP^

Use the Control menu, as shown in Figure 5.7, to control the execution of the program you are debugging.

Figure 5.7  Control Menu

Run ^TOP^

Use the Run menu to execute a program on the debug target, stopping only at breakpoints or at the normal end of the program execution.

If you have not yet connected to a debug target, Palm OS Debugger tries to connect. If the connection is successful, then Palm OS Debugger downloads the code to the debug target and runs it.

If you have already connected to the debug target, Palm OS Debugger runs the code that was already downloaded.

Restart ^TOP^

Use the Restart menu to go back to the beginning of a program, restarting the debugging session.

Stop ^TOP^

Use the Stop menu to suspend program execution during a debugging session.

Kill ^TOP^

Use the Kill menu to completely stop the execution of the program you are debugging and end the debugging session. This menu item will also disconnect Palm OS Debugger from the debug target.

Step ^TOP^

Use the Step menu to execute code, a single source line at a time, in the program being debugged.

Step In ^TOP^

Use the Step In menu to execute code a single source line at a time, stepping into a subroutine if execution branches into a subroutine.

Step Out ^TOP^

Use the Step Out menu to execute the rest of the code in a subroutine, stopping if execution steps out of the subroutine.

Window ^TOP^

Use the Window menu, shown in Figure 5.8, to open new debugging windows and to arrange the open debug windows.

Figure 5.8  Window Menu

Cascade ^TOP^

Use the Cascade menu to have the open windows displayed in an overlapping arrangement, with the title bar on each window visible.

Tile ^TOP^

Use the Tile menu to have the open windows displayed in the main window so that none of the windows overlap.

Arrange Icons ^TOP^

Use the Arrange Icons menu to arrange minimized window icons in the main window.

Files Window ^TOP^

Opens the content of the files view in a separate window. See "Files View" for information on the files view.

Breakpoints Window ^TOP^

Opens the content of the breakpoints view in a separate window. See "Breakpoints View" for information on the breakpoints view.

Registers Window ^TOP^

Opens the content of the registers view in a separate window. See "Registers View" for information on the registers view.

Variables Window ^TOP^

Opens the content of the variables view in a separate window. See "Variables View" for information on the variables view.

Global Variables Window ^TOP^

Opens the content of the global variables view in a separate window. See "Global Variables View" for information on the global variables view.

Memory Window ^TOP^

Opens the content of the memory view in a separate window. See "Memory View" for information on the memory view.

Processes Window ^TOP^

Opens the content of the processes view in a separate window. See "Processes View" for information on the processes view.

Stack Trace Window ^TOP^

Opens the content of the stack trace view in a separate window. See "Stack Trace View" for information on the stack trace view.

Expressions Window ^TOP^

Opens the content of the expressions view in a separate window. See "Expressions View" for information on the expressions view.

Profiler Window ^TOP^

Opens the content of the profiler view in a separate window. See "Profiler View" for information on the profiler view.

Create Dockable Windows ^TOP^

Select the Create Dockable Windows menu to cause the child windows to appear as docked windows attached to the main window. If this menu item is not selected, then child windows are separate child windows.

File Names ^TOP^

Palm OS Debugger adds each open debug target to the Window menu, so that you can switch between the currently opened windows.

Help ^TOP^

Use the Help menu, as displayed in Figure 5.9, to display information about Palm OS Debugger.

Figure 5.9  Help Menu

About Palm OS Debugger ^TOP^

Use the About Palm OS Debugger menu to display an About dialog box for Palm OS Debugger.