javaws(1)javaws(1)NAMEjavaws - a Java Web Start client
SYNOPSISjavaws [-run-options] jnlp file
javaws [-control-options]
DESCRIPTIONjavaws is an implementation of a JNLP client. It uses a JNLP (Java Net‐
work Launch Protocol) file to securely run a remote Java application or
a Java applet. This implementation of javaws is from the IcedTea
project and is based on the NetX project.
A JNLP file is an xml file that describes how to securely run a remote
Java application or a Java applet.
OPTIONS
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.
The jnlp-file can either be a url or a local path.
The JNLP file should only be specified once, whether as a main argu‐
ment, after -jnlp or through an html file.
Control options:
-about Shows a sample application.(No argument expected)
-help Prints out information about supported command and basic
usage.(No argument expected)
-license Display the GPL license and exit.(No argument expected)
-viewer Shows the trusted certificate viewer.(No argument expected)
-Xclearcache
Clean the JNLP application cache.(No argument expected)
Run options:
-allowredirect
Follows HTTP redirects.(No argument expected)
-arg arg Adds an application argument before launching.(Expected one
or more arguments)
-headless Disables download window, other UIs.(No argument expected)
-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)
-jnlp Location of JNLP file to launch (url or file).(Exactly one
argument expected)
-nosecurity Disables the secure runtime environment.(No argument
expected)
-noupdate Disables checking for updates.(No argument expected)
-param name=value
Adds an applet parameter before launching.(Expected one or
more arguments)
-property name=value
Sets a system property before launching.(Expected one or
more arguments)
-strict Enables strict checking of JNLP file format.(No argument
expected)
-update seconds
Check for updates.(Exactly one argument expected)
-verbose Enable verbose output.(No argument expected)
-version Print the IcedTea-Web version and exit.(No argument
expected)
-Xignoreheaders
Skip jar header verification.(No argument expected)
-xml Uses a strict XML parser to parse the JNLP file.(No argu‐
ment expected)
-Xnofork Do not create another JVM.(No argument expected)
-Xoffline Prevent ITW network connection. Only cache will be used.
Application can still connect.(No argument expected)
-Xtrustnone Instead of asking user, will foretold all answers as no.(No
argument expected)
EXAMPLESjavaws-about
Shows basic help and about informations.
javaws-about -headless
Shows basic help and about informations in terminal only.
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.
FILES
$JAVA_HOME/lib/deployment.config
java-global deployment properties file. May be affected by
deployment.jre.dir.
$JAVA_HOME/lib/security/cacerts
Contains various system java-wide stored certificates.
Controlled by deployment.system.security.cacerts
$JAVA_HOME/lib/security/jssecacerts
Contains various system java-wide stored certificates.
Controlled by deployment.system.security.jssecacerts
$JAVA_HOME/lib/security/trusted.certs
Contains various system java-wide stored certificates.
Controlled by deployment.system.security.trusted.certs
$JAVA_HOME/lib/security/trusted.clientcerts
Contains various system java-wide stored certificates.
Controlled by deployment.system.security.trusted.clien‐
tautcerts
$JAVA_HOME/lib/security/trusted.jssecerts
Contains various system java-wide stored certificates.
Controlled by deployment.system.security.trusted.jssecerts
$TMP/$USER/netx/locks
Location of netx locks. Controlled by deploy‐
ment.user.locksdir
$TMP/$USER/netx/locks/netx_running
Location of netx main lock. Controlled by deploy‐
ment.user.runningfile
$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/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_CONFIG_HOME/icedtea-web/security/java.policy
Contains granted permissions for selected unsigned apps.
Controlled by deployment.user.security.policy
$XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.cacerts
$XDG_CONFIG_HOME/icedtea-web/security/trusted.certs
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.certs
$XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.clientauthcerts
$XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.jssecacerts
$XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.jssecerts
$XDG_DATA_HOME/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 $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
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.
SEE ALSOicedtea-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.6.2-3.1) 14 Jan 2017 javaws(1)
