1javaws(1) General Commands Manual javaws(1)
2
3
4
6 javaws - a 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 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
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
24 argument 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
69 deployment.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
91 expected)
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
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
118 http://mypage.web/dangerous.jnlp
119 Will start dangerous.jnlp application, originally from
120 mypage.web, without downloading it, without headers check
121 and in forced single VM.
122
123
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
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
258 https://github.com/AdoptOpenJDK/icedtea-web/graphs/contributors
259
260
262 icedtea-web(1) javaws(1) icedtea-web-plugin(1) itweb-settings(1) poli‐
263 cyeditor(1) policytool(1) java(1)
264
265 https://github.com/AdoptOpenJDK/icedtea-web
266 https://github.com/AdoptOpenJDK/icedtea-web.git
267
268
269
270
271icedtea-web 2.0.0-SNAPSHOT 10 May 2020 javaws(1)