javaws(1) · carta

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 Network 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 argument, 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)

-Xcacheids: List available IDs in cache, which you can use to delete individual applications.(Expected none or one argument)

-Xclearcache: Clean the JNLP application cache. If you pass argument, only specified application is deleted.(Expected none or one argument)

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. You need also deployment.security.itw.ignorecertissues to workaround corrupted signatures(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)

-startuptracker: Enable startup time tracker(No argument expected)

-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 argument 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

$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.clientautcerts

$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 deployment.user.locksdir

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

$XDG_CACHE_HOME/icedtea-web/cache: Contains cached runtime entries. Controlled by deployment.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 deployment.user.pcachedir

$XDG_CACHE_HOME/icedtea-web/tmp: Contains temporary runtime files. Controlled by deployment.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 deployment.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.

{%WINDIR/Sun/Java or /etc/.java}/deployment/.appletTrustSettings: File responsible for various actions on applets and apps based on their codebase based on admins actions.

{%WINDIR/Sun/Java or /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

The following people have made contibutions to this project.
Please keep this list in alphabetical order.
Lillian Angel <[email protected]>Andrew Azores <[email protected]>Deepak Bhole <[email protected]>Laurent Bourgès <[email protected]>Adam Buchta <[email protected]>Ricardo Martín Camarero <[email protected]>Marcin Cieslak <[email protected]>Danesh Dadachanji <[email protected]>Adam Domurad <[email protected]>Lukasz Dracz <[email protected]>Thomas Fitzsimmons <[email protected]>Olesya Gerasimenko <[email protected]>Michał Górny <[email protected]>Mark Greenwood <[email protected]>Tereza Hlavackova <[email protected]>Lars Herschke <[email protected]>Peter Hatina <[email protected]>Andrew John Hughes <[email protected]>Jie Kang <[email protected]>Alex Kashchenko <[email protected]>Matthias Klose <[email protected]>Alexandr Kolouch <[email protected]>Jan Kmetko <[email protected]>Francis Kung <[email protected]>Denis Lila <[email protected]>DJ Lucas <[email protected]>Omair Majid <[email protected]>Jon A. Maxwell <[email protected]>Thomas Meyer <[email protected]>Kurt Miller <[email protected]>Saad Mohammad <[email protected]>Martin Olsson <[email protected]>Stefan Ring <[email protected]>Ville Skyttä <[email protected]>Fridrich Strba <[email protected]>Andrew Su <[email protected]>Joshua Sumali <[email protected]>Joel Tesdall <[email protected]>Michal Vala <[email protected]>Jiri Vanek <[email protected]>Tomáš Votava <[email protected]>Mark Wielaard <[email protected]>Jacob Wisor <[email protected]>Man Lung Wong <[email protected]>
This project also includes code from the following projects:
OpenJDK <http://openjdk.java.net/>
Netx <http://jnlp.sourceforge.net/netx/>