janosvm man page




SYNOPSIS

       janosvm [options...]  classname [arguments...]


DESCRIPTION

       janosvm loads and  executes  the  bytecode  in  the  class
       classname,  starting  with  the main method (which must be
       static and public).  Any arguments given  after  classname
       are  passed  to  the  main method.  Additional classes are
       loaded as needed.

       Unlike other virtual machines, the JanosVM supports multi-
       ple, separate processes (called "teams" in JanosVM) within
       a single VM.  Based  on  KaffeOS  (and  thus  Kaffe),  the
       JanosVM supports per-team separate heaps, per-team garbage
       collection  threads,  inter-team  thread  migration,  safe
       cross-team  reference  objects,  and  a  spiffy  tutorial.
       Designed to support asynchronous termination of uncoopera-
       tive  or malicious Java applications, the JanosVM provides
       robust and scalable multi-process support within a  single
       Java virtual machine.


OPTIONS

       -help  Give a short usage message.

       -version
              Print the version number.

       -fullversion
              Print verbose version info.

       -ss size
              Set the maximum stack size to size

       -ms size
              Set the initial heap size to size

       -mx size
              Set the maximum heap size to size

       -as size
              Set the heap increment to size

       -classpath path
              Override  the  default  search path for class files
              with path.

       -addclasspath path
              Appends the given path  to  the  current  classpath
              setting.  Multiple  instances  of  this flag may be
              given.

       -Dproperty=value
       -verbosegc
              Print messages during garbage collection.

       -verbosejit
              Print messages during JIT code generation.

       -verbosemem
              Print detailed memory allocation statistics.

       -vmstats flag{,flag}
              Turn  on  VM statistcs. Use ``-vmstats list'' for a
              list of available flags.


       -name name
              Register this VM instance as name.  This  is
              useful  when the JVM is going to be the tar-
              get of JSI messages since you can  just  use
              the  registered name instead of a whole pro-
              tocol and address specification.

       -jsiprovider name
              Specify where the jsi provider  should  lis-
              ten.   The format of name is a protocol name
              followed by a colon and then some  implemen-
              tation dependent address data.  For example,
              to listen on TCP port 10000 of  the  current
              machine   (sloane.sd6.gov),  you  would  use
              -jsiprovider tcp:sloane.sd6.gov/10000.  Cur-
              rently,  only  one  provider is allowed at a
              time.

       -jsitcpport port
              Specify a TCP based JSI provider that should
              listen on port .
                Basically,   a  fast  alternative  to  the
              above.

       -jsifile name
              Setup a JSI link through files with name  as
              their  basename.   This  option  can be used
              multiple times.

       -config file
              Use file for initial  configuration  of  the
              JanosVM.

       -noexit
              The  JanosVM  continues  even  if  only non-
              dameon threads are running.  Useful for JSI-
              controlled VMs that would otherwise exit.


       -Xxprof_gmon  filename
              Base  name  for  gmon  files.  Defaults   to
              xgmon.out

       -Xxprof_format  formatname
              Undocumented.

       -Xxdebug
              Generate  a debugging symbols file usable by
              gdb.  See FAQ/FAQ.xdebugging for details.

       -Xxdebug_file  format name
              Name  of   the   debugging   symbols   file.
              Defaults to xdb.as.

       -Xfeedback
              The file name to write feedback data to.



ENVIRONMENT

       CLASSPATH
              A  colon-separated  list  of  directories in
              which to search for .class files.

       KAFFEHOME
              Base directory of kaffe installation.

       KAFFE_DEBUG
              Optional value naming the debugger to  start
              JanosVM  up  under.   Performs debugger-spe-
              cific  initialization  to  ensure  that  the
              JanosVM  command  line is used by the debug-
              ger.  Can be ``gdb'', ``DDD'', or  ``Emacs''
              (for Emacs GDB mode).

       LD_LIBRARY_PATH
              A  colon-separated  list  of  directories in
              which to search for libraries.  See ld.so(1)
              for details. This needs to be set if Kaffe's
              shared libraries are installed in a location
              not  part  of  the  dynamic loader's default
              search path.


FILES

       There are native libraries, jar files, class files,
       shell scripts and libtool files used by the JanosVM
       at runtime.


NOTES

       Java is a registered trademark of Sun Microsystems,
       Inc.

       Kaffe  was  originally  written  by  Tim  Wilkinson
       <tim@transvirtual.com>, 1996.   Many,  many  others
       have contributed to the Kaffe project.



COPYING

       The  JanosVM  is distributed under the GNU GPL. For
       full details, see the  file  license.terms  in  the
       source distribution for full details.



JanosVM version 0.6.0       March 2002                 JANOSVM(1)

Man(1) output converted with man2html