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: include an absolute path to a file or
76 directory)
77 deployment.cache.jarcompression
79 0 (Possible: are in range 0 to 10 (inclusive))
80 deployment.cache.max.size
82 -1 (Possible: are in range -1 to 2,147,483,647 (inclusive))
83 deployment.console.startup.mode
85 HIDE (Possible: [DISABLE, HIDE, SHOW, SHOW_PLUGIN_ONLY,
86 SHOW_JAVAWS_ONLY])
87 deployment.headless.ignore
89 false (Possible: are true or false)
90 deployment.https.noenforce
92 false (Possible: are true or false)
93 deployment.javapi.cache.enabled
95 false (Possible: are true or false)
96 deployment.javaws.associations
98 2 (Possible: are in range 0 to 3 (inclusive))
99 deployment.javaws.autodownload
101 false (Possible: are true or false)
102 deployment.javaws.installURL
104 null (Possible: include any valid url (eg.
105 http://icedtea.classpath.org/hg/))
106 deployment.javaws.shortcut
108 ASK_IF_HINTED (Possible: [ALWAYS, ALWAYS_IF_HINTED,
109 ASK_USER, ASK_IF_HINTED, NEVER])
110 deployment.javaws.update.timeout
112 500 (Possible: are in range 0 to 10,000 (inclusive))
113 deployment.jnlpclassloader.strict
115 true (Possible: are true or false)
116 deployment.jre.dir
118 null
119 deployment.log
121 false (Possible: are true or false)
122 deployment.log.file
124 false (Possible: are true or false)
125 deployment.log.file.clientapp
127 true (Possible: are true or false)
128 deployment.log.file.legacylog
130 false (Possible: are true or false)
131 deployment.log.headers
133 false (Possible: are true or false)
134 deployment.log.stdstreams
136 true (Possible: are true or false)
137 deployment.log.system
139 true (Possible: are true or false)
140 deployment.manifest.attributes.check
142 ALL (Possible: (Values that can be used alone only): [ALL,
143 NONE] (Values that can be used in combination separated by
144 the delimiter "," with no space expected ): [ALAC, CODE‐
145 BASE, ENTRYPOINT, PERMISSIONS, TRUSTED])
146 deployment.plugin.jvm.arguments
148 null
149 deployment.proxy.auto.config.url
151 null (Possible: include any valid url (eg.
152 http://icedtea.classpath.org/hg/))
153 deployment.proxy.bypass.list
155 null
156 deployment.proxy.bypass.local
158 null
159 deployment.proxy.ftp.host
161 null
162 deployment.proxy.ftp.port
164 null
165 deployment.proxy.http.host
167 null
168 deployment.proxy.http.port
170 null
171 deployment.proxy.https.host
173 null
174 deployment.proxy.https.port
176 null
177 deployment.proxy.override.hosts
179 null
180 deployment.proxy.same
182 false (Possible: are true or false)
183 deployment.proxy.socks.host
185 null
186 deployment.proxy.socks.port
188 null
189 deployment.proxy.type
191 3 (Possible: are in range -1 to 3 (inclusive))
192 deployment.security.askgrantdialog.notinca
194 true (Possible: are true or false)
195 deployment.security.askgrantdialog.show
197 true (Possible: are true or false)
198 deployment.security.expired.warning
200 true (Possible: are true or false)
201 deployment.security.itw.ignorecertissues
203 false (Possible: are true or false)
204 deployment.security.jsse.hostmismatch.warning
206 true (Possible: are true or false)
207 deployment.security.level
209 null (Possible: DENY_ALL DENY_UNSIGNED ASK_UNSIGNED
210 ALLOW_UNSIGNED)
211 deployment.security.notinca.warning
213 true (Possible: are true or false)
214 deployment.security.sandbox.awtwarningwindow
216 true (Possible: are true or false)
217 deployment.security.sandbox.jnlp.enhanced
219 true (Possible: are true or false)
220 deployment.security.trusted.policy
222 null (Possible: include an absolute path to a file or
223 directory)
224 deployment.system.cachedir
226 null (Possible: include an absolute path to a file or
227 directory)
228 deployment.system.security.cacerts
230 $JAVA_HOME/lib/security/cacerts (Possible: include an abso‐
231 lute path to a file or directory)
232 deployment.system.security.jssecacerts
234 $JAVA_HOME/lib/security/jssecacerts (Possible: include an
235 absolute path to a file or directory)
236 deployment.system.security.policy
238 null (Possible: include any valid url (eg.
239 http://icedtea.classpath.org/hg/))
240 deployment.system.security.trusted.certs
242 $JAVA_HOME/lib/security/trusted.certs (Possible: include an
243 absolute path to a file or directory)
244 deployment.system.security.trusted.clientautcerts
246 $JAVA_HOME/lib/security/trusted.clientcerts (Possible:
247 include an absolute path to a file or directory)
248 deployment.system.security.trusted.jssecerts
250 $JAVA_HOME/lib/security/trusted.jssecerts (Possible:
251 include an absolute path to a file or directory)
252 deployment.user.cachedir
254 $XDG_CACHE_HOME/icedtea-web/cache (Possible: include an
255 absolute path to a file or directory)
256 deployment.user.locksdir
258 $TMP/$USER/netx/locks (Possible: include an absolute path
259 to a file or directory)
260 deployment.user.logdir
262 $XDG_CONFIG_HOME/icedtea-web/log (Possible: include an
263 absolute path to a file or directory)
264 deployment.user.pcachedir
266 $XDG_CACHE_HOME/icedtea-web/pcache (Possible: include an
267 absolute path to a file or directory)
268 deployment.user.runningfile
270 $TMP/$USER/netx/locks/netx_running (Possible: include an
271 absolute path to a file or directory)
272 deployment.user.security.policy
274 $XDG_CONFIG_HOME/icedtea-web/security/java.policy (Possi‐
275 ble: include any valid url (eg. http://icedtea.class‐
276 path.org/hg/))
277 deployment.user.security.trusted.cacerts
279 $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Pos‐
280 sible: include an absolute path to a file or directory)
281 deployment.user.security.trusted.certs
283 $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possi‐
284 ble: include an absolute path to a file or directory)
285 deployment.user.security.trusted.clientauthcerts
287 $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
288 (Possible: include an absolute path to a file or directory)
289 deployment.user.security.trusted.jssecacerts
291 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
292 (Possible: include an absolute path to a file or directory)
293 deployment.user.security.trusted.jssecerts
295 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
296 (Possible: include an absolute path to a file or directory)
297 deployment.user.tmp
299 $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an abso‐
300 lute path to a file or directory)
301
304 $JAVA_HOME/lib/deployment.config
305 java-global deployment properties file. May be affected by
306 deployment.jre.dir.
307 $XDG_CACHE_HOME/icedtea-web/cache
309 Contains cached runtime entries. Controlled by deploy‐
310 ment.user.cachedir
311 $XDG_CACHE_HOME/icedtea-web/cache/recently_used
314 Additional information about items in cache
315 $XDG_CACHE_HOME/icedtea-web/pcache
317 Contains saved application data. Controlled by deploy‐
318 ment.user.pcachedir
319 $XDG_CACHE_HOME/icedtea-web/tmp
322 Contains temporary runtime files. Controlled by deploy‐
323 ment.user.tmp
324 $XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
327 File responsible for various actions on applets and apps
328 based on their codebase based on users actions.
329 $XDG_CONFIG_HOME/icedtea-web/deployment.properties
331 Users main deployment properties file.
332 $XDG_CONFIG_HOME/icedtea-web/generated_jnlps
334 Location where jnlp files generated from html pages for
335 javaws applications desktop/menu launchers icons are stored
336 $XDG_CONFIG_HOME/icedtea-web/icons
338 Location where icons of javaws applications desktop/menu
339 launchers icons are stored
340 $XDG_CONFIG_HOME/icedtea-web/log
342 contains file-log files (if enabled), itw-cplugin-
343 date_time.log for native part of plugin, itw-javantx-
344 date_time.log for everything else. Controlled by deploy‐
345 ment.user.logdir
346 $XDG_DATA_HOME/applications/javaws
349 Subdirectory in users menus space, for placing custom menu
350 shortcuts.
351 /etc/.java/deployment/.appletTrustSettings
353 File responsible for various actions on applets and apps
354 based on their codebase based on admins actions.
355 /etc/.java/deployment/deployment.config
357 Global deployment config file.
358 Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are set as
361 ~/.config, ~/.cache and /tmp or /var/tmp if not set.
362
364 There aren't any known bugs. If you come across one, please file it at:
365 http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
366 http://icedtea.classpath.org/bugzilla
367 Please run in debug (-verbose switch or itw-settings setting or
369 ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that output
370 (best is from java console) with URL to jnlp or html file (or the
371 jnlp/html file or application itself) when filing out the bug report.
372
375 The following people have made contibutions to this project.
376 Please keep this list in alphabetical order.
377 Lillian Angel <langel@redhat.com>Andrew Azores <aazores@red‐
378 hat.com>Deepak Bhole <dbhole@redhat.com>Adam Buchta
379 <adbuch7@gmail.com>Ricardo Martín Camarero <rickye‐
380 poderi@yahoo.es>Marcin Cieslak <marcin.cieslak@gmail.com>Danesh
381 Dadachanji <ddadacha@redhat.com>Adam Domurad <adomurad@red‐
382 hat.com>Lukasz Dracz <ldracz@redhat.com>Thomas Fitzsimmons
383 <fitzsim@redhat.com>Michał Górny <mgorny@gentoo.org>Mark Greenwood
384 <mark@dcs.shef.ac.uk>Tereza Hlavackova <hlavack‐
385 ova.tereza@gmail.com>Peter Hatina <phatina@redhat.com>Andrew John
386 Hughes <ahughes@redhat.com>Jie Kang <jkang@redhat.com>Alex Kashchenko
387 <akashche@redhat.com>Matthias Klose <doko@ubuntu.com>Alexandr Kolouch
388 <skolnag@gmail.com>Jan Kmetko <jan.kmetko.ml@gmail.com>Francis Kung
389 <fkung@redhat.com>Denis Lila <dlila@redhat.com>DJ Lucas <dj@luca‐
390 sit.com>Omair Majid <omajid@redhat.com>Jon A. Maxwell
391 <jmaxwell@users.sourceforge.net>Thomas Meyer <thomas@m3y3r.de>Kurt
392 Miller <kurt@intricatesoftware.com>Saad Mohammad <smohammad@red‐
393 hat.com>Martin Olsson <martin@minimum.se>Stefan Ring <stefan@com‐
394 plang.tuwien.ac.at>Ville Skyttä <ville.skytta@iki.fi>Fridrich Strba
395 <fridrich.strba@suse.com>Andrew Su <asu@redhat.com>Joshua Sumali
396 <jsumali@redhat.com>Michal Vala <mvala@redhat.com>Jiri Vanek
397 <jvanek@redhat.com>Tomáš Votava <tomcacolca@gmail.com>Mark Wielaard
398 <mark@klomp.org>Jacob Wisor <gitne@excite.co.jp>Man Lung Wong
399 <mwong@redhat.com>
400 This project also includes code from the following projects:
401 OpenJDK <http://openjdk.java.net/>
402 Netx <http://jnlp.sourceforge.net/netx/>
403
407 icedtea-web(1) javaws(1) icedtea-web-plugin(1) itweb-settings(1) poli‐
408 cyeditor(1) policytool(1) java(1)
409 http://icedtea.classpath.org/wiki/IcedTea-Web
411 http://icedtea.classpath.org/hg/icedtea-web
412icedtea-web (fedora-17.el8_0-noarch1)Oct 2019 itweb-settings(1)