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      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 a 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 values.(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.assumeFileSystemInCodebase
75                   false (Possible: are true or false)
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.cache.parallelDownloadCount
99                   6 (Possible: are in range 1 to 24 (inclusive))
100
101       deployment.console.startup.mode
102                   HIDE (Possible:  [DISABLE,  HIDE,  SHOW,  SHOW_PLUGIN_ONLY,
103                   SHOW_JAVAWS_ONLY])
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.jvm.arguments.whitelist
138                   null
139
140       deployment.launcher.rust.bootcp.add
141                   null  (Possible: Rust native launchers only! CP and XBootCP
142                   properties are space separated members of bootcp/cp  to  be
143                   removed   or   added.   eg   `...cp.add=/usr/java/rhino.jar
144                   /usr/java/scary.jar` will add those two jars  to  cp.   Eg:
145                   `...bootcp.remove=rhino.jar  tagsoup.jar` will remove those
146                   two jars no meter of path. Removal is done first.)
147
148       deployment.launcher.rust.bootcp.remove
149                    (Possible: Rust native  launchers  only!  CP  and  XBootCP
150                   properties  are  space separated members of bootcp/cp to be
151                   removed   or   added.   eg   `...cp.add=/usr/java/rhino.jar
152                   /usr/java/scary.jar`  will  add  those two jars to cp.  Eg:
153                   `...bootcp.remove=rhino.jar tagsoup.jar` will remove  those
154                   two jars no meter of path. Removal is done first.)
155
156       deployment.launcher.rust.cp.add
157                    (Possible:  Rust  native  launchers  only!  CP and XBootCP
158                   properties are space separated members of bootcp/cp  to  be
159                   removed   or   added.   eg   `...cp.add=/usr/java/rhino.jar
160                   /usr/java/scary.jar` will add those two jars  to  cp.   Eg:
161                   `...bootcp.remove=rhino.jar  tagsoup.jar` will remove those
162                   two jars no meter of path. Removal is done first.)
163
164       deployment.launcher.rust.cp.remove
165                    (Possible: Rust native  launchers  only!  CP  and  XBootCP
166                   properties  are  space separated members of bootcp/cp to be
167                   removed   or   added.   eg   `...cp.add=/usr/java/rhino.jar
168                   /usr/java/scary.jar`  will  add  those two jars to cp.  Eg:
169                   `...bootcp.remove=rhino.jar tagsoup.jar` will remove  those
170                   two jars no meter of path. Removal is done first.)
171
172       deployment.log
173                   false (Possible: are true or false)
174
175       deployment.log.file
176                   false (Possible: are true or false)
177
178       deployment.log.file.clientapp
179                   true (Possible: are true or false)
180
181       deployment.log.file.legacylog
182                   false (Possible: are true or false)
183
184       deployment.log.headers
185                   false (Possible: are true or false)
186
187       deployment.log.stdstreams
188                   true (Possible: are true or false)
189
190       deployment.log.system
191                   true (Possible: are true or false)
192
193       deployment.manifest.attributes.check
194                   ALL  (Possible: (Values that can be used alone only): [ALL,
195                   NONE] (Values that can be used in combination separated  by
196                   the  delimiter  ","  with no space expected ): [ALAC, CODE‐
197                   BASE, ENTRYPOINT, PERMISSIONS, TRUSTED])
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                   false (Possible: are true or false)
211
212       deployment.proxy.ftp.host
213                   null
214
215       deployment.proxy.ftp.port
216                   null (Possible: are in range 0 to 65,535 (inclusive))
217
218       deployment.proxy.http.host
219                   null
220
221       deployment.proxy.http.port
222                   null (Possible: are in range 0 to 65,535 (inclusive))
223
224       deployment.proxy.https.host
225                   null
226
227       deployment.proxy.https.port
228                   null (Possible: are in range 0 to 65,535 (inclusive))
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 (Possible: are in range 0 to 65,535 (inclusive))
241
242       deployment.proxy.type
243                   4 (Possible: are in range -1 to 4 (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.security.whitelist
278                   null
279
280       deployment.small.size.override.height
281                   600 (Possible: are in range -9,999 to 9,999 (inclusive))
282
283       deployment.small.size.override.width
284                   800 (Possible: are in range -9,999 to 9,999 (inclusive))
285
286       deployment.small.size.threshold
287                   10 (Possible: are in range 0 to 1,000 (inclusive))
288
289       deployment.system.cachedir
290                   null  (Possible:  include an absolute path to a file or di‐
291                   rectory)
292
293       deployment.system.config
294                   null   (Possible:    include    any    valid    url    (eg.
295                   http://icedtea.classpath.org/hg/))
296
297       deployment.system.config.mandatory
298                   false (Possible: are true or false)
299
300       deployment.system.security.cacerts
301                   $JAVA_HOME/lib/security/cacerts (Possible: include an abso‐
302                   lute path to a file or directory)
303
304       deployment.system.security.jssecacerts
305                   $JAVA_HOME/lib/security/jssecacerts (Possible:  include  an
306                   absolute path to a file or directory)
307
308       deployment.system.security.policy
309                   null    (Possible:    include    any    valid    url   (eg.
310                   http://icedtea.classpath.org/hg/))
311
312       deployment.system.security.trusted.certs
313                   $JAVA_HOME/lib/security/trusted.certs (Possible: include an
314                   absolute path to a file or directory)
315
316       deployment.system.security.trusted.clientautcerts
317                   $JAVA_HOME/lib/security/trusted.clientcerts  (Possible: in‐
318                   clude an absolute path to a file or directory)
319
320       deployment.system.security.trusted.jssecerts
321                   $JAVA_HOME/lib/security/trusted.jssecerts  (Possible:   in‐
322                   clude an absolute path to a file or directory)
323
324       deployment.user.cachedir
325                   $XDG_CACHE_HOME/icedtea-web/cache (Possible: include an ab‐
326                   solute path to a file or directory)
327
328       deployment.user.locksdir
329                   $TMP/$USER/netx/locks (Possible: include an  absolute  path
330                   to a file or directory)
331
332       deployment.user.logdir
333                   $XDG_CONFIG_HOME/icedtea-web/log  (Possible: include an ab‐
334                   solute path to a file or directory)
335
336       deployment.user.pcachedir
337                   $XDG_CACHE_HOME/icedtea-web/pcache  (Possible:  include  an
338                   absolute path to a file or directory)
339
340       deployment.user.runningfile
341                   $TMP/$USER/netx/locks/netx_running  (Possible:  include  an
342                   absolute path to a file or directory)
343
344       deployment.user.security.policy
345                   $XDG_CONFIG_HOME/icedtea-web/security/java.policy   (Possi‐
346                   ble:  include  any  valid  url  (eg.  http://icedtea.class
347                   path.org/hg/))
348
349       deployment.user.security.trusted.cacerts
350                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Pos‐
351                   sible: include an absolute path to a file or directory)
352
353       deployment.user.security.trusted.certs
354                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possi‐
355                   ble: include an absolute path to a file or directory)
356
357       deployment.user.security.trusted.clientauthcerts
358                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
359                   (Possible: include an absolute path to a file or directory)
360
361       deployment.user.security.trusted.jssecacerts
362                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
363                   (Possible: include an absolute path to a file or directory)
364
365       deployment.user.security.trusted.jssecerts
366                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
367                   (Possible: include an absolute path to a file or directory)
368
369       deployment.user.tmp
370                   $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an abso‐
371                   lute path to a file or directory)
372
373

FILES

375       $JAVA_HOME/lib/deployment.config
376                   JVM-global deployment properties file. May be  affected  by
377                   deployment.jre.dir.
378
379       $XDG_CACHE_HOME/icedtea-web/cache
380                   Contains  cached  runtime  entries.  Controlled  by deploy‐
381                   ment.user.cachedir
382
383
384       $XDG_CACHE_HOME/icedtea-web/cache/recently_used
385                   Additional information about items in cache
386
387       $XDG_CACHE_HOME/icedtea-web/pcache
388                   Contains saved  application  data.  Controlled  by  deploy‐
389                   ment.user.pcachedir
390
391
392       $XDG_CACHE_HOME/icedtea-web/tmp
393                   Contains  temporary  runtime  files.  Controlled by deploy‐
394                   ment.user.tmp
395
396
397       $XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
398                   File responsible for various actions on  applets  and  apps
399                   based on their codebase based on users actions.
400
401       $XDG_CONFIG_HOME/icedtea-web/deployment.properties
402                   Users main deployment properties file.
403
404       $XDG_CONFIG_HOME/icedtea-web/generated_jnlps
405                   Location  where  jnlp  files  generated from html pages for
406                   javaws applications desktop/menu launchers icons are stored
407
408       $XDG_CONFIG_HOME/icedtea-web/icons
409                   Location where icons of  javaws  applications  desktop/menu
410                   launchers icons are stored
411
412       $XDG_CONFIG_HOME/icedtea-web/log
413                   contains   file-log   files   (if   enabled),  itw-cplugin-
414                   date_time.log  for  native  part  of  plugin,  itw-javantx-
415                   date_time.log  for  everything  else. Controlled by deploy‐
416                   ment.user.logdir
417
418
419       $XDG_DATA_HOME/applications/javaws
420                   Subdirectory in users menus space, for placing custom  menu
421                   shortcuts.
422
423       {%WINDIR/Sun/Java or /etc/.java}/deployment/.appletTrustSettings
424                   File  responsible  for  various actions on applets and apps
425                   based on their codebase based on admins actions.
426
427       {%WINDIR/Sun/Java or /etc/.java}/deployment/deployment.config
428                   Global deployment config file.
429
430
431       Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are  set  as
432       ~/.config, ~/.cache and /tmp or /var/tmp if not set.
433

BUGS

435       There aren't any known bugs. If you come across one, please file it at:
436       http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
437       https://github.com/AdoptOpenJDK/icedtea-web/issues
438
439       Please  run  in  debug  (-verbose  switch  or  itw-settings  setting or
440       ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that  output
441       (best  is  from  the  console)  with  URL  to jnlp or html file (or the
442       jnlp/html file or  application itself) when filling out the bug report.
443
444

AUTHOR

446       https://github.com/AdoptOpenJDK/icedtea-web/graphs/contributors
447
448

SEE ALSO

450       icedtea-web(1) javaws(1) icedtea-web-plugin(1) itweb-settings(1)  poli‐
451       cyeditor(1) policytool(1) java(1)
452
453       https://github.com/AdoptOpenJDK/icedtea-web
454       https://github.com/AdoptOpenJDK/icedtea-web.git
455
456
457
458
459icedtea-web 2.0.0-alpha16         19 Oct 2021                itweb-settings(1)
Impressum