Series 300 Only

NAME

ada.probe − interactive Ada debugger and viewer

SYNOPSIS

ada.probe [ options ] executable [ args ]

DESCRIPTION

Ada.probe is a symbolic debugger that offers such execution control features as setting breakpoints, executing in single steps and changing the value of variables.  Additionally, ada.probe  offers Ada source viewing features to facilitate comprehension of program structure. 

Executable is an Ada executable program file having one or more units compiled with either the -d or -D option of the ada(1) command.  In addition, the binding of the program must have included either of these options to create an executable with an associated .cui file. The .cui file defines the execution control information required by ada.probe. 

The following options are recognized:

-c Define dialog between the executable and user to start at the current cursor position within the ada.probe screen. Note that the dialog may  overwrite the information within the ada.probe screen. See −m. 

-e file Redirect standard error of the executable to the specified file name. 

-i file Redirect standard input of the executable from the specified file name. 

-m Define dialog between the executable and user that is  held in the Message Window of the ada.probe screen. See −c. 

-o file Redirect standard output of the executable to the specified file name. 

Ada.probe invokes the executable with the specified args (if any) within an interactive, controlling environment with an underlying windowing mechanism.  The basic screen layout consists of two initial windows:

1.  The Message Window displays output from ada.probe. In addition, dialog between the executable and user can be held in this window. (See Dialog.) 

2.  The Menu Window displays the list of available menu commands. Each choice is either another menu that groups related commands or a command. 

In addition to displaying its ouput in the Message Window, ada.probe records this information the file session.log, created in the directory where ada.probe is invoked. 

Dialog between the executable and user is controlled by the ada.probe options. For any dialog not redirected by the -i, -o and -e options, the area of the ada.probe screen where the dialog takes place is defined by either the -c or -m option. If neither option is specified, the default depends on whether or not ada.probe is being used within an X window system.  If within an X window system, the dialog is held in the X window where ada.probe was invoked; otherwise the dialog is held in the Message Window of the ada.probe screen. 

Commands

Commands are selected using pop-up window menus or entered using programmable key bindings. Within the permanent Menu Window the following menu commands are available:

Break Select submenu of breakpoint management commands. 

Exec Select submenu of execution control commands. 

Object Select submenu of object manipulation commands. 

Progress Select submenu of progression facility commands. 

Quit Exit ada.probe. 

Regs Display register values. 

Units Select submenu of unit manipulation commands. 

Help Obtain help on the various ada.probe commands. 

Xtra Select submenu of advanced and miscellaneous facilities. 

For the syntax and semantics of these menu commands and associated submenu commands, refer to the Ada Tools Manual or use the available on-line help facility. 

If the file .ada.proberc exists in the user’s home directory, its commands are executed before the first prompt is issued. 

Environment Variables

Two environment variables, ADA_PATH and ADA_PREDEF_LIB, are associated with all components of the the Ada compilation system. Both must be set properly and exported before any component of the Ada compilation system (including ada.probe) can be used (see ada(1), Environment Variables). 

AUTHOR

Ada.probe was developed by HP and Alsys. 

FILES

$ADA_PATH/adahostcap
Ada host system capability checker.

$ADA_PATH/ada.probe.bin
Ada debugger/viewer manager subprocess.

$ADA_PATH/ada.probe.dat
Ada debugger/viewer manager system dependencies data.

$ADA_PATH/upi/ada.probe.kb
Ada debugger/viewer manager key binding data.

$ADA_PATH/upi/tcf Ada debugger/viewer manager terminal configuration data. 

$ADA_PATH/upi/*.btl Ada debugger/viewer manager command tables. 

$ADA_PATH/upi/*.ft Ada debugger/viewer manager font files. 

$ADA_PATH/upi/*.hix Ada debugger/viewer manager help command index. 

$ADA_PATH/upi/*.hlp Ada debugger/viewer manager help command data. 

SEE ALSO

ada(1), ada.fmgr(1), ada.format(1), ada.mklib(1), ada.mvlib(1), ada.protect(1), ada.rmlib(1), ada.umgr(1), ada.unlock(1), ada.xref(1), X(1). 
 
Ada Tools Manual, HP Part No. 98860-90020. 
 
Ada User’s Guide (Series 300), HP Part No. 98860-90000. 
 
X Window System, HP Part No. 82320-90001, 82320-90002. 

INTERNATIONAL SUPPORT

8-bit file names. 

Hewlett-Packard Company  —  May 11, 2021