Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
itweb-settings(1)	     General Commands Manual	       itweb-settings(1)

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 set-
     tings used by the IcedTea-Web implementation of javaws and the browser plu-
     gin

     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  ar-
		 gument 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  ex-
		 pected)

     -set name value
		 Sets  the  settings to the new value specified, if it is an ap-
		 propriate  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.background.threads.count
		 3 (Possible: are in range 1 to 16 (inclusive))

     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 environ-
		 ment variable is serving same purpose. You can use keyword  IN-
		 TERNAL-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.enable.cache.fsync
		 false (Possible: are true or false)

     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  re-
		 moved	   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  proper-
		 ties  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. Re-
		 moval is done first.)

     deployment.launcher.rust.cp.add
		  (Possible: Rust native launchers only! CP and XBootCP  proper-
		 ties  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. Re-
		 moval is done first.)

     deployment.launcher.rust.cp.remove
		  (Possible: Rust native launchers only! CP and XBootCP  proper-
		 ties  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. Re-
		 moval 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, ENTRY-
		 POINT, PERMISSIONS, TRUSTED])

     deployment.max.urls.download.indicator
		 16 (Possible: are in range 1 to 1,024 (inclusive))

     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_UN-
		 SIGNED)

     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  direc-
		 tory)

     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 direc-
		 tory)

     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  ab-
		 solute 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 ab-
		 solute 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  ab-
		 solute 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 ab-
		 solute path to a file or directory)

     deployment.user.runningfile
		 $TMP/$USER/netx/locks/netx_running (Possible:	include  an  ab-
		 solute 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	 (Possi-
		 ble: 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 (Pos-
		 sible: include an absolute path to a file or directory)

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

     deployment.user.security.trusted.jssecerts
		 $XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts (Possi-
		 ble: 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 de-
		 ployment.jre.dir.

     $XDG_CACHE_HOME/icedtea-web/cache
		 Contains  cached  runtime  entries.   Controlled   by	 deploy-
		 ment.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  deploy-
		 ment.user.pcachedir

     $XDG_CACHE_HOME/icedtea-web/tmp
		 Contains  temporary  runtime  files.  Controlled   by	 deploy-
		 ment.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 every-
		 thing 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 ICEDTEAPLU-
     GIN_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   ap-
     plication 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  BourgA"s  <bourges.laurent@gmail.com>Adam
     Buchta   <adbuch7@gmail.com>Ricardo   MartAn   Camarero   <rickyepoderi@ya-
     hoo.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  Gerasi-
     menko <gammaray@basealt.ru>MichaA GA^3rny <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@luca-
     sit.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 Ols-
     son   <martin@minimum.se>Stefan  Ring   <stefan@complang.tuwien.ac.at>Ville
     SkyttAx <ville.skytta@iki.fi>Fridrich Strba <fridrich.strba@suse.com>Andrew
     Su <asu@redhat.com>Joshua Sumali  <jsumali@redhat.com>Joel  Tesdall  <jtes-
     dall@mapcon.com>Michal   Vala   <mvala@redhat.com>Jiri  Vanek  <jvanek@red-
     hat.com>TomA!A!	  Votava       <tomcacolca@gmail.com>Mark	Wielaard
     <mark@klomp.org>Jacob  Wisor  <gitne@excite.co.jp>Man Lung Wong <mwong@red-
     hat.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) policyedi-
     tor(1) policytool(1) java(1)

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

icedtea-web 1.8.8		   11 Jun 2026		       itweb-settings(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=itweb-settings&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help