1javaws(1) General Commands Manual javaws(1)
2
6 javaws - a Java Web Start client
7
9 javaws [-run-options] jnlp file
10 javaws [-control-options]
11
13 javaws is an implementation of a JNLP client. It uses a JNLP (Java Net‐
14 work Launch Protocol) file to securely run a remote Java application or
15 a Java applet. This implementation of javaws is from the IcedTea
16 project and is based on the NetX project.
17 A JNLP file is an xml file that describes how to securely run a remote
19 Java application or a Java applet.
20
23 When specifying options, the name of the jnlp file can be after the
24 command, the -jnlp option, an option with no arguments, or after an
25 argument with an option that takes one argument. A html file that
26 launches a jnlp can be specified after the -html option.
27 The jnlp-file can either be a url or a local path.
28 The JNLP file should only be specified once, whether as a main argu‐
29 ment, after -jnlp or through an html file.
30 Control options:
32 -about Shows a sample application.(No argument expected)
35 -help Prints out information about supported command and basic
37 usage.(No argument expected)
38 -license Display the GPL license and exit.(No argument expected)
40 -viewer Shows the trusted certificate viewer.(No argument expected)
42 -Xclearcache
44 Clean the JNLP application cache.(No argument expected)
45 Run options:
48 -allowredirect
51 Follows HTTP redirects.(No argument expected)
52 -arg arg Adds an application argument before launching.(Expected one
54 or more arguments)
55 -browser Launch embeded browser. Use in great need only!(Expected
57 one or more arguments)
58 -headless Disables download window, other UIs.(No argument expected)
60 -html Location of HTML file to launch (url or file). You can use
62 parameter ALL or numbers (like 1 2 5) to select applets on
63 page. However experimental, this switch should keep you
64 still in safety.(Expected one or more arguments)
65 -jnlp Location of JNLP file to launch (url or file).(Exactly one
67 argument expected)
68 -nosecurity Disables the secure runtime environment.(No argument
70 expected)
71 -noupdate Disables checking for updates.(No argument expected)
73 -param name=value
75 Adds an applet parameter before launching.(Expected one or
76 more arguments)
77 -property name=value
79 Sets a system property before launching.(Expected one or
80 more arguments)
81 -strict Enables strict checking of JNLP file format.(No argument
83 expected)
84 -update seconds
86 Check for updates.(Exactly one argument expected)
87 -verbose Enable verbose output.(No argument expected)
89 -version Print the IcedTea-Web version and exit.(No argument
91 expected)
92 -Xignoreheaders
94 Skip jar header verification.(No argument expected)
95 -xml Uses a strict XML parser to parse the JNLP file.(No argu‐
97 ment expected)
98 -Xnofork Do not create another JVM.(No argument expected)
100 -Xoffline Prevent ITW network connection. Only cache will be used.
102 Application can still connect.(No argument expected)
103 -Xtrustnone Instead of asking user, will foretold all answers as no.(No
105 argument expected)
106
109 javaws -about
110 Shows basic help and about informations.
111 javaws -about -headless
113 Shows basic help and about informations in terminal only.
114 javaws -Xnofork -Xignoreheaders -allowredirect -Xoffline
116 http://mypage.web/dangerous.jnlp
117 Will start dangerous.jnlp application, originally from
118 mypage.web, without downloading it, without headers check
119 and in forced single VM.
120
123 $JAVA_HOME/lib/deployment.config
124 java-global deployment properties file. May be affected by
125 deployment.jre.dir.
126 $JAVA_HOME/lib/security/cacerts
128 Contains various system java-wide stored certificates.
129 Controlled by deployment.system.security.cacerts
130 $JAVA_HOME/lib/security/jssecacerts
133 Contains various system java-wide stored certificates.
134 Controlled by deployment.system.security.jssecacerts
135 $JAVA_HOME/lib/security/trusted.certs
138 Contains various system java-wide stored certificates.
139 Controlled by deployment.system.security.trusted.certs
140 $JAVA_HOME/lib/security/trusted.clientcerts
143 Contains various system java-wide stored certificates.
144 Controlled by deployment.system.security.trusted.clien‐
145 tautcerts
146 $JAVA_HOME/lib/security/trusted.jssecerts
149 Contains various system java-wide stored certificates.
150 Controlled by deployment.system.security.trusted.jssecerts
151 $TMP/$USER/netx/locks
154 Location of netx locks. Controlled by deploy‐
155 ment.user.locksdir
156 $TMP/$USER/netx/locks/netx_running
159 Location of netx main lock. Controlled by deploy‐
160 ment.user.runningfile
161 $XDG_CACHE_HOME/icedtea-web/cache
164 Contains cached runtime entries. Controlled by deploy‐
165 ment.user.cachedir
166 $XDG_CACHE_HOME/icedtea-web/cache/recently_used
169 Additional information about items in cache
170 $XDG_CACHE_HOME/icedtea-web/pcache
172 Contains saved application data. Controlled by deploy‐
173 ment.user.pcachedir
174 $XDG_CACHE_HOME/icedtea-web/tmp
177 Contains temporary runtime files. Controlled by deploy‐
178 ment.user.tmp
179 $XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
182 File responsible for various actions on applets and apps
183 based on their codebase based on users actions.
184 $XDG_CONFIG_HOME/icedtea-web/deployment.properties
186 Users main deployment properties file.
187 $XDG_CONFIG_HOME/icedtea-web/icons
189 Location where icons of javaws applications desktop/menu
190 launchers icons are stored
191 $XDG_CONFIG_HOME/icedtea-web/log
193 contains file-log files (if enabled), itw-cplugin-
194 date_time.log for native part of plugin, itw-javantx-
195 date_time.log for everything else. Controlled by deploy‐
196 ment.user.logdir
197 $XDG_CONFIG_HOME/icedtea-web/security/java.policy
200 Contains granted permissions for selected unsigned apps.
201 Controlled by deployment.user.security.policy
202 $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts
205 Contains various users stored certificates. Controlled by
206 deployment.user.security.trusted.cacerts
207 $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs
210 Contains various users stored certificates. Controlled by
211 deployment.user.security.trusted.certs
212 $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
215 Contains various users stored certificates. Controlled by
216 deployment.user.security.trusted.clientauthcerts
217 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
220 Contains various users stored certificates. Controlled by
221 deployment.user.security.trusted.jssecacerts
222 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
225 Contains various users stored certificates. Controlled by
226 deployment.user.security.trusted.jssecerts
227 $XDG_DATA_HOME/applications/javaws
230 Subdirectory in users menus space, for placing custom menu
231 shortcuts.
232 /etc/.java/deployment/.appletTrustSettings
234 File responsible for various actions on applets and apps
235 based on their codebase based on admins actions.
236 /etc/.java/deployment/deployment.config
238 Global deployment config file.
239 Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are set as
242 ~/.config, ~/.cache and /tmp or /var/tmp if not set.
243
245 There aren't any known bugs. If you come across one, please file it at:
246 http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
247 http://icedtea.classpath.org/bugzilla
248 Please run in debug (-verbose switch or itw-settings setting or
250 ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that output
251 (best is from java console) with URL to jnlp or html file (or the
252 jnlp/html file or application itself) when filing out the bug report.
253
256 The following people have made contibutions to this project.
257 Please keep this list in alphabetical order.
258 Lillian Angel <langel@redhat.com>Andrew Azores <aazores@red‐
259 hat.com>Deepak Bhole <dbhole@redhat.com>Adam Buchta
260 <adbuch7@gmail.com>Ricardo Martín Camarero <rickye‐
261 poderi@yahoo.es>Marcin Cieslak <marcin.cieslak@gmail.com>Danesh
262 Dadachanji <ddadacha@redhat.com>Adam Domurad <adomurad@red‐
263 hat.com>Lukasz Dracz <ldracz@redhat.com>Thomas Fitzsimmons
264 <fitzsim@redhat.com>Michał Górny <mgorny@gentoo.org>Mark Greenwood
265 <mark@dcs.shef.ac.uk>Tereza Hlavackova <hlavack‐
266 ova.tereza@gmail.com>Peter Hatina <phatina@redhat.com>Andrew John
267 Hughes <ahughes@redhat.com>Jie Kang <jkang@redhat.com>Alex Kashchenko
268 <akashche@redhat.com>Matthias Klose <doko@ubuntu.com>Alexandr Kolouch
269 <skolnag@gmail.com>Jan Kmetko <jan.kmetko.ml@gmail.com>Francis Kung
270 <fkung@redhat.com>Denis Lila <dlila@redhat.com>DJ Lucas <dj@luca‐
271 sit.com>Omair Majid <omajid@redhat.com>Jon A. Maxwell
272 <jmaxwell@users.sourceforge.net>Thomas Meyer <thomas@m3y3r.de>Kurt
273 Miller <kurt@intricatesoftware.com>Saad Mohammad <smohammad@red‐
274 hat.com>Martin Olsson <martin@minimum.se>Stefan Ring <stefan@com‐
275 plang.tuwien.ac.at>Ville Skyttä <ville.skytta@iki.fi>Fridrich Strba
276 <fridrich.strba@suse.com>Andrew Su <asu@redhat.com>Joshua Sumali
277 <jsumali@redhat.com>Michal Vala <mvala@redhat.com>Jiri Vanek
278 <jvanek@redhat.com>Tomáš Votava <tomcacolca@gmail.com>Mark Wielaard
279 <mark@klomp.org>Jacob Wisor <gitne@excite.co.jp>Man Lung Wong
280 <mwong@redhat.com>
281 This project also includes code from the following projects:
282 OpenJDK <http://openjdk.java.net/>
283 Netx <http://jnlp.sourceforge.net/netx/>
284
288 icedtea-web(1) javaws(1) icedtea-web-plugin(1) itweb-settings(1) poli‐
289 cyeditor(1) policytool(1) java(1)
290 http://icedtea.classpath.org/wiki/IcedTea-Web
292 http://icedtea.classpath.org/hg/icedtea-web
293icedtea-web (rhel-1.el7-x86_64) 11 Apr 2018 javaws(1)