1itweb-settings(1) General Commands Manual itweb-settings(1)
2
6 itweb-settings - view and modify settings for javaws and the browser
7 plugin
8
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 If executed without any arguments, it starts up a GUI. Otherwise, it
20 tries to do what is specified in the argument.
21 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 -get name Shows the value of the specified settings.(Expected one or
30 more arguments)
31 -headless Disables download window, other UIs.(No argument expected)
33 -help Prints out information about supported command and basic
35 usage. Can also take an parameter, and then it prints de‐
36 tailed help for this command.(No argument expected)
37 -info name Shows additional information about the named settings. In‐
39 cludes a description, the current value, the possible val‐
40 ues, and the source of the setting.(Expected one or more
41 arguments)
42 -list Shows a list of all the IcedTea-Web settings and their cur‐
44 rent values.(No argument expected)
45 -reset name Resets the specified settings to their original value.(Ex‐
47 pected one or more arguments)
48 -reset all Resets all settings to their original values.(No argument
50 expected)
51 -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 -verbose Enable verbose output.(No argument expected)
58
62 itweb-settings
63 Show the GUI editor
64 itweb-settings -reset deployment.proxy.type
66 Resets the value of `deployment.proxy.type` setting.
67 Known properties (key and default value):
71 deployment.background.threads.count
75 3 (Possible: are in range 1 to 16 (inclusive))
76 deployment.browser.path
78 null (Possible: Set path to browser or any command launch‐
79 ing url. If not set, default browser is used. If default
80 browser is not available, you will be be prompted to pro‐
81 vide URL consumer. Eg: firefox, or (windows) rundll32
82 url.dll,FileProtocolHandler , microsoft-edge, (mac) safari,
83 xdg-open (linux) like commands. In headless mode you can
84 use wget, curl or lynx. It can be also javaws itself to
85 launch other jnlp. You can set yor custom browser via de‐
86 ployment.browser.path property. $BROWSER environment vari‐
87 able is serving same purpose. You can use keyword INTERNAL-
88 HTML to launch internal browser. But be warned, it is ter‐
89 rible. Use ALWAYS-ASK to enforce prompt each time instead
90 of using defaults.)
91 deployment.cache.jarcompression
93 0 (Possible: are in range 0 to 10 (inclusive))
94 deployment.cache.max.size
96 -1 (Possible: are in range -1 to 2,147,483,647 (inclusive))
97 deployment.console.startup.mode
99 HIDE (Possible: [DISABLE, HIDE, SHOW, SHOW_PLUGIN_ONLY,
100 SHOW_JAVAWS_ONLY])
101 deployment.enable.cache.fsync
103 false (Possible: are true or false)
104 deployment.headless.ignore
106 false (Possible: are true or false)
107 deployment.https.noenforce
109 false (Possible: are true or false)
110 deployment.javapi.cache.enabled
112 false (Possible: are true or false)
113 deployment.javaws.associations
115 2 (Possible: are in range 0 to 3 (inclusive))
116 deployment.javaws.autodownload
118 false (Possible: are true or false)
119 deployment.javaws.installURL
121 null (Possible: include any valid url (eg.
122 http://icedtea.classpath.org/hg/))
123 deployment.javaws.shortcut
125 ASK_IF_HINTED (Possible: [ALWAYS, ALWAYS_IF_HINTED,
126 ASK_USER, ASK_IF_HINTED, NEVER])
127 deployment.javaws.update.timeout
129 500 (Possible: are in range 0 to 10,000 (inclusive))
130 deployment.jnlpclassloader.strict
132 true (Possible: are true or false)
133 deployment.jre.dir
135 null
136 deployment.launcher.rust.bootcp.add
138 null (Possible: Rust native launchers only! CP and XBootCP
139 properties are space separated members of bootcp/cp to be
140 removed or added. eg `...cp.add=/usr/java/rhino.jar
141 /usr/java/scary.jar` will add those two jars to cp. Eg:
142 `...bootcp.remove=rhino.jar tagsoup.jar` will remove those
143 two jars no meter of path. Removal is done first.)
144 deployment.launcher.rust.bootcp.remove
146 (Possible: Rust native launchers only! CP and XBootCP
147 properties are space separated members of bootcp/cp to be
148 removed or added. eg `...cp.add=/usr/java/rhino.jar
149 /usr/java/scary.jar` will add those two jars to cp. Eg:
150 `...bootcp.remove=rhino.jar tagsoup.jar` will remove those
151 two jars no meter of path. Removal is done first.)
152 deployment.launcher.rust.cp.add
154 (Possible: Rust native launchers only! CP and XBootCP
155 properties are space separated members of bootcp/cp to be
156 removed or added. eg `...cp.add=/usr/java/rhino.jar
157 /usr/java/scary.jar` will add those two jars to cp. Eg:
158 `...bootcp.remove=rhino.jar tagsoup.jar` will remove those
159 two jars no meter of path. Removal is done first.)
160 deployment.launcher.rust.cp.remove
162 (Possible: Rust native launchers only! CP and XBootCP
163 properties are space separated members of bootcp/cp to be
164 removed or added. eg `...cp.add=/usr/java/rhino.jar
165 /usr/java/scary.jar` will add those two jars to cp. Eg:
166 `...bootcp.remove=rhino.jar tagsoup.jar` will remove those
167 two jars no meter of path. Removal is done first.)
168 deployment.log
170 false (Possible: are true or false)
171 deployment.log.file
173 false (Possible: are true or false)
174 deployment.log.file.clientapp
176 true (Possible: are true or false)
177 deployment.log.file.legacylog
179 false (Possible: are true or false)
180 deployment.log.headers
182 false (Possible: are true or false)
183 deployment.log.stdstreams
185 true (Possible: are true or false)
186 deployment.log.system
188 true (Possible: are true or false)
189 deployment.manifest.attributes.check
191 ALL (Possible: (Values that can be used alone only): [ALL,
192 NONE] (Values that can be used in combination separated by
193 the delimiter "," with no space expected ): [ALAC, CODE‐
194 BASE, ENTRYPOINT, PERMISSIONS, TRUSTED])
195 deployment.max.urls.download.indicator
197 16 (Possible: are in range 1 to 1,024 (inclusive))
198 deployment.plugin.jvm.arguments
200 null
201 deployment.proxy.auto.config.url
203 null (Possible: include any valid url (eg.
204 http://icedtea.classpath.org/hg/))
205 deployment.proxy.bypass.list
207 null
208 deployment.proxy.bypass.local
210 null
211 deployment.proxy.ftp.host
213 null
214 deployment.proxy.ftp.port
216 null
217 deployment.proxy.http.host
219 null
220 deployment.proxy.http.port
222 null
223 deployment.proxy.https.host
225 null
226 deployment.proxy.https.port
228 null
229 deployment.proxy.override.hosts
231 null
232 deployment.proxy.same
234 false (Possible: are true or false)
235 deployment.proxy.socks.host
237 null
238 deployment.proxy.socks.port
240 null
241 deployment.proxy.type
243 3 (Possible: are in range -1 to 3 (inclusive))
244 deployment.security.askgrantdialog.notinca
246 true (Possible: are true or false)
247 deployment.security.askgrantdialog.show
249 true (Possible: are true or false)
250 deployment.security.expired.warning
252 true (Possible: are true or false)
253 deployment.security.itw.ignorecertissues
255 false (Possible: are true or false)
256 deployment.security.jsse.hostmismatch.warning
258 true (Possible: are true or false)
259 deployment.security.level
261 null (Possible: DENY_ALL DENY_UNSIGNED ASK_UNSIGNED AL‐
262 LOW_UNSIGNED)
263 deployment.security.notinca.warning
265 true (Possible: are true or false)
266 deployment.security.sandbox.awtwarningwindow
268 true (Possible: are true or false)
269 deployment.security.sandbox.jnlp.enhanced
271 true (Possible: are true or false)
272 deployment.security.trusted.policy
274 null (Possible: include an absolute path to a file or di‐
275 rectory)
276 deployment.small.size.override.height
278 600 (Possible: are in range -9,999 to 9,999 (inclusive))
279 deployment.small.size.override.width
281 800 (Possible: are in range -9,999 to 9,999 (inclusive))
282 deployment.small.size.treshold
284 10 (Possible: are in range 0 to 1,000 (inclusive))
285 deployment.system.cachedir
287 null (Possible: include an absolute path to a file or di‐
288 rectory)
289 deployment.system.config
291 null (Possible: include any valid url (eg.
292 http://icedtea.classpath.org/hg/))
293 deployment.system.config.mandatory
295 false (Possible: are true or false)
296 deployment.system.security.cacerts
298 $JAVA_HOME/lib/security/cacerts (Possible: include an abso‐
299 lute path to a file or directory)
300 deployment.system.security.jssecacerts
302 $JAVA_HOME/lib/security/jssecacerts (Possible: include an
303 absolute path to a file or directory)
304 deployment.system.security.policy
306 null (Possible: include any valid url (eg.
307 http://icedtea.classpath.org/hg/))
308 deployment.system.security.trusted.certs
310 $JAVA_HOME/lib/security/trusted.certs (Possible: include an
311 absolute path to a file or directory)
312 deployment.system.security.trusted.clientautcerts
314 $JAVA_HOME/lib/security/trusted.clientcerts (Possible: in‐
315 clude an absolute path to a file or directory)
316 deployment.system.security.trusted.jssecerts
318 $JAVA_HOME/lib/security/trusted.jssecerts (Possible: in‐
319 clude an absolute path to a file or directory)
320 deployment.user.cachedir
322 $XDG_CACHE_HOME/icedtea-web/cache (Possible: include an ab‐
323 solute path to a file or directory)
324 deployment.user.locksdir
326 $TMP/$USER/netx/locks (Possible: include an absolute path
327 to a file or directory)
328 deployment.user.logdir
330 $XDG_CONFIG_HOME/icedtea-web/log (Possible: include an ab‐
331 solute path to a file or directory)
332 deployment.user.pcachedir
334 $XDG_CACHE_HOME/icedtea-web/pcache (Possible: include an
335 absolute path to a file or directory)
336 deployment.user.runningfile
338 $TMP/$USER/netx/locks/netx_running (Possible: include an
339 absolute path to a file or directory)
340 deployment.user.security.policy
342 $XDG_CONFIG_HOME/icedtea-web/security/java.policy (Possi‐
343 ble: include any valid url (eg. http://icedtea.class‐
344 path.org/hg/))
345 deployment.user.security.trusted.cacerts
347 $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Pos‐
348 sible: include an absolute path to a file or directory)
349 deployment.user.security.trusted.certs
351 $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possi‐
352 ble: include an absolute path to a file or directory)
353 deployment.user.security.trusted.clientauthcerts
355 $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
356 (Possible: include an absolute path to a file or directory)
357 deployment.user.security.trusted.jssecacerts
359 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
360 (Possible: include an absolute path to a file or directory)
361 deployment.user.security.trusted.jssecerts
363 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
364 (Possible: include an absolute path to a file or directory)
365 deployment.user.tmp
367 $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an abso‐
368 lute path to a file or directory)
369
372 $JAVA_HOME/lib/deployment.config
373 java-global deployment properties file. May be affected by
374 deployment.jre.dir.
375 $XDG_CACHE_HOME/icedtea-web/cache
377 Contains cached runtime entries. Controlled by deploy‐
378 ment.user.cachedir
379 $XDG_CACHE_HOME/icedtea-web/cache/recently_used
382 Additional information about items in cache
383 $XDG_CACHE_HOME/icedtea-web/pcache
385 Contains saved application data. Controlled by deploy‐
386 ment.user.pcachedir
387 $XDG_CACHE_HOME/icedtea-web/tmp
390 Contains temporary runtime files. Controlled by deploy‐
391 ment.user.tmp
392 $XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
395 File responsible for various actions on applets and apps
396 based on their codebase based on users actions.
397 $XDG_CONFIG_HOME/icedtea-web/deployment.properties
399 Users main deployment properties file.
400 $XDG_CONFIG_HOME/icedtea-web/generated_jnlps
402 Location where jnlp files generated from html pages for
403 javaws applications desktop/menu launchers icons are stored
404 $XDG_CONFIG_HOME/icedtea-web/icons
406 Location where icons of javaws applications desktop/menu
407 launchers icons are stored
408 $XDG_CONFIG_HOME/icedtea-web/log
410 contains file-log files (if enabled), itw-cplugin-
411 date_time.log for native part of plugin, itw-javantx-
412 date_time.log for everything else. Controlled by deploy‐
413 ment.user.logdir
414 $XDG_DATA_HOME/applications/javaws
417 Subdirectory in users menus space, for placing custom menu
418 shortcuts.
419 {%WINDIR/Sun/Java or /etc/.java}/deployment/.appletTrustSettings
421 File responsible for various actions on applets and apps
422 based on their codebase based on admins actions.
423 {%WINDIR/Sun/Java or /etc/.java}/deployment/deployment.config
425 Global deployment config file.
426 Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are set as
429 ~/.config, ~/.cache and /tmp or /var/tmp if not set.
430
432 There aren't any known bugs. If you come across one, please file it at:
433 http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
434 http://icedtea.classpath.org/bugzilla
435 Please run in debug (-verbose switch or itw-settings setting or
437 ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that output
438 (best is from java console) with URL to jnlp or html file (or the
439 jnlp/html file or application itself) when filing out the bug report.
440
443 The following people have made contibutions to this project.
444 Please keep this list in alphabetical order.
445 Lillian Angel <langel@redhat.com>Andrew Azores <aazores@red‐
446 hat.com>Deepak Bhole <dbhole@redhat.com>Laurent Bourgès <bourges.lau‐
447 rent@gmail.com>Adam Buchta <adbuch7@gmail.com>Ricardo Martín Camarero
448 <rickyepoderi@yahoo.es>Marcin Cieslak <marcin.cieslak@gmail.com>Danesh
449 Dadachanji <ddadacha@redhat.com>Adam Domurad <adomurad@red‐
450 hat.com>Lukasz Dracz <ldracz@redhat.com>Thomas Fitzsimmons
451 <fitzsim@redhat.com>Olesya Gerasimenko <gammaray@basealt.ru>Michał
452 Górny <mgorny@gentoo.org>Mark Greenwood <mark@dcs.shef.ac.uk>Tereza
453 Hlavackova <hlavackova.tereza@gmail.com>Lars Herschke <lhersch@dss‐
454 gmbh.de>Peter Hatina <phatina@redhat.com>Andrew John Hughes
455 <ahughes@redhat.com>Jie Kang <jkang@redhat.com>Alex Kashchenko
456 <akashche@redhat.com>Matthias Klose <doko@ubuntu.com>Alexandr Kolouch
457 <skolnag@gmail.com>Jan Kmetko <jan.kmetko.ml@gmail.com>Francis Kung
458 <fkung@redhat.com>Denis Lila <dlila@redhat.com>DJ Lucas <dj@luca‐
459 sit.com>Omair Majid <omajid@redhat.com>Jon A. Maxwell
460 <jmaxwell@users.sourceforge.net>Thomas Meyer <thomas@m3y3r.de>Kurt
461 Miller <kurt@intricatesoftware.com>Saad Mohammad <smohammad@red‐
462 hat.com>Martin Olsson <martin@minimum.se>Stefan Ring <stefan@com‐
463 plang.tuwien.ac.at>Ville Skyttä <ville.skytta@iki.fi>Fridrich Strba
464 <fridrich.strba@suse.com>Andrew Su <asu@redhat.com>Joshua Sumali
465 <jsumali@redhat.com>Joel Tesdall <jtesdall@mapcon.com>Michal Vala
466 <mvala@redhat.com>Jiri Vanek <jvanek@redhat.com>Tomáš Votava <tomca‐
467 colca@gmail.com>Mark Wielaard <mark@klomp.org>Jacob Wisor <gitne@ex‐
468 cite.co.jp>Man Lung Wong <mwong@redhat.com>
469 This project also includes code from the following projects:
470 OpenJDK <http://openjdk.java.net/>
471 Netx <http://jnlp.sourceforge.net/netx/>
472
476 icedtea-web(1) javaws(1) icedtea-web-plugin(1) itweb-settings(1) poli‐
477 cyeditor(1) policytool(1) java(1)
478 http://icedtea.classpath.org/wiki/IcedTea-Web
480 http://icedtea.classpath.org/hg/icedtea-web
481icedtea-web (fedora-2.fc39-x86_64)20 Jul 2023 itweb-settings(1)