Man Linux: Main Page and Category List

NAME

       ocamlrun - The Objective Caml bytecode interpreter

SYNOPSIS

       ocamlrun [ options ] filename argument ...

DESCRIPTION

       The ocamlrun(1) command executes bytecode files produced by the linking
       phase of the ocamlc(1) command.

       The first non-option argument is taken to  be  the  name  of  the  file
       containing  the  executable  bytecode.  (That  file  is searched in the
       executable path as well as in the  current  directory.)  The  remaining
       arguments are passed to the Objective Caml program, in the string array
       Sys.argv.  Element 0  of  this  array  is  the  name  of  the  bytecode
       executable file; elements 1 to n are the remaining arguments.

       In  most cases, the bytecode executable files produced by the ocamlc(1)
       command are self-executable,  and  manage  to  launch  the  ocamlrun(1)
       command on themselves automatically.

OPTIONS

       The following command-line options are recognized by ocamlrun(1).

       -b     When  the  program  aborts due to an uncaught exception, print a
              detailed "back  trace"  of  the  execution,  showing  where  the
              exception  was  raised and which function calls were outstanding
              at this point.  The back trace is printed only if  the  bytecode
              executable contains debugging information, i.e. was compiled and
              linked with the -g option to  ocamlc(1)  set.   This  option  is
              equivalent   to   setting   the  b  flag  in  the  OCAMLRUNPARAM
              environment variable (see below).

       -I dir Search the directory dir for  dynamically-loaded  libraries,  in
              addition to the standard search path.  -p Print the names of the
              primitives known to this version of ocamlrun(1) and exit.

       -v     Direct the memory manager to print verbose messages on  standard
              error.   This is equivalent to setting v=63 in the OCAMLRUNPARAM
              environment variable (see below).

       -version
              Print version and exit.

ENVIRONMENT VARIABLES

       The following environment variable are also consulted:

       CAML_LD_LIBRARY_PATH
              Additional  directories   to   search   for   dynamically-loaded
              libraries.

       OCAMLLIB
              The  directory  containing  the Objective Caml standard library.
              (If OCAMLLIB is not set, CAMLLIB will be used instead.) Used  to
              locate  the  ld.conf configuration file for dynamic loading.  If
              not  set,  default  to  the  library  directory  specified  when
              compiling Objective Caml.

       OCAMLRUNPARAM
              Set   the   runtime   system   options  and  garbage  collection
              parameters.  (If OCAMLRUNPARAM is not set, CAMLRUNPARAM will  be
              used  instead.)   This  variable must be a sequence of parameter
              specifications.  A parameter specification is an  option  letter
              followed by an = sign, a decimal number (or a hexadecimal number
              prefixed by 0x), and an optional  multiplier.   There  are  nine
              options,  six  of  which correspond to the fields of the control
              record documented in The Objective Caml users  manual,  chapter
              "Standard Library", section "Gc".

       b      Trigger  the  printing  of  a  stack  backtrace when an uncaught
              exception aborts the program.  This option takes no argument.

       p      Turn on debugging support for ocamlyacc-generated parsers.  When
              this  option  is  on,  the  pushdown automaton that executes the
              parsers prints a trace of its actions.   This  option  takes  no
              argument.

       a (allocation_policy)
              The  policy  used  for  allocating  in the OCaml heap.  Possible
              values are 0 for the next-fit policy, and 1  for  the  first-fit
              policy.   Next-fit  is  somewhat faster, but first-fit is better
              for avoiding fragmentation and the associated heap  compactions.

       s (minor_heap_size)
              The size of the minor heap (in words).

       i (major_heap_increment)
              The default size increment for the major heap (in words).

       o (space_overhead)
              The major GC speed setting.

       O (max_overhead)
              The heap compaction trigger setting.

       l (stack_limit)
              The limit (in words) of the stack size.

       h      The initial size of the major heap (in words).

       v (verbose)
              What  GC  messages  to print to stderr.  This is a sum of values
              selected from the following:

              0x001 Start of major GC cycle.

              0x002 Minor collection and major GC slice.

              0x004 Growing and shrinking of the heap.

              0x008 Resizing of stacks and memory manager tables.

              0x010 Heap compaction.

              0x020 Change of GC parameters.

              0x040 Computation of major GC slice size.

              0x080 Calling of finalisation functions.

              0x100 Startup messages (loading the  bytecode  executable  file,
              resolving shared libraries).

              The  multiplier  is k, M or G, for multiplication by 2^10, 2^20,
              and 2^30 respectively.  For example, on a 32-bit  machine  under
              bash,  the  command  export  OCAMLRUNPARAM=s=256k,v=1’  tells a
              subsequent ocamlrun to set its initial  minor  heap  size  to  1
              megabyte  and  to  print a message at the start of each major GC
              cycle.

       CAMLRUNPARAM
              If  OCAMLRUNPARAM  is  not  found  in  the   environment,   then
              CAMLRUNPARAM  will  be  used  instead.   If  CAMLRUNPARAM is not
              found, then the default values will be used.

       PATH   List of directories searched to  find  the  bytecode  executable
              file.

SEE ALSO

       ocamlc(1).
       The Objective Caml users manual, chapter "Runtime system".