lvmrun1

Usage

Overview

lvmrun is an interpreter which simulates a Lazy Virtual Machine. The interpreter executes instructions which are found in the instruction file file given on the command line.

One of the programs generating instruction files is the helium compiler which compiles Haskell files to instructions files for the Lazy Virtual Machine.

Options

-p

print final value on stdout after execution. (off)

-t

print timing report on stderr after execution. (off)

-?

show the help screen.

-hf<percent> the percentage of free heap before a major collection. ( 42%)

-hF<percent>

the percentage of free heap before a compaction. (100%)

-hr

print heap report on stderr after execution. (off)

-hv<level>

the heap verbose level. (0) level is off (0), only major gc (1), every gc (2) or detailed (3)

Some of the options take an additional value. The format of the values is described below:

<size>

A number with an optional scale and optional unit. The available scales are kilo (k), mega (m) or giga (g). The available units are machine words (w) or, by default, bytes (b). Example: lvmrun -H64m -s4kw -S512kb file

<percent>

A number between 0 and 100 followed by an optional '%' character. Example: lvmrun -hF88% <file>

<path>

A list of directories separated by ';' (or ':' on unix systems). You can use $name or %name to insert an environment variable. The current path value is available as $current and the lvm installation path is available as $lvmdir. Example: lvmrun -P%current:/usr/lib/lvm file

<name>

A function name Example: lvmrun -mmymain file

Environment

LVMPATH

The search path for lvm files (same as -P option). The default is: ".:/usr/lib/helium/lib"

LVMOPTIONS

The default options for the lvm. The default is: ""

LVMDLLPATH

Extra search path for shared (dynamic link) libraries (.so). The default is: ""

Notes

The options are read from LVMPATH, LVMOPTIONS and finally the command line.