diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-26 16:38:00 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-26 16:38:00 -0400 |
| commit | 97d5c458cfa039d857301e1ca7d5af3beb37131d (patch) | |
| tree | b460cd850d0537eb71806ba30358840377b27688 /static/unix-v10/man1/mc68dis.1 | |
| parent | b89dc2331a50c63f8b33272a5c4c61ab98abdaa3 (diff) | |
build: Better Build System
Diffstat (limited to 'static/unix-v10/man1/mc68dis.1')
| -rwxr-xr-x | static/unix-v10/man1/mc68dis.1 | 162 |
1 files changed, 162 insertions, 0 deletions
diff --git a/static/unix-v10/man1/mc68dis.1 b/static/unix-v10/man1/mc68dis.1 new file mode 100755 index 00000000..d44c9134 --- /dev/null +++ b/static/unix-v10/man1/mc68dis.1 @@ -0,0 +1,162 @@ +.TH MC68DIS 1 "630 MTG" +.SH NAME +mc68dis \- MC68000 disassembler +.SH SYNOPSIS +.B mc68dis +.RB [ \-o ] +.RB [ \-V ] +.RB [ \-L ] +.RB [ \-d " sec]" +.RB [ \-da " sec ]" +.RB [ \-F " function]" +.RB [ \-t " sec]" +.br +.RB [ \-l " string]" +files +.SH DESCRIPTION +The +.I mc68dis +command +produces an assembly language listing +of each of its +object +.IR file +arguments. +The listing includes +assembly +statements +and a hexadecimal or octal representation of the binary that +produced those statements. +.PP +The following \fIoptions\fP are +interpreted by the disassembler and may be specified in any order. +.PP +.TP 12 +.B \-o +Prints numbers in octal. +Default is hexadecimal. +.PP +.TP 12 +.B \-V +Version number of the disassembler is written to standard error. +.PP +.TP 12 +.B \-L +Invokes a look-up of C source labels in the symbol table for +subsequent printing. +.PP +.TP 12 +.BR \-d " sec" +Disassembles the +named section as data, +printing the offset of +the data from the +beginning of the section. +.PP +.TP 12 +.BR \-da " sec" +Disassembles the +named section as data, +printing the actual +address of the data. +.PP +.TP 12 +.BR \-F " function" +Disassembles the +named function +in each object file +that is specified +on the command line. +.PP +.TP 12 +.BR \-t " sec" +Disassembles the +named section as text. +.PP +.TP 12 +.BR \-l " string" +Disassembles the +library file specified +as +.IR string . +For example, +one would issue the +command +.B "mc68dis \-l x \-l z" +to disassemble +.B libx.a +and +.B libz.a\c +\&. +All libraries are +assumed to be in +.BR $DMD/lib . +.DT +.br +.PP +If the +.BR \-d , +.B \-da +or +.BR \-t +options are specified, +only those named +sections from each +user supplied file name +are disassembled. +Otherwise, all sections +containing text will +be disassembled. +.PP +If the +.BR \-F +option is specified, +only those named +functions from each +user supplied file name +are disassembled. +.B \-F +only works with object files that have been compiled with the +.B "dmdcc -g" +option. +.bp +.PP +On output, a number enclosed in brackets +at the beginning of a line, +such as +.BR [5] , +represents a C break-pointable line number that +starts with the following instruction. +These line numbers are present only when the +object file has been compiled with the +.B "dmdcc -g" +option. +An expression such as +.B <40> +in the operand field, +following a relative displacement +for control transfer instructions, +is the computed address +within the section to which +control is transferred. +Similarly, an expression such as +\f3<40>+%d0\f1, +following a program counter index plus displacement +operand, indicates that the effective address +of the operand in the current section is 40 plus the content of %d0. +A C function name +will appear in the first column, +followed by +.BR (\|) , +if the function was compiled with +.BR -g . +.SH "SEE ALSO" +dmdcc(1), +mc68as(1), +mc68ld(1). +.SH "DIAGNOSTICS" +The self-explanatory diagnostics +indicate errors in +the command line or problems +encountered with the +specified files. |
