The Source Window


The Source Window is the primary interface between the user and the debugger; it is automatically opened when the debugger starts. The Source Window displays the status of the program, controls execution of the program, and allows visualization of the program execution.

Menus

Toolbar

Source Window Display

Source Window Status Bars

Search Entry


Menus

File Menu

Open
Opens a file selection dialog to select the executable to debug
Close
Closes a previously opened executable file
Source
Reads and executes GDB commands from a text file
Target Settings...
Opens the Target Selection Dialog to edit target settings
Page Setup
(Windows only) Opens the Windows Page Setup dialog to configure printing
PTons; Files, Function Filter, Functions, and Source Display.

Files

The Files section displays a list of all the source files. The files are read from the debug information in the program being debugged. To see the list of functions in a file, click on it. The function list should appear in the Functions Display and the source should appear in the Source Display. You can select multiple files by using the Control or Shift keys while clicking the left mouse button. When multiple files are selected, all the functions in those files are displayed in the Functions Display.

At the bottom of the Files Display, you should see a checkbutton labelled "Hide .h files" and a button labelled "Select All". Checking "Hide .h files" will remove all files ending in ".h" from the Files Display. Clicking "Select All" will select all files in the Files Display.

Function Filter

Above the Function Display you should see a section labelled "Function Filter". The purpose of this section is to apply a filter to the list of functions in the Functions Display. For example, if you click "Select All" in the Files Display, then many hundreds of functions could appear in the Functions Display. To see all functions containing the string "print", for example, click on the combobox in the Function Filter and select "contains". Then type "print" into the box to the right and hit the enter or return key. You should see the Function Display updated with a list of all functions containing "print".

Insight remember what the last filter you used was and will always open the Function Browser window with the last filter settings.

Function Display

The Function Display contains the list of functions in the files that have been selected in the Files Display, after running them through any filter settings in the Filter Display. There are two buttons at the bottom of the display that allow you so set or delete breakpoints on every function in the Function Display in one operation.

For example, to set a breakpoint of every function name containing "print", follow the example in the Function Filter section to get a list of all functions containing "print". Then simply click the "Set BP" button.

Source Display

The Source Display shows the source code for any file selected in the File Display. If a function is selected in the Function Display, the first line of that function containing executable code will be highlighted. If no source file is found, then the function will be displayed disassembled.

At the bottom of the window are two comboboxes and a text field. The combobox on the far left contains the function name or file location to display. Normally this is just output for your information, however you can type the name of any function into this box to see its source.

To the right of this is another combobox that allows you to toggle between source and assembly.

To the far right is an empty field. You can type a string in it and hit enter to search the current source file for any string.

In the source window itself, you can set breakpoints just like the source window.

Popup Menu

If you click the right mouse button while over the File Browser, you should get a simple menu with three options; Toggle Layout, Help, and Close. Toggle Layout switches you between the two different Browser Window layouts. Choose the one you like best; Insight will remember it between sessions. Help pops up this help window. Close closes the Function Browser.

./usr/share/insight1.0/help/index.html0000644000000000000000000000226411076074207016445 0ustar rootroot Insight Index

For Developers Only



Insight Home Page



GNU General Public License ./usr/share/insight1.0/help/session.html0000644000000000000000000000170711076074207017022 0ustar rootroot Sessions

Sessions

Insight will save your session for you automatically. The ``session'' is essentially a group of settings which are keyed by the name of the inferior which you are debugging.

Insight will show a list of the five most recent previous sessions on the File menu. Choosing an item from this list will cause Insight to load the indicated executable and restore all the settings saved in the session.

The settings stored in a session are:

More items may be added to this list as the need arises.

At present there is no way to disable session saving.

./usr/share/insight1.0/help/target.html0000644000000000000000000001200111076074207016612 0ustar rootroot Target Selection Help

The Target Selection Dialog

Overview

The Target Selection Dialog allows users to specify the debug target, the interface used to connect to the target, and some useful run options.

Selecting a Target

Options

More Options

Selecting a Target

Selecting a target involves choosing a target for debugging and setting connection interface options for the target.

Common targets include: "Exec" for native debuggers, "Remote/Serial" for establishing a connection to a target board via a serial line, "Remote/TCP" for TCP connections, and "Simulator" for connections to the simulator. There may be more depending on the configuration of the debugger being used.

In general, "remote" targets are always serial connections which require the user to specify the serial port and baud rate to be used for the connection and "remote/tcp" targets are always TCP connections which require specifying the hostname and port number of the machine to which to connect. Depending upon configuration, there may be numerous serial- and TCP-based connections. These always follow the naming convention target/Serial and target/TCP.

To select a target, choose one of the available targets from the dropdown menu in the Connection Frame. Then specify the interface options for this target: selecting the baudrate and serial port from the dropdown menus (serial targets only) or entering the hostname and port number (TCP targets only).

Options

Three run options which may be selected include:
Run until 'main'
Sets a breakpoint at main()
Set breakpoint at 'exit'
Sets a breakpoint at exit()
Set breakpoint at
Sets a breakpoint at a user-specified locaiton
Display Download Dialog
Displays a dialog showing the progress of the download to the target section by section
Use xterm as inferior's tty
Causes insight to open a tty for inferior I/O (unix versions only)

More Options

Several additional run options may be set for each target from the Target Selection Dialog. These options govern the behavior of the debugger's Run Button. The debugger automatically selects default values for these options whenever a target is selected with the dropdown menu in the Connection Frame. To modify this default behavior, click the small triangle next to "More Options" at the bottom of the dialog. The Run Options for the current target are displayed, allowing modification of the actions for the target. When the "OK" button is selected, these settings are saved and will be used as the default for the target in future sessions.
Attach to Target
Establish a connection to the target board.
Download Program
Download the program to the target board.
Run Program
Run the program on the target board, creating a new "process". This option may not be specified along with the continue option. See note below.
Continue from Last Stop
Continue the program on the target board from where it last stopped. This option may not be specified along with the "run" option. See note below.

Note that all remote targets typically do not "run" programs. Since target boards are usually incapable of creating a new "process", these targets seldom "Run". The defaults for all remote targets reflect this distinction: they are all set to "Continue".

Only one of the options "Run Program" and "Continue from Last Stop" may be used. Typically, the default behavior of this setting should not be altered.

./usr/share/insight1.0/help/source.html0000644000000000000000000004721011076074207016636 0ustar rootroot Source Window Help

The Source Window


The Source Window is the primary interface between the user and the debugger; it is automatically opened when the debugger starts. The Source Window displays the status of the program, controls execution of the program, and allows visualization of the program execution.

Menus

Toolbar

Source Window Display

Source Window Status Bars

Search Entry


Menus

File Menu

Open
Opens a file selection dialog to select the executable to debug
Close
Closes a previously opened executable file
Source
Reads and executes GDB commands from a text file
Target Settings...
Opens the Target Selection Dialog to edit target settings
Page Setup
(Windows only) Opens the Windows Page Setup dialog to configure printing
PTons; Files, Function Filter, Functions, and Source Display.

Files

The Files section displays a list of all the source files. The files are read from the debug information in the program being debugged. To see the list of functions in a file, click on it. The function list should appear in the Functions Display and the source should appear in the Source Display. You can select multiple files by using the Control or Shift keys while clicking the left mouse button. When multiple files are selected, all the functions in those files are displayed in the Functions Display.

At the bottom of the Files Display, you should see a checkbutton labelled "Hide .h files" and a button labelled "Select All". Checking "Hide .h files" will remove all files ending in ".h" from the Files Display. Clicking "Select All" will select all files in the Files Display.

Function Filter

Above the Function Display you should see a section labelled "Function Filter". The purpose of this section is to apply a filter to the list of functions in the Functions Display. For example, if you click "Select All" in the Files Display, then many hundreds of functions could appear in the Functions Display. To see all functions containing the string "print", for example, click on the combobox in the Function Filter and select "contains". Then type "print" into the box to the right and hit the enter or return key. You should see the Function Di