dis(1)            (Software Generation System Utilities)             dis(1)


   NAME
         dis - object code disassembler

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


   8/91                                                                 Page 1

   dis(1)            (Software Generation System Utilities)             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
         [e.g., 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).

   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                                                                 8/91