NAME¶

SYNOPSIS¶

DESCRIPTION¶

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

OPTIONS¶

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)

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

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¶

SEE ALSO¶

http://icedtea.classpath.org/wiki/IcedTea-Web
http://icedtea.classpath.org/hg/icedtea-web