Ubuntu Manpage: javaws - a Java Web Start client

Provided by: icedtea-netx_1.8.4-1build1_all

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)

       -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   <langel@redhat.com>Andrew   Azores   <aazores@redhat.com>Deepak   Bhole
       <dbhole@redhat.com>Laurent      Bourgès       <bourges.laurent@gmail.com>Adam       Buchta
       <adbuch7@gmail.com>Ricardo    Martín    Camarero   <rickyepoderi@yahoo.es>Marcin   Cieslak
       <marcin.cieslak@gmail.com>Danesh     Dadachanji     <ddadacha@redhat.com>Adam      Domurad
       <adomurad@redhat.com>Lukasz        Dracz       <ldracz@redhat.com>Thomas       Fitzsimmons
       <fitzsim@redhat.com>Olesya       Gerasimenko       <gammaray@basealt.ru>Michał       Górny
       <mgorny@gentoo.org>Mark       Greenwood       <mark@dcs.shef.ac.uk>Tereza       Hlavackova
       <hlavackova.tereza@gmail.com>Lars      Herschke      <lhersch@dssgmbh.de>Peter      Hatina
       <phatina@redhat.com>Andrew John Hughes <ahughes@redhat.com>Jie Kang <jkang@redhat.com>Alex
       Kashchenko   <akashche@redhat.com>Matthias   Klose    <doko@ubuntu.com>Alexandr    Kolouch
       <skolnag@gmail.com>Jan         Kmetko         <jan.kmetko.ml@gmail.com>Francis        Kung
       <fkung@redhat.com>Denis  Lila  <dlila@redhat.com>DJ  Lucas   <dj@lucasit.com>Omair   Majid
       <omajid@redhat.com>Jon    A.    Maxwell    <jmaxwell@users.sourceforge.net>Thomas    Meyer
       <thomas@m3y3r.de>Kurt       Miller        <kurt@intricatesoftware.com>Saad        Mohammad
       <smohammad@redhat.com>Martin         Olsson          <martin@minimum.se>Stefan        Ring
       <stefan@complang.tuwien.ac.at>Ville     Skyttä     <ville.skytta@iki.fi>Fridrich     Strba
       <fridrich.strba@suse.com>Andrew  Su <asu@redhat.com>Joshua Sumali <jsumali@redhat.com>Joel
       Tesdall      <jtesdall@mapcon.com>Michal      Vala      <mvala@redhat.com>Jiri       Vanek
       <jvanek@redhat.com>Tomáš  Votava <tomcacolca@gmail.com>Mark Wielaard <mark@klomp.org>Jacob
       Wisor  <gitne@excite.co.jp>Man Lung Wong <mwong@redhat.com>
       This project also includes code from the following projects:
       OpenJDK <http://openjdk.java.net/>
       Netx <http://jnlp.sourceforge.net/netx/>