| [348] | 1 | .TH javaws 1 "9 Sep 2010"
|
|---|
| 2 | .SH NAME
|
|---|
| 3 | javaws - a Java Web Start client
|
|---|
| [429] | 4 | .SH SYNOPSIS
|
|---|
| [348] | 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
|
|---|
| [429] | 37 | Shows about dialog.
|
|---|
| [348] | 38 | .TP
|
|---|
| 39 | \-viewer
|
|---|
| 40 | Shows the trusted certificate viewer. This allows a user to list, examine, remove
|
|---|
| 41 | or export trusted certificates. Note that this only reflects the certificates
|
|---|
| 42 | trusted by
|
|---|
| 43 | .B javaws
|
|---|
| 44 | and not any other certificates or programs.
|
|---|
| 45 |
|
|---|
| 46 | .PP
|
|---|
| 47 | .B Run Options
|
|---|
| 48 | .PP
|
|---|
| 49 | In the default mode, the following run-options can be used:
|
|---|
| 50 | .TP 12
|
|---|
| [429] | 51 | \-version
|
|---|
| 52 | Prints out version and exit
|
|---|
| [348] | 53 | .TP
|
|---|
| 54 | \-arg arg
|
|---|
| 55 | Adds an application argument before launching.
|
|---|
| 56 | .TP
|
|---|
| 57 | \-param name=value
|
|---|
| 58 | Adds an applet parameter before launching.
|
|---|
| 59 | .TP
|
|---|
| 60 | \-property name=value
|
|---|
| 61 | Sets a system property before launching.
|
|---|
| 62 | .TP
|
|---|
| 63 | \-update seconds
|
|---|
| 64 | Update check if seconds since last checked.
|
|---|
| 65 | .TP
|
|---|
| 66 | \-license
|
|---|
| 67 | Display the GPL license and exit.
|
|---|
| 68 | .TP
|
|---|
| 69 | \-verbose
|
|---|
| 70 | Enable verbose output. Very useful in debugging.
|
|---|
| 71 | .TP
|
|---|
| 72 | \-nosecurity
|
|---|
| 73 | Disables the secure runtime environment.
|
|---|
| 74 | .TP
|
|---|
| 75 | \-noupdate
|
|---|
| 76 | Disables checking for updates.
|
|---|
| 77 | .TP
|
|---|
| 78 | \-headless
|
|---|
| 79 | Disables download window, other UIs.
|
|---|
| 80 | .TP
|
|---|
| 81 | \-strict
|
|---|
| 82 | Enables strict checking of JNLP file format. Any deviations from
|
|---|
| 83 | the JNLP DTD will cause
|
|---|
| 84 | .B javaws
|
|---|
| 85 | to abort.
|
|---|
| 86 | .TP
|
|---|
| [429] | 87 | \-xml
|
|---|
| 88 | The jnlp files will be checked more strictly for XML validity
|
|---|
| [348] | 89 | .TP
|
|---|
| [429] | 90 | \-allowredirect
|
|---|
| 91 | Allow to follow 301, 302, 303, 307 and 308 redirections for javaws
|
|---|
| 92 | applications
|
|---|
| 93 | .TP
|
|---|
| [348] | 94 | \-Xnofork
|
|---|
| 95 | Do not create another JVM, even if the JNLP file asks for running in
|
|---|
| 96 | a separate JVM. This is useful for debugging.
|
|---|
| 97 | .TP
|
|---|
| [429] | 98 | \-Xclearcache
|
|---|
| 99 | Clean the JNLP application cache.
|
|---|
| 100 | .TP
|
|---|
| 101 | \-Xignoreheaders
|
|---|
| 102 | Skip jar header verification.
|
|---|
| 103 | .TP
|
|---|
| [348] | 104 | \-Jjava-option
|
|---|
| 105 | This passes along java-option to the java binary that is running
|
|---|
| 106 | javaws. For example, to make javaws run with a max heap size
|
|---|
| 107 | of 80m, use -J-Xmx80m.
|
|---|
| 108 | .TP
|
|---|
| 109 | \-help
|
|---|
| 110 | Print a help message and exit.
|
|---|
| 111 |
|
|---|
| 112 | .SH FILES
|
|---|
| [429] | 113 | $XDG_CONFIG_DIR/icedtea-web/deployment.properties specifies the settings used by javaws
|
|---|
| [348] | 114 |
|
|---|
| [429] | 115 | $XDG_CONFIG_DIR/icedtea-web/log (may be set to different location by you) contains file log files (if enabled).
|
|---|
| 116 | itw-cplugin-date_time.log for native part of plugin, itw-javantx-date_time.log for everything else.
|
|---|
| 117 |
|
|---|
| 118 | $XDG_CONFIG_DIR/icedtea-web/security/java.policy contains granted permissions for selected unsigned apps
|
|---|
| 119 |
|
|---|
| 120 | $XDG_CONFIG_DIR/icedtea-web/security/trusted.*certs contains various stored certificates
|
|---|
| 121 |
|
|---|
| 122 | $XDG_CACHE_DIR/icedtea-web/cache contains cached runtime entries (amy be changed by you)
|
|---|
| 123 |
|
|---|
| 124 | $XDG_CACHE_DIR/icedtea-web/pcache contains saved application data
|
|---|
| 125 |
|
|---|
| 126 | $XDG_CACHE_DIR/icedtea-web/tmp contains temporary runtime files
|
|---|
| 127 |
|
|---|
| 128 | $XDG_RUNTIME_DIR/icedteaplugin-user-*/ contains in and out pipe for native<->java communication and
|
|---|
| 129 | (if enabled) debugging pipe
|
|---|
| 130 |
|
|---|
| 131 | Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are set as ~/.config, ~/.cache and /tmp or /var/tmp if not set.
|
|---|
| 132 |
|
|---|
| [348] | 133 | .SH BUGS
|
|---|
| 134 | There arent any known bugs. If you come across one, please file it at
|
|---|
| 135 | http://icedtea.classpath.org/bugzilla/
|
|---|
| 136 | .br
|
|---|
| [429] | 137 | Please run javaws in debug (-verbose switch or itw-settings setting or ICEDTEAPLUGIN_DEBUG variable set to true)
|
|---|
| 138 | mode and include that output (best is from java console) with URL to jnlp or html file
|
|---|
| 139 | (ot the jnlp/html file or application itself) when filing out the bug report.
|
|---|
| [348] | 140 |
|
|---|
| 141 | .SH AUTHOR
|
|---|
| 142 | Originally written by Jon. A. Maxwell.
|
|---|
| 143 | .br
|
|---|
| [429] | 144 | Currently maintained by the IcedTea contributors. See javaws -about for more info
|
|---|
| [348] | 145 |
|
|---|
| 146 | .SH SEE ALSO
|
|---|
| 147 | .BR java (1)
|
|---|
| 148 | .br
|
|---|
| [429] | 149 | http://icedtea.classpath.org/wiki/IcedTea-Web
|
|---|
