LVMRUN(1) User Commands LVMRUN(1)
lvmrun - Lazy Virtual Machine interpreter
lvmrun [ lvm options ] file [ program options ]
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
the initial heap size. (256k)
the maximal heap size. ( 64m)
the initial stack size. ( 16k)
the maximal stack size. ( 64m)
the search path.
the initial start function.
-p print final value on stdout after execution. (off)
-t print timing report on stderr after execution. (off)
-? show the help screen.
the heap expansion size. (256k)
the minor generation size. (128k)
-hf<percent> the percentage of free heap before a major collection. ( 42%)
the percentage of free heap before a compaction. (100%)
-hr print heap report on stderr after execution. (off)
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
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%cur-
<name> A function name Example: lvmrun -mmymain file
The search path for lvm files (same as -P option). The default is: ".:/usr/lib/helium/lib"
The default options for the lvm. The default is: ""
Extra search path for shared (dynamic link) libraries (.so). The default is: ""
The options are read from LVMPATH, LVMOPTIONS and finally the command line.
(C) 1999,2001 Daan Leijen <email@example.com>
The source files of the Lazy Virtual Machine, which are the files in the directory lvm, except the files in lvm/src/lib/core, are licensed
under the GNU Library General Public License, currently known as the GNU Lesser General Public License:
This package is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License
version 2 as published by the Free Software Foundation.
This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this package; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
The source files in the directory lvm/src/lib/core which are part of the Core Assembler of the Lazy Virtual Machine are licensed under the
Redistribution and use in source and binary forms, with or without modification, are permitted under the terms of the BSD License.
THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIM-
ITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This manual page was written by Arjan Oosting <arjanoosting@home> for the Debian system and is licensed under the terms of the GNU General
Public License version 2.
Lazy Virtual Machine interpreter December 2006 LVMRUN(1)