sablevm(1)
NAME
- SableVM - manual page for SableVM - free (LGPL) Java Vir
- tual Machine
SYNOPSIS
sablevm [OPTION]... CLASSNAME [ARGUMENT]...
DESCRIPTION
- NOTE: sablevm command is NOT command-line compatible with
- the java command. The sablevm command uses GNU style of parame
- ters, and ignores the environmental variables often used by Java
- programs, like CLASSPATH. If this is not what you want you
- should look at java-sablevm command which is meant to be command
- line compatible with the java command.
- -c, --classpath="PATH"
- set class path
- -p, --property="NAME=VALUE"
- set system property
- -v, --verbose
- enable all verbose options
- -q, --quiet
- disable all verbose options
- -s, --verbose-class
- enable verbose class loading
- -S, --no-verbose-class
- disable verbose class loading
- -g, --verbose-gc
- enable verbose garbage collection
- -G, --no-verbose-gc
- disable verbose garbage collection
- -j, --verbose-jni
- enable verbose JNI
- -J, --no-verbose-jni
- disable verbose JNI
- -y, --copyright
- display copyright
- -Y, --no-copyright
- do not display copyright
- -L, --license
- display license information and exit
- -V, --version
- display version information and exit
- Help options:
- -?, --help
Show this help message
- --usage
Display brief usage message
AUXILIARY PROPERTIES
- It is possible to place multiple elements on boot class
- path. Each element may be either a top directory of class tree or
- a .jar (or zip) file. SableVM offers flexible setup of boot
- class path thru usage of the following properties.
- sablevm.boot.class.path
- changes boot classpath
- sablevm.boot.class.path.prepend
- prepends entries to default or set boot classpath
- sablevm.boot.class.path.append
- appends entries to default or set boot classpath
- sablevm.boot.library.path
- changes native libraries patch which are used by
- boot classpath
- (WARNING: the two last properties above are very fragile;
- expect
- cannot create vm messages if you use them in a
- wrong way.
MEMORY USAGE CONTROL PROPERTIES
- There exist a number of properties that can be used to
- tune memory usage of SableVM. Normally it is NOT needed to use
- any of them, as SableVM will take care of allocating as much mem
- ory, as your application needs and of freeing the memory when it
- is not needed anymore. Still, there are some situations when you
- want to tune or limit maximum memory usage.
- The general pattern of available memory controlling prop
- erties is:
- sablevm.[stack,classloader.heap].size.[min,max,increment]
- which tranlates into the following set of available prop
- erties:
- sablevm.stack.size.min
- sablevm.stack.size.max
- sablevm.stack.size.increment
- sablevm.heap.size.min
- sablevm.heap.size.max
- sablevm.heap.size.increment
- sablevm.classloader.size.min
- sablevm.classloader.size.max
- sablevm.classloader.size.increment
These properties allow for control over java stack,
- java heap, and java class loader.
- Meaning of the min, max, increment suffixes is the
- following:
- ...min initial size in bytes,
- ...max maximal size in bytes (hard limit); 0 means
- "no limit",
- ...increment step by which the amount of memory is
- incremented when needed, up to the limit specified in max, if
- any; 0 means "fixed size" (no changes allowed, min is used).
DEBUGGING PROPERTIES
- sablevm.verbose.methods
- when operating on a binary compiled with debugging
- features - setting this property to true outputs names of every
- method that is to be executed
- sablevm.verbose.instructions
- when operating on a binary compiled with debugging
- features - setting this property to true outputs names of every
- instruction that is to be executed (WARNING: expect flood!!!)
- sablevm.verbose.synchronization
- when operating on a binary compiled with debugging
- features - setting this property to true causes SableVM to dump a
- stack trace on every locking contention and on fat lock acquisi
- tion.
SEE ALSO
java-sablevm(1)
- For more informations about SableVM see http://sablevm.org
- SableVM version 1.13 January 2005