ASX(CP)                  XENIX System V                   ASX(CP)



     Name
          asx - XENIX 8086/186/286/386 assembler.

     Syntax
          asx [ options ] source-file

     Description
          asx assembles 8086/186/286/386 assembly language source
          files and produces linkable object modules. Note that
          masm(CP) is the supported  assembler and should be used
          instead of asx for new development.

          asx accepts one source-file.  The source file name must have
          the ``.s'' extension.  The resulting file containing the
          object module is given the same base name as the source,
          with the ``.o'' extension replacing the ``.s'' extension.

          There are the following options:

          -a   Assembled segments are output in alphabetic order,
               instead of in order of occurrence in the source file.

          -d   Creates program listings for both passes of the
               assembler.  This listing can be used to resolve phase
               errors between assembler passes.  The -d option is
               ignored if the -l option is not in effect.

          -l   Produces a listing file.  The listing file has the same
               base name as the source file, but has the ``.lst''
               extension.

          -Mu  Disables case sensitivity for all names and symbols.
               This option makes upper and lowercase letters in names
               and symbols indistinguishable to the assembler.  This
               option also causes the symbols defined by the EXTRN and
               PUBLIC directives to be output in uppercase regardless
               of their original spelling.

          -Mx  Disables case sensitivity for all names and symbols
               except those names defined by the EXTRN and PUBLIC
               directives.  This option is similar to the -Mu option
               except that public and external names copied to the
               object file retain their original spelling.

          -n   Suppresses the generation of the symbol table in the
               program listing.  This option is ignored if the -l
               option is not in effect.

          -o filename
               Directs the generated object module to the file named
               filename.  No default extension is assumed.




     Page 1                                           (printed 8/7/87)

     ASX(CP)                  XENIX System V                   ASX(CP)



          -O   Causes values in the program listing to be displayed in
               octal.  The default radix is hexadecimal.

          -r   Causes generation of actual 8087/287 instructions
               instead of software interrupts for the floating point
               emulation package.  Object modules created using this
               option can only be executed on machines with an 8087 or
               287.

          -X   Directs the assembler to list any conditional block
               whose IF condition resolves to false.  This option can
               be overridden in the source file by using the .TFCOND
               directive.  This option is ignored if the -l option is
               not in effect.

          By default, asx recognizes 8086 instruction mnemonics only.
          To assemble 186, 286, 386, 8087, or 287 instructions, the
          corresponding .186, .286c, .286p, .386, .8087, or .287
          directive must be given in the source file.

     Files
          /bin/asx

     See Also
          ld(CP)

     Note
          Unless the -r is given, asx assumes all 8087/287
          instructions are to be carried out using floating point
          emulation. The -r option should only be used on machines
          with an 8087 or 287 coprocessor.

          asx (CP) is also known as the Ritchie assembler. It was used
          before the introduction of the cmerge C compiler and is not
          compatible with cc (CP).  Use ld(CP) to link object modules
          created with asx.



















     Page 2                                           (printed 8/7/87)