itweb-settings(1)

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
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  val‐
47                   ues.(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.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
86                   deployment.browser.path  property.   $BROWSER   environment
87                   variable  is  serving  same  purpose.  You  can use keyword
88                   INTERNAL-HTML to launch internal browser. But be warned, it
89                   is  terrible.  Use  ALWAYS-ASK  to enforce prompt each time
90                   instead 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.headless.ignore
103                   false (Possible: are true or false)
104
105       deployment.https.noenforce
106                   false (Possible: are true or false)
107
108       deployment.javapi.cache.enabled
109                   false (Possible: are true or false)
110
111       deployment.javaws.associations
112                   2 (Possible: are in range 0 to 3 (inclusive))
113
114       deployment.javaws.autodownload
115                   false (Possible: are true or false)
116
117       deployment.javaws.installURL
118                   null    (Possible:    include    any    valid    url   (eg.
119                   http://icedtea.classpath.org/hg/))
120
121       deployment.javaws.shortcut
122                   ASK_IF_HINTED   (Possible:    [ALWAYS,    ALWAYS_IF_HINTED,
123                   ASK_USER, ASK_IF_HINTED, NEVER])
124
125       deployment.javaws.update.timeout
126                   500 (Possible: are in range 0 to 10,000 (inclusive))
127
128       deployment.jnlpclassloader.strict
129                   true (Possible: are true or false)
130
131       deployment.jre.dir
132                   null
133
134       deployment.launcher.rust.bootcp.add
135                   null  (Possible: Rust native launchers only! CP and XBootCP
136                   properties are space separated members of bootcp/cp  to  be
137                   removed   or   added.   eg   `...cp.add=/usr/java/rhino.jar
138                   /usr/java/scary.jar` will add those two jars  to  cp.   Eg:
139                   `...bootcp.remove=rhino.jar  tagsoup.jar` will remove those
140                   two jars no meter of path. Removal is done first.)
141
142       deployment.launcher.rust.bootcp.remove
143                    (Possible: Rust native  launchers  only!  CP  and  XBootCP
144                   properties  are  space separated members of bootcp/cp to be
145                   removed   or   added.   eg   `...cp.add=/usr/java/rhino.jar
146                   /usr/java/scary.jar`  will  add  those two jars to cp.  Eg:
147                   `...bootcp.remove=rhino.jar tagsoup.jar` will remove  those
148                   two jars no meter of path. Removal is done first.)
149
150       deployment.launcher.rust.cp.add
151                    (Possible:  Rust  native  launchers  only!  CP and XBootCP
152                   properties are space separated members of bootcp/cp  to  be
153                   removed   or   added.   eg   `...cp.add=/usr/java/rhino.jar
154                   /usr/java/scary.jar` will add those two jars  to  cp.   Eg:
155                   `...bootcp.remove=rhino.jar  tagsoup.jar` will remove those
156                   two jars no meter of path. Removal is done first.)
157
158       deployment.launcher.rust.cp.remove
159                    (Possible: Rust native  launchers  only!  CP  and  XBootCP
160                   properties  are  space separated members of bootcp/cp to be
161                   removed   or   added.   eg   `...cp.add=/usr/java/rhino.jar
162                   /usr/java/scary.jar`  will  add  those two jars to cp.  Eg:
163                   `...bootcp.remove=rhino.jar tagsoup.jar` will remove  those
164                   two jars no meter of path. Removal is done first.)
165
166       deployment.log
167                   false (Possible: are true or false)
168
169       deployment.log.file
170                   false (Possible: are true or false)
171
172       deployment.log.file.clientapp
173                   true (Possible: are true or false)
174
175       deployment.log.file.legacylog
176                   false (Possible: are true or false)
177
178       deployment.log.headers
179                   false (Possible: are true or false)
180
181       deployment.log.stdstreams
182                   true (Possible: are true or false)
183
184       deployment.log.system
185                   true (Possible: are true or false)
186
187       deployment.manifest.attributes.check
188                   ALL  (Possible: (Values that can be used alone only): [ALL,
189                   NONE] (Values that can be used in combination separated  by
190                   the  delimiter  ","  with no space expected ): [ALAC, CODE‐
191                   BASE, ENTRYPOINT, PERMISSIONS, TRUSTED])
192
193       deployment.plugin.jvm.arguments
194                   null
195
196       deployment.proxy.auto.config.url
197                   null   (Possible:    include    any    valid    url    (eg.
198                   http://icedtea.classpath.org/hg/))
199
200       deployment.proxy.bypass.list
201                   null
202
203       deployment.proxy.bypass.local
204                   false (Possible: are true or false)
205
206       deployment.proxy.ftp.host
207                   null
208
209       deployment.proxy.ftp.port
210                   null (Possible: are in range 0 to 65,535 (inclusive))
211
212       deployment.proxy.http.host
213                   null
214
215       deployment.proxy.http.port
216                   null (Possible: are in range 0 to 65,535 (inclusive))
217
218       deployment.proxy.https.host
219                   null
220
221       deployment.proxy.https.port
222                   null (Possible: are in range 0 to 65,535 (inclusive))
223
224       deployment.proxy.override.hosts
225                   null
226
227       deployment.proxy.same
228                   false (Possible: are true or false)
229
230       deployment.proxy.socks.host
231                   null
232
233       deployment.proxy.socks.port
234                   null (Possible: are in range 0 to 65,535 (inclusive))
235
236       deployment.proxy.type
237                   4 (Possible: are in range -1 to 4 (inclusive))
238
239       deployment.security.askgrantdialog.notinca
240                   true (Possible: are true or false)
241
242       deployment.security.askgrantdialog.show
243                   true (Possible: are true or false)
244
245       deployment.security.expired.warning
246                   true (Possible: are true or false)
247
248       deployment.security.itw.ignorecertissues
249                   false (Possible: are true or false)
250
251       deployment.security.jsse.hostmismatch.warning
252                   true (Possible: are true or false)
253
254       deployment.security.level
255                   null   (Possible:   DENY_ALL   DENY_UNSIGNED   ASK_UNSIGNED
256                   ALLOW_UNSIGNED)
257
258       deployment.security.notinca.warning
259                   true (Possible: are true or false)
260
261       deployment.security.sandbox.awtwarningwindow
262                   true (Possible: are true or false)
263
264       deployment.security.sandbox.jnlp.enhanced
265                   true (Possible: are true or false)
266
267       deployment.security.trusted.policy
268                   null (Possible: include an  absolute  path  to  a  file  or
269                   directory)
270
271       deployment.security.whitelist
272                   null
273
274       deployment.small.size.override.height
275                   600 (Possible: are in range -9,999 to 9,999 (inclusive))
276
277       deployment.small.size.override.width
278                   800 (Possible: are in range -9,999 to 9,999 (inclusive))
279
280       deployment.small.size.threshold
281                   10 (Possible: are in range 0 to 1,000 (inclusive))
282
283       deployment.system.cachedir
284                   null  (Possible:  include  an  absolute  path  to a file or
285                   directory)
286
287       deployment.system.config
288                   null   (Possible:    include    any    valid    url    (eg.
289                   http://icedtea.classpath.org/hg/))
290
291       deployment.system.config.mandatory
292                   false (Possible: are true or false)
293
294       deployment.system.security.cacerts
295                   $JAVA_HOME/lib/security/cacerts (Possible: include an abso‐
296                   lute path to a file or directory)
297
298       deployment.system.security.jssecacerts
299                   $JAVA_HOME/lib/security/jssecacerts (Possible:  include  an
300                   absolute path to a file or directory)
301
302       deployment.system.security.policy
303                   null    (Possible:    include    any    valid    url   (eg.
304                   http://icedtea.classpath.org/hg/))
305
306       deployment.system.security.trusted.certs
307                   $JAVA_HOME/lib/security/trusted.certs (Possible: include an
308                   absolute path to a file or directory)
309
310       deployment.system.security.trusted.clientautcerts
311                   $JAVA_HOME/lib/security/trusted.clientcerts      (Possible:
312                   include an absolute path to a file or directory)
313
314       deployment.system.security.trusted.jssecerts
315                   $JAVA_HOME/lib/security/trusted.jssecerts        (Possible:
316                   include an absolute path to a file or directory)
317
318       deployment.user.cachedir
319                   $XDG_CACHE_HOME/icedtea-web/cache   (Possible:  include  an
320                   absolute path to a file or directory)
321
322       deployment.user.locksdir
323                   $TMP/$USER/netx/locks (Possible: include an  absolute  path
324                   to a file or directory)
325
326       deployment.user.logdir
327                   $XDG_CONFIG_HOME/icedtea-web/log   (Possible:   include  an
328                   absolute path to a file or directory)
329
330       deployment.user.pcachedir
331                   $XDG_CACHE_HOME/icedtea-web/pcache  (Possible:  include  an
332                   absolute path to a file or directory)
333
334       deployment.user.runningfile
335                   $TMP/$USER/netx/locks/netx_running  (Possible:  include  an
336                   absolute path to a file or directory)
337
338       deployment.user.security.policy
339                   $XDG_CONFIG_HOME/icedtea-web/security/java.policy   (Possi‐
340                   ble:  include  any  valid  url  (eg.  http://icedtea.class‐
341                   path.org/hg/))
342
343       deployment.user.security.trusted.cacerts
344                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Pos‐
345                   sible: include an absolute path to a file or directory)
346
347       deployment.user.security.trusted.certs
348                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possi‐
349                   ble: include an absolute path to a file or directory)
350
351       deployment.user.security.trusted.clientauthcerts
352                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
353                   (Possible: include an absolute path to a file or directory)
354
355       deployment.user.security.trusted.jssecacerts
356                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
357                   (Possible: include an absolute path to a file or directory)
358
359       deployment.user.security.trusted.jssecerts
360                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
361                   (Possible: include an absolute path to a file or directory)
362
363       deployment.user.tmp
364                   $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an abso‐
365                   lute path to a file or directory)
366
367

FILES

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

BUGS

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

AUTHOR

440       https://github.com/AdoptOpenJDK/icedtea-web/graphs/contributors
441
442