NAME

       ikvm - java virtual machine executable using the CLI runtime

SYNOPOSIS

       ikvm [ options ] class [ args ...  ]

       ikvm [ options ] -jar jarfile [ args ...  ]

DESCRIPTION

       IKVM  is an implentation of the Java for the Common Language Infrastructure (CLI) runtime.
       It includes a byte code JIT compiler/verifier to translate Java byte code to CIL  and  GNU
       Classpath to provide the Java class libraries.  ikvm program performs this translation and
       execution at run time, the ikvmc(1) program provides a static compilation to CIL.

       This program is intended to act as  a  drop-in  replacement  for  the  java  program  that
       executes  java bytecode (with or without a JIT) and as such, takes a subset of that tool's
       options and arguments as given here.

       ikvm operates in two modes, either on a fully-qualified Java classname or on  a  jar  file
       with  the  -jar jarfile option given.  Any remaining arguments args ...  are passed to the
       main class.

CLASS SEARCHING

       Classes are searched for in the current directory if no -cp / -classpath option,  no  -jar
       option and no CLASSPATH environment variable is set.

       If  only  CLASSPATH  is set and no ptions are given only that is used to find classes, the
       current directory is not used unless CLSSPATH contains .

       If -cp / -classpath is given, CLASSPATH is ignored.

       If -jar is given, the jar file is put at the start of the classpath taken from either  the
       -cp / -classpath option or from CLASSPATH.

       See also the description for the -Xbootclasspath option below.

OPTIONS

       -cp path

       -classpath path
              Set the JVM classpath to search for application classes and resources.  The path is
              a sequence of directories and zip/jar files separated by : (; on Windows).  If this
              option is given more than once, only the last one applies.

       -Dname=value
              Set a system property name to value.

       -ea[:packagename ... | :classname]

       -enableassertions[:packagename ... | :classname]
              Enable assertions.

       -da[:packagename ... |:classname]

       -disableassertions[:packagename ... | :classname]
              Disable assertions.

       -version
              Display IKVM and runtime version

       -Xbootclasspath:path
              Set  the  boot  JVM  classpath  for bootstrap classes and resources.  The path is a
              sequence of directories and zip/jar files separated by : (; on Windows).   If  this
              option is given more than once, only the last one applies.

       -Xbreak
              Trigger a user defined breakpoint at startup

       -Xmethodtrace:string
              Builds method trace into the specified output methods

       -Xsave Save the generated assembly for debugging.

       -Xtime Time the execution.

       -Xtrace:name
              Displays all tracepoints with the given name.

       -Xwait Keep the process hanging around after exit.

       -? -help
              Display a summary of the usage.

SEE ALSO

       ikvmc(1), ikvmstub(1).

       IKVM Project web site http://ikvm.net/ ⟨http://ikvm.net/⟩

       Man page by Dave Beckett, made available under the same terms as IKVM.

                                            2005-06-19                                    ikvm(1)