dis(1)                                                     dis(1)



     NAME
          dis - disassembler

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

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

          The following flag options are interpreted by the disassem-
          bler 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 com-
                      mand

                         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 func-
          tions 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



     April, 1990                                                     1

     dis(1)                                                     dis(1)



          the assembly code where a C language line (numbered as stat-
          ed) 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 displace-
          ment for control transfer instructions, is the computed ad-
          dress 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), strings(1).

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





































     2                                                     April, 1990