dis(1) — AIX PS/2 1.2.1



DIS(1,C)                    AIX Commands Reference                     DIS(1,C)



-------------------------------------------------------------------------------
dis



PURPOSE

Produces PS/2 Assembler language listing from compiled programs.

SYNTAX


      +--------------------------------------------------------------------+
dis --| +-----------------+ +-------------------------+  +- object file -+ |--|
      +-| +-------------+ |-|         one of          |--|               |-+
        +-| -o filename |-+ | +---------------------+ |  +- executable --+
         ^| -w          ||  +-| -e entry-point name |-+
         |+-------------+|    | -r                  |
         +---------------+    +---------------------+


Note:  This command is for the PS/2 only.

DESCRIPTION

The dis command provides a disassembler to be used with AIX C, VS Pascal and VS
FORTRAN programs on the PS/2.  The disassembler can be executed from the
command line or through the menu system.  It can operate on either the object
file (file.o) or the executable file (file).  Use the d+ flag when you compile
your program to produce the symbolic information the disassembler needs.
Although the symbolic information is not necessary, the function of the
disassembler becomes limited without it.  It uses this information to generate
user type declarations, user variable location information, user statement
labels, and unique symbol labels.

When disassembling executable files made from separately compiled modules, full
symbolic information exists only for the entry points contained in the modules
compiled with the d+ flag.

Note:  dis works on C files compiled with both Extended C and C compilers.

FLAGS

-e entry-point Specifies the entry point to be disassembled.  An entry point is
               the name of a function, procedure, subroutine, program, or
               FORTRAN entry statement in the user's program.  The entry point
               name is case sensitive.  All Pascal and FORTRAN entry point
               names must be specified in lowercase.  This option cannot be
               used with the -r option.

-o file name   Specifies the output file for disassembled code.




Processed November 8, 1990         DIS(1,C)                                   1



DIS(1,C)                    AIX Commands Reference                     DIS(1,C)



-r             Specifies that the output of the disassembled program can be
               reassembled using the assembler (see the as command).  This
               option cannot be used with executable files; it is used with
               object files only.  The absence of the symbolic information
               prohibits the use of this option from the command line.  This
               option cannot be used with the -e option.

-w             Suppresses the display of warning messages.

FILES

/usr/lib/msg/vsdismsg.inc
                       Message file, which must be present.

RELATED INFORMATION

See the following commands:  "as" and "cc."

See the discussion of the disassembler in AIX Operating System Programming
Tools and Interfaces.



































Processed November 8, 1990         DIS(1,C)                                   2

Museum

Related Articles