dis(1)                 UNIX System V(C Development Set)                  dis(1)


NAME
      dis - object code disassembler

SYNOPSIS
      dis [-o] [-V] [-L] [-s] [-d sec] [-D sec] [-F function] [-t sec] [-l
      string] 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.

      The following options are interpreted by the disassembler and 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.

      -D 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
                  specified multiple times on the command line.

      -L          Lookup source labels for subsequent printing.  This option
                  works only if the file was compiled with additional debugging
                  information [e.g., the -g option of cc].

      -l string   Disassemble the archive file specified by string.  For
                  example, one would issue the command dis -l x -l z to
                  disassemble libx.a and libz.a, which are assumed to be in
                  LIBDIR.

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

      -s          Perform symbolic disassembly where possible.  Symbolic
                  disassembly output will appear on the line following the
                  instruction.  Symbol names will be printed using C syntax.

      -t sec      Disassemble the named section as text.

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

      If the -d, -D 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.





10/89                                                                    Page 1

dis(1)                 UNIX System V(C Development Set)                  dis(1)


      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].  An expression such as <40> in the operand field or in
      the symbolic disassembly, following a relative displacement for control
      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 () if the object file contains a symbol table.

FILES
      LIBDIR         usually /usr/ccs/lib

SEE ALSO
      as(1), cc(1), ld(1), a.out(4)

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

NOTES
      Since the -da option did not adhere to the command syntax rules, it has
      been replaced by -D.

      At this time, symbolic disassembly does not take advantage of additional
      information available if the file is compiled with the -g option.




























Page 2                                                                    10/89