DIS(1) (Software Generation System Utilities) DIS(1)
NAME
dis - object code disassembler
SYNOPSIS
dis [-o] [-V] [-L] [-s] [-d sec] [-da 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.
-o Print numbers in octal. The default is
hexadecimal.
-V Print, on standard error, the version number of
the disassembler being executed.
-L Lookup source labels in the symbol table for
subsequent printing. This option works only if
the file was compiled with additional debugging
information [e.g., the -g option of cc(1)].
-s Perform symbolic disassembly- i.e., specify
source symbol names for operands where possible.
Symbolic disassembly output will appear on the
line following the instruction. For maximal
symbolic disassembly to be performed, the file
must be compiled with additional debugging
information [e.g., the -g option of cc(1)].
Symbol names will be printed using C syntax.
-d sec Disassemble the named section as data, printing
the offset of the data from the beginning of the
section.
Page 1 May 1989
DIS(1) (Software Generation System Utilities) DIS(1)
-da 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.
-t sec Disassemble the named section as text.
-l string Disassemble the library file specified by
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
LIBDIR.
If the -d, -da 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.
On output, a number enclosed in brackets at the beginning of
a line, such as [5], represents 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(1)]. 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 ().
FILES
LIBDIR usually /lib.
SEE ALSO
as(1), cc(1), ld(1), a.out(4).
DIAGNOSTICS
Page 2 May 1989
DIS(1) (Software Generation System Utilities) DIS(1)
The self-explanatory diagnostics indicate errors in the
command line or problems encountered with the specified
files.
Page 3 May 1989