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  disassem-
           bly.

     -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 out-
           put.

     -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 sections containing text  will  be  disassem-
     bled.

     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(1B).  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 () 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.

     >0    An error occurred.

FILES

     /usr/lib
           default LIBDIR

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWbtool                   |
    |_____________________________|_____________________________|

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 com-
     mand line or problems encountered with the specified files.