Return to mc68dis.1 CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1

Annotation of researchv10dc/630/man/src/u_man/man1/mc68dis.1, revision 1.1.1.1

1.1       root        1: .TH MC68DIS 1 "630 MTG" 
                      2: .SH NAME
                      3: mc68dis \- MC68000 disassembler
                      4: .SH SYNOPSIS
                      5: .B mc68dis
                      6: .RB [ \-o ]
                      7: .RB [ \-V ]
                      8: .RB [ \-L ]
                      9: .RB [ \-d " sec]"
                     10: .RB [ \-da " sec ]"
                     11: .RB [ \-F " function]"
                     12: .RB [ \-t " sec]"
                     13: .br
                     14: .RB [ \-l " string]"
                     15: files
                     16: .SH DESCRIPTION
                     17: The 
                     18: .I mc68dis
                     19: command
                     20: produces an assembly language listing
                     21: of each of its
                     22: object
                     23: .IR file
                     24: arguments.
                     25: The listing includes
                     26: assembly
                     27: statements
                     28: and a hexadecimal or octal representation of the binary that
                     29: produced those statements.
                     30: .PP
                     31: The following \fIoptions\fP are
                     32: interpreted by the disassembler and may be specified in any order.
                     33: .PP
                     34: .TP 12
                     35: .B \-o
                     36: Prints numbers in octal.
                     37: Default is hexadecimal.
                     38: .PP
                     39: .TP 12
                     40: .B \-V
                     41: Version number of the disassembler is written to standard error.
                     42: .PP
                     43: .TP 12
                     44: .B \-L
                     45: Invokes a look-up of C source labels in the symbol table for
                     46: subsequent printing.
                     47: .PP
                     48: .TP 12
                     49: .BR \-d " sec"
                     50: Disassembles the 
                     51: named section as data,
                     52: printing the offset of
                     53: the data from the
                     54: beginning of the section.
                     55: .PP
                     56: .TP 12
                     57: .BR \-da " sec"
                     58: Disassembles the 
                     59: named section as data,
                     60: printing the actual 
                     61: address of the data.
                     62: .PP
                     63: .TP 12
                     64: .BR \-F " function"
                     65: Disassembles the
                     66: named function
                     67: in each object file
                     68: that is specified
                     69: on the command line.
                     70: .PP
                     71: .TP 12
                     72: .BR \-t " sec"
                     73: Disassembles the
                     74: named section as text.
                     75: .PP
                     76: .TP 12
                     77: .BR \-l " string"
                     78: Disassembles the
                     79: library file specified
                     80: as
                     81: .IR string .
                     82: For example,
                     83: one would issue the
                     84: command
                     85: .B "mc68dis \-l x \-l z"
                     86: to disassemble
                     87: .B libx.a
                     88: and
                     89: .B libz.a\c
                     90: \&.
                     91: All libraries are
                     92: assumed to be in
                     93: .BR $DMD/lib .
                     94: .DT
                     95: .br
                     96: .PP
                     97: If the
                     98: .BR \-d ,
                     99: .B \-da
                    100: or
                    101: .BR \-t
                    102: options are specified,
                    103: only those named
                    104: sections from each
                    105: user supplied file name
                    106: are disassembled.
                    107: Otherwise, all sections
                    108: containing text will
                    109: be disassembled.
                    110: .PP
                    111: If the
                    112: .BR \-F
                    113: option is specified,
                    114: only those named 
                    115: functions from each
                    116: user supplied file name
                    117: are disassembled.
                    118: .B \-F
                    119: only works with object files that have been compiled with the
                    120: .B "dmdcc -g"
                    121: option.
                    122: .bp
                    123: .PP
                    124: On output, a number enclosed in brackets
                    125: at the beginning of a line,
                    126: such as 
                    127: .BR [5] ,
                    128: represents a C break-pointable line number that
                    129: starts with the following instruction.
                    130: These line numbers are present only when the
                    131: object file has been compiled with the
                    132: .B "dmdcc -g"
                    133: option.
                    134: An expression such as
                    135: .B <40>
                    136: in the operand field,
                    137: following a relative displacement
                    138: for control transfer instructions,
                    139: is the computed address
                    140: within the section to which
                    141: control is transferred.
                    142: Similarly, an expression such as
                    143: \f3<40>+%d0\f1,
                    144: following a program counter index plus displacement
                    145: operand, indicates that the effective address
                    146: of the operand in the current section is 40 plus the content of %d0.
                    147: A C function name
                    148: will appear in the first column,
                    149: followed by
                    150: .BR (\|) ,
                    151: if the function was compiled with
                    152: .BR -g .
                    153: .SH "SEE ALSO"
                    154: dmdcc(1),
                    155: mc68as(1),
                    156: mc68ld(1).
                    157: .SH "DIAGNOSTICS"
                    158: The self-explanatory diagnostics
                    159: indicate errors in
                    160: the command line or problems
                    161: encountered with the
                    162: specified files.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.