NAME

dbxtool − window- and mouse-based source-level debugger for C, FORTRAN 77, and Pascal programs

SYNOPSIS

dbxtool [ −i ] [ −I dir ] [ −k ] [ −kbd ] [ objfile [ corefile ] ]

DESCRIPTION

dbxtool, a source-level debugger for C, Pascal and FORTRAN 77 programs, is a standard tool that runs within the SunView environment.  It accepts the same commands as dbx, but provides a more convenient user interface.

You can use the mouse to set breakpoints, examine the values of variables, control execution, peruse source files, and so on.  dbxtool has separate subwindows for viewing source code, entering commands and other uses. 

objfile is an object file produced by cc(1V), f77(1), or pc(1) (or a combination of them) with the appropriate flag (−g) specified to produce symbol information in the object file.  IMPORTANT: every stage of the compilation process, including the linking phase, must include the −g option.  If no objfile is specified, you can use the debug command to specify the program to be debugged.  The object file contains a symbol table which includes the names of all the source files translated by the compiler to create it.  These files are available for perusal while using the debugger. 

If a file named core exists in the current directory or a corefile is specified, dbxtool can be used to examine the state of the program when it faulted. 

Debugger commands in the file .dbxinit are executed immediately after the symbolic information is read, if that file exists in the current directory, or in the user’s home directory if .dbxinit doesn’t exist in the current directory. 

OPTIONS

−iForce dbxtool to act as though standard input were a terminal. 

−I dirAdd dir to the list of directories that are searched when looking for a source file.  Normally dbxtool looks for source files in the current directory and then in the directory where objfile is located.  The directory search path can also be set with the use command.  Multiple −I options may be given. 

−kKernel debugging. 

−kbdDebugs a program that sets the keyboard into up/down translation mode.  This flag is necessary if you are debugging a program that uses up/down encoding. 

USAGE

Refer to dbx(1) for a summary of dbx commands, or Program Debugging Tools for the Sun Workstation for more complete information on using dbxtool.

FILES

a.outdefault object file
coredefault core file
.dbxint,~/.dbxinitcustomization file for dbx

SEE ALSO

dbx(1), cc(1V), f77(1), pc(1)

Debugging Tools for the Sun Workstation

The SunView Application Programmer’s Guide

BUGS

The bugs for dbx(1) apply to dbxtool as well. 

The interaction between scrolling in the source subwindow and dbx’s regular expression search commands is wrong. Scrolling should affect where the next search begins, but it does not.

Sun Release 3.2  —  Last change: 29 April 1986