javaws(1)

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 ar‐
25       gument  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  de‐
75                   ployment.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       -startuptracker
89                   Enable startup time tracker(No argument expected)
90
91       -strict     Enables  strict  checking  of JNLP file format.(No argument
92                   expected)
93
94       -update seconds
95                   Check for updates.(Exactly one argument expected)
96
97       -verbose    Enable verbose output.(No argument expected)
98
99       -version    Print the IcedTea-Web version  and  exit.(No  argument  ex‐
100                   pected)
101
102       -Xignoreheaders
103                   Skip jar header verification.(No argument expected)
104
105       -xml        Uses  a  strict XML parser to parse the JNLP file.(No argu‐
106                   ment expected)
107
108       -Xnofork    Do not create another JVM.(No argument expected)
109
110       -Xoffline   Prevent ITW network connection. Only cache  will  be  used.
111                   Application can still connect.(No argument expected)
112
113       -Xtrustnone Instead of asking user, will foretold all answers as no.(No
114                   argument expected)
115
116

EXAMPLES

118       javaws -about
119                   Shows basic help and about informations.
120
121       javaws -about -headless
122                   Shows basic help and about informations in terminal only.
123
124       javaws  -Xnofork -Xignoreheaders  -allowredirect  -Xoffline  http://my‐
125       page.web/dangerous.jnlp
126                   Will  start dangerous.jnlp application, originally from my‐
127                   page.web, without downloading it, without headers check and
128                   in forced single VM.
129
130

FILES

132       $JAVA_HOME/lib/deployment.config
133                   java-global  deployment properties file. May be affected by
134                   deployment.jre.dir.
135
136       $JAVA_HOME/lib/security/cacerts
137                   Contains  various  system  java-wide  stored  certificates.
138                   Controlled by deployment.system.security.cacerts
139
140
141       $JAVA_HOME/lib/security/jssecacerts
142                   Contains   various  system  java-wide  stored certificates.
143                   Controlled by deployment.system.security.jssecacerts
144
145
146       $JAVA_HOME/lib/security/trusted.certs
147                   Contains  various  system  java-wide  stored  certificates.
148                   Controlled by deployment.system.security.trusted.certs
149
150
151       $JAVA_HOME/lib/security/trusted.clientcerts
152                   Contains   various  system  java-wide  stored certificates.
153                   Controlled   by   deployment.system.security.trusted.clien‐
154                   tautcerts
155
156
157       $JAVA_HOME/lib/security/trusted.jssecerts
158                   Contains   various  system  java-wide  stored certificates.
159                   Controlled by deployment.system.security.trusted.jssecerts
160
161
162       $TMP/$USER/netx/locks
163                   Location   of   netx   locks.   Controlled    by    deploy‐
164                   ment.user.locksdir
165
166
167       $TMP/$USER/netx/locks/netx_running
168                   Location   of   netx   main  lock.  Controlled  by  deploy‐
169                   ment.user.runningfile
170
171
172       $XDG_CACHE_HOME/icedtea-web/cache
173                   Contains cached  runtime  entries.  Controlled  by  deploy‐
174                   ment.user.cachedir
175
176
177       $XDG_CACHE_HOME/icedtea-web/cache/recently_used
178                   Additional information about items in cache
179
180       $XDG_CACHE_HOME/icedtea-web/pcache
181                   Contains  saved  application  data.  Controlled  by deploy‐
182                   ment.user.pcachedir
183
184
185       $XDG_CACHE_HOME/icedtea-web/tmp
186                   Contains temporary runtime  files.  Controlled  by  deploy‐
187                   ment.user.tmp
188
189
190       $XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
191                   File  responsible  for  various actions on applets and apps
192                   based on their codebase based on users actions.
193
194       $XDG_CONFIG_HOME/icedtea-web/deployment.properties
195                   Users main deployment properties file.
196
197       $XDG_CONFIG_HOME/icedtea-web/icons
198                   Location where icons of  javaws  applications  desktop/menu
199                   launchers icons are stored
200
201       $XDG_CONFIG_HOME/icedtea-web/log
202                   contains   file-log   files   (if   enabled),  itw-cplugin-
203                   date_time.log  for  native  part  of  plugin,  itw-javantx-
204                   date_time.log  for  everything  else. Controlled by deploy‐
205                   ment.user.logdir
206
207
208       $XDG_CONFIG_HOME/icedtea-web/security/java.policy
209                   Contains granted permissions for  selected  unsigned  apps.
210                   Controlled by deployment.user.security.policy
211
212
213       $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts
214                   Contains   various users stored certificates. Controlled by
215                   deployment.user.security.trusted.cacerts
216
217
218       $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs
219                   Contains  various users stored certificates. Controlled  by
220                   deployment.user.security.trusted.certs
221
222
223       $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
224                   Contains   various users stored certificates. Controlled by
225                   deployment.user.security.trusted.clientauthcerts
226
227
228       $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
229                   Contains  various users stored certificates. Controlled  by
230                   deployment.user.security.trusted.jssecacerts
231
232
233       $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
234                   Contains   various users stored certificates. Controlled by
235                   deployment.user.security.trusted.jssecerts
236
237
238       $XDG_DATA_HOME/applications/javaws
239                   Subdirectory in users menus space, for placing custom  menu
240                   shortcuts.
241
242       {%WINDIR/Sun/Java or /etc/.java}/deployment/.appletTrustSettings
243                   File  responsible  for  various actions on applets and apps
244                   based on their codebase based on admins actions.
245
246       {%WINDIR/Sun/Java or /etc/.java}/deployment/deployment.config
247                   Global deployment config file.
248
249
250       Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are  set  as
251       ~/.config, ~/.cache and /tmp or /var/tmp if not set.
252

BUGS

254       There aren't any known bugs. If you come across one, please file it at:
255       http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
256       http://icedtea.classpath.org/bugzilla
257
258       Please  run  in  debug  (-verbose  switch  or  itw-settings  setting or
259       ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that  output
260       (best  is  from  java  console)  with  URL to jnlp or html file (or the
261       jnlp/html file or  application itself) when filing out the bug report.
262
263

AUTHOR

265       The following people have made contibutions to this project.
266       Please keep this list in alphabetical order.
267       Lillian   Angel    <langel@redhat.com>Andrew    Azores    <aazores@red‐
268       hat.com>Deepak  Bhole  <dbhole@redhat.com>Laurent Bourgès <bourges.lau‐
269       rent@gmail.com>Adam Buchta <adbuch7@gmail.com>Ricardo  Martín  Camarero
270       <rickyepoderi@yahoo.es>Marcin  Cieslak <marcin.cieslak@gmail.com>Danesh
271       Dadachanji     <ddadacha@redhat.com>Adam     Domurad     <adomurad@red‐
272       hat.com>Lukasz      Dracz     <ldracz@redhat.com>Thomas     Fitzsimmons
273       <fitzsim@redhat.com>Olesya   Gerasimenko    <gammaray@basealt.ru>Michał
274       Górny   <mgorny@gentoo.org>Mark  Greenwood  <mark@dcs.shef.ac.uk>Tereza
275       Hlavackova  <hlavackova.tereza@gmail.com>Lars  Herschke   <lhersch@dss‐
276       gmbh.de>Peter    Hatina    <phatina@redhat.com>Andrew    John    Hughes
277       <ahughes@redhat.com>Jie    Kang    <jkang@redhat.com>Alex    Kashchenko
278       <akashche@redhat.com>Matthias  Klose  <doko@ubuntu.com>Alexandr Kolouch
279       <skolnag@gmail.com>Jan  Kmetko  <jan.kmetko.ml@gmail.com>Francis   Kung
280       <fkung@redhat.com>Denis   Lila   <dlila@redhat.com>DJ  Lucas  <dj@luca‐
281       sit.com>Omair     Majid     <omajid@redhat.com>Jon      A.      Maxwell
282       <jmaxwell@users.sourceforge.net>Thomas    Meyer   <thomas@m3y3r.de>Kurt
283       Miller   <kurt@intricatesoftware.com>Saad   Mohammad    <smohammad@red‐
284       hat.com>Martin  Olsson   <martin@minimum.se>Stefan  Ring   <stefan@com‐
285       plang.tuwien.ac.at>Ville  Skyttä  <ville.skytta@iki.fi>Fridrich   Strba
286       <fridrich.strba@suse.com>Andrew    Su   <asu@redhat.com>Joshua   Sumali
287       <jsumali@redhat.com>Joel   Tesdall   <jtesdall@mapcon.com>Michal   Vala
288       <mvala@redhat.com>Jiri  Vanek  <jvanek@redhat.com>Tomáš  Votava <tomca‐
289       colca@gmail.com>Mark Wielaard <mark@klomp.org>Jacob  Wisor   <gitne@ex‐
290       cite.co.jp>Man Lung Wong <mwong@redhat.com>
291       This project also includes code from the following projects:
292       OpenJDK <http://openjdk.java.net/>
293       Netx <http://jnlp.sourceforge.net/netx/>
294
295
296