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 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.jsse.hostmismatch.warning
200                   true (Possible: are true or false)
201
202       deployment.security.level
203                   null   (Possible:   DENY_ALL   DENY_UNSIGNED   ASK_UNSIGNED
204                   ALLOW_UNSIGNED)
205
206       deployment.security.notinca.warning
207                   true (Possible: are true or false)
208
209       deployment.security.sandbox.awtwarningwindow
210                   true (Possible: are true or false)
211
212       deployment.security.sandbox.jnlp.enhanced
213                   true (Possible: are true or false)
214
215       deployment.security.trusted.policy
216                   null  (Possible:  include  an  absolute  path  to a file or
217                   directory)
218
219       deployment.system.cachedir
220                   null (Possible: include an  absolute  path  to  a  file  or
221                   directory)
222
223       deployment.system.security.cacerts
224                   $JAVA_HOME/lib/security/cacerts (Possible: include an abso‐
225                   lute path to a file or directory)
226
227       deployment.system.security.jssecacerts
228                   $JAVA_HOME/lib/security/jssecacerts (Possible:  include  an
229                   absolute path to a file or directory)
230
231       deployment.system.security.policy
232                   null    (Possible:    include    any    valid    url   (eg.
233                   http://icedtea.classpath.org/hg/))
234
235       deployment.system.security.trusted.certs
236                   $JAVA_HOME/lib/security/trusted.certs (Possible: include an
237                   absolute path to a file or directory)
238
239       deployment.system.security.trusted.clientautcerts
240                   $JAVA_HOME/lib/security/trusted.clientcerts      (Possible:
241                   include an absolute path to a file or directory)
242
243       deployment.system.security.trusted.jssecerts
244                   $JAVA_HOME/lib/security/trusted.jssecerts        (Possible:
245                   include an absolute path to a file or directory)
246
247       deployment.user.cachedir
248                   $XDG_CACHE_HOME/icedtea-web/cache   (Possible:  include  an
249                   absolute path to a file or directory)
250
251       deployment.user.locksdir
252                   $TMP/$USER/netx/locks (Possible: include an  absolute  path
253                   to a file or directory)
254
255       deployment.user.logdir
256                   $XDG_CONFIG_HOME/icedtea-web/log   (Possible:   include  an
257                   absolute path to a file or directory)
258
259       deployment.user.pcachedir
260                   $XDG_CACHE_HOME/icedtea-web/pcache  (Possible:  include  an
261                   absolute path to a file or directory)
262
263       deployment.user.runningfile
264                   $TMP/$USER/netx/locks/netx_running  (Possible:  include  an
265                   absolute path to a file or directory)
266
267       deployment.user.security.policy
268                   $XDG_CONFIG_HOME/icedtea-web/security/java.policy   (Possi‐
269                   ble:  include  any  valid  url  (eg.  http://icedtea.class‐
270                   path.org/hg/))
271
272       deployment.user.security.trusted.cacerts
273                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Pos‐
274                   sible: include an absolute path to a file or directory)
275
276       deployment.user.security.trusted.certs
277                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possi‐
278                   ble: include an absolute path to a file or directory)
279
280       deployment.user.security.trusted.clientauthcerts
281                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
282                   (Possible: include an absolute path to a file or directory)
283
284       deployment.user.security.trusted.jssecacerts
285                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
286                   (Possible: include an absolute path to a file or directory)
287
288       deployment.user.security.trusted.jssecerts
289                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
290                   (Possible: include an absolute path to a file or directory)
291
292       deployment.user.tmp
293                   $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an abso‐
294                   lute path to a file or directory)
295
296

FILES

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

BUGS

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

AUTHOR

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