dis(1)
_________________________________________________________________
dis Command
object code disassembler
_________________________________________________________________
SYNTAX
dis [-o] [-V] [-L] [-s] [-d sec] [-da sec ] [-F function ] [-t
sec] [-l lib] file ...
DESCRIPTION
The dis command produces an assembly language listing of file,
which may be an object or executable file or an archive of object
or executable 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 [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 section Disassemble the named section as data, printing the
relative offset of the data from the beginning of the
section.
-da section Disassemble the named section as data, printing the
actual (absolute) address of the data.
-F function Disassemble only the named function in each object
file specified on the command line. The -F option
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
dis(1)
may be specified multiple times on the command line.
-t section Disassemble the named section as text.
-l library Disassemble the library file specified by library.
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 /lib.
If the -d, -da, 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, such as [5], indicates that a breakpoint can be set on the
line. These line numbers will be printed only if the file was
compiled with additional debugging information [e.g., the -g
option of cc(1)]. The function names will appear in the first
column, followed by ().
FILES
/lib directory searched for libraries with the -l option.
SEE ALSO
as(1), cc(1), ld(1), ar(1), att_dump(1), nm(1).
DIAGNOSTICS
The self-explanatory diagnostics indicate errors in the command
line or problems encountered with the specified files.
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)