NAME

dbxtool − SunView and OpenWindows interface for the dbx source-level debugger

SYNOPSIS

dbxtool [ −I dir ] [ −kbd ] [ −Wfsdb/-fullscreen ] [ execfile [ corefile | processID ] ]

DESCRIPTION

dbxtool, a source-level debugger for C, ANSI C, C++, Pascal, FORTRAN, and Modula-2 programs, is a standard tool that runs within the SunView and OpenWindows environments.  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. 

execfile is an executable file produced by any other Sun compiler (or a combination of them) with the −g flag specified to produce symbol information in the executable file.  IMPORTANT: every stage of the compilation process, including the linking phase, must include the −g option.  If no execfile is specified, you can use the debug command to specify the program to be debugged.  The executable 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 you are 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. 

Giving a processID instead of a corefile halts that running process and allows you to start debugging that program.  Detaching the debugger from the process allows that process to continue to execute. 

dbxtool executes commands in file .dbxinit file immediately before it reads the symbol table.  dbxtool first searches for .dbxinit in the current directory.  If .dbxinit does not exist in the current directory, dbxtool looks in the user’s home directory. 

OPTIONS

−I dir Add directory 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 execfile is located.  The directory search path can also be set with the use command.  Multiple −I options may be given. 

−kbd Debugs 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. 

−Wfsdb/-fullscreen
OpenWindows only. Debug program on the same server on which you are displaying it. Active grabs are disabled when you press a key, move the pointer, or perform a server action. Passive grabs are disabled when you press a mouse button.

USAGE

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

FILES

core default core file

.dbxinit local dbx initialization file

/.dbxinit user’s dbx initialization file

SEE ALSO

dbx(1), dbxinit(5)

Debugging Tools

  —  Last change: 2 January 1991