itweb-settings - view and modify settings for javaws and the browser plugin

Author

       The following people have made contibutions to this project.
       Please keep this list in alphabetical order.
       Lillian       Angel      <langel@redhat.com>Andrew      Azores      <aazores@redhat.com>Deepak      Bhole
       <dbhole@redhat.com>Laurent  Bourgès  <bourges.laurent@gmail.com>Adam  Buchta   <adbuch7@gmail.com>Ricardo
       Martín   Camarero   <rickyepoderi@yahoo.es>Marcin   Cieslak  <marcin.cieslak@gmail.com>Danesh  Dadachanji
       <ddadacha@redhat.com>Adam Domurad <adomurad@redhat.com>Lukasz Dracz <ldracz@redhat.com>Thomas Fitzsimmons
       <fitzsim@redhat.com>Olesya   Gerasimenko   <gammaray@basealt.ru>Michał   Górny    <mgorny@gentoo.org>Mark
       Greenwood     <mark@dcs.shef.ac.uk>Tereza     Hlavackova    <hlavackova.tereza@gmail.com>Lars    Herschke
       <lhersch@dssgmbh.de>Peter Hatina  <phatina@redhat.com>Andrew  John  Hughes  <ahughes@redhat.com>Jie  Kang
       <jkang@redhat.com>Alex  Kashchenko  <akashche@redhat.com>Matthias Klose <doko@ubuntu.com>Alexandr Kolouch
       <skolnag@gmail.com>Jan  Kmetko   <jan.kmetko.ml@gmail.com>Francis   Kung   <fkung@redhat.com>Denis   Lila
       <dlila@redhat.com>DJ    Lucas    <dj@lucasit.com>Omair    Majid    <omajid@redhat.com>Jon    A.   Maxwell
       <jmaxwell@users.sourceforge.net>Thomas           Meyer            <thomas@m3y3r.de>Kurt            Miller
       <kurt@intricatesoftware.com>Saad  Mohammad <smohammad@redhat.com>Martin Olsson  <martin@minimum.se>Stefan
       Ring       <stefan@complang.tuwien.ac.at>Ville      Skyttä      <ville.skytta@iki.fi>Fridrich       Strba
       <fridrich.strba@suse.com>Andrew   Su   <asu@redhat.com>Joshua   Sumali  <jsumali@redhat.com>Joel  Tesdall
       <jtesdall@mapcon.com>Michal   Vala   <mvala@redhat.com>Jiri   Vanek    <jvanek@redhat.com>Tomáš    Votava
       <tomcacolca@gmail.com>Mark   Wielaard  <mark@klomp.org>Jacob  Wisor   <gitne@excite.co.jp>Man  Lung  Wong
       <mwong@redhat.com>
       This project also includes code from the following projects:
       OpenJDK <http://openjdk.java.net/>
       Netx <http://jnlp.sourceforge.net/netx/>

Bugs

       There aren't any known bugs. If you come across one, please file it at:
       http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
       http://icedtea.classpath.org/bugzilla

       Please run in debug (-verbose switch or itw-settings setting or ICEDTEAPLUGIN_DEBUG variable set to true)
       mode and include that output (best is from java console) with URL to jnlp or html file (or the  jnlp/html
       file or  application itself) when filing out the bug report.

Description

       -check name Checks that all the current settings have valid values.(No argument expected)

       -get name   Shows the value of the specified settings.(Expected one or more arguments)

       -headless   Disables download window, other UIs.(No argument expected)

       -help       Prints  out  information about supported command and basic usage. Can also take an parameter,
                   and then it prints detailed help for this command.(No argument expected)

       -info name  Shows additional information about the named settings. Includes a  description,  the  current
                   value, the possible values, and the source of the setting.(Expected one or more arguments)

       -list       Shows a list of all the IcedTea-Web settings and their current values.(No argument expected)

       -reset name Resets the specified settings to their original value.(Expected one or more arguments)

       -reset all  Resets all settings to their original values.(No argument expected)

       -set name value
                   Sets  the  settings  to the new value specified, if it is an appropriate value.(Expected even
                   number of arguments with param=value as valid argument)

       -verbose    Enable verbose output.(No argument expected)

Examples

       itweb-settings
                   Show the GUI editor

       itweb-settings  -reset deployment.proxy.type
                    Resets the value of `deployment.proxy.type` setting.

       Knownproperties(keyanddefaultvalue):

       deployment.browser.path
                   null (Possible: Set path to browser or any command launching url. If not set, default browser
                   is used. If default browser is not  available,  you  will  be  be  prompted  to  provide  URL
                   consumer.  Eg:  firefox,  or (windows) rundll32 url.dll,FileProtocolHandler , microsoft-edge,
                   (mac) safari, xdg-open (linux) like commands. In headless mode you  can  use  wget,  curl  or
                   lynx.  It  can be also javaws itself to launch other jnlp. You can set yor custom browser via
                   deployment.browser.path property. $BROWSER environment variable is serving same purpose.  You
                   can  use keyword INTERNAL-HTML to launch internal browser. But be warned, it is terrible. Use
                   ALWAYS-ASK to enforce prompt each time instead of using defaults.)

       deployment.cache.jarcompression
                   0 (Possible: are in range 0 to 10 (inclusive))

       deployment.cache.max.size
                   -1 (Possible: are in range -1 to 2,147,483,647 (inclusive))

       deployment.console.startup.mode
                   HIDE (Possible: [DISABLE, HIDE, SHOW, SHOW_PLUGIN_ONLY, SHOW_JAVAWS_ONLY])

       deployment.headless.ignore
                   false (Possible: are true or false)

       deployment.https.noenforce
                   false (Possible: are true or false)

       deployment.javapi.cache.enabled
                   false (Possible: are true or false)

       deployment.javaws.associations
                   2 (Possible: are in range 0 to 3 (inclusive))

       deployment.javaws.autodownload
                   false (Possible: are true or false)

       deployment.javaws.installURL
                   null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/))

       deployment.javaws.shortcut
                   ASK_IF_HINTED (Possible: [ALWAYS, ALWAYS_IF_HINTED, ASK_USER, ASK_IF_HINTED, NEVER])

       deployment.javaws.update.timeout
                   500 (Possible: are in range 0 to 10,000 (inclusive))

       deployment.jnlpclassloader.strict
                   true (Possible: are true or false)

       deployment.jre.dir
                   null

       deployment.launcher.rust.bootcp.add
                   null (Possible: Rust native launchers only! CP and XBootCP  properties  are  space  separated
                   members   of   bootcp/cp   to   be   removed   or  added.  eg  `...cp.add=/usr/java/rhino.jar
                   /usr/java/scary.jar`  will  add  those  two  jars  to  cp.   Eg:  `...bootcp.remove=rhino.jar
                   tagsoup.jar` will remove those two jars no meter of path. Removal is done first.)

       deployment.launcher.rust.bootcp.remove
                    (Possible: Rust native launchers only! CP and XBootCP properties are space separated members
                   of  bootcp/cp  to be removed or added. eg `...cp.add=/usr/java/rhino.jar /usr/java/scary.jar`
                   will add those two jars to cp.   Eg:  `...bootcp.remove=rhino.jar  tagsoup.jar`  will  remove
                   those two jars no meter of path. Removal is done first.)

       deployment.launcher.rust.cp.add
                    (Possible: Rust native launchers only! CP and XBootCP properties are space separated members
                   of  bootcp/cp  to be removed or added. eg `...cp.add=/usr/java/rhino.jar /usr/java/scary.jar`
                   will add those two jars to cp.   Eg:  `...bootcp.remove=rhino.jar  tagsoup.jar`  will  remove
                   those two jars no meter of path. Removal is done first.)

       deployment.launcher.rust.cp.remove
                    (Possible: Rust native launchers only! CP and XBootCP properties are space separated members
                   of  bootcp/cp  to be removed or added. eg `...cp.add=/usr/java/rhino.jar /usr/java/scary.jar`
                   will add those two jars to cp.   Eg:  `...bootcp.remove=rhino.jar  tagsoup.jar`  will  remove
                   those two jars no meter of path. Removal is done first.)

       deployment.log
                   false (Possible: are true or false)

       deployment.log.file
                   false (Possible: are true or false)

       deployment.log.file.clientapp
                   true (Possible: are true or false)

       deployment.log.file.legacylog
                   false (Possible: are true or false)

       deployment.log.headers
                   false (Possible: are true or false)

       deployment.log.stdstreams
                   true (Possible: are true or false)

       deployment.log.system
                   true (Possible: are true or false)

       deployment.manifest.attributes.check
                   ALL  (Possible: (Values that can be used alone only): [ALL, NONE] (Values that can be used in
                   combination separated by the delimiter  ","  with  no  space  expected  ):  [ALAC,  CODEBASE,
                   ENTRYPOINT, PERMISSIONS, TRUSTED])

       deployment.plugin.jvm.arguments
                   null

       deployment.proxy.auto.config.url
                   null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/))

       deployment.proxy.bypass.list
                   null

       deployment.proxy.bypass.local
                   null

       deployment.proxy.ftp.host
                   null

       deployment.proxy.ftp.port
                   null

       deployment.proxy.http.host
                   null

       deployment.proxy.http.port
                   null

       deployment.proxy.https.host
                   null

       deployment.proxy.https.port
                   null

       deployment.proxy.override.hosts
                   null

       deployment.proxy.same
                   false (Possible: are true or false)

       deployment.proxy.socks.host
                   null

       deployment.proxy.socks.port
                   null

       deployment.proxy.type
                   3 (Possible: are in range -1 to 3 (inclusive))

       deployment.security.askgrantdialog.notinca
                   true (Possible: are true or false)

       deployment.security.askgrantdialog.show
                   true (Possible: are true or false)

       deployment.security.expired.warning
                   true (Possible: are true or false)

       deployment.security.itw.ignorecertissues
                   false (Possible: are true or false)

       deployment.security.jsse.hostmismatch.warning
                   true (Possible: are true or false)

       deployment.security.level
                   null (Possible: DENY_ALL DENY_UNSIGNED ASK_UNSIGNED ALLOW_UNSIGNED)

       deployment.security.notinca.warning
                   true (Possible: are true or false)

       deployment.security.sandbox.awtwarningwindow
                   true (Possible: are true or false)

       deployment.security.sandbox.jnlp.enhanced
                   true (Possible: are true or false)

       deployment.security.trusted.policy
                   null (Possible: include an absolute path to a file or directory)

       deployment.small.size.override.height
                   600 (Possible: are in range -9,999 to 9,999 (inclusive))

       deployment.small.size.override.width
                   800 (Possible: are in range -9,999 to 9,999 (inclusive))

       deployment.small.size.treshold
                   10 (Possible: are in range 0 to 1,000 (inclusive))

       deployment.system.cachedir
                   null (Possible: include an absolute path to a file or directory)

       deployment.system.config
                   null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/))

       deployment.system.config.mandatory
                   false (Possible: are true or false)

       deployment.system.security.cacerts
                   $JAVA_HOME/lib/security/cacerts (Possible: include an absolute path to a file or directory)

       deployment.system.security.jssecacerts
                   $JAVA_HOME/lib/security/jssecacerts  (Possible:  include  an  absolute  path  to  a  file  or
                   directory)

       deployment.system.security.policy
                   null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/))

       deployment.system.security.trusted.certs
                   $JAVA_HOME/lib/security/trusted.certs (Possible: include  an  absolute  path  to  a  file  or
                   directory)

       deployment.system.security.trusted.clientautcerts
                   $JAVA_HOME/lib/security/trusted.clientcerts  (Possible: include an absolute path to a file or
                   directory)

       deployment.system.security.trusted.jssecerts
                   $JAVA_HOME/lib/security/trusted.jssecerts (Possible: include an absolute path to  a  file  or
                   directory)

       deployment.user.cachedir
                   $XDG_CACHE_HOME/icedtea-web/cache (Possible: include an absolute path to a file or directory)

       deployment.user.locksdir
                   $TMP/$USER/netx/locks (Possible: include an absolute path to a file or directory)

       deployment.user.logdir
                   $XDG_CONFIG_HOME/icedtea-web/log (Possible: include an absolute path to a file or directory)

       deployment.user.pcachedir
                   $XDG_CACHE_HOME/icedtea-web/pcache   (Possible:  include  an  absolute  path  to  a  file  or
                   directory)

       deployment.user.runningfile
                   $TMP/$USER/netx/locks/netx_running  (Possible:  include  an  absolute  path  to  a  file   or
                   directory)

       deployment.user.security.policy
                   $XDG_CONFIG_HOME/icedtea-web/security/java.policy  (Possible:  include  any  valid  url  (eg.
                   http://icedtea.classpath.org/hg/))

       deployment.user.security.trusted.cacerts
                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Possible: include an absolute path  to
                   a file or directory)

       deployment.user.security.trusted.certs
                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs  (Possible: include an absolute path to a
                   file or directory)

       deployment.user.security.trusted.clientauthcerts
                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts (Possible: include an absolute path
                   to a file or directory)

       deployment.user.security.trusted.jssecacerts
                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts (Possible: include an absolute path
                   to a file or directory)

       deployment.user.security.trusted.jssecerts
                   $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts (Possible: include an  absolute  path
                   to a file or directory)

       deployment.user.tmp
                   $XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an absolute path to a file or directory)

Files

$JAVA_HOME/lib/deployment.config
java-global deployment properties file. May be affected by deployment.jre.dir.

$XDG_CACHE_HOME/icedtea-web/cache
Contains cached runtime entries. Controlled by deployment.user.cachedir

$XDG_CACHE_HOME/icedtea-web/cache/recently_used
Additional information about items in cache

$XDG_CACHE_HOME/icedtea-web/pcache
Contains saved application data. Controlled by deployment.user.pcachedir

$XDG_CACHE_HOME/icedtea-web/tmp
Contains temporary runtime files. Controlled by deployment.user.tmp

$XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
File responsible for various actions on applets and apps based on their codebase based on
users actions.

$XDG_CONFIG_HOME/icedtea-web/deployment.properties
Users main deployment properties file.

$XDG_CONFIG_HOME/icedtea-web/generated_jnlps
Location where jnlp files generated from html pages for javaws applications desktop/menu
launchers icons are stored

$XDG_CONFIG_HOME/icedtea-web/icons
Location where icons of javaws applications desktop/menu launchers icons are stored

$XDG_CONFIG_HOME/icedtea-web/log
contains file-log files (if enabled), itw-cplugin-date_time.log for native part of plugin,
itw-javantx-date_time.log for everything else. Controlled by deployment.user.logdir

$XDG_DATA_HOME/applications/javaws
Subdirectory in users menus space, for placing custom menu shortcuts.

{%WINDIR/Sun/Java or /etc/.java}/deployment/.appletTrustSettings
File responsible for various actions on applets and apps based on their codebase based on
admins actions.

{%WINDIR/Sun/Java or /etc/.java}/deployment/deployment.config
Global deployment config file.

Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are set as ~/.config, ~/.cache and /tmp or
/var/tmp if not set.

Name

       itweb-settings - view and modify settings for javaws and the browserplugin

Synopsis

itweb-settingsitweb-settings command arguments