NAME

stabn − allow source-level debugging of assembly language

SYNOPSIS

stabn [ file ]

DESCRIPTION

stabn allows the use of source-level debuggers like dbx(1) and pdb(1) on assembly language files.  When an assembly language file is run through stabn and the output run through as(1), the corresponding object file will contain symbol-table information similar to that produced by cc(1) when run with the -g option.  The ENTRY and EXIT macros defined in /usr/include/machine/asm_linkage.h must be used to mark the beginning and end of each function.  Only assembly language encompassed by these macros will be instrumented. 

EXAMPLES

The following two lines will produce an object file with line number information in the symbol table:

stabn file.s > Tfile.S
cc Tfile.S -o file.o

FILES

<machine/asm_linkage.h>

SEE ALSO

as(1), dbx(1), cc(1), pdb(1). 

BUGS

C style comments and as(1) style comments (exclamation point) can not be mixed together on the same line. 

Solbourne Computer, Inc.  —  22 March 1989