dis(1) 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 (for
example, the -g option of cc).
-l string Disassemble the archive file specified by string.
For example, you 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.
Copyright 1994 Novell, Inc. Page 1
dis(1) dis(1)
-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.
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.
Errors
The self-explanatory diagnostics indicate errors in the
command line or problems encountered with the specified files.
Files
Libdir usually /usr/ccs/lib
REFERENCES
a.out(4), as(1), cc(1), ld(1)
NOTICES
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.
Copyright 1994 Novell, Inc. Page 2