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

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

FILES

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

BUGS

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
427       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
432

AUTHOR

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
464
465

SEE ALSO

467       icedtea-web(1)  javaws(1) icedtea-web-plugin(1) itweb-settings(1) poli‐
468       cyeditor(1) policytool(1) java(1)
469
470       http://icedtea.classpath.org/wiki/IcedTea-Web
471       http://icedtea.classpath.org/hg/icedtea-web
472
473
474
475
476icedtea-web (fedora-3.fc31-x86_64)31 Jul 2019                itweb-settings(1)
Impressum