javaws.itweb(1)

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

NAME

6       javaws - a 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 file to
14       securely run a remote application or an applet. This implementation  of
15       javaws is from the IcedTea project and is based on the NetX project.
16
17       A  JNLP file is an xml file that describes how to securely run a remote
18       application or an applet.
19
20

Missing Resource: manCommandLineOptions_en

22       When specifying options, the name of the jnlp file  can  be  after  the
23       command, the -jnlp option, an option with no arguments, or after an ar‐
24       gument with an option  that  takes  one  argument.  A  html  file  that
25       launches a jnlp can be specified after the -html option.
26       The jnlp-file can either be a url or a local path.
27       The  JNLP  file  should only be specified once, whether as a main argu‐
28       ment, after -jnlp or through an html file.
29
30       Control options:
31
32
33       -about      Shows a sample application.(No argument expected)
34
35       -help       Prints out information about supported  command  and  basic
36                   usage.(No argument expected)
37
38       -license    Display the GPL license and exit.(No argument expected)
39
40       -viewer     Shows the trusted certificate viewer.(No argument expected)
41
42       -Xcacheids  List  available  IDs  in cache, which you can use to delete
43                   individual applications.(Expected none or one argument)
44
45       -Xclearcache
46                   Clean the JNLP application cache.  If  you  pass  argument,
47                   only specified application is deleted.(Expected none or one
48                   argument)
49
50
51       Run options:
52
53
54       -allowredirect
55                   Follows HTTP redirects.(No argument expected)
56
57       -arg arg    Adds an application argument before launching.(Expected one
58                   or more arguments)
59
60       -browser    Launch  embedded  browser. Use in great need only!(Expected
61                   one or more arguments)
62
63       -headless   Disables download window, other UIs.(No argument expected)
64
65       -jnlp       Location of JNLP file to launch (url or file).(Exactly  one
66                   argument expected)
67
68       -nosecurity Disables the secure runtime environment. You need also  de‐
69                   ployment.security.itw.ignorecertissues to  workaround  cor‐
70                   rupted signatures(No argument expected)
71
72       -noupdate   Disables checking for updates.(No argument expected)
73
74       -param name=value
75                   Adds  an applet parameter before launching.(Expected one or
76                   more arguments)
77
78       -property name=value
79                   Sets a system property before  launching.(Expected  one  or
80                   more arguments)
81
82       -strict     Enables  strict  checking  of JNLP file format.(No argument
83                   expected)
84
85       -update seconds
86                   Check for updates.(Exactly one argument expected)
87
88       -verbose    Enable verbose output.(No argument expected)
89
90       -version    Print the IcedTea-Web version  and  exit.(No  argument  ex‐
91                   pected)
92
93       -Xignoreheaders
94                   Skip jar header verification.(No argument expected)
95
96       -xml        Uses  a  strict XML parser to parse the JNLP file.(No argu‐
97                   ment expected)
98
99       -Xnofork    Do not create another JVM.(No argument expected)
100
101       -Xnosplash  Do not show splash screen. (No argument expected)
102
103       -Xoffline   Prevent ITW network connection. Only cache  will  be  used.
104                   Application can still connect.(No argument expected)
105
106       -Xtrustnone Instead  of  asking  user,  will  answer all questions with
107                   no.(No argument expected)
108
109

EXAMPLES

111       javaws -about
112                   Shows basic help and about informations.
113
114       javaws -about -headless
115                   Shows basic help and about informations in terminal only.
116
117       javaws  -Xnofork -Xignoreheaders  -allowredirect  -Xoffline  http://my‐
118       page.web/dangerous.jnlp
119                   Will  start dangerous.jnlp application, originally from my‐
120                   page.web, without downloading it, without headers check and
121                   in forced single VM.
122
123

FILES

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

BUGS

247       There aren't any known bugs. If you come across one, please file it at:
248       http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
249       https://github.com/AdoptOpenJDK/icedtea-web/issues
250
251       Please  run  in  debug  (-verbose  switch  or  itw-settings  setting or
252       ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that  output
253       (best  is  from  the  console)  with  URL  to jnlp or html file (or the
254       jnlp/html file or  application itself) when filling out the bug report.
255
256

AUTHOR

258       https://github.com/AdoptOpenJDK/icedtea-web/graphs/contributors
259
260