unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

dis(1)                           User Commands                          dis(1)



NAME
       dis - object code disassembler

SYNOPSIS
       /usr/ccs/bin/dis  [-C]  [-o]  [-V] [-L] [-d sec] [-D sec] [-F function]
       [-l string] [-t sec] 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. However, the IA64 listing
       is limited to assembly statements only.

OPTIONS
       The following options are interpreted by the disassembler  and  may  be
       specified in any order.

       -C              Displays demangled C++ symbol names in the disassembly.



       -d sec          Disassembles  the  named  section as data, printing the
                       offset of the data from the beginning of the section.



       -D sec          Disassembles the named section as  data,  printing  the
                       actual address of the data.



       -F function     Disassembles  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 string       Disassembles  the archive file specified by string. For
                       example, one would issue the command dis -l x -l  z  to
                       disassemble  libx.a and libz.a, which are assumed to be
                       in LIBDIR.



       -L              Invokes a lookup of C-language  source  labels  in  the
                       symbol table for subsequent writing to standard output.



       -o              Prints numbers in octal. The default is hexadecimal.



       -t sec          Disassembles the named section as text.



       -V              Prints,  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 will be disassembled. Otherwise, all sec-
       tions 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 exam-
       ple, the -g option of cc(1B). An expression such as <&lt;40>&gt; 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.

OPERANDS
       The following operand is supported:

       file            A path name of an object file or an archive (see ar(1))
                       of object files.



ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following environment  variables
       that affect the execution of dis: LC_CTYPE, LC_MESSAGES, and NLSPATH.

       LIBDIR          If this environment variable contains a value, use this
                       as the path to search for the library. If the  variable
                       contains  a  null  value, or is not set, it defaults to
                       searching for the library under /usr/lib.



EXIT STATUS
       The following exit values are returned:

       0               Successful completion.



       >&gt;0              An error occurred.



FILES
       /usr/lib        default LIBDIR



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE  VALUE  AvailabilitySUNWbtool
       Interface StabilitySee below.


       The human readable output is Unstable. The  command  line  options  are
       Evolving.

SEE ALSO
       ar(1), as(1), cc(1B), ld(1), a.out(4), attributes(5), environ(5)

DIAGNOSTICS
       The self-explanatory diagnostics indicate errors in the command line or
       problems encountered with the specified files.



SunOS 5.10                        14 Feb 2003                           dis(1)