NAME

edge − window-based debugger

SYNOPSIS

edge [  −r  ] [  −i  ] [  −I dir  ] [  −c file  ] [ objfile ]

DESCRIPTION

Edge is a window-based interface to dbx(1).  Objfile is an object file that you create by using the −g flag when you compile your FORTRAN or C source code.  When you start edge, it creates three windows: the dbx command window, the source window, and the user input/output window.  The dbx window contains the dbx prompt. You can use the typical dbx commands here. This window also contains buttons for sending commands to dbx.  The user window, stdin/stdout/stderr, acts as the user program’s input and output window.  The source window contains the user program’s source code.  You can resize, reshape and move these windows by pressing and holding the right mouse button in the title bar. This produces the mex(1G) menu.  See below for more information on windows. 

Arguments to edge are the same as those to dbx. 

The Dbx Window

See dbx(1) for the line interface in this window. You use the buttons in this window by moving the cursor over the item you want to select, then pressing the left mouse button. The buttons invoke these commands:

rerunSends the rerun command to dbx.  Edge uses arguments you specified for the last run command to rerun your program. 

stopSets a breakpoint at the currently selected line in the source window. Selecting text in the source window is discussed below. 

stepSingle steps one source line. 

nextSingle steps one source line, but skips over function and subroutine calls. 

contContinues execution. 

printPrints the value of the variable selected in the source window. 

where
Prints a stack trace from the current point of execution.

traceTraces execution of all source lines.  The currently executing line is highlighted in green in the source window. 

interrupt
Sends an interrupt to dbx. 

shForks a shell in a window.  The environment variable SHELL determines which shell is used. 

quitExits from edge. 

When you press the the right mouse button over any edge window, you see a menu with the following choices:

attach
Attaches input focus to the window.

selectPops and attaches to the window. 

editLets you edit a source file. This choice contains a sub-menu that lists the source files that make up your program. Slide the cursor to the right to see the sub-menu, then select the file you want to edit. This invokes the editor specified by the $EDIT environment variable on the selected file. 

fileLets you read another source file into the source window. This choice contains a sub-menu that lists the source files that make up your program. Select the file you want displayed in the source window. 

The Source Window

The source window displays your source. The currently executing line is highlighted in green. Breakpoints are highlighted in red.  Selected text is highlighted in yellow. Select text by pressing and holding the left mouse button, dragging the cursor over the text to be selected, then releasing the mouse button. When you use the file or / commands in the dbx window, the results  will be reflected in the source window.  The title bar of this window contains the name of the file being displayed. 

The User window.

This window acts as the user program’s stdin/stdout/stderr. 

Edgerc syntax.

If the file .edgerc exists in the current directory, edge reads it. The syntax for commands in the .edgerc file follow:

size window [rows] [columns]
window specifies either the dbx, source, or user window.  Rows specifies the number of rows the window should occupy, and columns specifies the number of columns the window should occupy.  If you do not specify rows and columns, you will be prompted to size and place your windows. 

origin window [xcoord] [ycoord]
This command causes the specified window’s origin to be at xcoord, ycoord.  If you do not specify xcoord and ycoord, you will be prompted to place your own windows. 

color text background
Text and background are integers that specify the color indices to be used for text and background. 

FILES

a.outdefault object file
.edgercinitialization commands
/usr/lib/gshterminal emulator

SEE ALSO

cc(1), f77(1), dbx(1)
Getting Started with edge for C
Getting Started with edge for FORTRAN

AUTHOR

Jim Terhorst

BUGS

Edge uses the color indices 0-7. If you modify these, you modify edge’s colors. 

Version 3.6  —  December 20, 1987