.TH itweb-settings 1 "14 Jan 2017" "icedtea-web (1.6.2-3.1)"

.SH NAME


.PP
itweb-settings - view and modify settings for 
.B javaws 
and the 
.B browser plugin

.SH SYNOPSIS


.PP

.B itweb-settings 
.br
.B itweb-settings 
command arguments
.SH DESCRIPTION


.PP

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

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

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


.PP
.TP 12
\-check name
Checks that all the current settings have valid values.(No argument expected)
.TP 12
\-get name
Shows the value of the specified settings.(Expected one or more arguments)
.TP 12
\-headless 
Disables download window, other UIs.(No argument expected)
.TP 12
\-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)
.TP 12
\-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)
.TP 12
\-list 
Shows a list of all the IcedTea-Web settings and their current values.(No argument expected)
.TP 12
\-reset name
Resets the specified settings to their original value.(Expected one or more arguments)
.TP 12
\-reset all
Resets all settings to their original values.(No argument expected)
.TP 12
\-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)
.TP 12
\-verbose 
Enable verbose output.(No argument expected)


.SH EXAMPLES


.PP
.TP 12
itweb-settings
Show the GUI editor
.TP 12
itweb-settings  -reset deployment.proxy.type
 Resets the value of `deployment.proxy.type` setting.

.br

.PP

.B Known properties (key and default value):

.br

.PP
.TP 12
deployment.browser.path
null (Possible: include an absolute path to a file or directory)
.TP 12
deployment.cache.jarcompression
0 (Possible: are in range 0 to 10 (inclusive))
.TP 12
deployment.cache.max.size
\-1 (Possible: are in range -1 to 2,147,483,647 (inclusive))
.TP 12
deployment.console.startup.mode
HIDE (Possible: [DISABLE, HIDE, SHOW, SHOW_PLUGIN_ONLY, SHOW_JAVAWS_ONLY])
.TP 12
deployment.javapi.cache.enabled
false (Possible: are true or false)
.TP 12
deployment.javaws.associations
2 (Possible: are in range 0 to 3 (inclusive))
.TP 12
deployment.javaws.autodownload
false (Possible: are true or false)
.TP 12
deployment.javaws.installURL
null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/))
.TP 12
deployment.javaws.shortcut
ASK_IF_HINTED (Possible: [ALWAYS, ALWAYS_IF_HINTED, ASK_USER, ASK_IF_HINTED, NEVER])
.TP 12
deployment.javaws.update.timeout
500 (Possible: are in range 0 to 10,000 (inclusive))
.TP 12
deployment.jnlpclassloader.strict
true (Possible: are true or false)
.TP 12
deployment.jre.dir
null
.TP 12
deployment.log
false (Possible: are true or false)
.TP 12
deployment.log.file
false (Possible: are true or false)
.TP 12
deployment.log.file.clientapp
false (Possible: are true or false)
.TP 12
deployment.log.file.legacylog
true (Possible: are true or false)
.TP 12
deployment.log.headers
false (Possible: are true or false)
.TP 12
deployment.log.stdstreams
true (Possible: are true or false)
.TP 12
deployment.log.system
true (Possible: are true or false)
.TP 12
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])
.TP 12
deployment.plugin.jvm.arguments
null
.TP 12
deployment.proxy.auto.config.url
null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/))
.TP 12
deployment.proxy.bypass.list
null
.TP 12
deployment.proxy.bypass.local
null
.TP 12
deployment.proxy.ftp.host
null
.TP 12
deployment.proxy.ftp.port
null
.TP 12
deployment.proxy.http.host
null
.TP 12
deployment.proxy.http.port
null
.TP 12
deployment.proxy.https.host
null
.TP 12
deployment.proxy.https.port
null
.TP 12
deployment.proxy.override.hosts
null
.TP 12
deployment.proxy.same
false (Possible: are true or false)
.TP 12
deployment.proxy.socks.host
null
.TP 12
deployment.proxy.socks.port
null
.TP 12
deployment.proxy.type
3 (Possible: are in range -1 to 3 (inclusive))
.TP 12
deployment.security.askgrantdialog.notinca
true (Possible: are true or false)
.TP 12
deployment.security.askgrantdialog.show
true (Possible: are true or false)
.TP 12
deployment.security.expired.warning
true (Possible: are true or false)
.TP 12
deployment.security.jsse.hostmismatch.warning
true (Possible: are true or false)
.TP 12
deployment.security.level
null (Possible: DENY_ALL DENY_UNSIGNED ASK_UNSIGNED ALLOW_UNSIGNED)
.TP 12
deployment.security.notinca.warning
true (Possible: are true or false)
.TP 12
deployment.security.sandbox.awtwarningwindow
true (Possible: are true or false)
.TP 12
deployment.security.sandbox.jnlp.enhanced
true (Possible: are true or false)
.TP 12
deployment.security.trusted.policy
null (Possible: include an absolute path to a file or directory)
.TP 12
deployment.system.cachedir
null (Possible: include an absolute path to a file or directory)
.TP 12
deployment.system.security.cacerts
$JAVA_HOME/lib/security/cacerts (Possible: include an absolute path to a file or directory)
.TP 12
deployment.system.security.jssecacerts
$JAVA_HOME/lib/security/jssecacerts (Possible: include an absolute path to a file or directory)
.TP 12
deployment.system.security.policy
null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/))
.TP 12
deployment.system.security.trusted.certs
$JAVA_HOME/lib/security/trusted.certs (Possible: include an absolute path to a file or directory)
.TP 12
deployment.system.security.trusted.clientautcerts
$JAVA_HOME/lib/security/trusted.clientcerts (Possible: include an absolute path to a file or directory)
.TP 12
deployment.system.security.trusted.jssecerts
$JAVA_HOME/lib/security/trusted.jssecerts (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.cachedir
$XDG_CACHE_HOME/icedtea-web/cache (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.locksdir
$TMP/$USER/netx/locks (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.logdir
$XDG_CONFIG_HOME/icedtea-web/log (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.pcachedir
$XDG_CACHE_HOME/icedtea-web/pcache (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.runningfile
$TMP/$USER/netx/locks/netx_running (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.security.policy
$XDG_CONFIG_HOME/icedtea-web/security/java.policy (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/))
.TP 12
deployment.user.security.trusted.cacerts
$XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.security.trusted.certs
$XDG_CONFIG_HOME/icedtea-web/security/trusted.certs (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.security.trusted.clientauthcerts
$XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.security.trusted.jssecacerts
$XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.security.trusted.jssecerts
$XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts (Possible: include an absolute path to a file or directory)
.TP 12
deployment.user.tmp
$XDG_CACHE_HOME/icedtea-web/tmp (Possible: include an absolute path to a file or directory)

.SH FILES


.PP
.TP 12
$JAVA_HOME/lib/deployment.config
java-global deployment properties file. May be affected by deployment.jre.dir.
.TP 12
$XDG_CACHE_HOME/icedtea-web/cache
Contains cached runtime entries. Controlled by 
.B deployment.user.cachedir

.TP 12
$XDG_CACHE_HOME/icedtea-web/cache/recently_used
Additional information about items in cache
.TP 12
$XDG_CACHE_HOME/icedtea-web/pcache
Contains saved application data. Controlled by 
.B deployment.user.pcachedir

.TP 12
$XDG_CACHE_HOME/icedtea-web/tmp
Contains temporary runtime files. Controlled by 
.B deployment.user.tmp

.TP 12
$XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
File responsible for various actions on applets and apps based on their codebase based on users actions.
.TP 12
$XDG_CONFIG_HOME/icedtea-web/deployment.properties
Users main deployment properties file.
.TP 12
$XDG_CONFIG_HOME/icedtea-web/generated_jnlps
Location where jnlp files generated from html pages for javaws applications desktop/menu launchers icons are stored
.TP 12
$XDG_CONFIG_HOME/icedtea-web/icons
Location where icons of javaws applications desktop/menu launchers icons are stored
.TP 12
$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 
.B deployment.user.logdir

.TP 12
$XDG_DATA_HOME/applications/javaws
Subdirectory in users menus space, for placing custom menu shortcuts.
.TP 12
/etc/.java/deployment/.appletTrustSettings
File responsible for various actions on applets and apps based on their codebase based on admins actions.
.TP 12
/etc/.java/deployment/deployment.config
Global deployment config file.

.PP
Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are  set  as ~/.config, ~/.cache and /tmp or /var/tmp if not set.
.SH BUGS


.PP
There aren't any known bugs. If you come across one, please file it at:
.br
http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
.br
http://icedtea.classpath.org/bugzilla
.br

.br
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.
.br

.SH AUTHOR


.PP
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.
.br

.SH SEE ALSO


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

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