dis(CP)                        6 January 1993                        dis(CP)


 Name

    dis - object code disassembler

 Syntax

    dis [-d sec] [-da sec] [-F function] [-L] [-l string] [-o] [-R] [-s] [-T]
    [-t sec] [-V] file ...

 Description

    The dis command produces an assembly language listing of file, which may
    be an object file or an archive of object files.  The listing includes
    assembly statements and an octal or hexadecimal representation of the
    binary that produced those statements.  This utility operates only on
    COFF executables.

    dis accepts the following options which may be specified in any order.

    -d sec      Disassemble the named section as data, printing the offset of
                the data from the beginning of the section.

    -da sec     Disassemble the named section as data, printing the actual
                address of the data.

    -F function Disassemble only the named function in each object file
                specified on the command line.  The -F option may be speci-
                fied multiple times on the command line.

    -L          Look up source labels in the symbol table for subsequent
                printing.  This option works only if the file was compiled
                with additional debugging information (for example, the -g
                option of cc(CP)).

    -l string   Disassemble the library file specified by string.  For exam-
                ple, one would issue the command dis -l x -l z to disassemble
                libx.a and libz.a.  All libraries are assumed to be in LIB-
                DIR.

    -o          Print numbers in octal (the default is hexadecimal).

    -R          Real mode flag.  dis assumes 16-bit wide addresses and regis-
                ters when disassembling a file using the -R option.

    -s          Perform symbolic disassembly, that is, specify source symbol
                names for operands where possible.  Symbolic disassembly out-
                put will appear on the line following the instruction.  For
                maximal symbolic disassembly to be performed, the file must
                be compiled with additional debugging information (for exam-
                ple, the -g option of cc(CP)).  Symbol names will be printed
                using C syntax.

    -T          Debug the operation of the disassembler itself.

    -t sec      Disassemble the named section as text.

    -V          Print, on standard error, the version number of the disassem-
                bler being executed.

    If the -d, -da or -t options are specified, only those named sections
    from each user-supplied file name will be disassembled.  Otherwise, all
    sections containing text will be disassembled.

    On output, a number enclosed in brackets at the beginning of a line, such
    as [5], indicates that the break-pointable line number starts with the
    following instruction.  These line numbers will be printed only if the
    file was compiled with additional debugging information (for example, the
    -g option of cc(CP)).  An expression such as <40> in the operand field or
    in the symbolic disassembly, following a relative displacement for con-
    trol transfer instructions, is the computed address within the section to
    which control will be transferred.  A function name will appear in the
    first column, followed by ( ).

 Files

    LIBDIR  Usually /lib.

 Diagnostics

    The self-explanatory diagnostics indicate errors in the command line or
    problems encountered with the specified files.

 See also

    a.out(FP), as(CP), cc(CP), ld(CP)

 Standards conformance

    dis is conformant with:
    AT&T SVID Issue 2;
    and X/Open Portability Guide, Issue 3, 1989.