cvm(1CC)

NAME | SYNOPSIS | FEATURES | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | ATTRIBUTES | SEE ALSO

NAME

cvm- C virtual machine for Java applications

SYNOPSIS

rsh target cvm [-classpath path] [-Dproperty=value] [-fullversion] [-showversion] [-version] [-Xbootclasspath=bootclasspath] [-Xbootclasspath/a=path] [-Xbootclasspath/p=path] [-Xdebug] [-Xgc:youngGen=size] [-Xmssize] [-Xrunlib] [-XfullShutdown] [-Xsssize] [-Xverify:[all|remote|none]]

FEATURES

CVM

DESCRIPTION

cvm is a target utility.

OPTIONS

The following options are supported:

-Dproperty=value

Set a system property value.

-fullversion

Display build version information, then exit.

-showversion

Display product version information and continue.

-version

Display product version information, then exit.

-classpath path

Specify a colon-separated list of directories, JAR archives, and ZIP archives to search for user class files. Specifying -classpath or -cp overrides any setting of the CLASSPATH environment variable.

If -classpath is not used and CLASSPATH is not set, the user class path consists of the current directory (.).

-Xbootclasspath=bootclasspath

Specify a colon-separated or semicolon-separated list of directories, JAR archives, and ZIP archives to search for boot class files. These are used in place of the boot class files included in the CDC (Connected Device Configuration). If CVM is started from the bin directory that contains the CVM executable, the default bootclasspath is the ../lib directory.

-Xbootclasspath/a=path

Specify a colon-separated or semicolon-separated path of directories, JAR archives, and ZIP archives to append to the default boot class path.

-Xbootclasspath/p=path

Specify a colon-separated or semicolon-separated path of directories, JAR archives, and ZIP archives to prepend to the default boot class path.

-Xdebug

Enables debugging support in the VM.

-Xgc:youngGen=nnn

Specifies garbage collector (GC) specific options. For the generational garbage collector that is bundled with CVM, the GC specific option is youngGen=nnn to specify the size of the young object generation, in bytes. Append the letter k or K to indicate kilobytes, or m or M to indicate megabytes. The default value is 1M.

-Xmssize

Specify the size, in bytes, of the memory allocation pool. (This value may be rounded up by the GC implementation). Append the letter k or K to indicate kilobytes, or m or M to indicate megabytes. The default value is 4M. Examples:

-Xms6291456 -Xms6144k -Xms6m

-Xrunlib

Load a dynamic library.

-XfullShutdown

Make sure all resources are freed and the VM destroyed upon exit.

-Xsssize

Set thread stack size in bytes. As for the -Xms option, the value can use the letters k, K, m, or M to indicate kilobytes or megabytes.

-Xverify:[all|remote|none]

Verify classes according to the suboption.

• all -- verifies all classes

• remote -- verifies remote classes only

• none -- turns off class verification

ENVIRONMENT VARIABLES

The following environment variables are supported:

JAVA_MAX_THREADS

Maximum number of simultaneous Java threads in a CVM process. CVM also creates 1 additional thread.

Threads created in JNI code and attached later are not counted.

When attempting to allocate more than this limit, you will get an error message.

JAVA_MAX_FILES

Maximum number of files that can be opened simultaneously. This includes class files opened by CVM itself.

JAVA_MAX_PRIORITY

POSIX thread priority associated with Thread.MAX_PRIORITY. This must be in the range of [9, 255].

By default, this variable has the value of the main thread's priority plus 4. The main thread has NORM_PRIORITY.

CLASSPATH

Colon-separated list of directories, JAR files, and ZIP archives to search for user class files. See -classpath option above.

JAVA_SCHEDFIFO

Run all Java threads in FIFO scheduling mode, instead of the default (ROUND_ROBIN).

---

Note -

To have the environment variables set automatically each time the target boots, include the variables in sysadm.ini(4CC) or rc.chorus(4CC).

---

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

CVM(5FEA), sysadm.ini(4CC), rc.chorus(4CC)

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | FEATURES | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | ATTRIBUTES | SEE ALSO