jdk/src/solaris/doc/sun/man/man1/javaws.1
changeset 2692 345bc8d65b19
parent 2 90ce3da70b43
child 5506 202f599c92aa
equal deleted inserted replaced
2691:bad7bbf42755 2692:345bc8d65b19
     1 .'" t
     1 ." Copyright 2003-2006 Sun Microsystems, Inc.  All Rights Reserved.
     2 ." Copyright 2006 Sun Microsystems, Inc.  All Rights Reserved.
       
     3 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4 ."
     3 ."
     5 ." This code is free software; you can redistribute it and/or modify it
     4 ." This code is free software; you can redistribute it and/or modify it
     6 ." under the terms of the GNU General Public License version 2 only, as
     5 ." under the terms of the GNU General Public License version 2 only, as
     7 ." published by the Free Software Foundation.
     6 ." published by the Free Software Foundation.
    17 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    18 ."
    17 ."
    19 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
    18 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
    20 ." CA 95054 USA or visit www.sun.com if you need additional information or
    19 ." CA 95054 USA or visit www.sun.com if you need additional information or
    21 ." have any questions.
    20 ." have any questions.
    22 ." ` 
    21 ."
    23 .TH javaws 1 "05 Aug 2006"
    22 .TH javaws 1 "04 May 2009"
    24 ." Generated by html2roff
    23 ." Generated from HTML by html2man (author: Eric Armstrong)
    25 
    24 
    26 .LP
    25 .LP
    27 
    26 
    28 .LP
    27 .LP
    29 .SH NAME
    28 .SH "Name"
    30 \f2javaws\fP Command Line
    29 \f2javaws\fP Command Line
    31 .LP
    30 .LP
    32 
    31 
    33 .LP
    32 .LP
    34 .LP
    33 .LP
    35 \ 
    34 \ 
    36 .LP
    35 .LP
    37 .SS 
    36 .SS 
    38 NAME
    37 NAME
    39 .LP
    38 .LP
       
    39 .RS 3
    40 
    40 
    41 .LP
    41 .LP
    42 .LP
    42 .LP
    43 \f2javaws\fP \- Java Web Start launcher command
    43 \f2javaws\fP \- Java Web Start launcher command
    44 .LP
    44 .LP
       
    45 .RE
    45 .SS 
    46 .SS 
    46 SYNOPSIS
    47 SYNOPSIS
    47 .LP
    48 .LP
    48 
    49 .RS 3
    49 .LP
    50 
    50 .LP
    51 .LP
    51 \f2javaws [ options ] [ URL ]\fP
    52 .LP
    52 .LP
    53 \f2javaws [run\-options] <jnlp>\fP
       
    54 .LP
       
    55 .LP
       
    56 \f2javaws [control\-options]\fP
       
    57 .LP
       
    58 .RE
    53 .SS 
    59 .SS 
    54 PARAMETERS
    60 PARAMETERS
    55 .LP
    61 .LP
    56 
    62 .RS 3
    57 .LP
    63 
    58 .LP
    64 .LP
    59 \f2options\fP
    65 .LP
    60 .LP
    66 \f2[run\-options]\fP
    61 .RS 3
    67 .LP
    62 
    68 .RS 3
    63 .LP
    69 
    64 .LP
    70 .LP
    65 Command\-line options. Options may be in any order. For a discussion of the various options, see OPTIONS below.
    71 .LP
    66 .LP
    72 Command\-line run\-options. run\-options may be in any order. For a discussion of the various run\-options, see RUN\-OPTIONS below.
    67 .RE
    73 .LP
    68 .LP
    74 .RE
    69 \f2URL\fP
    75 .LP
    70 .LP
    76 \f2<jnlp>\fP
    71 .RS 3
    77 .LP
    72 
    78 .RS 3
    73 .LP
    79 
    74 .LP
    80 .LP
    75 Uniform Resource Locator (\f2URL\fP) of the JNLP (Java Net\-work Launching Protocol) file.
    81 .LP
    76 .LP
    82 This can be either the path of, or the Uniform Resource Locater (URL) of the JNLP (Java Network Launching Protocol) file.
       
    83 .LP
       
    84 .RE
       
    85 .LP
       
    86 \f2[control\-options]\fP
       
    87 .LP
       
    88 .RS 3
       
    89 
       
    90 .LP
       
    91 .LP
       
    92 Command\-line control\-options. control\-options may be in any order. For a discussion of the various control\-options, see CONTROL\-OPTIONS below.
       
    93 .LP
       
    94 .RE
    77 .RE
    95 .RE
    78 .SS 
    96 .SS 
    79 DESCRIPTION
    97 DESCRIPTION
    80 .LP
    98 .LP
       
    99 .RS 3
    81 
   100 
    82 .LP
   101 .LP
    83 .LP
   102 .LP
    84 The \f2javaws\fP command launches Java Web Start, which is the reference implementation of the Java Network Launching Protocol (JNLP). Java Web Start launches Java applications/applets hosted on a network.
   103 The \f2javaws\fP command launches Java Web Start, which is the reference implementation of the Java Network Launching Protocol (JNLP). Java Web Start launches Java applications/applets hosted on a network.
    85 .LP
   104 .LP
    86 .LP
   105 .LP
    87 Without any options \f2javaws\fP will launch the Java JNLP Application Manager, from which users can launch applications/applet or configure Java Web Start.
   106 If a JNLP file is specified, \f2javaws\fP will launch the Java application/applet specified in the JNLP file.
    88 .LP
   107 .LP
    89 .LP
   108 .LP
    90 If a \f2URL\fP for a JNLP file is specified, \f2javaws\fP will launch the Java application/applet specified in the JNLP file.
   109 The \f2javaws\fP launcher has a set of options that are supported in the current release. However, the options may be removed in a future release.
    91 .LP
   110 .LP
    92 .SS 
   111 .RE
    93 OPTIONS
   112 .SS 
    94 .LP
   113 RUN\-OPTIONS
    95 
   114 .LP
    96 .LP
   115 .RS 3
    97 .LP
   116 
    98 The \f2javaws\fP launcher has a set of options that are supported in the current release. However, the options may be removed in a future release. All \f2\-X\fP options are non\-standard and subject to change.
       
    99 .LP
   117 .LP
   100 .LP
   118 .LP
   101 \f2\-offline\fP
   119 \f2\-offline\fP
   102 .LP
   120 .LP
   103 .RS 3
   121 .RS 3
   104 
   122 
   105 .LP
   123 .LP
   106 .LP
   124 .LP
   107 Runs Java Web Start in offline mode.
   125 run Java Web Start in offline mode.
   108 .LP
       
   109 .RE
       
   110 .LP
       
   111 \f2\-uninstall <URL>\fP
       
   112 .LP
       
   113 .RS 3
       
   114 
       
   115 .LP
       
   116 .LP
       
   117 Removes a specific application/applet from the user's cache, as indicated by the URL for the JNLP file. If \f2<URL>\fP is not specified, the entire cache is removed. Java Web Start will exit after the command is completed.
       
   118 .LP
       
   119 .RE
       
   120 .LP
       
   121 \f2\-updateVersions\fP
       
   122 .LP
       
   123 .RS 3
       
   124 
       
   125 .LP
       
   126 .LP
       
   127 Updates the Java Web Start configuration file based on the current machine's settings. Java Web Start will exit after the command is completed.
       
   128 .LP
       
   129 .RE
       
   130 .LP
       
   131 \f2\-Xclearcache\fP
       
   132 .LP
       
   133 .RS 3
       
   134 
       
   135 .LP
       
   136 .LP
       
   137 Clears the user's cache. Java Web Start will exit after the command is completed.
       
   138 .LP
   126 .LP
   139 .RE
   127 .RE
   140 .LP
   128 .LP
   141 \f2\-Xnosplash\fP
   129 \f2\-Xnosplash\fP
   142 .LP
   130 .LP
   143 .RS 3
   131 .RS 3
   144 
   132 
   145 .LP
   133 .LP
   146 .LP
   134 .LP
   147 Disables the display of the initial splash screen.
   135 disable the display of the initial splash screen.
   148 .LP
   136 .LP
   149 .RE
   137 .RE
   150 .LP
   138 .LP
   151 \f2\-import\fP
   139 \f2\-open <arguments>\fP
   152 .LP
   140 .LP
   153 .RS 3
   141 .RS 3
   154 
   142 
   155 .LP
   143 .LP
   156 .LP
   144 .LP
   157 Imports the application specified by URL into the user's cache but does not run it.
   145 If specified, replaces the arguments in the jnlp file with \f2\-open <arguments>\fP.
   158 .LP
   146 .LP
   159 .RE
   147 .RE
       
   148 .LP
       
   149 \f2\-print <arguments>\fP
       
   150 .LP
       
   151 .RS 3
       
   152 
       
   153 .LP
       
   154 .LP
       
   155 If specified, replaces the arguments in the jnlp file with \f2\-print <arguments>\fP.
       
   156 .LP
       
   157 .RE
       
   158 .LP
       
   159 \f2\-online\fP
       
   160 .LP
       
   161 .RS 3
       
   162 
       
   163 .LP
       
   164 .LP
       
   165 run in online mode (default behavior).
       
   166 .LP
       
   167 .RE
       
   168 .LP
       
   169 \f2\-wait\fP
       
   170 .LP
       
   171 .RS 3
       
   172 
       
   173 .LP
       
   174 .LP
       
   175 If specified, the \f2javaws\fP process will not exit until the application exits.
       
   176 .LP
       
   177 .RE
       
   178 .LP
       
   179 \f2\-verbose\fP
       
   180 .LP
       
   181 .RS 3
       
   182 
       
   183 .LP
       
   184 .LP
       
   185 display additional output.
       
   186 .LP
       
   187 .RE
       
   188 .LP
       
   189 \f2\-J<option>\fP
       
   190 .LP
       
   191 .RS 3
       
   192 
       
   193 .LP
       
   194 .LP
       
   195 supply options to the vm.
       
   196 .LP
       
   197 .RE
       
   198 .LP
       
   199 \f2\-system\fP
       
   200 .LP
       
   201 .RS 3
       
   202 
       
   203 .LP
       
   204 .LP
       
   205 run the application from the system cache only.
       
   206 .LP
       
   207 .RE
       
   208 .RE
       
   209 .SS 
       
   210 CONTROL\-OPTIONS
       
   211 .LP
       
   212 .RS 3
       
   213 
       
   214 .LP
       
   215 .LP
       
   216 \f2\-viewer\fP
       
   217 .LP
       
   218 .RS 3
       
   219 
       
   220 .LP
       
   221 .LP
       
   222 show the Cache Viewer in the java control panel
       
   223 .LP
       
   224 .RE
       
   225 .LP
       
   226 \f2\-userConfig <property name>\fP
       
   227 .LP
       
   228 .RS 3
       
   229 
       
   230 .LP
       
   231 .LP
       
   232 clear the specified deployment property.
       
   233 .LP
       
   234 .RE
       
   235 .LP
       
   236 \f2\-userConfig <property name> <property value>\fP
       
   237 .LP
       
   238 .RS 3
       
   239 
       
   240 .LP
       
   241 .LP
       
   242 set the specified deployment property to the specified value.
       
   243 .LP
       
   244 .RE
       
   245 .LP
       
   246 \f2\-uninstall\fP
       
   247 .LP
       
   248 .RS 3
       
   249 
       
   250 .LP
       
   251 .LP
       
   252 remove all applications from the cache.
       
   253 .LP
       
   254 .RE
       
   255 .LP
       
   256 \f2\-uninstall <jnlp>\fP
       
   257 .LP
       
   258 .RS 3
       
   259 
       
   260 .LP
       
   261 .LP
       
   262 remove the application from the cache.
       
   263 .LP
       
   264 .RE
       
   265 .LP
       
   266 \f2\-import [import\-options] <jnlp>\fP
       
   267 .LP
       
   268 .RS 3
       
   269 
       
   270 .LP
       
   271 .LP
       
   272 import the application to the cache.
       
   273 .LP
       
   274 .RE
       
   275 \f3IMPORT\-OPTIONS\fP
       
   276 .LP
   160 .LP
   277 .LP
   161 \f2\-silent\fP
   278 \f2\-silent\fP
   162 .LP
   279 .LP
   163 .RS 3
   280 .RS 3
   164 
   281 
   165 .LP
   282 .LP
   166 .LP
   283 .LP
   167 When used with the \f2\-import\fP option, imports in silent mode; i.e., there will be no UI pop up. The process exit code will be either 0 if successful or 1 if not.
   284 import silently (with no user interface).
       
   285 .LP
       
   286 .RE
       
   287 .LP
       
   288 \f2\-system\fP
       
   289 .LP
       
   290 .RS 3
       
   291 
       
   292 .LP
       
   293 .LP
       
   294 import application to the system cache.
   168 .LP
   295 .LP
   169 .RE
   296 .RE
   170 .LP
   297 .LP
   171 \f2\-codebase <url>\fP
   298 \f2\-codebase <url>\fP
   172 .LP
   299 .LP
   173 .RS 3
   300 .RS 3
   174 
   301 
   175 .LP
   302 .LP
   176 .LP
   303 .LP
   177 Replaces the codebase with \f2<url>\fP in the jnlp file specified when importing the resources. \f2<url>\fP must be a valid \f2URL\fP.
   304 retrieve resources from the given codebase.
   178 .LP
       
   179 .RE
       
   180 .LP
       
   181 \f2\-system\fP
       
   182 .LP
       
   183 .RS 3
       
   184 
       
   185 .LP
       
   186 .LP
       
   187 Uses the system cache instead of the user cache.
       
   188 .LP
   305 .LP
   189 .RE
   306 .RE
   190 .LP
   307 .LP
   191 \f2\-shortcut\fP
   308 \f2\-shortcut\fP
   192 .LP
   309 .LP
   193 .RS 3
   310 .RS 3
   194 
   311 
   195 .LP
   312 .LP
   196 .LP
   313 .LP
   197 Allows the creation of shortcuts during silent import.
   314 install shortcuts as if user allowed prompt. This option has no effect unless \f2\-silent\fP option is also used.
   198 .LP
   315 .LP
   199 .RE
   316 .RE
   200 .LP
   317 .LP
   201 \f2\-association\fP
   318 \f2\-association\fP
   202 .LP
   319 .LP
   203 .RS 3
   320 .RS 3
   204 
   321 
   205 .LP
   322 .LP
   206 .LP
   323 .LP
   207 Allows the creation of associations during silent import.
   324 install associations as if user allowed prompt. This option has no effect unless \f2\-silent\fP option is also used.
   208 .LP
   325 .LP
   209 .RE
   326 .RE
   210 .LP
   327 .RE
   211 \f2\-open <arguments>\fP
       
   212 .LP
       
   213 .RS 3
       
   214 
       
   215 .LP
       
   216 .LP
       
   217 If specified, replaces the arguments in the jnlp file with \f2\-open <arguments>\fP.
       
   218 .LP
       
   219 .RE
       
   220 .LP
       
   221 \f2\-print <arguments>\fP
       
   222 .LP
       
   223 .RS 3
       
   224 
       
   225 .LP
       
   226 .LP
       
   227 If specified, replaces the arguments in the jnlp file with \f2\-print <arguments>\fP.
       
   228 .LP
       
   229 .RE
       
   230 .LP
       
   231 \f2\-online\fP
       
   232 .LP
       
   233 .RS 3
       
   234 
       
   235 .LP
       
   236 .LP
       
   237 Runs in online mode (default behavior).
       
   238 .LP
       
   239 .RE
       
   240 .LP
       
   241 \f2\-viewer\fP
       
   242 .LP
       
   243 .RS 3
       
   244 
       
   245 .LP
       
   246 .LP
       
   247 Runs the Java Application Cache Viewer (default if no URL is specified).
       
   248 .LP
       
   249 .RE
       
   250 .LP
       
   251 \f2\-userConfig <property name>\fP
       
   252 .LP
       
   253 .RS 3
       
   254 
       
   255 .LP
       
   256 .LP
       
   257 Clears the specified deployment property.
       
   258 .LP
       
   259 .RE
       
   260 .LP
       
   261 \f2\-userConfig <property name> <property value>\fP
       
   262 .LP
       
   263 .RS 3
       
   264 
       
   265 .LP
       
   266 .LP
       
   267 Sets the specified deployment property to the specified value.
       
   268 .LP
       
   269 .RE
       
   270 .LP
       
   271 \f2\-wait\fP
       
   272 .LP
       
   273 .RS 3
       
   274 
       
   275 .LP
       
   276 .LP
       
   277 If specified, the \f2javaws\fP process will not exit until the application exits.
       
   278 .LP
       
   279 .RE
       
   280 .LP
       
   281 \ 
       
   282 .LP
       
   283 .SS 
   328 .SS 
   284 FILES
   329 FILES
   285 .LP
   330 .LP
       
   331 .RS 3
   286 
   332 
   287 .LP
   333 .LP
   288 .LP
   334 .LP
   289 For information about the user and system cache and deployment.properties files, see 
   335 For information about the user and system cache and deployment.properties files, see 
   290 .na
   336 .na
   291 \f2System\- and User\-Level Properties\fP @
   337 \f2System\- and User\-Level Properties\fP @
   292 .fi
   338 .fi
   293 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.html.
   339 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.html.
   294 .LP
   340 .LP
       
   341 .RE
   295 .SS 
   342 .SS 
   296 MORE INFORMATION
   343 MORE INFORMATION
   297 .LP
   344 .LP
       
   345 .RS 3
   298 
   346 
   299 .LP
   347 .LP
   300 .LP
   348 .LP
   301 For more information about Java Web Start, see 
   349 For more information about Java Web Start, see 
   302 .na
   350 .na
   303 \f2Java Web Start version 1.5.0\fP @
   351 \f2Java Web Start\fP @
   304 .fi
   352 .fi
   305 http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html.
   353 http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html.
   306 .LP
   354 .LP
   307 .RS 3
   355 .RS 3
   308 
   356 
   309 .LP
   357 .LP
   310 .LP
   358 .LP
   311 \ 
   359 \ 
   312 .LP
   360 .LP
   313 .RE
   361 .RE
       
   362 .RE
       
   363 
       
   364 .LP
   314  
   365