Name
dis - object code disassembler
Syntax
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 Look up source labels in the symbol table for
subsequent printing. This option works only if
the file was compiled with additional debugging
information (for example, the -g option of
cc(CP)).
-s Perform symbolic disassembly, that is, 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 (for example, the -g option of
cc(CP)). 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
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 (for example, the -g
option of cc(CP)). 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 ().
Notes
Note that this utility operates only on COFF format
executables.
Files
LIBDIR usually /lib.
See Also
as(CP), cc(CP), ld(CP), a.out(F)
Diagnostics
The self-explanatory diagnostics indicate errors in the
command line or problems encountered with the specified
files.
Standards Conformance
dis is conformant with:
AT&T SVID Issue 2, Select Code 307-127;
and The X/Open Portability Guide II of January 1987.
(printed 6/18/89)