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
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 cur‐
rent 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: include an absolute path to a file or
directory)
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, SHOWPLUGINONLY,
SHOWJAVAWSONLY])
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
ASKIFHINTED (Possible: [ALWAYS, ALWAYSIFHINTED,
ASKUSER, ASKIFHINTED, 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.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.jsse.hostmismatch.warning
true (Possible: are true or false)
deployment.security.level
null (Possible: DENYALL DENYUNSIGNED ASKUNSIGNED
ALLOWUNSIGNED)
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.system.cachedir
null (Possible: include an absolute path to a file or
directory)
deployment.system.security.cacerts
$JAVAHOME/lib/security/cacerts (Possible: include an abso‐
lute path to a file or directory)
deployment.system.security.jssecacerts
$JAVAHOME/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
$JAVAHOME/lib/security/trusted.certs (Possible: include an
absolute path to a file or directory)
deployment.system.security.trusted.clientautcerts
$JAVAHOME/lib/security/trusted.clientcerts (Possible:
include an absolute path to a file or directory)
deployment.system.security.trusted.jssecerts
$JAVAHOME/lib/security/trusted.jssecerts (Possible:
include an absolute path to a file or directory)
deployment.user.cachedir
$XDGCACHEHOME/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
$XDGCONFIGHOME/icedtea-web/log (Possible: include an
absolute path to a file or directory)
deployment.user.pcachedir
$XDGCACHEHOME/icedtea-web/pcache (Possible: include an
absolute path to a file or directory)
deployment.user.runningfile
$TMP/$USER/netx/locks/netxrunning (Possible: include an
absolute path to a file or directory)
deployment.user.security.policy
$XDGCONFIGHOME/icedtea-web/security/java.policy (Possi‐
ble: include any valid url (eg. http://icedtea.class‐
path.org/hg/))
deployment.user.security.trusted.cacerts
$XDGCONFIGHOME/icedtea-web/security/trusted.cacerts (Pos‐
sible: include an absolute path to a file or directory)
deployment.user.security.trusted.certs
$XDGCONFIGHOME/icedtea-web/security/trusted.certs (Possi‐
ble: include an absolute path to a file or directory)
deployment.user.security.trusted.clientauthcerts
$XDGCONFIGHOME/icedtea-web/security/trusted.clientcerts
(Possible: include an absolute path to a file or directory)
deployment.user.security.trusted.jssecacerts
$XDGCONFIGHOME/icedtea-web/security/trusted.jssecacerts
(Possible: include an absolute path to a file or directory)
deployment.user.security.trusted.jssecerts
$XDGCONFIGHOME/icedtea-web/security/trusted.jssecerts
(Possible: include an absolute path to a file or directory)
deployment.user.tmp
$XDGCACHEHOME/icedtea-web/tmp (Possible: include an abso‐
lute path to a file or directory)
FILES
$JAVAHOME/lib/deployment.config
java-global deployment properties file. May be affected by
deployment.jre.dir.
$XDGCACHEHOME/icedtea-web/cache
Contains cached runtime entries. Controlled by deploy‐
ment.user.cachedir
$XDGCACHEHOME/icedtea-web/cache/recentlyused
Additional information about items in cache
$XDGCACHEHOME/icedtea-web/pcache
Contains saved application data. Controlled by deploy‐
ment.user.pcachedir
$XDGCACHEHOME/icedtea-web/tmp
Contains temporary runtime files. Controlled by deploy‐
ment.user.tmp
$XDGCONFIGHOME/icedtea-web/.appletTrustSettings
File responsible for various actions on applets and apps
based on their codebase based on users actions.
$XDGCONFIGHOME/icedtea-web/deployment.properties
Users main deployment properties file.
$XDGCONFIGHOME/icedtea-web/generatedjnlps
Location where jnlp files generated from html pages for
javaws applications desktop/menu launchers icons are stored
$XDGCONFIGHOME/icedtea-web/icons
Location where icons of javaws applications desktop/menu
launchers icons are stored
$XDGCONFIGHOME/icedtea-web/log
contains file-log files (if enabled), itw-cplugin-
datetime.log for native part of plugin, itw-javantx-
datetime.log for everything else. Controlled by deploy‐
ment.user.logdir
$XDGDATAHOME/applications/javaws
Subdirectory in users menus space, for placing custom menu
shortcuts.
/etc/.java/deployment/.appletTrustSettings
File responsible for various actions on applets and apps
based on their codebase based on admins actions.
/etc/.java/deployment/deployment.config
Global deployment config file.
Where $XDGCONFIGDIR, $XDGCACHEDIR and $XDGRUNTIMEDIR 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#Filingbugs
http://icedtea.classpath.org/bugzilla
Please run in debug (-verbose switch or itw-settings setting or
ICEDTEAPLUGINDEBUG 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 Andrew Azores Deepak Bhole Adam Buchta
Ricardo Martín Camarero Marcin Cieslak Danesh
Dadachanji Adam Domurad Lukasz Dracz Thomas Fitzsimmons
Michał Górny Mark Greenwood
Tereza Hlavackova Peter Hatina Andrew John
Hughes Jie Kang Alex Kashchenko
Matthias Klose Alexandr Kolouch
Jan Kmetko Francis Kung
Denis Lila DJ Lucas Omair Majid Jon A. Maxwell
Thomas Meyer Kurt
Miller Saad Mohammad Martin Olsson Stefan Ring Ville Skyttä Fridrich Strba
Andrew Su Joshua Sumali
Michal Vala Jiri Vanek
Tomáš Votava Mark Wielaard
Jacob Wisor Man Lung Wong
This project also includes code from the following projects:
OpenJDK
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 (rhel-1.el7-x8664) 11 Apr 2018 itweb-settings(1)