blob: 429a4f1d15da11afe10fd18f5e0b4aae526b15e5 [file] [log] [blame]
duke6e45e102007-12-01 00:00:00 +00001.'" t
2."
3." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
4." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5."
6." This code is free software; you can redistribute it and/or modify it
7." under the terms of the GNU General Public License version 2 only, as
8." published by the Free Software Foundation.
9."
10." This code is distributed in the hope that it will be useful, but WITHOUT
11." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
13." version 2 for more details (a copy is included in the LICENSE file that
14." accompanied this code).
15."
16." You should have received a copy of the GNU General Public License version
17." 2 along with this work; if not, write to the Free Software Foundation,
18." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
19."
20." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21." CA 95054 USA or visit www.sun.com if you need additional information or
22." have any questions.
23."
24." `
25.TH javaws 1 "05 Aug 2006"
26." Generated by html2roff
27
28.LP
29
30.LP
31.SH NAME
32\f2javaws\fP Command Line
33.LP
34
35.LP
36.LP
37\
38.LP
39.SS
40NAME
41.LP
42
43.LP
44.LP
45\f2javaws\fP \- Java Web Start launcher command
46.LP
47.SS
48SYNOPSIS
49.LP
50
51.LP
52.LP
53\f2javaws [ options ] [ URL ]\fP
54.LP
55.SS
56PARAMETERS
57.LP
58
59.LP
60.LP
61\f2options\fP
62.LP
63.RS 3
64
65.LP
66.LP
67Command\-line options. Options may be in any order. For a discussion of the various options, see OPTIONS below.
68.LP
69.RE
70.LP
71\f2URL\fP
72.LP
73.RS 3
74
75.LP
76.LP
77Uniform Resource Locator (\f2URL\fP) of the JNLP (Java Net\-work Launching Protocol) file.
78.LP
79.RE
80.SS
81DESCRIPTION
82.LP
83
84.LP
85.LP
86The \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.
87.LP
88.LP
89Without any options \f2javaws\fP will launch the Java JNLP Application Manager, from which users can launch applications/applet or configure Java Web Start.
90.LP
91.LP
92If a \f2URL\fP for a JNLP file is specified, \f2javaws\fP will launch the Java application/applet specified in the JNLP file.
93.LP
94.SS
95OPTIONS
96.LP
97
98.LP
99.LP
100The \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.
101.LP
102.LP
103\f2\-offline\fP
104.LP
105.RS 3
106
107.LP
108.LP
109Runs Java Web Start in offline mode.
110.LP
111.RE
112.LP
113\f2\-uninstall <URL>\fP
114.LP
115.RS 3
116
117.LP
118.LP
119Removes 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.
120.LP
121.RE
122.LP
123\f2\-updateVersions\fP
124.LP
125.RS 3
126
127.LP
128.LP
129Updates the Java Web Start configuration file based on the current machine's settings. Java Web Start will exit after the command is completed.
130.LP
131.RE
132.LP
133\f2\-Xclearcache\fP
134.LP
135.RS 3
136
137.LP
138.LP
139Clears the user's cache. Java Web Start will exit after the command is completed.
140.LP
141.RE
142.LP
143\f2\-Xnosplash\fP
144.LP
145.RS 3
146
147.LP
148.LP
149Disables the display of the initial splash screen.
150.LP
151.RE
152.LP
153\f2\-import\fP
154.LP
155.RS 3
156
157.LP
158.LP
159Imports the application specified by URL into the user's cache but does not run it.
160.LP
161.RE
162.LP
163\f2\-silent\fP
164.LP
165.RS 3
166
167.LP
168.LP
169When 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.
170.LP
171.RE
172.LP
173\f2\-codebase <url>\fP
174.LP
175.RS 3
176
177.LP
178.LP
179Replaces the codebase with \f2<url>\fP in the jnlp file specified when importing the resources. \f2<url>\fP must be a valid \f2URL\fP.
180.LP
181.RE
182.LP
183\f2\-system\fP
184.LP
185.RS 3
186
187.LP
188.LP
189Uses the system cache instead of the user cache.
190.LP
191.RE
192.LP
193\f2\-shortcut\fP
194.LP
195.RS 3
196
197.LP
198.LP
199Allows the creation of shortcuts during silent import.
200.LP
201.RE
202.LP
203\f2\-association\fP
204.LP
205.RS 3
206
207.LP
208.LP
209Allows the creation of associations during silent import.
210.LP
211.RE
212.LP
213\f2\-open <arguments>\fP
214.LP
215.RS 3
216
217.LP
218.LP
219If specified, replaces the arguments in the jnlp file with \f2\-open <arguments>\fP.
220.LP
221.RE
222.LP
223\f2\-print <arguments>\fP
224.LP
225.RS 3
226
227.LP
228.LP
229If specified, replaces the arguments in the jnlp file with \f2\-print <arguments>\fP.
230.LP
231.RE
232.LP
233\f2\-online\fP
234.LP
235.RS 3
236
237.LP
238.LP
239Runs in online mode (default behavior).
240.LP
241.RE
242.LP
243\f2\-viewer\fP
244.LP
245.RS 3
246
247.LP
248.LP
249Runs the Java Application Cache Viewer (default if no URL is specified).
250.LP
251.RE
252.LP
253\f2\-userConfig <property name>\fP
254.LP
255.RS 3
256
257.LP
258.LP
259Clears the specified deployment property.
260.LP
261.RE
262.LP
263\f2\-userConfig <property name> <property value>\fP
264.LP
265.RS 3
266
267.LP
268.LP
269Sets the specified deployment property to the specified value.
270.LP
271.RE
272.LP
273\f2\-wait\fP
274.LP
275.RS 3
276
277.LP
278.LP
279If specified, the \f2javaws\fP process will not exit until the application exits.
280.LP
281.RE
282.LP
283\
284.LP
285.SS
286FILES
287.LP
288
289.LP
290.LP
291For information about the user and system cache and deployment.properties files, see
292.na
293\f2System\- and User\-Level Properties\fP @
294.fi
295http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.html.
296.LP
297.SS
298MORE INFORMATION
299.LP
300
301.LP
302.LP
303For more information about Java Web Start, see
304.na
305\f2Java Web Start version 1.5.0\fP @
306.fi
307http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html.
308.LP
309.RS 3
310
311.LP
312.LP
313\
314.LP
315.RE
316