Invoking mixasm

In its simplest form, mixasm is invoked with a single argument, which is the name of the MIXAL file to be compiled, e.g.

     mixasm hello
     

will compile either hello or hello.mixal, producing a binary file named hello.mix if no errors are found.

In addition, mixasm can be invoked with the following command line options (note, that, following GNU's conventions, we provide a long option name for each available single letter switch):

     mixasm [-vhulg] [-o OUTPUT_FILE] [--version] [--help] [--usage]
            [--debug] [--output=OUTPUT_FILE] [--list[=LIST_FILE]] file
     

The meaning of these options is as follows:

-v	User Option
-version	User Option

Prints version and copyleft information and exits.

-h	User Option
-help	User Option
-u	User Option
-usage	User Option

Prints a summary of available options and exits.

-g	User Option
-debug	User Option

Includes debugging information in the compiled file, allowing breakpoint setting at source level and symbol table inspection under mixvm.

-o output_file	User Option
-output=output_file	User Option

By default, the given source file file.mixal is compiled into file.mix. You can provide a different name for the output file using this option.

-l	User Option
-list[=list_file]	User Option

This option causes mixasm to produce, in addion to the .mix file, an ASCII file containing a summary of the compilation results. The file is named after the MIXAL source file, changing its extension to .mls if no argument is provided; otherwise, the listing file is named according to the argument.