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: include an  absolute  path  to  a  file  or
76                   directory)
77
78       deployment.cache.jarcompression
79                   0 (Possible: are in range 0 to 10 (inclusive))
80
81       deployment.cache.max.size
82                   -1 (Possible: are in range -1 to 2,147,483,647 (inclusive))
83
84       deployment.console.startup.mode
85                   HIDE  (Possible:  [DISABLE,  HIDE,  SHOW, SHOW_PLUGIN_ONLY,
86                   SHOW_JAVAWS_ONLY])
87
88       deployment.https.noenforce
89                   false (Possible: are true or false)
90
91       deployment.javapi.cache.enabled
92                   false (Possible: are true or false)
93
94       deployment.javaws.associations
95                   2 (Possible: are in range 0 to 3 (inclusive))
96
97       deployment.javaws.autodownload
98                   false (Possible: are true or false)
99
100       deployment.javaws.installURL
101                   null   (Possible:    include    any    valid    url    (eg.
102                   http://icedtea.classpath.org/hg/))
103
104       deployment.javaws.shortcut
105                   ASK_IF_HINTED    (Possible:    [ALWAYS,   ALWAYS_IF_HINTED,
106                   ASK_USER, ASK_IF_HINTED, NEVER])
107
108       deployment.javaws.update.timeout
109                   500 (Possible: are in range 0 to 10,000 (inclusive))
110
111       deployment.jnlpclassloader.strict
112                   true (Possible: are true or false)
113
114       deployment.jre.dir
115                   null
116
117       deployment.log
118                   false (Possible: are true or false)
119
120       deployment.log.file
121                   false (Possible: are true or false)
122
123       deployment.log.file.clientapp
124                   true (Possible: are true or false)
125
126       deployment.log.file.legacylog
127                   false (Possible: are true or false)
128
129       deployment.log.headers
130                   false (Possible: are true or false)
131
132       deployment.log.stdstreams
133                   true (Possible: are true or false)
134
135       deployment.log.system
136                   true (Possible: are true or false)
137
138       deployment.manifest.attributes.check
139                   ALL (Possible: (Values that can be used alone only):  [ALL,
140                   NONE]  (Values that can be used in combination separated by
141                   the delimiter "," with no space expected  ):  [ALAC,  CODE‐
142                   BASE, ENTRYPOINT, PERMISSIONS, TRUSTED])
143
144       deployment.plugin.jvm.arguments
145                   null
146
147       deployment.proxy.auto.config.url
148                   null    (Possible:    include    any    valid    url   (eg.
149                   http://icedtea.classpath.org/hg/))
150
151       deployment.proxy.bypass.list
152                   null
153
154       deployment.proxy.bypass.local
155                   null
156
157       deployment.proxy.ftp.host
158                   null
159
160       deployment.proxy.ftp.port
161                   null
162
163       deployment.proxy.http.host
164                   null
165
166       deployment.proxy.http.port
167                   null
168
169       deployment.proxy.https.host
170                   null
171
172       deployment.proxy.https.port
173                   null
174
175       deployment.proxy.override.hosts
176                   null
177
178       deployment.proxy.same
179                   false (Possible: are true or false)
180
181       deployment.proxy.socks.host
182                   null
183
184       deployment.proxy.socks.port
185                   null
186
187       deployment.proxy.type
188                   3 (Possible: are in range -1 to 3 (inclusive))
189
190       deployment.security.askgrantdialog.notinca
191                   true (Possible: are true or false)
192
193       deployment.security.askgrantdialog.show
194                   true (Possible: are true or false)
195
196       deployment.security.expired.warning
197                   true (Possible: are true or false)
198
199       deployment.security.itw.ignorecertissues
200                   false (Possible: are true or false)
201
202       deployment.security.jsse.hostmismatch.warning
203                   true (Possible: are true or false)
204
205       deployment.security.level
206                   null   (Possible:   DENY_ALL   DENY_UNSIGNED   ASK_UNSIGNED
207                   ALLOW_UNSIGNED)
208
209       deployment.security.notinca.warning
210                   true (Possible: are true or false)
211
212       deployment.security.sandbox.awtwarningwindow
213                   true (Possible: are true or false)
214
215       deployment.security.sandbox.jnlp.enhanced
216                   true (Possible: are true or false)
217
218       deployment.security.trusted.policy
219                   null  (Possible:  include  an  absolute  path  to a file or
220                   directory)
221
222       deployment.system.cachedir
223                   null (Possible: include an  absolute  path  to  a  file  or
224                   directory)
225
226       deployment.system.security.cacerts
227                   $JAVA_HOME/lib/security/cacerts (Possible: include an abso‐
228                   lute path to a file or directory)
229
230       deployment.system.security.jssecacerts
231                   $JAVA_HOME/lib/security/jssecacerts (Possible:  include  an
232                   absolute path to a file or directory)
233
234       deployment.system.security.policy
235                   null    (Possible:    include    any    valid    url   (eg.
236                   http://icedtea.classpath.org/hg/))
237
238       deployment.system.security.trusted.certs
239                   $JAVA_HOME/lib/security/trusted.certs (Possible: include an
240                   absolute path to a file or directory)
241
242       deployment.system.security.trusted.clientautcerts
243                   $JAVA_HOME/lib/security/trusted.clientcerts      (Possible:
244                   include an absolute path to a file or directory)
245
246       deployment.system.security.trusted.jssecerts
247                   $JAVA_HOME/lib/security/trusted.jssecerts        (Possible:
248                   include an absolute path to a file or directory)
249
250       deployment.user.cachedir
251                   $XDG_CACHE_HOME/icedtea-web/cache   (Possible:  include  an
252                   absolute path to a file or directory)
253
254       deployment.user.locksdir
255                   $TMP/$USER/netx/locks (Possible: include an  absolute  path
256                   to a file or directory)
257
258       deployment.user.logdir
259                   $XDG_CONFIG_HOME/icedtea-web/log   (Possible:   include  an
260                   absolute path to a file or directory)
261
262       deployment.user.pcachedir
263                   $XDG_CACHE_HOME/icedtea-web/pcache  (Possible:  include  an
264                   absolute path to a file or directory)
265
266       deployment.user.runningfile
267                   $TMP/$USER/netx/locks/netx_running  (Possible:  include  an
268                   absolute path to a file or directory)
269
270       deployment.user.security.policy
271                   $XDG_CONFIG_HOME/icedtea-web/security/java.policy   (Possi‐
272                   ble:  include  any  valid  url  (eg.  http://icedtea.class
273                   path.org/hg/))
274
275       deployment.user.security.trusted.cacerts
276                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Pos‐
277                   sible: include an absolute path to a file or directory)
278
279       deployment.user.security.trusted.certs
280                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possi‐
281                   ble: include an absolute path to a file or directory)
282
283       deployment.user.security.trusted.clientauthcerts
284                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
285                   (Possible: include an absolute path to a file or directory)
286
287       deployment.user.security.trusted.jssecacerts
288                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
289                   (Possible: include an absolute path to a file or directory)
290
291       deployment.user.security.trusted.jssecerts
292                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
293                   (Possible: include an absolute path to a file or directory)
294
295       deployment.user.tmp
296                   $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an abso‐
297                   lute path to a file or directory)
298
299

FILES

301       $JAVA_HOME/lib/deployment.config
302                   java-global deployment properties file. May be affected  by
303                   deployment.jre.dir.
304
305       $XDG_CACHE_HOME/icedtea-web/cache
306                   Contains  cached  runtime  entries.  Controlled  by deploy‐
307                   ment.user.cachedir
308
309
310       $XDG_CACHE_HOME/icedtea-web/cache/recently_used
311                   Additional information about items in cache
312
313       $XDG_CACHE_HOME/icedtea-web/pcache
314                   Contains saved  application  data.  Controlled  by  deploy‐
315                   ment.user.pcachedir
316
317
318       $XDG_CACHE_HOME/icedtea-web/tmp
319                   Contains  temporary  runtime  files.  Controlled by deploy‐
320                   ment.user.tmp
321
322
323       $XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
324                   File responsible for various actions on  applets  and  apps
325                   based on their codebase based on users actions.
326
327       $XDG_CONFIG_HOME/icedtea-web/deployment.properties
328                   Users main deployment properties file.
329
330       $XDG_CONFIG_HOME/icedtea-web/generated_jnlps
331                   Location  where  jnlp  files  generated from html pages for
332                   javaws applications desktop/menu launchers icons are stored
333
334       $XDG_CONFIG_HOME/icedtea-web/icons
335                   Location where icons of  javaws  applications  desktop/menu
336                   launchers icons are stored
337
338       $XDG_CONFIG_HOME/icedtea-web/log
339                   contains   file-log   files   (if   enabled),  itw-cplugin-
340                   date_time.log  for  native  part  of  plugin,  itw-javantx-
341                   date_time.log  for  everything  else. Controlled by deploy‐
342                   ment.user.logdir
343
344
345       $XDG_DATA_HOME/applications/javaws
346                   Subdirectory in users menus space, for placing custom  menu
347                   shortcuts.
348
349       /etc/.java/deployment/.appletTrustSettings
350                   File  responsible  for  various actions on applets and apps
351                   based on their codebase based on admins actions.
352
353       /etc/.java/deployment/deployment.config
354                   Global deployment config file.
355
356
357       Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are  set  as
358       ~/.config, ~/.cache and /tmp or /var/tmp if not set.
359

BUGS

361       There aren't any known bugs. If you come across one, please file it at:
362       http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
363       http://icedtea.classpath.org/bugzilla
364
365       Please  run  in  debug  (-verbose  switch  or  itw-settings  setting or
366       ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that  output
367       (best  is  from  java  console)  with  URL to jnlp or html file (or the
368       jnlp/html file or  application itself) when filing out the bug report.
369
370

AUTHOR

372       The following people have made contibutions to this project.
373       Please keep this list in alphabetical order.
374       Lillian   Angel    <langel@redhat.com>Andrew    Azores    <aazores@red‐
375       hat.com>Deepak        Bhole        <dbhole@redhat.com>Adam       Buchta
376       <adbuch7@gmail.com>Ricardo       Martín        Camarero        <rickye‐
377       poderi@yahoo.es>Marcin     Cieslak     <marcin.cieslak@gmail.com>Danesh
378       Dadachanji     <ddadacha@redhat.com>Adam     Domurad     <adomurad@red‐
379       hat.com>Lukasz      Dracz     <ldracz@redhat.com>Thomas     Fitzsimmons
380       <fitzsim@redhat.com>Michał  Górny   <mgorny@gentoo.org>Mark   Greenwood
381       <mark@dcs.shef.ac.uk>Tereza             Hlavackova            <hlavack‐
382       ova.tereza@gmail.com>Peter   Hatina   <phatina@redhat.com>Andrew   John
383       Hughes  <ahughes@redhat.com>Jie  Kang <jkang@redhat.com>Alex Kashchenko
384       <akashche@redhat.com>Matthias Klose  <doko@ubuntu.com>Alexandr  Kolouch
385       <skolnag@gmail.com>Jan   Kmetko  <jan.kmetko.ml@gmail.com>Francis  Kung
386       <fkung@redhat.com>Denis  Lila  <dlila@redhat.com>DJ   Lucas   <dj@luca‐
387       sit.com>Omair      Majid      <omajid@redhat.com>Jon     A.     Maxwell
388       <jmaxwell@users.sourceforge.net>Thomas   Meyer    <thomas@m3y3r.de>Kurt
389       Miller    <kurt@intricatesoftware.com>Saad   Mohammad   <smohammad@red‐
390       hat.com>Martin  Olsson   <martin@minimum.se>Stefan  Ring   <stefan@com‐
391       plang.tuwien.ac.at>Ville   Skyttä  <ville.skytta@iki.fi>Fridrich  Strba
392       <fridrich.strba@suse.com>Andrew   Su   <asu@redhat.com>Joshua    Sumali
393       <jsumali@redhat.com>Michal     Vala     <mvala@redhat.com>Jiri    Vanek
394       <jvanek@redhat.com>Tomáš  Votava  <tomcacolca@gmail.com>Mark   Wielaard
395       <mark@klomp.org>Jacob    Wisor    <gitne@excite.co.jp>Man   Lung   Wong
396       <mwong@redhat.com>
397       This project also includes code from the following projects:
398       OpenJDK <http://openjdk.java.net/>
399       Netx <http://jnlp.sourceforge.net/netx/>
400
401
402

SEE ALSO

404       icedtea-web(1) javaws(1) icedtea-web-plugin(1) itweb-settings(1)  poli‐
405       cyeditor(1) policytool(1) java(1)
406
407       http://icedtea.classpath.org/wiki/IcedTea-Web
408       http://icedtea.classpath.org/hg/icedtea-web
409
410
411
412
413icedtea-web (rhel-7.el6-x86_64)   19 Jun 2018                itweb-settings(1)
Impressum