dis(1)                                                     dis(1)



     NAME
          dis -  disassembler

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

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

          The following flag options are interpreted by the
          disassembler and may be specified in any order:

          -o          Print numbers in octal.  Default is hexadecimal.

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

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

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

          -t sec      Disassemble the named section as text.

          -l string   Disassemble 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.

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

          If the -F flag option is specified, only those named
          functions from each user-supplied filename are 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



     Page 1                                        (last mod. 1/16/87)

     dis(1)                                                     dis(1)



          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 ().

     FILES
          /bin/dis

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

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







































     Page 2                                        (last mod. 1/16/87)