Node:Invoking mixasm, Previous:mixasm, Up:mixasm



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.