Provided by: kaffe-common_1.1.8-5.2ubuntu1_all bug

NAME

       kaffe - a virtual machine to execute Java(tm) bytecode

SYNOPSIS

       kaffe [options] classname [argument...]

       kaffe [options] -jar filename [argument...]

       The  provided  options  are  passed to kaffe virtual machine. Available
       options are described in the section OPTIONS.  The  provided  arguments
       are passed to the main function of the called class.

DESCRIPTION

       kaffe   executes   Java(tm)   bytecode,   either  as  a  pure  bytecode
       interpreter, or  by  doing  "just-in-time"  code  conversion  from  the
       abstract code to the host machine’s native code.

       The  specified  classname  has  to be a fully-qualified classname (e.g.
       foo.bar.ClassName). If kaffe is used with the -jar flag, the  class  to
       execute  is  determined  through  the  manifest  file  included  in the
       specified Jar-File filename.

       kaffe searches for needed  classes  during  program  execution  on  the
       bootclasspath  (see -Xbootclasspath options) and the classpath given by
       the user (see the -classpath option).

OPTIONS

       The options for the kaffe command  are  divided  into  general  options
       (available   on   all   kaffe   installations),  options  provided  for
       compatibility reasons and further options which are  depending  on  the
       configuration during compilation of kaffe.

   GENERAL OPTIONS
       These options are available on all kaffe installations.

       -help  Give  a  short  usage  message  of all available options on your
              kaffe installation.

       -version
              Print the version number.

       -fullversion
              Same as -version plus compile date and flags, changelog head.

       -ss size
              Set the maximum stack size to size.

       -mx size
              Set the maximum heap size to size. Kilobytes  are  indicated  by
              the letters k or K and megabytes by m or M.

       -ms size
              Set  the  initial  heap size to size. Kilobytes are indicated by
              the letters k or K and megabytes by m or M.

       -as size
              Set the heap increment size to size

       -classpath path
              Set the path which is searched for compiled classes. This can be
              a list of directories and Jar-Files containing compiled classes.
              The entries in this list are separated by colons (:).

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

       -Xbootclasspath: bootclasspath
              Set the bootclasspath to the given path.

       -Xbootclasspath/a: bootclasspath
              Appends the given path to the bootclasspath.

       -Xbootclasspath/p: bootclasspath
              Prepends the given path to the bootclasspath.

       -Dproperty=value
              Set a property to a given value.

       -verifyremote *
              Verify  all  classes  not loaded from the bootclasspath. This is
              the default behavior.

       -verify *
              Verify all classes.

       -noverify
              Do not verify any classes.

       -noclassgc
              Disable class garbage collection.

       -verbosegc
              Print message during garbage collection.

       -v, -verbose
              Enable verbose output.

       -verbosemem
              Print detailed memory allocation statistics.

       -verbosejit
              Print message during JIT code generation.

       -verbosecall
              Print detailed call flow information.

       -nodeadlock
              Disable deadlock detection.

       -debug *
              Trace method calls.

       -noasyncgc *
              Do not garbage collect asynchronously.

       -cs, -checksource *
              Check source against class files.

       -oss * size
              Maximum stack size.

       -debug-fd descriptor
              Descriptor to send debug info to.

       -jar file
              Executes a Java(tm) program  which  is  provided  by  the  given
              Jar-File file.

       * Option currently ignored.

   COMPATIBILITY OPTIONS
       These  options  are  provided  for  compatibility  reasons  with  other
       Java(tm) runtime environments.

       -Xss size
              Maximum native stack size (see -ss).

       -Xmx size
              Maximum heap size (see -mx).

       -Xms size
              Initial heap size (see -ms).

       -cp path
              Set classpath (see -classpath).

   FURTHER OPTIONS
       Further options may be available based on the  configuration  of  kaffe
       during compilation. To get a complete list of options available in your
       kaffe installation type kaffe --help on the commandline.

       -ia32  Execute the ia32 version of Kaffe.

       -prof  Enable profiling of methods.

       -Xxprof
              Enable cross language profiling.

       -Xxprof_syms file
              Name    of    the    profiling    symbols     file     [Default:
              kaffe-jit-symbols.s].

       -Xxprof_gmon file
              Base name for gmon files [Default: xgmon.out]

       -Xxdebug_file file
              Name of the debugging symbols file.

       -Xfeedback
              The file name to write feedback data to.

       -vmstats flag{,flag}
              Print VM statistics. Set flag=all for all

       -Xnative-big-math
              Use GMP for faster, native bignum calculations.

       -vmdebug flag{,flag}
              Enable VM debugging. Set flag=list for a list.

       -Xkaffe-xlib-awt
              Use Kaffe’s Xlib AWT backend.

       -Xkaffe-qt-awt
              Use Kaffe’s Qt2/3/Embedded AWT backend.

       -Xkaffe-nanox-awt
              Use Kaffe’s Nano-X AWT backend.

ENVIRONMENT

       CLASSPATH
              A  colon-separated list of directories and Jar-Files in which to
              search for .class files. The entries have  to  be  separated  by
              colons (:).

       KAFFEHOME
              Base directory of kaffe installation.

       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

       /usr/lib/kaffe/pthreads/share/kaffe/kafferc
              System-wide shell script read by kaffe script (optional).

       ${HOME}/.kafferc
              Per-user shell script read by kaffe script (optional).

DIAGNOSTICS

       Not documented yet.

NOTES

       Java is a registered trademark of Sun Microsystems, Inc.

       Kaffe  is  available  from  various  sites,  the  primary   one   being
       <http://www.kaffe.org: http://www.kaffe.org>.

       There are several mailing lists for Kaffe:

       kaffe@kaffe.org
              General Kaffe discussions

       kaffe-announce@kaffe.org
              Kaffe related announcements

BUGS

       See the file FAQ.Known-Bugs for an updated list.

AUTHOR

       Kaffe  was  originally  written  by  Tim  Wilkinson,  1996. Many others
       contributed to the  Kaffe  project.  They  are  listed  in  the  source
       distribution’s AUTHORS file.

COPYING

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

       The  included  DOM  bindings  are  published  under  the  W3C  Software
       Copyright   Notice   and  License.  For  full  details,  see  the  file
       license-w3c.terms in the source distribution for full details.

SEE ALSO

       jikes, a fast Java(tm) compiler

       gjdoc, the GNU javadoc tool

                                                                      KAFFE(1)