NAME
javaws - a Java Web Start client
SYNOPSIS
javaws [-run-options] jnlp file
javaws [-control-options]
DESCRIPTION
javaws 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)
-browser Launch embeded browser. Use in great need only!(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)
EXAMPLES
javaws -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
$JAVAHOME/lib/deployment.config
java-global deployment properties file. May be affected by
deployment.jre.dir.
$JAVAHOME/lib/security/cacerts
Contains various system java-wide stored certificates.
Controlled by deployment.system.security.cacerts
$JAVAHOME/lib/security/jssecacerts
Contains various system java-wide stored certificates.
Controlled by deployment.system.security.jssecacerts
$JAVAHOME/lib/security/trusted.certs
Contains various system java-wide stored certificates.
Controlled by deployment.system.security.trusted.certs
$JAVAHOME/lib/security/trusted.clientcerts
Contains various system java-wide stored certificates.
Controlled by deployment.system.security.trusted.clien‐
tautcerts
$JAVAHOME/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/netxrunning
Location of netx main lock. Controlled by deploy‐
ment.user.runningfile
$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/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
$XDGCONFIGHOME/icedtea-web/security/java.policy
Contains granted permissions for selected unsigned apps.
Controlled by deployment.user.security.policy
$XDGCONFIGHOME/icedtea-web/security/trusted.cacerts
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.cacerts
$XDGCONFIGHOME/icedtea-web/security/trusted.certs
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.certs
$XDGCONFIGHOME/icedtea-web/security/trusted.clientcerts
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.clientauthcerts
$XDGCONFIGHOME/icedtea-web/security/trusted.jssecacerts
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.jssecacerts
$XDGCONFIGHOME/icedtea-web/security/trusted.jssecerts
Contains various users stored certificates. Controlled by
deployment.user.security.trusted.jssecerts
$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 javaws(1)