1itweb-settings(1)           General Commands Manual          itweb-settings(1)
2
3
4

NAME

6       itweb-settings  -  view  and modify settings for javaws and the browser
7       plugin
8
9

SYNOPSIS

11       itweb-settings
12       itweb-settings command arguments
13

DESCRIPTION

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

DESCRIPTION

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 de‐
36                   tailed help for this command.(No argument expected)
37
38       -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
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  value.(Ex‐
47                   pected 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

EXAMPLES

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.background.threads.count
75                   3 (Possible: are in range 1 to 16 (inclusive))
76
77       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
92       deployment.cache.jarcompression
93                   0 (Possible: are in range 0 to 10 (inclusive))
94
95       deployment.cache.max.size
96                   -1 (Possible: are in range -1 to 2,147,483,647 (inclusive))
97
98       deployment.console.startup.mode
99                   HIDE (Possible:  [DISABLE,  HIDE,  SHOW,  SHOW_PLUGIN_ONLY,
100                   SHOW_JAVAWS_ONLY])
101
102       deployment.enable.cache.fsync
103                   false (Possible: are true or false)
104
105       deployment.headless.ignore
106                   false (Possible: are true or false)
107
108       deployment.https.noenforce
109                   false (Possible: are true or false)
110
111       deployment.javapi.cache.enabled
112                   false (Possible: are true or false)
113
114       deployment.javaws.associations
115                   2 (Possible: are in range 0 to 3 (inclusive))
116
117       deployment.javaws.autodownload
118                   false (Possible: are true or false)
119
120       deployment.javaws.installURL
121                   null    (Possible:    include    any    valid    url   (eg.
122                   http://icedtea.classpath.org/hg/))
123
124       deployment.javaws.shortcut
125                   ASK_IF_HINTED   (Possible:    [ALWAYS,    ALWAYS_IF_HINTED,
126                   ASK_USER, ASK_IF_HINTED, NEVER])
127
128       deployment.javaws.update.timeout
129                   500 (Possible: are in range 0 to 10,000 (inclusive))
130
131       deployment.jnlpclassloader.strict
132                   true (Possible: are true or false)
133
134       deployment.jre.dir
135                   null
136
137       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
145       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
153       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
161       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
169       deployment.log
170                   false (Possible: are true or false)
171
172       deployment.log.file
173                   false (Possible: are true or false)
174
175       deployment.log.file.clientapp
176                   true (Possible: are true or false)
177
178       deployment.log.file.legacylog
179                   false (Possible: are true or false)
180
181       deployment.log.headers
182                   false (Possible: are true or false)
183
184       deployment.log.stdstreams
185                   true (Possible: are true or false)
186
187       deployment.log.system
188                   true (Possible: are true or false)
189
190       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
196       deployment.max.urls.download.indicator
197                   16 (Possible: are in range 1 to 1,024 (inclusive))
198
199       deployment.plugin.jvm.arguments
200                   null
201
202       deployment.proxy.auto.config.url
203                   null   (Possible:    include    any    valid    url    (eg.
204                   http://icedtea.classpath.org/hg/))
205
206       deployment.proxy.bypass.list
207                   null
208
209       deployment.proxy.bypass.local
210                   null
211
212       deployment.proxy.ftp.host
213                   null
214
215       deployment.proxy.ftp.port
216                   null
217
218       deployment.proxy.http.host
219                   null
220
221       deployment.proxy.http.port
222                   null
223
224       deployment.proxy.https.host
225                   null
226
227       deployment.proxy.https.port
228                   null
229
230       deployment.proxy.override.hosts
231                   null
232
233       deployment.proxy.same
234                   false (Possible: are true or false)
235
236       deployment.proxy.socks.host
237                   null
238
239       deployment.proxy.socks.port
240                   null
241
242       deployment.proxy.type
243                   3 (Possible: are in range -1 to 3 (inclusive))
244
245       deployment.security.askgrantdialog.notinca
246                   true (Possible: are true or false)
247
248       deployment.security.askgrantdialog.show
249                   true (Possible: are true or false)
250
251       deployment.security.expired.warning
252                   true (Possible: are true or false)
253
254       deployment.security.itw.ignorecertissues
255                   false (Possible: are true or false)
256
257       deployment.security.jsse.hostmismatch.warning
258                   true (Possible: are true or false)
259
260       deployment.security.level
261                   null  (Possible:  DENY_ALL  DENY_UNSIGNED  ASK_UNSIGNED AL‐
262                   LOW_UNSIGNED)
263
264       deployment.security.notinca.warning
265                   true (Possible: are true or false)
266
267       deployment.security.sandbox.awtwarningwindow
268                   true (Possible: are true or false)
269
270       deployment.security.sandbox.jnlp.enhanced
271                   true (Possible: are true or false)
272
273       deployment.security.trusted.policy
274                   null (Possible: include an absolute path to a file  or  di‐
275                   rectory)
276
277       deployment.small.size.override.height
278                   600 (Possible: are in range -9,999 to 9,999 (inclusive))
279
280       deployment.small.size.override.width
281                   800 (Possible: are in range -9,999 to 9,999 (inclusive))
282
283       deployment.small.size.treshold
284                   10 (Possible: are in range 0 to 1,000 (inclusive))
285
286       deployment.system.cachedir
287                   null  (Possible:  include an absolute path to a file or di‐
288                   rectory)
289
290       deployment.system.config
291                   null   (Possible:    include    any    valid    url    (eg.
292                   http://icedtea.classpath.org/hg/))
293
294       deployment.system.config.mandatory
295                   false (Possible: are true or false)
296
297       deployment.system.security.cacerts
298                   $JAVA_HOME/lib/security/cacerts (Possible: include an abso‐
299                   lute path to a file or directory)
300
301       deployment.system.security.jssecacerts
302                   $JAVA_HOME/lib/security/jssecacerts (Possible:  include  an
303                   absolute path to a file or directory)
304
305       deployment.system.security.policy
306                   null    (Possible:    include    any    valid    url   (eg.
307                   http://icedtea.classpath.org/hg/))
308
309       deployment.system.security.trusted.certs
310                   $JAVA_HOME/lib/security/trusted.certs (Possible: include an
311                   absolute path to a file or directory)
312
313       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
317       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
321       deployment.user.cachedir
322                   $XDG_CACHE_HOME/icedtea-web/cache (Possible: include an ab‐
323                   solute path to a file or directory)
324
325       deployment.user.locksdir
326                   $TMP/$USER/netx/locks (Possible: include an  absolute  path
327                   to a file or directory)
328
329       deployment.user.logdir
330                   $XDG_CONFIG_HOME/icedtea-web/log  (Possible: include an ab‐
331                   solute path to a file or directory)
332
333       deployment.user.pcachedir
334                   $XDG_CACHE_HOME/icedtea-web/pcache  (Possible:  include  an
335                   absolute path to a file or directory)
336
337       deployment.user.runningfile
338                   $TMP/$USER/netx/locks/netx_running  (Possible:  include  an
339                   absolute path to a file or directory)
340
341       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
346       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
350       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
354       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
358       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
362       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
366       deployment.user.tmp
367                   $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an abso‐
368                   lute path to a file or directory)
369
370

FILES

372       $JAVA_HOME/lib/deployment.config
373                   java-global deployment properties file. May be affected  by
374                   deployment.jre.dir.
375
376       $XDG_CACHE_HOME/icedtea-web/cache
377                   Contains  cached  runtime  entries.  Controlled  by deploy‐
378                   ment.user.cachedir
379
380
381       $XDG_CACHE_HOME/icedtea-web/cache/recently_used
382                   Additional information about items in cache
383
384       $XDG_CACHE_HOME/icedtea-web/pcache
385                   Contains saved  application  data.  Controlled  by  deploy‐
386                   ment.user.pcachedir
387
388
389       $XDG_CACHE_HOME/icedtea-web/tmp
390                   Contains  temporary  runtime  files.  Controlled by deploy‐
391                   ment.user.tmp
392
393
394       $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
398       $XDG_CONFIG_HOME/icedtea-web/deployment.properties
399                   Users main deployment properties file.
400
401       $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
405       $XDG_CONFIG_HOME/icedtea-web/icons
406                   Location where icons of  javaws  applications  desktop/menu
407                   launchers icons are stored
408
409       $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
415
416       $XDG_DATA_HOME/applications/javaws
417                   Subdirectory in users menus space, for placing custom  menu
418                   shortcuts.
419
420       {%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
424       {%WINDIR/Sun/Java or /etc/.java}/deployment/deployment.config
425                   Global deployment config file.
426
427
428       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

BUGS

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
436       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
441

AUTHOR

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
473
474

SEE ALSO

476       icedtea-web(1)  javaws(1) icedtea-web-plugin(1) itweb-settings(1) poli‐
477       cyeditor(1) policytool(1) java(1)
478
479       http://icedtea.classpath.org/wiki/IcedTea-Web
480       http://icedtea.classpath.org/hg/icedtea-web
481
482
483
484
485icedtea-web (fedora-2.fc39-x86_64)20 Jul 2023                itweb-settings(1)
Impressum