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.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.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.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 abso-
		   lute	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 abso-
		   lute	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	BourgA"s <bourges.lau-
       rent@gmail.com>Adam Buchta <adbuch7@gmail.com>Ricardo  MartAn  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>MichaA
       GA^3rny	<mgorny@gentoo.org>Mark	 Greenwood <mark@dcs.shef.ac.uk>Tereza
       Hlavackova  <hlavackova.tereza@gmail.com>Lars  Herschke	 <lhersch@dss-
       gmbh.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@red-
       hat.com>Martin  Olsson	<martin@minimum.se>Stefan  Ring	  <stefan@com-
       plang.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   <jtesdall@mapcon.com>Michal	  Vala
       <mvala@redhat.com>Jiri  Vanek <jvanek@redhat.com>TomA!A!	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.4		  1 Mar	2021		     itweb-settings(1)

NAME | SYNOPSIS | DESCRIPTION | DESCRIPTION | EXAMPLES | FILES | BUGS | AUTHOR | SEE ALSO

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

home | help