diff --git a/wdcsym.1 b/wdcsym.1 new file mode 100644 index 0000000..b4db69a --- /dev/null +++ b/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