| 1 | .TH javaws 1 "9 Sep 2010"
|
|---|
| 2 | .SH NAME
|
|---|
| 3 | javaws - a Java Web Start client
|
|---|
| 4 | .SH SYNOPSYS
|
|---|
| 5 | .B javaws
|
|---|
| 6 | [-run-options] jnlp-file
|
|---|
| 7 | .br
|
|---|
| 8 | .B javaws
|
|---|
| 9 | [-control-option]
|
|---|
| 10 | .SH DESCRIPTION
|
|---|
| 11 | .B javaws
|
|---|
| 12 | is an implementation of a JNLP client. It uses a JNLP (Java Network
|
|---|
| 13 | Launch Protocol) file to securely run a remote Java application or
|
|---|
| 14 | a Java applet. This implementation of
|
|---|
| 15 | .B javaws
|
|---|
| 16 | is from the IcedTea project and is based on the NetX project.
|
|---|
| 17 | .PP
|
|---|
| 18 | A JNLP file is an xml file that describes how to securely run a
|
|---|
| 19 | remote Java application or a Java applet.
|
|---|
| 20 |
|
|---|
| 21 | .SH OPTIONS
|
|---|
| 22 | When specifying options, the name of the jnlp file must be the last
|
|---|
| 23 | argument to
|
|---|
| 24 | .B javaws
|
|---|
| 25 | - all the options must preceede it.
|
|---|
| 26 | .PP
|
|---|
| 27 | The jnlp-file can either be a url or a local path.
|
|---|
| 28 | .PP
|
|---|
| 29 | .B Control Options
|
|---|
| 30 | .PP
|
|---|
| 31 | By default
|
|---|
| 32 | .B javaws
|
|---|
| 33 | will launch the jnlp file specified on the command line. The control
|
|---|
| 34 | options can be used to change this behaviour.
|
|---|
| 35 | .TP 12
|
|---|
| 36 | \-about
|
|---|
| 37 | Shows a sample application that can be used to test the basic functionality
|
|---|
| 38 | of this implementation.
|
|---|
| 39 | .TP
|
|---|
| 40 | \-viewer
|
|---|
| 41 | Shows the trusted certificate viewer. This allows a user to list, examine, remove
|
|---|
| 42 | or export trusted certificates. Note that this only reflects the certificates
|
|---|
| 43 | trusted by
|
|---|
| 44 | .B javaws
|
|---|
| 45 | and not any other certificates or programs.
|
|---|
| 46 |
|
|---|
| 47 | .PP
|
|---|
| 48 | .B Run Options
|
|---|
| 49 | .PP
|
|---|
| 50 | In the default mode, the following run-options can be used:
|
|---|
| 51 | .TP 12
|
|---|
| 52 | \-basedir dir
|
|---|
| 53 | Directory where the cache and certificates to be used are stored.
|
|---|
| 54 | .TP
|
|---|
| 55 | \-arg arg
|
|---|
| 56 | Adds an application argument before launching.
|
|---|
| 57 | .TP
|
|---|
| 58 | \-param name=value
|
|---|
| 59 | Adds an applet parameter before launching.
|
|---|
| 60 | .TP
|
|---|
| 61 | \-property name=value
|
|---|
| 62 | Sets a system property before launching.
|
|---|
| 63 | .TP
|
|---|
| 64 | \-update seconds
|
|---|
| 65 | Update check if seconds since last checked.
|
|---|
| 66 | .TP
|
|---|
| 67 | \-license
|
|---|
| 68 | Display the GPL license and exit.
|
|---|
| 69 | .TP
|
|---|
| 70 | \-verbose
|
|---|
| 71 | Enable verbose output. Very useful in debugging.
|
|---|
| 72 | .TP
|
|---|
| 73 | \-nosecurity
|
|---|
| 74 | Disables the secure runtime environment.
|
|---|
| 75 | .TP
|
|---|
| 76 | \-noupdate
|
|---|
| 77 | Disables checking for updates.
|
|---|
| 78 | .TP
|
|---|
| 79 | \-headless
|
|---|
| 80 | Disables download window, other UIs.
|
|---|
| 81 | .TP
|
|---|
| 82 | \-strict
|
|---|
| 83 | Enables strict checking of JNLP file format. Any deviations from
|
|---|
| 84 | the JNLP DTD will cause
|
|---|
| 85 | .B javaws
|
|---|
| 86 | to abort.
|
|---|
| 87 | .TP
|
|---|
| 88 | \-umask=value
|
|---|
| 89 | Sets the umask for files created by an application.
|
|---|
| 90 | .TP
|
|---|
| 91 | \-Xnofork
|
|---|
| 92 | Do not create another JVM, even if the JNLP file asks for running in
|
|---|
| 93 | a separate JVM. This is useful for debugging.
|
|---|
| 94 | .TP
|
|---|
| 95 | \-Jjava-option
|
|---|
| 96 | This passes along java-option to the java binary that is running
|
|---|
| 97 | javaws. For example, to make javaws run with a max heap size
|
|---|
| 98 | of 80m, use -J-Xmx80m.
|
|---|
| 99 | .TP
|
|---|
| 100 | \-help
|
|---|
| 101 | Print a help message and exit.
|
|---|
| 102 |
|
|---|
| 103 | .SH FILES
|
|---|
| 104 | ~/.icedtea/deployment.properties specifies the settings used by javaws
|
|---|
| 105 |
|
|---|
| 106 | .SH BUGS
|
|---|
| 107 | There arent any known bugs. If you come across one, please file it at
|
|---|
| 108 | http://icedtea.classpath.org/bugzilla/
|
|---|
| 109 | .br
|
|---|
| 110 | Please run javaws in verbose mode and include that output along
|
|---|
| 111 | with the jnlp file when filing out the bug report.
|
|---|
| 112 |
|
|---|
| 113 | .SH AUTHOR
|
|---|
| 114 | Originally written by Jon. A. Maxwell.
|
|---|
| 115 | .br
|
|---|
| 116 | Currently maintained by the IcedTea contributors.
|
|---|
| 117 |
|
|---|
| 118 | .SH SEE ALSO
|
|---|
| 119 | .BR java (1)
|
|---|
| 120 | .br
|
|---|
| 121 | http://icedtea.classpath.org/
|
|---|
| 122 | .br
|
|---|
| 123 | http://jnlp.sourceforge.net/netx/
|
|---|
