---
name: "java-sablevm"
section: "1"
platform: "linux"
package: "sablevm"
version: "1.13-1.1"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/java-sablevm"
---

# java-sablevm(1)

free (LGPL) Java virtual machine

## NAME

Manual page of 'java' wrapper for SableVM - free (LGPL) Java virtual machine

## SYNOPSIS

**java-sablevm** \[*OPTION*\]... *CLASSNAME* \[*ARGUMENT*\]...

## DESCRIPTION

- **\[-\]-addclasspath ADDEDCLASSPATH**

  appends ADDEDCLASSPATH at the end of CLASSPATH (note that parameters' order is important!)

- **\[-\]-cp CLASSPATH**, **\[-\]-classpath CLASSPATH**, **\[-\]-classpath=CLASSPATH**

  set CLASSPATH for program to be run (overrides value of CLASSPATH environment variable)

- **-DPROPERTY=VALUE**

  set PROPERTY value to VALUE

- **-h**, **\[-\]-help**, **-?**

  show help (not implemented yet, see manual page)

- **-jar FILE**

  execute content of FILE as a jar type file (requires unzip utility installed); note that you can't specify CLASSNAME in this case

- **\[-\]-showversion**

  show version (like -V) and continue execution

- **-v**, **\[-\]-verbose**

  enable all verbose options (might \*flood\* you if SableVM is compiled with debugging options)

- **\[-\]-verbose-gc**

  enable verbose garbage collection

- **\[-\]-verbose\[:\]jni**

  enable verbose Java Native Interface

- **-V**, **\[-\]-version**

  show version information, including some compilation options

- **-Xbootclasspath:/pa/th**, **-Xbootclasspath/p:/pa/th**, **-Xbootclasspath/a:/pa/th**

  set the value of the boot classpath, prepend or append a value to it

- **-Xgnuclasspath:/dir/ectory**

  sets the location of GNU Classpath libraries (not sablevm-classpath);  *NOTE:* due to ever-changing nature of VM \<-\> Classpath interfaces you might need to use the latest SableVM snapshot if you want to run the latest GNU Classpath CVS directly with SableVM;  This option is meant mainly for Java Virtual Machine and GNU Classpath developers and advanced users.

- **--**

  end of options marker - CLASSNAME (if any) and ARGUMENTS (if any) should follow

## RECOGNIZED ENVIRONMENTAL VARIABLES

- **CLASSPATH**

  used as the classpath for the program being started, unless -cp was specified

- **LD\_LIBRARY\_PATH**

  used to search for location of native java libraries, *incompatible* with setting java.library.path property

## OPTIONS IGNORED

- **\[-\]-debug**, **-Xdebug**, (extended debug options)

  - **-ss VALUE**, (maximal stack size)

  - **-ms VALUE**, (initial heap size)

  - **-ms VALUE**, (maximum heap size)

  - **-X\[...\]**, (other extended option)

  - **-noverify**, (turn off bytecode verifier)

  - **-verbosemem**, (verbose memory allocation)

  - **-verbosegc**, (verbose memory allocation)

  - **-verbosejit**, (verbose memory allocation)

  - **-verbose\[...\]**, (other verbose option)

  - **-vmdebug opt1\[,opt2...\]**, (other debug option)

  All the above options are recognized by *java-sablevm* wrapper and *ignored*. Their handling is either not implemented by the wrapper or by sablevm binary (and thus they can not be translated to options sablevm is able to recognize).

## DEBUGGING PROPERTIES

The below properties are only usable when SableVM was compiled with --enable-debugging-features, which is not the case ie. for binary distributions.

- **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 acquisition.

## SEE ALSO

[sablevm(1)](/sablevm/1.md)

For more informations about **SableVM** see **http://sablevm.org**