javaws

Section: User Commands (1)
Updated: 26 Jan 2021
Page Index

 

NAME

javaws - a 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 file to securely run a remote application or an 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 application or an applet.

 

Missing Resource: manCommandLineOptions_en

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 embedded browser. Use in great need only!(Expected one or more arguments)
-headless
Disables download window, other UIs.(No argument expected)
-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)
-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)
-Xnosplash
Do not show splash screen. (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 answer all questions with 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
JVM-global deployment properties file. May be affected by deployment.jre.dir.
$JAVA_HOME/lib/security/cacerts
Contains various system JVM-wide stored certificates. Controlled by deployment.system.security.cacerts

$JAVA_HOME/lib/security/jssecacerts
Contains various system JVM-wide stored certificates. Controlled by deployment.system.security.jssecacerts

$JAVA_HOME/lib/security/trusted.certs
Contains various system JVM-wide stored certificates. Controlled by deployment.system.security.trusted.certs

$JAVA_HOME/lib/security/trusted.clientcerts
Contains various system JVM-wide stored certificates. Controlled by deployment.system.security.trusted.clientautcerts

$JAVA_HOME/lib/security/trusted.jssecerts
Contains various system JVM-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
https://github.com/AdoptOpenJDK/icedtea-web/issues


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 the console) with URL to jnlp or html file (or the jnlp/html file or application itself) when filling out the bug report.

 

AUTHOR

https://github.com/AdoptOpenJDK/icedtea-web/graphs/contributors

 

SEE ALSO

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


https://github.com/AdoptOpenJDK/icedtea-web
https://github.com/AdoptOpenJDK/icedtea-web.git


 

Index

NAME
SYNOPSIS
DESCRIPTION
Missing Resource: manCommandLineOptions_en
EXAMPLES
FILES
BUGS
AUTHOR
SEE ALSO