- asm_fast.gc (default)
- This is my default go-to grade. It compiles to low-level C code using the Boehm garbage collector and supports concurrency (though not parallelism). It is therefore very fast, can interface seamlessly with C libraries, and can run code that uses threads.
- asm_fast.par.gc.stseg (
- This grade adds parallelism and stack segmentation to the asm_fast.gc grade. Parallelism allows programs to make use of multiple cores (though note that this isn’t necessary if all you need is concurrent execution). Stack segmentation allows pieces of the stack to be allocated on the heap. Beside allowing programs to grow beyond a fixed stack size, this option (only available for the asm_fast grades) greatly reduces the amount of memory allocated by thread spawns, which can otherwise measure in the gigabytes. Both these features come at a small runtime cost.
- hlc.gc (
- This is the “high-level C” grade. It compiles to C code which is much closer to what a programmer might write than that generated by the asm_fast grade. Curiously this grade is sometimes faster than the low-level grade (likely due to an increased number of optimization opportunities available to GCC), so if you need speed, it is worth testing your application in this grade as well. Unlike asm_fast however, this grade does not support concurrency.
- hlc.par.gc (
- This grade adds to hlc.gc support for concurrency and parallelism via native system threads. If your application requires a 1:1 mapping of Mercury threads to system threads, then this grade is a must.
- java (
- As the name implies, this grade compiles to Java code. It is the only option if you need to interface with Java libraries. Due to the JVM’s speed the code it generates is often as fast as its C counterparts. This grade supports concurrency and parallelism via Java’s built-in threading mechanisms (
--parallelis not needed). (Note that unlike in the C grades, a program compiled under the java grade will not wait for all spawned threads to terminate before exiting.) Unfortunately some standard library procedures are not yet implemented.
- asm_fast.gc.prof (
-p); hlc.gc.prof (
- These grades allow you to profile your code using mprof, of course at the expense of execution speed. They are handy to have around.
- asm_fast.gc.debug (
- This grade allows you to debug your code using mdb. Note that if you’re not debugging the standard library, then instead of compiling this grade, you can instead pass the
--trace deepoption to the compiler to enable debugging of just your modules.
Compiling extra gradesWe all know that the Mercury build process takes forever. This is because it must compile the standard library in each of the required grades. Fortunately there’s a shortcut around this.
The first time you install the system, instead of
make install, run
make install LIBGRADES=asm_fast.gc. This will install the compiler, but only the default library grade. You can pass
LIBGRADES= if you wish instead to install no library grades.
Later, when you wish to install additional grades, run
make install_grades LIBGRADES='asm_fast.par.gc hlc.gc' (for example). This will compile only the given library grades. To complete the installation, you should edit /path/to/mercury/lib/mercury/conf/Mercury.config to add the appropriate
--libgrade flags to the end of
DEFAULT_MCFLAGS (near the end of the file), and /path/to/mercury/lib/mercury/mmake/Mmake.vars to add the grade names to the definition of
LIBGRADES. (These steps are only necessary if you plan to build and install libraries.)
Don’t forget also that you can speed up compilation by passing
PARALLEL=-j5 (where 5 is one plus the number of parallel cores in your system) to
make (or simply
Working with multiple gradesFinally, when testing with multiple grades, you may with to use the
--use-grade-subdirs option in conjunction with
mmc --make. This will cause
mmc --make to use a different subdirectory for each grade in which you build your project, avoiding errors caused by linking incompatible grades, and allowing you not to have to rebuild the entire project each time you switch grades.