3.11;debug, revision 3.11, 84/04/06
DEBUG -- Invoke the Language Level Debugger.
usage: DEBUG [-WPn|-NWP] [-NC] [-SRC|-SRC_T|-SRC_R] [-SDIR pathname]
[-R[EAD] pathname] [-SMAP]
target_pathname [target_parameters...]
FORMAT
DEBUG [options] target_pathname [target_parameters...]
The Language Level Debugger provides an easy way to debug high-level language
programs (Pascal, FORTRAN, C). When you invoke DEBUG, it splits the current
window into two sections, or "windowpanes". The DEBUG session runs in the top
pane, and your program runs in the bottom pane. These windowpanes disappear
when you terminate the DEBUG session.
NOTE: All DEBUG options MUST appear before the "target_pathname". DEBUG looks
for its options until it finds the target_pathname, and then stops
looking. (This permits a target program to have an option with the same
name as a DEBUG option, if necessary.)
ARGUMENTS
target_pathname
(required) Specify the name of the file containing the program you
wish to debug.
target_parameters
(optional) Specify any parameters that you wish to pass to the program
given by 'target_pathname'. DEBUG options may not be given
here.
Default if omitted: no parameters passed
OPTIONS
Note that all DEBUG options MUST PRECEDE the pathname of the target program.
-WPn Specify size of DEBUG windowpane from 10% to 90%. 'n' may
equal 10, 20, 30, 40, 50, 60, 70, 80, or 90. Default if
omitted: DEBUG creates a windowpane in the top 50% of the
window.
-NWP Do not create DEBUG windowpanes. Instead, DEBUG will
perform input and output operations using the error input
and error output streams in your transcript pad.
-NC This option prevents DEBUG from copying the object file.
Instead, the actual file is mapped for writing and executed
directly.
-SRC
-SRC_T
-SRC_R These options cause DEBUG to display the source file(s)
which were used to make the target program being debugged.
The -SRC option lets DEBUG choose where the source will be
displayed. The -SRC_T option makes DEBUG put the source at
the top of the window; the -SRC_R option makes DEBUG put
the source on the right-hand side of the window.
-SDIR pathname
This option provides alternative directory pathnames for
finding the source file(s), when one of the -SRC options is
used. It may be given any number of times on the command
line. (When the source was compiled, the full pathname was
remembered. If DEBUG cannot find the source file using
that pathname, the source filename is extracted from the
full pathname and is appended to each SDIR pathname. Then,
DEBUG tries each of these pathnames as well.)
-R[EAD] pathname
This option causes DEBUG to read the file specified by
"pathname" and process each line as a DEBUG command as
DEBUG is invoked. It may be given only once on the command
line. (As a regular DEBUG command, it may be given more
than once.)
-SMAP This option generates a brief section map of the loading of
the target program.
DEBUG COMMANDS
Once DEBUG is invoked, it recognizes the following commands. See the Language
Level Debugger Manual for complete details about each command.
A[RGS] - Display the arguments of an active routine.
B[REAKPOINT] - Set a breakpoint.
DEF[INE] - Create or change a substitution string.
D[ELETE] - Delete a breakpoint, macro, or substitution string.
DES[CRIBE] - Print information about a variable's definition.
ENV[IRONMENT] - Display/change the assumed symbolic routine name.
E[XAMINE] - Examine a variable.
EXI[T] - Leave the debugger.
G[O] - Run the target program.
H[ELP] - Display brief information about the commands.
IF - Evaluate a conditional expression and do commands.
J[UMP] - Go to a labeled statement in an action list (command list).
L[IST] - List routines, breakpoints, macros, substitution strings
and debugger variables.
M[ACRO] - Create or change a macro.
P[RINT] - Print the value of one or more expressions.
Q[UIT] - Leave the debugger.
R[EAD] - Read a DEBUG command file.
SDIR - Provide alternate pathnames for source file display.
S[ET] - Set a variable to a new value.
SH[ELL] - Invoke a Shell under the debugger.
STCODE - Display information about a given status code.
ST[EP] - Step the target program one statement.
TB - Traceback the current user calls.
VA - Show the Virtual Address of current program location,
one named routine, or a list of variables.
NOTE: Certain options chosen in the compilation phase of program development
(i.e.,-NDB/-DB/-DBS/-DBA) may influence your ability to access those
programs via DEBUG. See the appropriate compiler manual for details.
RELATED TOPICS
More information is available. Type:
- HELP DEBUG CMD_NAME_ABBREV
for description of a particular Debug command. For example,
$ HELP DEBUG DEF
displays information about the DEBUG command, DEFINE.
- To save your dialog with DEBUG, use the Display Manager's command "PN" to
name the debugger's transcript pad anytime before you issue the debugger's
quit command. Type HELP PN for more information.