*** icedtea-web 1.6.2 *** 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) -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 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. /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 ALSO * icedtea-web * javaws * icedtea-web-plugin * itweb-settings * policyeditor * policytool * java http://icedtea.classpath.org/wiki/IcedTea-Web http://icedtea.classpath.org/hg/icedtea-web