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     ! 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.