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
36 detailed help for this command.(No argument expected)
37 -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 -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
47 value.(Expected 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.browser.path
75 null (Possible: Set path to browser or any command launch‐
76 ing url. If not set, default browser is used. If default
77 browser is not available, you will be be prompted to pro‐
78 vide URL consumer. Eg: firefox, or (windows) rundll32
79 url.dll,FileProtocolHandler , microsoft-edge, (mac) safari,
80 xdg-open (linux) like commands. In headless mode you can
81 use wget, curl or lynx. It can be also javaws itself to
82 launch other jnlp. You can set yor custom browser via
83 deployment.browser.path property. $BROWSER environment
84 variable is serving same purpose. You can use keyword
85 INTERNAL-HTML to launch internal browser. But be warned, it
86 is terrible. Use ALWAYS-ASK to enforce prompt each time
87 instead of using defaults.)
88 deployment.cache.jarcompression
90 0 (Possible: are in range 0 to 10 (inclusive))
91 deployment.cache.max.size
93 -1 (Possible: are in range -1 to 2,147,483,647 (inclusive))
94 deployment.console.startup.mode
96 HIDE (Possible: [DISABLE, HIDE, SHOW, SHOW_PLUGIN_ONLY,
97 SHOW_JAVAWS_ONLY])
98 deployment.headless.ignore
100 false (Possible: are true or false)
101 deployment.https.noenforce
103 false (Possible: are true or false)
104 deployment.javapi.cache.enabled
106 false (Possible: are true or false)
107 deployment.javaws.associations
109 2 (Possible: are in range 0 to 3 (inclusive))
110 deployment.javaws.autodownload
112 false (Possible: are true or false)
113 deployment.javaws.installURL
115 null (Possible: include any valid url (eg.
116 http://icedtea.classpath.org/hg/))
117 deployment.javaws.shortcut
119 ASK_IF_HINTED (Possible: [ALWAYS, ALWAYS_IF_HINTED,
120 ASK_USER, ASK_IF_HINTED, NEVER])
121 deployment.javaws.update.timeout
123 500 (Possible: are in range 0 to 10,000 (inclusive))
124 deployment.jnlpclassloader.strict
126 true (Possible: are true or false)
127 deployment.jre.dir
129 null
130 deployment.launcher.rust.bootcp.add
132 null (Possible: Rust native launchers only! CP and XBootCP
133 properties are space separated members of bootcp/cp to be
134 removed or added. eg `...cp.add=/usr/java/rhino.jar
135 /usr/java/scary.jar` will add those two jars to cp. Eg:
136 `...bootcp.remove=rhino.jar tagsoup.jar` will remove those
137 two jars no meter of path. Removal is done first.)
138 deployment.launcher.rust.bootcp.remove
140 (Possible: Rust native launchers only! CP and XBootCP
141 properties are space separated members of bootcp/cp to be
142 removed or added. eg `...cp.add=/usr/java/rhino.jar
143 /usr/java/scary.jar` will add those two jars to cp. Eg:
144 `...bootcp.remove=rhino.jar tagsoup.jar` will remove those
145 two jars no meter of path. Removal is done first.)
146 deployment.launcher.rust.cp.add
148 (Possible: Rust native launchers only! CP and XBootCP
149 properties are space separated members of bootcp/cp to be
150 removed or added. eg `...cp.add=/usr/java/rhino.jar
151 /usr/java/scary.jar` will add those two jars to cp. Eg:
152 `...bootcp.remove=rhino.jar tagsoup.jar` will remove those
153 two jars no meter of path. Removal is done first.)
154 deployment.launcher.rust.cp.remove
156 (Possible: Rust native launchers only! CP and XBootCP
157 properties are space separated members of bootcp/cp to be
158 removed or added. eg `...cp.add=/usr/java/rhino.jar
159 /usr/java/scary.jar` will add those two jars to cp. Eg:
160 `...bootcp.remove=rhino.jar tagsoup.jar` will remove those
161 two jars no meter of path. Removal is done first.)
162 deployment.log
164 false (Possible: are true or false)
165 deployment.log.file
167 false (Possible: are true or false)
168 deployment.log.file.clientapp
170 true (Possible: are true or false)
171 deployment.log.file.legacylog
173 false (Possible: are true or false)
174 deployment.log.headers
176 false (Possible: are true or false)
177 deployment.log.stdstreams
179 true (Possible: are true or false)
180 deployment.log.system
182 true (Possible: are true or false)
183 deployment.manifest.attributes.check
185 ALL (Possible: (Values that can be used alone only): [ALL,
186 NONE] (Values that can be used in combination separated by
187 the delimiter "," with no space expected ): [ALAC, CODE‐
188 BASE, ENTRYPOINT, PERMISSIONS, TRUSTED])
189 deployment.plugin.jvm.arguments
191 null
192 deployment.proxy.auto.config.url
194 null (Possible: include any valid url (eg.
195 http://icedtea.classpath.org/hg/))
196 deployment.proxy.bypass.list
198 null
199 deployment.proxy.bypass.local
201 null
202 deployment.proxy.ftp.host
204 null
205 deployment.proxy.ftp.port
207 null
208 deployment.proxy.http.host
210 null
211 deployment.proxy.http.port
213 null
214 deployment.proxy.https.host
216 null
217 deployment.proxy.https.port
219 null
220 deployment.proxy.override.hosts
222 null
223 deployment.proxy.same
225 false (Possible: are true or false)
226 deployment.proxy.socks.host
228 null
229 deployment.proxy.socks.port
231 null
232 deployment.proxy.type
234 3 (Possible: are in range -1 to 3 (inclusive))
235 deployment.security.askgrantdialog.notinca
237 true (Possible: are true or false)
238 deployment.security.askgrantdialog.show
240 true (Possible: are true or false)
241 deployment.security.expired.warning
243 true (Possible: are true or false)
244 deployment.security.itw.ignorecertissues
246 false (Possible: are true or false)
247 deployment.security.jsse.hostmismatch.warning
249 true (Possible: are true or false)
250 deployment.security.level
252 null (Possible: DENY_ALL DENY_UNSIGNED ASK_UNSIGNED
253 ALLOW_UNSIGNED)
254 deployment.security.notinca.warning
256 true (Possible: are true or false)
257 deployment.security.sandbox.awtwarningwindow
259 true (Possible: are true or false)
260 deployment.security.sandbox.jnlp.enhanced
262 true (Possible: are true or false)
263 deployment.security.trusted.policy
265 null (Possible: include an absolute path to a file or
266 directory)
267 deployment.small.size.override.height
269 600 (Possible: are in range -9,999 to 9,999 (inclusive))
270 deployment.small.size.override.width
272 800 (Possible: are in range -9,999 to 9,999 (inclusive))
273 deployment.small.size.treshold
275 10 (Possible: are in range 0 to 1,000 (inclusive))
276 deployment.system.cachedir
278 null (Possible: include an absolute path to a file or
279 directory)
280 deployment.system.config
282 null (Possible: include any valid url (eg.
283 http://icedtea.classpath.org/hg/))
284 deployment.system.config.mandatory
286 false (Possible: are true or false)
287 deployment.system.security.cacerts
289 $JAVA_HOME/lib/security/cacerts (Possible: include an abso‐
290 lute path to a file or directory)
291 deployment.system.security.jssecacerts
293 $JAVA_HOME/lib/security/jssecacerts (Possible: include an
294 absolute path to a file or directory)
295 deployment.system.security.policy
297 null (Possible: include any valid url (eg.
298 http://icedtea.classpath.org/hg/))
299 deployment.system.security.trusted.certs
301 $JAVA_HOME/lib/security/trusted.certs (Possible: include an
302 absolute path to a file or directory)
303 deployment.system.security.trusted.clientautcerts
305 $JAVA_HOME/lib/security/trusted.clientcerts (Possible:
306 include an absolute path to a file or directory)
307 deployment.system.security.trusted.jssecerts
309 $JAVA_HOME/lib/security/trusted.jssecerts (Possible:
310 include an absolute path to a file or directory)
311 deployment.user.cachedir
313 $XDG_CACHE_HOME/icedtea-web/cache (Possible: include an
314 absolute path to a file or directory)
315 deployment.user.locksdir
317 $TMP/$USER/netx/locks (Possible: include an absolute path
318 to a file or directory)
319 deployment.user.logdir
321 $XDG_CONFIG_HOME/icedtea-web/log (Possible: include an
322 absolute path to a file or directory)
323 deployment.user.pcachedir
325 $XDG_CACHE_HOME/icedtea-web/pcache (Possible: include an
326 absolute path to a file or directory)
327 deployment.user.runningfile
329 $TMP/$USER/netx/locks/netx_running (Possible: include an
330 absolute path to a file or directory)
331 deployment.user.security.policy
333 $XDG_CONFIG_HOME/icedtea-web/security/java.policy (Possi‐
334 ble: include any valid url (eg. http://icedtea.class‐
335 path.org/hg/))
336 deployment.user.security.trusted.cacerts
338 $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Pos‐
339 sible: include an absolute path to a file or directory)
340 deployment.user.security.trusted.certs
342 $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possi‐
343 ble: include an absolute path to a file or directory)
344 deployment.user.security.trusted.clientauthcerts
346 $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
347 (Possible: include an absolute path to a file or directory)
348 deployment.user.security.trusted.jssecacerts
350 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
351 (Possible: include an absolute path to a file or directory)
352 deployment.user.security.trusted.jssecerts
354 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
355 (Possible: include an absolute path to a file or directory)
356 deployment.user.tmp
358 $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an abso‐
359 lute path to a file or directory)
360
363 $JAVA_HOME/lib/deployment.config
364 java-global deployment properties file. May be affected by
365 deployment.jre.dir.
366 $XDG_CACHE_HOME/icedtea-web/cache
368 Contains cached runtime entries. Controlled by deploy‐
369 ment.user.cachedir
370 $XDG_CACHE_HOME/icedtea-web/cache/recently_used
373 Additional information about items in cache
374 $XDG_CACHE_HOME/icedtea-web/pcache
376 Contains saved application data. Controlled by deploy‐
377 ment.user.pcachedir
378 $XDG_CACHE_HOME/icedtea-web/tmp
381 Contains temporary runtime files. Controlled by deploy‐
382 ment.user.tmp
383 $XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
386 File responsible for various actions on applets and apps
387 based on their codebase based on users actions.
388 $XDG_CONFIG_HOME/icedtea-web/deployment.properties
390 Users main deployment properties file.
391 $XDG_CONFIG_HOME/icedtea-web/generated_jnlps
393 Location where jnlp files generated from html pages for
394 javaws applications desktop/menu launchers icons are stored
395 $XDG_CONFIG_HOME/icedtea-web/icons
397 Location where icons of javaws applications desktop/menu
398 launchers icons are stored
399 $XDG_CONFIG_HOME/icedtea-web/log
401 contains file-log files (if enabled), itw-cplugin-
402 date_time.log for native part of plugin, itw-javantx-
403 date_time.log for everything else. Controlled by deploy‐
404 ment.user.logdir
405 $XDG_DATA_HOME/applications/javaws
408 Subdirectory in users menus space, for placing custom menu
409 shortcuts.
410 {%WINDIR/Sun/Java or /etc/.java}/deployment/.appletTrustSettings
412 File responsible for various actions on applets and apps
413 based on their codebase based on admins actions.
414 {%WINDIR/Sun/Java or /etc/.java}/deployment/deployment.config
416 Global deployment config file.
417 Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are set as
420 ~/.config, ~/.cache and /tmp or /var/tmp if not set.
421
423 There aren't any known bugs. If you come across one, please file it at:
424 http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
425 http://icedtea.classpath.org/bugzilla
426 Please run in debug (-verbose switch or itw-settings setting or
428 ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that output
429 (best is from java console) with URL to jnlp or html file (or the
430 jnlp/html file or application itself) when filing out the bug report.
431
434 The following people have made contibutions to this project.
435 Please keep this list in alphabetical order.
436 Lillian Angel <langel@redhat.com>Andrew Azores <aazores@red‐
437 hat.com>Deepak Bhole <dbhole@redhat.com>Laurent Bourgès <bourges.lau‐
438 rent@gmail.com>Adam Buchta <adbuch7@gmail.com>Ricardo Martín Camarero
439 <rickyepoderi@yahoo.es>Marcin Cieslak <marcin.cieslak@gmail.com>Danesh
440 Dadachanji <ddadacha@redhat.com>Adam Domurad <adomurad@red‐
441 hat.com>Lukasz Dracz <ldracz@redhat.com>Thomas Fitzsimmons
442 <fitzsim@redhat.com>Olesya Gerasimenko <gammaray@basealt.ru>Michał
443 Górny <mgorny@gentoo.org>Mark Greenwood <mark@dcs.shef.ac.uk>Tereza
444 Hlavackova <hlavackova.tereza@gmail.com>Lars Herschke <lhersch@dss‐
445 gmbh.de>Peter Hatina <phatina@redhat.com>Andrew John Hughes
446 <ahughes@redhat.com>Jie Kang <jkang@redhat.com>Alex Kashchenko
447 <akashche@redhat.com>Matthias Klose <doko@ubuntu.com>Alexandr Kolouch
448 <skolnag@gmail.com>Jan Kmetko <jan.kmetko.ml@gmail.com>Francis Kung
449 <fkung@redhat.com>Denis Lila <dlila@redhat.com>DJ Lucas <dj@luca‐
450 sit.com>Omair Majid <omajid@redhat.com>Jon A. Maxwell
451 <jmaxwell@users.sourceforge.net>Thomas Meyer <thomas@m3y3r.de>Kurt
452 Miller <kurt@intricatesoftware.com>Saad Mohammad <smohammad@red‐
453 hat.com>Martin Olsson <martin@minimum.se>Stefan Ring <stefan@com‐
454 plang.tuwien.ac.at>Ville Skyttä <ville.skytta@iki.fi>Fridrich Strba
455 <fridrich.strba@suse.com>Andrew Su <asu@redhat.com>Joshua Sumali
456 <jsumali@redhat.com>Joel Tesdall <jtesdall@mapcon.com>Michal Vala
457 <mvala@redhat.com>Jiri Vanek <jvanek@redhat.com>Tomáš Votava <tomca‐
458 colca@gmail.com>Mark Wielaard <mark@klomp.org>Jacob Wisor
459 <gitne@excite.co.jp>Man Lung Wong <mwong@redhat.com>
460 This project also includes code from the following projects:
461 OpenJDK <http://openjdk.java.net/>
462 Netx <http://jnlp.sourceforge.net/netx/>
463
467 icedtea-web(1) javaws(1) icedtea-web-plugin(1) itweb-settings(1) poli‐
468 cyeditor(1) policytool(1) java(1)
469 http://icedtea.classpath.org/wiki/IcedTea-Web
471 http://icedtea.classpath.org/hg/icedtea-web
472icedtea-web (fedora-3.fc31-x86_64)31 Jul 2019 itweb-settings(1)