DIS(1) INTERACTIVE UNIX System 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 pro-
duced 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 hexade-
cimal.
-V Print, on standard error, the version number of
the disassembler being executed.
-L Look up 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 sym-
bolic disassembly to be performed, the file must
be compiled with additional debugging informa-
tion [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.
-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
Rev. C Software Development Set Page 1
DIS(1) INTERACTIVE UNIX System DIS(1)
command dis -l x -l z to disassemble libx.a and
libz.a. All libraries are assumed to be in LIB-
DIR.
If the -d, -da or -t options are specified, only those named
sections from each user-supplied file name will be disassem-
bled. 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 dis-
placement 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
The self-explanatory diagnostics indicate errors in the com-
mand line or problems encountered with the specified files.
Rev. C Software Development Set Page 2