Provided by: icedtea-netx_1.8.4-1build1_all bug

NAME

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

SYNOPSIS

       itweb-settings
       itweb-settings command arguments

DESCRIPTION

       itweb-settings is a command line and a GUI program to modify and edit settings used by the
       IcedTea-Web implementation of javaws and the browser plugin

       If executed without any arguments, it starts up a GUI. Otherwise, it tries to do  what  is
       specified in the argument.

       The  command-line  allows  quickly  searching,  making  a  copy  of and modifying specific
       settings without having to hunt through a UI.

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.

       Known properties (key and default value):

       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.

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.

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/>

SEE ALSO

       icedtea-web(1)    javaws(1)    icedtea-web-plugin(1)   itweb-settings(1)   policyeditor(1)
       policytool(1) java(1)

       http://icedtea.classpath.org/wiki/IcedTea-Web
       http://icedtea.classpath.org/hg/icedtea-web