dis(1)                                                               dis(1)

NAME
     dis - object code disassembler

SYNOPSIS
     dis [-o] [-V] [-L] [-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 representa-
     tion of the binary that produced those statements.

OPTIONS
     -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 informa-
          tion (for example, 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.

     -t sec
          Disassemble the named section as text.

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

     --   If the first filename begins with a dash (-), the end of the
          command-line options must be marked with --.

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

     On output, a number enclosed in brackets at the beginning of a line,



Page 1                       Reliant UNIX 5.44                Printed 11/98

dis(1)                                                               dis(1)

     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.

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

FILES
     LIBDIR
          Usually /usr/ccs/lib

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
































Page 2                       Reliant UNIX 5.44                Printed 11/98