Using the Maisie Compiler

The Maisie compiler, called mc, accepts all the options supported by the C compiler, and also supports separate compilation. C programs (files with .c suffix) and object files (files with .o suffix) can also be compiled and linked with Maisie programs. Note: a Maisie program must be suffixed with .m and include the header file maisie.h.

Options

Maisie compiler also supports the following options:

	-lmaisie	 Link with the entity library.
	-trace		 Generate code for trace-facility.
	-May		 Generate a file with the translated C code.

Sequential Execution

The following examples illustrate how to compile Maisie programs on a sequential architecture. (Note: the Maisie compiler is called mc.)

%mc -o example example.m
This generates an executable file example in the current working directory.

%mc example.m
This generates an executable file a.out in the current working directory.

%mc -o example example.m xxx.c yyy.o
This generates an executable file called example in the current working directory. The file example is compiled and linked with xxx.c and yyy.o.

%mc server.m client.m
This compiles two Maisie programs: server.m and client.m, and generates a.out as the executable.

Parallel Execution

In order to produce an executable that can be run on a parallel architecture, the Maisie program needs to be compiled with the flag '-sync protocol'. Currently supported protocols are cons -parallel conservative, opt -parallel optimistic, and seq -sequential (default - if no '-sync' flag is specified). The parallel implementation of Maisie uses MPI (Message Passing Interface) communication library. Therefore, before using parallel Maisie, MPI needs to be installed on the available parallel architecture (Several public domain implementations of MPI exist. MPICH, one such implementation, is available from http://www.erc.msstate.edu/mpi/). MPI commands are used to execute the compiled maisie program on the parallel architecture (see the documentation on the particular MPI implementation you are using).