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