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
       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 modify-
       ing 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  de-
		   tailed help for this	command.(No argument expected)

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

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

       -reset name Resets the specified	settings to their original  value.(Ex-
		   pected 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.background.threads.count
		   3 (Possible:	are in range 1 to 16 (inclusive))

       deployment.browser.path
		   null	(Possible: Set path to browser or any command  launch-
		   ing	url.  If  not set, default browser is used. If default
		   browser is not available, you will be be prompted  to  pro-
		   vide	 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  de-
		   ployment.browser.path  property. $BROWSER environment vari-
		   able	is serving same	purpose. You can use keyword INTERNAL-
		   HTML	to launch internal browser. But	be warned, it is  ter-
		   rible.  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
		   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, CODE-
		   BASE, ENTRYPOINT, 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 AL-
		   LOW_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  di-
		   rectory)

       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 di-
		   rectory)

       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 ab-
		   solute 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:  in-
		   clude an absolute path to a file or directory)

       deployment.system.security.trusted.jssecerts
		   $JAVA_HOME/lib/security/trusted.jssecerts   (Possible:  in-
		   clude 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 ab-
		   solute 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   (Possi-
		   ble:	 include  any  valid  url  (eg.	 http://icedtea.class-
		   path.org/hg/))

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

       deployment.user.security.trusted.certs
		   $XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possi-
		   ble:	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  ab-
		   solute 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  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 everything	else.  Controlled  by  deploy-
		   ment.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@red-
       hat.com>Deepak  Bhole  <dbhole@redhat.com>Laurent  Bourgs <bourges.lau-
       rent@gmail.com>Adam Buchta  <adbuch7@gmail.com>Ricardo  Martn  Camarero
       <rickyepoderi@yahoo.es>Marcin  Cieslak <marcin.cieslak@gmail.com>Danesh
       Dadachanji     <ddadacha@redhat.com>Adam	    Domurad	<adomurad@red-
       hat.com>Lukasz	   Dracz     <ldracz@redhat.com>Thomas	   Fitzsimmons
       <fitzsim@redhat.com>Olesya Gerasimenko <gammaray@basealt.ru>Micha  Grny
       <mgorny@gentoo.org>Mark	Greenwood <mark@dcs.shef.ac.uk>Tereza Hlavack-
       ova <hlavackova.tereza@gmail.com>Lars Herschke  <lhersch@dssgmbh.de>Pe-
       ter   Hatina   <phatina@redhat.com>Andrew   John	 Hughes	 <ahughes@red-
       hat.com>Jie  Kang  <jkang@redhat.com>Alex   Kashchenko	<akashche@red-
       hat.com>Matthias	  Klose	  <doko@ubuntu.com>Alexandr   Kolouch	<skol-
       nag@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@red-
       hat.com>Martin  Olsson	<martin@minimum.se>Stefan  Ring	  <stefan@com-
       plang.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  <tomca-
       colca@gmail.com>Mark Wielaard <mark@klomp.org>Jacob  Wisor   <gitne@ex-
       cite.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) poli-
       cyeditor(1) policytool(1) java(1)

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

icedtea-web 1.8.8		  12 Apr 2025		     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+14.3.quarterly>

home | help