.TH javaws 1 "11 Nov 2018" "icedtea-web (1.6.2-3.1+deb9u1)"

.SH NAME


.PP
javaws - a Java Web Start client
.SH SYNOPSIS


.PP

.B  javaws 
[-run-options] jnlp file
.br
.B javaws 
[-control-options]
.SH DESCRIPTION


.PP

.B javaws 
is an implementation of a JNLP client. It uses a JNLP (Java Network Launch Protocol) file to securely run a remote Java application or a Java applet. This implementation of 
.B javaws 
is from the IcedTea project and is based on the NetX project.
.br

.br
A JNLP file is an xml file that describes how to securely run a remote Java application or a Java applet.

.SH OPTIONS


.PP
When specifying options, the name of the jnlp file can be after the command, the -jnlp option, an option with no arguments, or after an argument with an option that takes one argument. A html file that launches a jnlp can be specified after the -html option.
.br
The jnlp-file can either be a url or a local path.
.br
The JNLP file should only be specified once, whether as a main argument, after -jnlp or through an html file.
.PP

.B Control options:

.br
.TP 12
\-about 
Shows a sample application.(No argument expected)
.TP 12
\-help 
Prints out information about supported command and basic usage.(No argument expected)
.TP 12
\-license 
Display the GPL license and exit.(No argument expected)
.TP 12
\-viewer 
Shows the trusted certificate viewer.(No argument expected)
.TP 12
\-Xclearcache 
Clean the JNLP application cache.(No argument expected)

.PP

.B Run options:

.br
.TP 12
\-allowredirect 
Follows HTTP redirects.(No argument expected)
.TP 12
\-arg arg
Adds an application argument before launching.(Expected one or more arguments)
.TP 12
\-headless 
Disables download window, other UIs.(No argument expected)
.TP 12
\-html 
Location of HTML file to launch (url or file). You can use parameter ALL  or numbers (like 1 2 5) to select applets on page. However experimental, this switch should keep you still in safety.(Expected one or more arguments)
.TP 12
\-jnlp 
Location of JNLP file to launch (url or file).(Exactly one argument expected)
.TP 12
\-nosecurity 
Disables the secure runtime environment.(No argument expected)
.TP 12
\-noupdate 
Disables checking for updates.(No argument expected)
.TP 12
\-param name=value
Adds an applet parameter before launching.(Expected one or more arguments)
.TP 12
\-property name=value
Sets a system property before launching.(Expected one or more arguments)
.TP 12
\-strict 
Enables strict checking of JNLP file format.(No argument expected)
.TP 12
\-update seconds
Check for updates.(Exactly one argument expected)
.TP 12
\-verbose 
Enable verbose output.(No argument expected)
.TP 12
\-version 
Print the IcedTea-Web version and exit.(No argument expected)
.TP 12
\-Xignoreheaders 
Skip jar header verification.(No argument expected)
.TP 12
\-xml 
Uses a strict XML parser to parse the JNLP file.(No argument expected)
.TP 12
\-Xnofork 
Do not create another JVM.(No argument expected)
.TP 12
\-Xoffline 
Prevent ITW network connection. Only cache will be used. Application can still connect.(No argument expected)
.TP 12
\-Xtrustnone 
Instead of asking user, will foretold all answers as no.(No argument expected)

.SH EXAMPLES


.PP
.TP 12
javaws -about
Shows basic help and about informations.
.TP 12
javaws -about -headless
Shows basic help and about informations in terminal only.
.TP 12
javaws  -Xnofork -Xignoreheaders -allowredirect -Xoffline http://mypage.web/dangerous.jnlp
Will start dangerous.jnlp application, originally from mypage.web, without downloading it, without headers check and in forced single VM.

.SH FILES


.PP
.TP 12
$JAVA_HOME/lib/deployment.config
java-global deployment properties file. May be affected by deployment.jre.dir.
.TP 12
$JAVA_HOME/lib/security/cacerts
Contains  various system java-wide stored certificates. Controlled by 
.B deployment.system.security.cacerts

.TP 12
$JAVA_HOME/lib/security/jssecacerts
Contains  various system java-wide stored certificates. Controlled by 
.B deployment.system.security.jssecacerts

.TP 12
$JAVA_HOME/lib/security/trusted.certs
Contains  various system java-wide stored certificates. Controlled by 
.B deployment.system.security.trusted.certs

.TP 12
$JAVA_HOME/lib/security/trusted.clientcerts
Contains  various system java-wide stored certificates. Controlled by 
.B deployment.system.security.trusted.clientautcerts

.TP 12
$JAVA_HOME/lib/security/trusted.jssecerts
Contains  various system java-wide stored certificates. Controlled by 
.B deployment.system.security.trusted.jssecerts

.TP 12
$TMP/$USER/netx/locks
Location of netx locks. Controlled by 
.B deployment.user.locksdir

.TP 12
$TMP/$USER/netx/locks/netx_running
Location of netx main lock. Controlled by 
.B deployment.user.runningfile

.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/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_CONFIG_HOME/icedtea-web/security/java.policy
Contains granted permissions for selected unsigned apps. Controlled by 
.B deployment.user.security.policy

.TP 12
$XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts
Contains  various users stored certificates. Controlled by 
.B deployment.user.security.trusted.cacerts

.TP 12
$XDG_CONFIG_HOME/icedtea-web/security/trusted.certs
Contains  various users stored certificates. Controlled by 
.B deployment.user.security.trusted.certs

.TP 12
$XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
Contains  various users stored certificates. Controlled by 
.B deployment.user.security.trusted.clientauthcerts

.TP 12
$XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
Contains  various users stored certificates. Controlled by 
.B deployment.user.security.trusted.jssecacerts

.TP 12
$XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
Contains  various users stored certificates. Controlled by 
.B deployment.user.security.trusted.jssecerts

.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