1javaws(1)                   General Commands Manual                  javaws(1)
2
3
4

NAME

6       javaws - a Java Web Start client
7

SYNOPSIS

9       javaws [-run-options] jnlp file
10       javaws [-control-options]
11

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

FILES

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

BUGS

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

AUTHOR

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

SEE ALSO

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-1.fc30-x86_64)13 Mar 2019                        javaws(1)
Impressum