wdc-utils/man1/wdcsym.1
2017-01-05 20:48:12 -05:00

85 lines
1.9 KiB
Groff

.Dd December 28, 2016
.Dt WDCSYM 1
.Os
.Sh NAME
.Nm wdcsym
.Nd Examine WDC symbol tables
.Sh SYNOPSIS
.Nm
.Op Fl ALS
.Ar symfile
.Sh DESCRIPTION
The
.Nm
utility provides a means to examine symbol files generated by the
.Nm WDCLN linker.
.Nm
will print out the sections defined in the target program and if desired the
line tables, symbol records, auxiliary records and global symbols.
.Pp
Note:This is only for
.Em ZARDOZ
symbol files. See the
.Nm WDCLN
manual and the
.Fl G
and
.Fl HZ
options.
.Sh OPTIONS
.Bl -tag -width indent
.It Fl A
This option causes the display of the auxiliary table. This table contains
typing information, array sizes and other information used in source level
debugging. Only one table is present in the symbol file and is referenced
by all sections and modules.
.It Fl L
This option causes the display of the line information data for each section
in the symbol file.
.It Fl S
This option causes the display of all global symbol records in the symbol
file. Normally, the global symbol records are suppressed.
.Pp
The following command displays the section information, and symbols for all
sections and the global symbols as well.
.Pp
.Dl Nm Fl S Ar PROG.SYM
.Pp
.El
The basic structure of the file is outlined as follows:
.Bl -inset -compact -offset indent
.It File Header
.It Module 1 Information
.Bl -inset -compact -offset indent
.It Section 1 Information
.It ...
.It Section N Information
.It Line Record Information
.El
.It Module 2 Information
.Bl -inset -compact -offset indent
.It ...
.El
.It Module N Information
.Bl -inset -compact -offset indent
.It ...
.El
.It Global Symbol Records
.It String Table
.It Auxiliary Record Table
.It Source File Information
.It End of file
.El
.Sh SEE ALSO
.Xr wdc02as 1 ,
.Xr wdc02cc 1 ,
.Xr wdc02op 1 ,
.Xr wdc816as 1 ,
.Xr wdc816cc 1 ,
.Xr wdc816op 1 ,
.Xr wdcdb 1 ,
.Xr wdcln 1 ,
.\" .Xr wdclib 1 ,
.Xr wdcobj 1
.\" .Xr wdcsym 1