dis(1)                                                     dis(1)



NAME
     dis - produces an assembly language listing for a  specified
     file

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

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

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

     file Specifies the file that is to be disassembled.

     -F function
          Causes only those named functions from each user-
          supplied filename to be disassembled.

     -l string
          Disassembles the library file specified as string.  For
          example, 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.

     -L   Invokes a lookup of C source labels in the symbol table
          for subsequent printing.

     -o   Prints numbers in octal.  The default is hexadecimal.

     -t sec
          Disassembles the named section as .text.

     -V   Writes the version number of the disassembler to
          standard error.

DESCRIPTION
     dis (disassembler) produces an assembly language listing of
     each of its object file arguments.  The listing includes
     assembly statements and the binary that produced those
     statements.

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



January 1992                                                    1

dis(1)                                                     dis(1)



     disassembled.

     On output, a number enclosed in brackets at the beginning of
     a line, such as [5], means that dis has reached the point in
     the assembly code where a C language line (numbered as
     stated) begins.  If a breakpoint is placed there using
     sdb/adb, the debugger used will stop on a C line.  An
     expression such as <40> in the operand field, following a
     relative displacement for control transfer instructions, is
     the computed address within the section to which control
     will be transferred.  A C function name will appear in the
     first column, followed by ().

STATUS MESSAGES AND VALUES
     The self-explanatory messages indicate errors in the command
     line or problems encountered with the specified files.

FILES
     /bin/dis
          Executable file

SEE ALSO
     as(1), cc(1), ld(1), strings(1)
































2                                                    January 1992