1itweb-settings(1) General Commands Manual itweb-settings(1)
2
3
4
6 itweb-settings - view and modify settings for javaws and the browser
7 plugin
8
9
11 itweb-settings
12 itweb-settings command arguments
13
15 itweb-settings is a command line and a GUI program to modify and edit
16 settings used by the IcedTea-Web implementation of javaws and the
17 browser plugin
18
19 If executed without any arguments, it starts up a GUI. Otherwise, it
20 tries to do what is specified in the argument.
21
22 The command-line allows quickly searching, making a copy of and modify‐
23 ing specific settings without having to hunt through a UI.
24
26 -check name Checks that all the current settings have valid values.(No
27 argument expected)
28
29 -get name Shows the value of the specified settings.(Expected one or
30 more arguments)
31
32 -headless Disables download window, other UIs.(No argument expected)
33
34 -help Prints out information about supported command and basic
35 usage. Can also take an parameter, and then it prints
36 detailed help for this command.(No argument expected)
37
38 -info name Shows additional information about the named settings.
39 Includes a description, the current value, the possible
40 values, and the source of the setting.(Expected one or more
41 arguments)
42
43 -list Shows a list of all the IcedTea-Web settings and their cur‐
44 rent values.(No argument expected)
45
46 -reset name Resets the specified settings to their original
47 value.(Expected one or more arguments)
48
49 -reset all Resets all settings to their original values.(No argument
50 expected)
51
52 -set name value
53 Sets the settings to the new value specified, if it is an
54 appropriate value.(Expected even number of arguments with
55 param=value as valid argument)
56
57 -verbose Enable verbose output.(No argument expected)
58
59
60
62 itweb-settings
63 Show the GUI editor
64
65 itweb-settings -reset deployment.proxy.type
66 Resets the value of `deployment.proxy.type` setting.
67
68
69
70 Known properties (key and default value):
71
72
73
74 deployment.browser.path
75 null (Possible: include an absolute path to a file or
76 directory)
77
78 deployment.cache.jarcompression
79 0 (Possible: are in range 0 to 10 (inclusive))
80
81 deployment.cache.max.size
82 -1 (Possible: are in range -1 to 2,147,483,647 (inclusive))
83
84 deployment.console.startup.mode
85 HIDE (Possible: [DISABLE, HIDE, SHOW, SHOW_PLUGIN_ONLY,
86 SHOW_JAVAWS_ONLY])
87
88 deployment.https.noenforce
89 false (Possible: are true or false)
90
91 deployment.javapi.cache.enabled
92 false (Possible: are true or false)
93
94 deployment.javaws.associations
95 2 (Possible: are in range 0 to 3 (inclusive))
96
97 deployment.javaws.autodownload
98 false (Possible: are true or false)
99
100 deployment.javaws.installURL
101 null (Possible: include any valid url (eg.
102 http://icedtea.classpath.org/hg/))
103
104 deployment.javaws.shortcut
105 ASK_IF_HINTED (Possible: [ALWAYS, ALWAYS_IF_HINTED,
106 ASK_USER, ASK_IF_HINTED, NEVER])
107
108 deployment.javaws.update.timeout
109 500 (Possible: are in range 0 to 10,000 (inclusive))
110
111 deployment.jnlpclassloader.strict
112 true (Possible: are true or false)
113
114 deployment.jre.dir
115 null
116
117 deployment.log
118 false (Possible: are true or false)
119
120 deployment.log.file
121 false (Possible: are true or false)
122
123 deployment.log.file.clientapp
124 true (Possible: are true or false)
125
126 deployment.log.file.legacylog
127 false (Possible: are true or false)
128
129 deployment.log.headers
130 false (Possible: are true or false)
131
132 deployment.log.stdstreams
133 true (Possible: are true or false)
134
135 deployment.log.system
136 true (Possible: are true or false)
137
138 deployment.manifest.attributes.check
139 ALL (Possible: (Values that can be used alone only): [ALL,
140 NONE] (Values that can be used in combination separated by
141 the delimiter "," with no space expected ): [ALAC, CODE‐
142 BASE, ENTRYPOINT, PERMISSIONS, TRUSTED])
143
144 deployment.plugin.jvm.arguments
145 null
146
147 deployment.proxy.auto.config.url
148 null (Possible: include any valid url (eg.
149 http://icedtea.classpath.org/hg/))
150
151 deployment.proxy.bypass.list
152 null
153
154 deployment.proxy.bypass.local
155 null
156
157 deployment.proxy.ftp.host
158 null
159
160 deployment.proxy.ftp.port
161 null
162
163 deployment.proxy.http.host
164 null
165
166 deployment.proxy.http.port
167 null
168
169 deployment.proxy.https.host
170 null
171
172 deployment.proxy.https.port
173 null
174
175 deployment.proxy.override.hosts
176 null
177
178 deployment.proxy.same
179 false (Possible: are true or false)
180
181 deployment.proxy.socks.host
182 null
183
184 deployment.proxy.socks.port
185 null
186
187 deployment.proxy.type
188 3 (Possible: are in range -1 to 3 (inclusive))
189
190 deployment.security.askgrantdialog.notinca
191 true (Possible: are true or false)
192
193 deployment.security.askgrantdialog.show
194 true (Possible: are true or false)
195
196 deployment.security.expired.warning
197 true (Possible: are true or false)
198
199 deployment.security.itw.ignorecertissues
200 false (Possible: are true or false)
201
202 deployment.security.jsse.hostmismatch.warning
203 true (Possible: are true or false)
204
205 deployment.security.level
206 null (Possible: DENY_ALL DENY_UNSIGNED ASK_UNSIGNED
207 ALLOW_UNSIGNED)
208
209 deployment.security.notinca.warning
210 true (Possible: are true or false)
211
212 deployment.security.sandbox.awtwarningwindow
213 true (Possible: are true or false)
214
215 deployment.security.sandbox.jnlp.enhanced
216 true (Possible: are true or false)
217
218 deployment.security.trusted.policy
219 null (Possible: include an absolute path to a file or
220 directory)
221
222 deployment.system.cachedir
223 null (Possible: include an absolute path to a file or
224 directory)
225
226 deployment.system.security.cacerts
227 $JAVA_HOME/lib/security/cacerts (Possible: include an abso‐
228 lute path to a file or directory)
229
230 deployment.system.security.jssecacerts
231 $JAVA_HOME/lib/security/jssecacerts (Possible: include an
232 absolute path to a file or directory)
233
234 deployment.system.security.policy
235 null (Possible: include any valid url (eg.
236 http://icedtea.classpath.org/hg/))
237
238 deployment.system.security.trusted.certs
239 $JAVA_HOME/lib/security/trusted.certs (Possible: include an
240 absolute path to a file or directory)
241
242 deployment.system.security.trusted.clientautcerts
243 $JAVA_HOME/lib/security/trusted.clientcerts (Possible:
244 include an absolute path to a file or directory)
245
246 deployment.system.security.trusted.jssecerts
247 $JAVA_HOME/lib/security/trusted.jssecerts (Possible:
248 include an absolute path to a file or directory)
249
250 deployment.user.cachedir
251 $XDG_CACHE_HOME/icedtea-web/cache (Possible: include an
252 absolute path to a file or directory)
253
254 deployment.user.locksdir
255 $TMP/$USER/netx/locks (Possible: include an absolute path
256 to a file or directory)
257
258 deployment.user.logdir
259 $XDG_CONFIG_HOME/icedtea-web/log (Possible: include an
260 absolute path to a file or directory)
261
262 deployment.user.pcachedir
263 $XDG_CACHE_HOME/icedtea-web/pcache (Possible: include an
264 absolute path to a file or directory)
265
266 deployment.user.runningfile
267 $TMP/$USER/netx/locks/netx_running (Possible: include an
268 absolute path to a file or directory)
269
270 deployment.user.security.policy
271 $XDG_CONFIG_HOME/icedtea-web/security/java.policy (Possi‐
272 ble: include any valid url (eg. http://icedtea.class‐
273 path.org/hg/))
274
275 deployment.user.security.trusted.cacerts
276 $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Pos‐
277 sible: include an absolute path to a file or directory)
278
279 deployment.user.security.trusted.certs
280 $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possi‐
281 ble: include an absolute path to a file or directory)
282
283 deployment.user.security.trusted.clientauthcerts
284 $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
285 (Possible: include an absolute path to a file or directory)
286
287 deployment.user.security.trusted.jssecacerts
288 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
289 (Possible: include an absolute path to a file or directory)
290
291 deployment.user.security.trusted.jssecerts
292 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
293 (Possible: include an absolute path to a file or directory)
294
295 deployment.user.tmp
296 $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an abso‐
297 lute path to a file or directory)
298
299
301 $JAVA_HOME/lib/deployment.config
302 java-global deployment properties file. May be affected by
303 deployment.jre.dir.
304
305 $XDG_CACHE_HOME/icedtea-web/cache
306 Contains cached runtime entries. Controlled by deploy‐
307 ment.user.cachedir
308
309
310 $XDG_CACHE_HOME/icedtea-web/cache/recently_used
311 Additional information about items in cache
312
313 $XDG_CACHE_HOME/icedtea-web/pcache
314 Contains saved application data. Controlled by deploy‐
315 ment.user.pcachedir
316
317
318 $XDG_CACHE_HOME/icedtea-web/tmp
319 Contains temporary runtime files. Controlled by deploy‐
320 ment.user.tmp
321
322
323 $XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
324 File responsible for various actions on applets and apps
325 based on their codebase based on users actions.
326
327 $XDG_CONFIG_HOME/icedtea-web/deployment.properties
328 Users main deployment properties file.
329
330 $XDG_CONFIG_HOME/icedtea-web/generated_jnlps
331 Location where jnlp files generated from html pages for
332 javaws applications desktop/menu launchers icons are stored
333
334 $XDG_CONFIG_HOME/icedtea-web/icons
335 Location where icons of javaws applications desktop/menu
336 launchers icons are stored
337
338 $XDG_CONFIG_HOME/icedtea-web/log
339 contains file-log files (if enabled), itw-cplugin-
340 date_time.log for native part of plugin, itw-javantx-
341 date_time.log for everything else. Controlled by deploy‐
342 ment.user.logdir
343
344
345 $XDG_DATA_HOME/applications/javaws
346 Subdirectory in users menus space, for placing custom menu
347 shortcuts.
348
349 /etc/.java/deployment/.appletTrustSettings
350 File responsible for various actions on applets and apps
351 based on their codebase based on admins actions.
352
353 /etc/.java/deployment/deployment.config
354 Global deployment config file.
355
356
357 Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are set as
358 ~/.config, ~/.cache and /tmp or /var/tmp if not set.
359
361 There aren't any known bugs. If you come across one, please file it at:
362 http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
363 http://icedtea.classpath.org/bugzilla
364
365 Please run in debug (-verbose switch or itw-settings setting or
366 ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that output
367 (best is from java console) with URL to jnlp or html file (or the
368 jnlp/html file or application itself) when filing out the bug report.
369
370
372 The following people have made contibutions to this project.
373 Please keep this list in alphabetical order.
374 Lillian Angel <langel@redhat.com>Andrew Azores <aazores@red‐
375 hat.com>Deepak Bhole <dbhole@redhat.com>Adam Buchta
376 <adbuch7@gmail.com>Ricardo Martín Camarero <rickye‐
377 poderi@yahoo.es>Marcin Cieslak <marcin.cieslak@gmail.com>Danesh
378 Dadachanji <ddadacha@redhat.com>Adam Domurad <adomurad@red‐
379 hat.com>Lukasz Dracz <ldracz@redhat.com>Thomas Fitzsimmons
380 <fitzsim@redhat.com>Michał Górny <mgorny@gentoo.org>Mark Greenwood
381 <mark@dcs.shef.ac.uk>Tereza Hlavackova <hlavack‐
382 ova.tereza@gmail.com>Peter Hatina <phatina@redhat.com>Andrew John
383 Hughes <ahughes@redhat.com>Jie Kang <jkang@redhat.com>Alex Kashchenko
384 <akashche@redhat.com>Matthias Klose <doko@ubuntu.com>Alexandr Kolouch
385 <skolnag@gmail.com>Jan Kmetko <jan.kmetko.ml@gmail.com>Francis Kung
386 <fkung@redhat.com>Denis Lila <dlila@redhat.com>DJ Lucas <dj@luca‐
387 sit.com>Omair Majid <omajid@redhat.com>Jon A. Maxwell
388 <jmaxwell@users.sourceforge.net>Thomas Meyer <thomas@m3y3r.de>Kurt
389 Miller <kurt@intricatesoftware.com>Saad Mohammad <smohammad@red‐
390 hat.com>Martin Olsson <martin@minimum.se>Stefan Ring <stefan@com‐
391 plang.tuwien.ac.at>Ville Skyttä <ville.skytta@iki.fi>Fridrich Strba
392 <fridrich.strba@suse.com>Andrew Su <asu@redhat.com>Joshua Sumali
393 <jsumali@redhat.com>Michal Vala <mvala@redhat.com>Jiri Vanek
394 <jvanek@redhat.com>Tomáš Votava <tomcacolca@gmail.com>Mark Wielaard
395 <mark@klomp.org>Jacob Wisor <gitne@excite.co.jp>Man Lung Wong
396 <mwong@redhat.com>
397 This project also includes code from the following projects:
398 OpenJDK <http://openjdk.java.net/>
399 Netx <http://jnlp.sourceforge.net/netx/>
400
401
402
404 icedtea-web(1) javaws(1) icedtea-web-plugin(1) itweb-settings(1) poli‐
405 cyeditor(1) policytool(1) java(1)
406
407 http://icedtea.classpath.org/wiki/IcedTea-Web
408 http://icedtea.classpath.org/hg/icedtea-web
409
410
411
412
413icedtea-web (rhel-7.el6-x86_64) 19 Jun 2018 itweb-settings(1)