LVMRUN(1)							   User Commands							 LVMRUN(1)

NAME

       lvmrun - Lazy Virtual Machine interpreter

SYNOPSIS

       lvmrun [ lvm options ] file [ program options ]

DESCRIPTION

       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

       -h<size>
	      the initial heap size.  (256k)

       -H<size>
	      the maximal heap size.  ( 64m)

       -s<size>
	      the initial stack size. ( 16k)

       -S<size>
	      the maximal stack size. ( 64m)

       -P<path>
	      the search path.

       -m<name>
	      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.

       -he<size>
	      the heap expansion size.	 (256k)

       -hm<size>
	      the minor generation size. (128k)

       -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%cur-
	      rent:/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.

COPYRIGHT

       (C) 1999,2001 Daan Leijen <daan@cs.uu.nl>

       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
       BSD license:

	      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.

SEE ALSO

       helium(1)

AUTHOR

       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)