wdcsym.1

wdcsym.1

@@ -0,0 +1,86 @@
+.Dd December 28, 2016
+.Dt WDCSYM 1
+.Os
+.Sh NAME
+.Nm wdcsym
+.Nd Examine symbol tables
+.Sh SYNOPSIS
+.Nm
+.Op Fl A
+.Op Fl L
+.Op Fl S
+.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 WDCSYM -S 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