Man Linux: Main Page and Category List

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%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.

COPYRIGHT

       © 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
              MERCHANTABILITY  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
              LIMITED  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.