Tornado Reference : Tornado Tools
browser - the Tornado browser (UNIX)
browser [-T.clmode] [-v.ersion] [-h.elp] serverIdentifier [Xt_Standard_Command_line_Parameters]
The Tornado browser is a graphical tool that regularly fetches and displays information about the target to which it is connected. When started, it connects itself to the specified target server (see tgtsvr).
The browser can be started from the launcher (see launch).
The menu bar contains three menu buttons. The File button provides access to the Quit item, which terminates the browser. The About button provides access to the Tornado item, which launches an information window about the current version of the Tornado development environment. The Help button provides access to two menu items: On Browser and Manuals. Both of these items launch the windman tool. The first item displays the browser manual pages, while the second item displays the home page for the Tornado Online Manuals.
The button bar contains five buttons:
- Immediate-update button (!)
- Periodic-update button (clock)
- The browser can be updated in two modes. The first is the per-request mode: the browser updates its windows each time the immediate-update button is pressed. The second is the intervals mode and is selected when the periodic-update button is pressed. Use the parameter-adjustment button (described below) to specify the update interval. Note that a second click on this button will stop the automatic update. These actions affect all the windows associated to the browser.
- Stack-check button (stacked plates)
- More information about the target activity is available via the stack-check button and the spy panel. Press the stack-check button to get the spy panel. This panel summarizes the current and maximum stack usage for each task currently running.
- Spy button (chart)
- Pressing the spy button starts the spy facility on the target. Results of the survey are regularly sent to a dedicated window that shows the CPU usage per task. Use the parameter-adjustment button (described below) to configure the spy facility. Note that the spy report is stopped if the spy button is pressed again.
- Parameter-adjustment button (tools)
- The browser configuration panel is called when the parameter-adjustment button is pressed. This configuration panel lets you choose between various modes: the symbol may be sorted by name or by address, and spy may be run in cumulative or differential modes. Also, spy report time and frequency, and the browser update interval may be specified here.
State indicators (under the the button bar) keep track of the browser configuration.
The browser's windows are organized following a hierarchical model much like directories in a file system. It is possible to hide or display groups of data selectively by closing or opening the groups in which they belong. Each group is identified by a title preceded by a folder-like icon. This icon groups related information and is open by default. A mouse click on this icon closes it, thus hiding the information in groups. Because the information model is hierarchical, closing the top-level folder icon hides all the underlying groups.
Tasks are displayed in two lists: one for system tasks (WRS tasks), the other for user tasks. These lists can be closed or opened by clicking the folder icons. A synopsis of each task is provided, including the task ID, the task name, and the task status.Clicking on the task ID in either task list displays a pop-up window holding data about the selected task, such as its attributes, stack, and registers.
The browser can display detailed information about objects managed by the remote target system. To use this feature, type or copy an object's name or ID into the text window, and then press the Show button. If the object type is known, a pop-up window holding various details about the object is displayed.
The browser displays two bar graphs that represent the amount of allocated memory in the target agent's memory pool and in the target runtime's memory pool.Clicking in the lower bar graph displays a specialized browser that gives detailed information about the target memory usage.
The lowest part of the browser window gives information about loaded modules: module ID, module name, size of text segment, size of data segment, and size of bss segment. The total size for all text, data, and bss segments is also displayed.If more precise information about a module is required, clicking on the module name or ID will display a hierarchical window that holds data such as load options, module format, module type, module address, module segment size, and a list of the published module symbols. Use the parameter-adjustment button to specify how to sort symbols.
The browser accepts the X Toolkit Intrinsics standard command-line parameters such -display or -iconic plus the following dedicated options:
- -T | -Tclmode
- Run a Tcl interpreter on standard input. This is useful for adding and debugging new features.
- -v | -version
- Print the current version of the Tornado development environment.
- -h | -help
- Print the help message.
- WIND_BASE
- the root location of the Tornado tree.
- WIND_REGISTRY
- the host on which the Tornado Registry daemon runs (see wtxregd).
The following resource files are required by the browser:
- $WIND_BASE/host/resource/tcl/Browser.tcl
- Tcl implementation of the browser's interface.
- $WIND_BASE/host/resource/tcl/shelbrws.tcl
- Tcl implementation of the browser's routines.
- $WIND_BASE/host/resource/tcl/app-config/Browser/*.tcl
- Tcl implementation of the browser's additional features.
- $WIND_BASE/host/resource/tcl/app-config/all/host.tcl
- Tcl implementation of the host dependancies.
- $WIND_BASE/host/resource/tcl/app-config/all/host_type.tcl
- Tcl implementation of the host specifics.
The following resource file is applied if present:
- $HOME/.wind/browser.tcl
- Tcl implementation of the user's facilities for the browser.
browser, wtxregd, tgtsvr, launch, Tornado User's Guide