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