Differential D22342 Diff 64914 head/java/javavmwrapper/src/javavm.1

Changeset View

Standalone View

head/java/javavmwrapper/src/javavm.1

	Show All 19 Lines
	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)			.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd February 24, 2005			.Dd November 12, 2019
	.Os			.Os
	.Dt JAVAVM 1			.Dt JAVAVM 1
	.Sh NAME			.Sh NAME
	.Nm javavm			.Nm javavm
	.Nd convenient wrapper for switching Java VMs			.Nd convenient wrapper for switching Java VMs
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Op Ar arguments ...			.Op Ar arguments ...
	▲ Show 20 Lines • Show All 70 Lines • ▼ Show 20 Lines
	.It Ev JAVA_VERSION			.It Ev JAVA_VERSION
	A space delimited list of versions of the Java VM that may be used.			A space delimited list of versions of the Java VM that may be used.
	By appending a			By appending a
	.Ql +			.Ql +
	to a version, any Java VM with a version greater than or			to a version, any Java VM with a version greater than or
	equal to the given version will be used.			equal to the given version will be used.
	.Pp			.Pp
	Currently allowed versions are			Currently allowed versions are
	.Ql 1.6 ,
	.Ql 1.6+ ,
	.Ql 1.7 ,			.Ql 1.7 ,
	.Ql 1.7+ ,			.Ql 1.7+ ,
	.Ql 1.8 ,			.Ql 1.8 ,
	.Ql 1.8+ ,			.Ql 1.8+ ,
	.Ql 1.9 ,			.Ql 1.9 ,
	.Ql 1.9+ ,			.Ql 1.9+ ,
	.Ql 6 ,
	.Ql 6+ ,
	.Ql 7 ,			.Ql 7 ,
	.Ql 7+ ,			.Ql 7+ ,
	.Ql 8 ,			.Ql 8 ,
	.Ql 8+ ,			.Ql 8+ ,
	.Ql 9 ,			.Ql 9 ,
	.Ql 9+ ,			.Ql 9+ ,
	.Ql 10 ,			.Ql 10 ,
	.Ql 10+ ,			.Ql 10+ ,
	▲ Show 20 Lines • Show All 64 Lines • ▼ Show 20 Lines
	.It Ev JAVA_VERSION=8+ Pa %%LOCALBASE%%/bin/javac MyClass.java			.It Ev JAVA_VERSION=8+ Pa %%LOCALBASE%%/bin/javac MyClass.java
	Compile MyClass.java with a registered Java VM's javac that is at least			Compile MyClass.java with a registered Java VM's javac that is at least
	version 8.			version 8.
	.It Ev JAVA_OS=native Pa %%LOCALBASE%%/bin/java Fl jar Pa MyApp.jar			.It Ev JAVA_OS=native Pa %%LOCALBASE%%/bin/java Fl jar Pa MyApp.jar
	Execute MyApp with the most up to date native Java VM that is registered			Execute MyApp with the most up to date native Java VM that is registered
	with			with
	.Nm .			.Nm .
	This is necessary if MyApp uses JNI, for instance.			This is necessary if MyApp uses JNI, for instance.
	.It Ev JAVA_VERSION="6 8" Pa %%LOCALBASE%%/bin/java Fl jar Pa MyApp.jar			.It Ev JAVA_VERSION="8 11" Pa %%LOCALBASE%%/bin/java Fl jar Pa MyApp.jar
	Execute MyApp with either a Java VM that is either version 6 or version 8.			Execute MyApp with either a Java VM that is either version 8 or version 11.
	.It Ev JAVAVM_DRYRUN=yes Pa %%LOCALBASE%%/bin/java			.It Ev JAVAVM_DRYRUN=yes Pa %%LOCALBASE%%/bin/java
	Don't invoke the Java VM, but print out information about what would have			Don't invoke the Java VM, but print out information about what would have
	been done.			been done.
	This could be used in a script to determine the			This could be used in a script to determine the
	.Ev JAVA_HOME			.Ev JAVA_HOME
	that the Java VM wrapper will use, for instance:			that the Java VM wrapper will use, for instance:
	.Lp			.Lp
	.Ev JAVA_HOME=`env JAVAVM_DRYRUN=yes %%LOCALBASE%%/bin/java \| grep '^JAVA_HOME' \| cut -c11-`			.Ev JAVA_HOME=`env JAVAVM_DRYRUN=yes %%LOCALBASE%%/bin/java \| grep '^JAVA_HOME' \| cut -c11-`
	Show All 26 Lines