source: archive/jdk.SAVE

trunk
Last change on this file was fda29e4, checked in by Xi Ruoyao <xry111@…>, 3 months ago

remove hardcoded $Date: $

  • Property mode set to 100644
File size: 36.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY jdk-download-binary "http://java.sun.com/javase/downloads/index.jsp">
8 <!ENTITY jdk-bin-md5sum "f7528500c17c09546566e05988beda86">
9 <!ENTITY jdk-bin-size "67 MB">
10 <!ENTITY jdk-bin-buildsize "207 MB">
11 <!ENTITY jdk-bin-version "6u5">
12
13 <!ENTITY jdk-source-jrl-md5sum "83390379fb9f3193e93a9d5eed5b31d9">
14 <!ENTITY jdk-source-bin-md5sum "8b6f1b8d8dec051c18385539111141ec">
15 <!ENTITY jdk-source-moz-md5sum "6dcaf7af16211617adff5d672a8b79f4">
16
17 <!ENTITY jdk-source-jrl-size "111 MB">
18 <!ENTITY jdk-source-bin-size "2 MB">
19 <!ENTITY jdk-source-moz-size "8.2 MB">
20
21 <!ENTITY jdk-src-buildsize "1.5 GB">
22 <!ENTITY jdk-time "12.5 SBU (for both installations)">
23 <!ENTITY jdk-version-string "6u3">
24 <!ENTITY jdk-bin-version-string "1.6.0_05">
25
26 <!ENTITY jdk-download-source-jrl "http://www.java.net/download/jdk6/&jdk-version-string;/promoted/b05/jdk-&jdk-version-string;-fcs-src-b05-jrl-24_sep_2007.jar">
27 <!ENTITY jdk-download-source-bin "http://www.java.net/download/jdk6/&jdk-version-string;/promoted/b05/jdk-&jdk-version-string;-fcs-bin-b05-jrl-24_sep_2007.jar">
28 <!ENTITY jdk-download-source-moz "http://www.java.net/download/jdk6/&jdk-version-string;/promoted/b05/jdk-&jdk-version-string;-fcs-mozilla_headers-b05-unix-24_sep_2007.jar">
29
30]>
31
32<sect1 id="jdk" xreflabel="JDK-&jdk-version;">
33 <?dbhtml filename="jdk.html" ?>
34
35 <sect1info>
36 <date>$Date$</date>
37 </sect1info>
38
39 <title>JDK-&jdk-version;</title>
40
41 <indexterm zone="jdk">
42 <primary sortas="a-JDK">JDK</primary>
43 </indexterm>
44
45 <sect2 role="package">
46 <title>Introduction to JDK</title>
47
48 <para>The <application>JDK</application> package contains
49 Sun's <application>Java</application> development environment. This is
50 useful for developing <application>Java</application> programs and provides
51 the runtime environment necessary to run <application>Java</application>
52 programs. It also includes a plug-in for browsers so that they can be
53 <application>Java</application> aware.</para>
54
55 <!-- Previously, the plugin included
56 in the <application>JDK</application> binary package was unusable on LFS
57 owing to incompatibilities with <application>GCC</application>-3 compiled
58 browsers. This is not the case anymore.</para> -->
59
60 <para>The <application>JDK</application> comes in two flavors, a
61 precompiled binary and a source package. You will first need to download
62 and install the binary version of the <application>JDK</application>
63 (you'll need to click and agree to the <quote>Sun Microsystems, Inc.
64 Binary Code License Agreement</quote>). To build from the source, you
65 will need to read, and agree to the Sun
66 <!--<ulink url="&patch-root;/jdk-Readme.txt">-->Java Research License<!--</ulink>-->.
67 You will also need to download the additional files and patches to
68 complete the source build as detailed below. Note that in some countries
69 you cannot download the source code.</para>
70
71 <warning><para>Sun has recently decided not to provide JRL sources for
72 the latest update versions of the JDK. The source build instructions and
73 patches are here for reference only, and contain known security
74 vulnerabilities. For more information, please see Sun Alerts
75 <ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-231246-1">231246</ulink>,
76 <ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233321-1">233321</ulink>,
77 <ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233322-1">233322</ulink>,
78 <ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233323-1">233323</ulink>,
79 <ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233324-1">233324</ulink>,
80 <ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233325-1">233325</ulink>,
81 <ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233326-1">233326</ulink>, and
82 <ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233327-1">233327</ulink>.</para>
83 <para> Sun is actively working on a GPL'd version of the JDK, titled
84 <ulink url="http://openjdk.java.net/projects/jdk6/">OpenJDK</ulink>.
85 This new JDK will be licensed under the
86 <ulink url="http://openjdk.java.net/legal/gplv2+ce.html">GNU General
87 Public License, version 2, with the Classpath Exception</ulink>.
88 A stable OpenJDK was not available at the time of writing.</para></warning>
89
90
91 <bridgehead renderas="sect3">Binary Package Information</bridgehead>
92 <itemizedlist spacing="compact">
93 <listitem>
94 <para>Binary download (jdk-&jdk-bin-version;-linux-i586.bin):
95 <ulink url="&jdk-download-binary;"/></para>
96 </listitem>
97 <listitem>
98 <para>Download MD5 sum: &jdk-bin-md5sum;</para>
99 </listitem>
100 <listitem>
101 <para>Download size (binary): &jdk-bin-size;</para>
102 </listitem>
103 <listitem>
104 <para>Estimated disk space required: &jdk-bin-buildsize;</para>
105 </listitem>
106 </itemizedlist>
107
108 <bridgehead renderas="sect3">Source Package Information</bridgehead>
109
110 <itemizedlist spacing="compact">
111 <listitem>
112 <para>JRL Source
113 <simplelist>
114 <member><ulink url="&jdk-download-source-jrl;"/></member>
115 <member>&jdk-source-jrl-md5sum;</member>
116 <member>&jdk-source-jrl-size;</member>
117 </simplelist>
118 </para>
119 </listitem>
120 <listitem>
121 <para>Source Binaries
122 <simplelist>
123 <member><ulink url="&jdk-download-source-bin;"/></member>
124 <member>&jdk-source-bin-md5sum;</member>
125 <member>&jdk-source-bin-size;</member>
126 </simplelist>
127 </para>
128 </listitem>
129 <listitem>
130 <para>Mozilla Headers
131 <simplelist>
132 <member><ulink url="&jdk-download-source-moz;"/></member>
133 <member>&jdk-source-moz-md5sum;</member>
134 <member>&jdk-source-moz-size;</member>
135 </simplelist>
136 </para>
137 </listitem>
138 <listitem>
139 <para>Estimated disk space required: &jdk-src-buildsize;</para>
140 </listitem>
141 <listitem>
142 <para>Estimated build time: &jdk-time;</para>
143 </listitem>
144 </itemizedlist>
145
146 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
147
148 <bridgehead renderas="sect4">Required Patches</bridgehead>
149 <itemizedlist spacing='compact'>
150 <listitem>
151 <para><ulink
152 url="&patch-root;/jdk-&jdk-version-string;-gcc4-1.patch"/></para>
153 </listitem>
154 <listitem>
155 <para><ulink
156 url="&patch-root;/jdk-&jdk-version-string;-motif_fixes-1.patch"/></para>
157 </listitem>
158 <listitem>
159 <para><ulink
160 url="&patch-root;/jdk-&jdk-version-string;-remove_fixed_paths-1.patch"/></para>
161 </listitem>
162 </itemizedlist>
163
164 <bridgehead renderas="sect3">JDK Dependencies</bridgehead>
165
166 <bridgehead renderas="sect4">Optional Runtime Dependencies (for binary
167 installation)</bridgehead>
168 <para role="optional">
169 <xref linkend="alsa-lib"/>,
170 <xref linkend="cups"/>, and
171 <xref linkend="gtk2"/></para>
172
173 <bridgehead renderas="sect4">Additional Requirements
174 (for source build, including optional requirements)</bridgehead>
175 <para role="required">
176 <xref linkend="cpio"/>,
177 <xref linkend="ksh"/>,
178 <xref linkend="unzip"/>,
179 <xref linkend="which"/>, and
180 <xref linkend="zip"/></para>
181
182 <para condition="html" role="usernotes">User Notes:
183 <ulink url="&blfs-wiki;/jdk"/></para>
184
185 </sect2>
186
187 <sect2 role="installation">
188 <title>Installation of JDK</title>
189
190 <para>The instructions below install both the binary and source versions.
191 You may stop after installing the binary version or continue on installing
192 the source version. You can choose to keep either or both.</para>
193
194 <tip>
195 <para>The <command>./jdk-&jdk-bin-version;-linux-i586.bin</command>
196 command below unpacks the distribution into a
197 <filename class='directory'>jdk&jdk-bin-version-string;</filename>
198 directory. You will be required to view, and then accept (by entering a
199 <keycap>y</keycap> keypress), a license agreement before any files are
200 unpacked. If you are scripting (automating) the build, you'll need to
201 account for this. There is information about automating build commands
202 in the <xref linkend="automating-builds"/> section of Chapter 2. Towards
203 the end of this section, specific information for automating this type of
204 installation is discussed.</para>
205 </tip>
206
207 <para>Normally in BLFS, the files are unpacked into a subdirectory
208 and the starting point for the installation procedures is that
209 location. For this application only, start in the directory where all
210 the downloaded files are located.</para>
211
212 <para>Install the binary <application>JDK</application> with the
213 following commands:</para>
214
215<screen><userinput>chmod 755 jdk-&jdk-bin-version;-linux-i586.bin &amp;&amp;
216./jdk-&jdk-bin-version;-linux-i586.bin</userinput></screen>
217
218 <note><para>The installation will end with a message
219 "./jdk-&jdk-bin-version;-linux-i586.bin: line 43: 20283 Aborted" as
220 javaprefix is unset in the environment. This is by design as
221 <application>GTK+</application> may not be installed during the
222 installation, however, the installation will still exit with a zero error
223 value if scripting the build.</para></note>
224
225 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
226
227<screen role="root"><userinput>cd jdk&jdk-bin-version-string; &amp;&amp;
228install -v -m755 -d /opt/jdk-bin-&jdk-bin-version; &amp;&amp;
229mv -v * /opt/jdk-bin-&jdk-bin-version; &amp;&amp;
230chown -v -R root:root /opt/jdk-bin-&jdk-bin-version; &amp;&amp;
231ln -v -sf xawt/libmawt.so \
232 /opt/jdk-bin-&jdk-bin-version;/jre/lib/i386/ &amp;&amp;
233cd ..</userinput></screen>
234
235 <para>Recent versions of libX11 break libmawt
236 when used with the Xinerama extension. While still the
237 <systemitem class="username">root</systemitem> user, apply the
238 following sed to the installed binary to work around this
239 problem:</para>
240
241<screen role="root"><userinput>sed -i 's@XINERAMA@FAKEEXTN@g' \
242 /opt/jdk-bin-&jdk-bin-version;/jre/lib/i386/xawt/libmawt.so</userinput></screen>
243
244 <para>The binary version is now installed.</para>
245
246 <para>If you don't want to compile the source or are not in a position to
247 download the source owing to license restrictions, skip ahead to the
248 configuration section.</para>
249
250 <para>Save the existing path, and append the recently installed
251 <application>JDK</application>.</para>
252
253<screen><userinput>export JAVA_HOME=/opt/jdk-bin-&jdk-bin-version; &amp;&amp;
254export PATH_HOLD=${PATH} &amp;&amp;
255export PATH=${PATH}:${JAVA_HOME}/bin</userinput></screen>
256
257 <para>The source code is contained in self-extracting
258 <filename class='extension'>jar</filename> files. You
259 will need to be in a windowed environment to extract the sources.
260 Create a directory to store the extracted sources. Choose the newly
261 created <filename class="directory">jdk-build</filename> directory
262 when prompted for the target directory.</para>
263
264<screen><userinput>mkdir jdk-build &amp;&amp;
265cd jdk-build &amp;&amp;
266for JAR in ../jdk-&jdk-version-string;*.jar
267 do java -jar ${JAR}
268done</userinput></screen>
269
270 <para>Apply all the patches downloaded above:</para>
271
272<screen><userinput>for PATCH in ../jdk-&jdk-version-string;*.patch
273 do patch -Np1 -i ${PATCH}
274done</userinput></screen>
275
276 <para>Use the following commands to apply some minor changes that
277 are a little more specific to BLFS, such as lack of a gcc-2.9
278 compiler, removing a broken demo, and forcing to link to shared
279 libraries. See the 'Command Explanations' section for more detail:</para>
280
281<screen><userinput>sed -i '/^.*linux)/ { N; /.*/ { N; /.*/d }}' \
282 deploy/make/plugin/{adapter,nscore}/Makefile &amp;&amp;
283sed -i '/.*mtrace.*/ { N; /.*/ s/.*mtrace.*\n.*/\t mtrace/ }' \
284 j2se/make/mkdemo/jvmti/Makefile &amp;&amp;
285sed -i 's/= true/= false/' \
286 j2se/make/common/shared/Compiler-gcc.gmk</userinput></screen>
287
288 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
289 href="../../xincludes/X11R6_symlink.xml"/>
290
291 <!-- <para>If your <application>X Window System</application> is installed into
292 any prefix other than <filename class="directory">/usr/X11R6</filename>,
293 execute the following commands, replacing
294 <replaceable>&lt;PREFIX&gt;</replaceable> with the installation prefix of
295 the <application>X Window System</application>:</para>
296
297<screen><userinput>for file in `find . -name Makefile \
298 -or -name Imakefile -or -name *.gmk`
299do sed -i 's@/usr/X11R6@<replaceable>&lt;PREFIX&gt;</replaceable>@g' $file
300done &amp;&amp;
301sed -i 's@/usr/X11R6@<replaceable>&lt;PREFIX&gt;</replaceable>@g' \
302 j2se/src/solaris/native/sun/awt/fontpath.c \
303 j2se/src/solaris/classes/sun/awt/motif/linux.fontconfig.Sun.properties \
304 j2se/src/solaris/classes/sun/awt/motif/linux.fontconfig.RedHat.3.properties</userinput></screen> -->
305
306 <para>Set/unset some variables which affect the build:</para>
307
308<screen><userinput>export ALT_BOOTDIR=${JAVA_HOME} &amp;&amp;
309export CLASSPATH_HOLD=${CLASSPATH} &amp;&amp;
310export ALT_CACERTS_FILE=${ALT_BOOTDIR}/jre/lib/security/cacerts &amp;&amp;
311export ALT_MOZILLA_HEADERS_PATH=${PWD}/share/plugin &amp;&amp;
312export MILESTONE="03-BLFS" &amp;&amp;
313export BUILD_NUMBER="b05" &amp;&amp;
314export INSANE=true &amp;&amp;
315export DEV_ONLY=true &amp;&amp;
316export SKIP_FASTDEBUG_BUILD=true &amp;&amp;
317unset JAVA_HOME CLASSPATH CFLAGS CXXFLAGS LDFLAGS</userinput></screen>
318
319 <warning><para>Setting CFLAGS/CXXFLAGS/LDFLAGS is guaranteed to make
320 the build fail. If you are interested in optimizing the build, set
321 OTHER_CFLAGS/OTHER_CXXFLAGS/OTHER_LDFLAGS instead. -O3, even in
322 OTHER_C{,XX}FLAGS, is known to cause a build failure.</para></warning>
323
324
325 <para>Additionally, if you would like to <command>make</command> in
326 parallel, add the following:</para>
327
328<screen><userinput>export HOTSPOT_BUILD_JOBS=<replaceable>&lt;3&gt;</replaceable></userinput></screen>
329
330 <para>Build the <application>JDK</application> with the following
331 commands. There will be a few messages about missing files that look like
332 errors. These are caused by not meeting the expected build environment
333 (Red Hat). As long as the build doesn't stop, the messages
334 are harmless.</para>
335
336<screen><userinput>pushd control/make &amp;&amp;
337make &amp;&amp;
338popd</userinput></screen>
339
340 <para>To test the results, you can run one of the provided demo programs
341 using the newly created <command>java</command> binary. Issue the
342 following commands:</para>
343
344<screen><userinput>pushd control/build/linux-i586/j2sdk-image/demo/jfc/Java2D &amp;&amp;
345../../../bin/java -jar Java2Demo.jar &amp;&amp;
346popd</userinput></screen>
347
348 <para>Now, as the <systemitem class="username">root</systemitem> user,
349 install the <application>JDK</application>:</para>
350
351<screen role="root"><userinput>pushd control/build/linux-i586 &amp;&amp;
352cp -v -a j2sdk-image /opt/jdk-&jdk-version-string; &amp;&amp;
353chown -v -R root:root /opt/jdk-&jdk-version-string; &amp;&amp;
354ln -v -sf xawt/libmawt.so /opt/jdk-&jdk-version-string;/jre/lib/i386/ &amp;&amp;
355popd</userinput></screen>
356
357 <para>Restore the unprivileged user's environment using the following
358 commands:</para>
359
360<screen><userinput>export JAVA_HOME=${ALT_BOOTDIR} &amp;&amp;
361export CLASSPATH=${CLASSPATH_HOLD} &amp;&amp;
362export PATH=${PATH_HOLD} &amp;&amp;
363unset PATH_HOLD ALT_BOOTDIR CLASSPATH_HOLD \
364 ALT_CACERTS_FILE ALT_MOZILLA_HEADERS_PATH \
365 BUILD_NUMBER MILESTONE INSANE DEV_ONLY \
366 SKIP_FASTDEBUG_BUILD</userinput></screen>
367
368 </sect2>
369
370 <sect2 role="commands">
371 <title>Command Explanations</title>
372
373 <para><command>sed -i '/^.*linux)/...</command>: This command disables
374 the build of a gcc-2.9 compatible browser plugin. LFS does not contain
375 gcc-2.9, and hasn't in quite a few years.</para>
376
377 <para><command>sed -i '/.*mtrace.*/...</command>: This command disables
378 building of the broken 'waiters' demo.</para>
379
380 <para><command>sed -i 's/= true/= false/'...</command>: This command
381 forces the compiler to link against the standard C libraries
382 dynamically.</para>
383
384 <para><command>export ALT_BOOTDIR=${JAVA_HOME}</command>: This variable sets
385 the location of the bootstrap <application>JDK</application>.</para>
386
387 <para><command>export ALT_CACERTS_FILE...</command>: Specifies the
388 certificate file to use (from the installed binary
389 <application>JDK</application>).</para>
390
391 <para><command>export ALT_MOZILLA_HEADERS_PATH=${PWD}/share/plugin/</command>:
392 This tells the build exactly where to find the
393 <application>Mozilla</application> headers. This has changed since the
394 previous version and is not mentioned in the installation documentation
395 included with the package source.</para>
396
397 <para><command>export MILESTONE="03-BLFS"</command>: This appends
398 the string '03-BLFS' to the buld number. 'internal' is
399 unconditionally added if MILESTONE is unset. This is similar
400 to the format used by Sun for the official release.</para>
401
402 <para><command>export BUILD_NUMBER="b05"</command>:
403 This will help you identify the compiled version of the runtime
404 environment and virtual machine by appending this information to
405 the version string. This is the same build number used by Sun to
406 identify the official release.</para>
407
408 <para><command>export INSANE=true</command>: The certified platform for the
409 build is Redhat Enterprise Advanced Server 2.1. This variable ensures that
410 all the errors related to compiling on a non-certified platform will be
411 displayed as warnings instead of errors.</para>
412
413 <para><command>export DEV_ONLY=true</command>: This command
414 skips compiling the comparison build.</para>
415
416 <para><command>export SKIP_FASTDEBUG_BUILD=true</command>: This command
417 skips building of the debug version. Omit this command if you need
418 to build the fastdebug target.</para>
419
420 <para><command>unset JAVA_HOME CLASSPATH CFLAGS CXXFLAGS LDFLAGS</command>:
421 These variables cause miscompilation of the build. Never set them.</para>
422
423 <para><command>ln -sf xawt/libmawt.so
424 /opt/jdk-&jdk-version-string;/jre/lib/i386/</command>: This fixes
425 linking issues with other applications that expect to find the
426 <application>motif</application> libraries with the other
427 <application>JDK</application> libraries.</para>
428
429 </sect2>
430
431 <sect2 role="configuration">
432 <title>Configuring JDK</title>
433
434 <sect3>
435 <title>Configuration Information</title>
436
437 <para>There are now two Java 2 SDKs installed in
438 <filename>/opt</filename>. You should decide on which one you
439 would like to use as the default. For example if you decide to use the
440 precompiled <application>JDK</application>, do the following as the
441 <systemitem class="username">root</systemitem> user:</para>
442
443<screen role="root"><userinput>ln -v -nsf jdk-bin-&jdk-bin-version; /opt/jdk</userinput></screen>
444
445 <para>The information below assumes your system is set up using the
446 instructions found in
447 <quote><xref linkend="postlfs-config-profile"/></quote>. You may need to
448 extract the relevant information below and incorporate it into your
449 system's startup files if your system is set up differently.</para>
450
451 <para>Add the following <filename>jdk.sh</filename> shell startup file to
452 the <filename>/etc/profile.d</filename> directory with the following
453 commands as the <systemitem class="username">root</systemitem> user:</para>
454
455<screen role="root"><userinput>cat &gt; /etc/profile.d/jdk.sh &lt;&lt; "EOF"
456<literal># Begin /etc/profile.d/jdk.sh
457
458# Set JAVA_HOME directory
459JAVA_HOME=/opt/jdk
460
461# Adjust PATH
462pathappend ${JAVA_HOME}/bin PATH
463
464# Auto Java CLASSPATH
465# Copy jar files to, or create symlinks in this directory
466AUTO_CLASSPATH_DIR=/usr/lib/classpath
467pathprepend . CLASSPATH
468for dir in `find ${AUTO_CLASSPATH_DIR} -type d 2>/dev/null`; do
469 pathappend $dir CLASSPATH
470done
471
472export JAVA_HOME CLASSPATH
473unset AUTO_CLASSPATH_DIR
474unset dir
475
476# End /etc/profile.d/jdk.sh</literal>
477EOF</userinput></screen>
478
479 <para>The <application>Java</application> plugin is located in
480 <filename class="directory">$JAVA_HOME/jre/plugin/i?86/ns7/</filename>.
481 Make a symbolic link to the file in that directory from your browser(s)
482 plugins directory.</para>
483
484 <important>
485 <para>The plugin must be a symlink for it to work. If not, the browsers
486 will crash when you attempt to load a <application>Java</application>
487 application.</para>
488 </important>
489
490 </sect3>
491
492 </sect2>
493
494 <sect2 role="content">
495 <title>Contents</title>
496
497 <segmentedlist>
498 <segtitle>Installed Programs</segtitle>
499 <segtitle>Installed Libraries</segtitle>
500 <segtitle>Installed Directory</segtitle>
501
502 <seglistitem>
503 <seg>appletviewer, apt, extcheck, idlj, HtmlConverter, jar,
504 jarsigner, java, javac, javadoc, javah, javap, java-rmi.cgi,
505 javaws, jconsole, jdb, jhat, jinfo, jmap, jps,
506 jrunscript, jsadebugd, jstack, jstat, jstatd, keytool,
507 native2ascii, orbd, pack200, policytool, rmic, rmid, rmiregistry,
508 schemagen, serialver, servertool, tnameserv, unpack200,
509 wsgen, wsimport, and xjc</seg>
510 <seg><envar>$JAVA_HOME</envar>/lib/*,
511 <envar>$JAVA_HOME</envar>/jre/lib/*,
512 and libjavaplugin_oji.so</seg>
513 <seg>/opt/jdk-&jdk-version-string;</seg>
514 </seglistitem>
515 </segmentedlist>
516
517 <variablelist>
518 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
519 <?dbfo list-presentation="list"?>
520 <?dbhtml list-presentation="table"?>
521
522 <varlistentry id="appletviewer">
523 <term><command>appletviewer</command></term>
524 <listitem>
525 <para>runs Java applets outside of the context of a browser.</para>
526 <indexterm zone="jdk appletviewer">
527 <primary sortas="b-appletviewer">appletviewer</primary>
528 </indexterm>
529 </listitem>
530 </varlistentry>
531
532 <varlistentry id="apt">
533 <term><command>apt</command></term>
534 <listitem>
535 <para>is an annotation processing tool.</para>
536 <indexterm zone="jdk apt">
537 <primary sortas="b-apt">apt</primary>
538 </indexterm>
539 </listitem>
540 </varlistentry>
541
542 <varlistentry id="extcheck">
543 <term><command>extcheck</command></term>
544 <listitem>
545 <para>checks a specified jar file for title and version conflicts
546 with any extensions installed in the <application>JDK</application>
547 software.</para>
548 <indexterm zone="jdk extcheck">
549 <primary sortas="b-extcheck">extcheck</primary>
550 </indexterm>
551 </listitem>
552 </varlistentry>
553
554 <varlistentry id="HtmlConverter">
555 <term><command>HtmlConverter</command></term>
556 <listitem>
557 <para>adds Java auto download to html and asp pages. </para>
558 <indexterm zone="jdk HtmlConverter">
559 <primary sortas="b-HtmlConverter">HtmlConverter</primary>
560 </indexterm>
561 </listitem>
562 </varlistentry>
563
564 <varlistentry id="idlj">
565 <term><command>idlj</command></term>
566 <listitem>
567 <para>generates Java bindings from a given IDL file.</para>
568 <indexterm zone="jdk idlj">
569 <primary sortas="b-idlj">idlj</primary>
570 </indexterm>
571 </listitem>
572 </varlistentry>
573
574 <varlistentry id="jar">
575 <term><command>jar</command></term>
576 <listitem>
577 <para>combines multiple files into a single jar archive.</para>
578 <indexterm zone="jdk jar">
579 <primary sortas="b-jar">jar</primary>
580 </indexterm>
581 </listitem>
582 </varlistentry>
583
584 <varlistentry id="jarsigner">
585 <term><command>jarsigner</command></term>
586 <listitem>
587 <para>signs jar files and verifies the signatures and integrity
588 of a signed jar file.</para>
589 <indexterm zone="jdk jarsigner">
590 <primary sortas="b-jarsigner">jarsigner</primary>
591 </indexterm>
592 </listitem>
593 </varlistentry>
594
595 <varlistentry id="java">
596 <term><command>java</command></term>
597 <listitem>
598 <para>launches a Java application by starting a Java runtime
599 environment, loading a specified class and invoking its main
600 method.</para>
601 <indexterm zone="jdk java">
602 <primary sortas="b-java">java</primary>
603 </indexterm>
604 </listitem>
605 </varlistentry>
606
607 <varlistentry id="javac">
608 <term><command>javac</command></term>
609 <listitem>
610 <para>reads class and interface definitions, written in the
611 Java programming language, and compiles them into bytecode
612 class files.</para>
613 <indexterm zone="jdk javac">
614 <primary sortas="b-javac">javac</primary>
615 </indexterm>
616 </listitem>
617 </varlistentry>
618
619 <varlistentry id="javadoc">
620 <term><command>javadoc</command></term>
621 <listitem>
622 <para>parses the declarations and documentation comments in a
623 set of Java source files and produces a corresponding set of
624 HTML pages describing the classes, interfaces,constructors,
625 methods, and fields.</para>
626 <indexterm zone="jdk javadoc">
627 <primary sortas="b-javadoc">javadoc</primary>
628 </indexterm>
629 </listitem>
630 </varlistentry>
631
632 <varlistentry id="javah">
633 <term><command>javah</command></term>
634 <listitem>
635 <para>generates C header and source files
636 that are needed to implement native methods.</para>
637 <indexterm zone="jdk javah">
638 <primary sortas="b-javah">javah</primary>
639 </indexterm>
640 </listitem>
641 </varlistentry>
642
643 <varlistentry id="javap">
644 <term><command>javap</command></term>
645 <listitem>
646 <para>disassembles a Java class file.</para>
647 <indexterm zone="jdk javap">
648 <primary sortas="b-javap">javap</primary>
649 </indexterm>
650 </listitem>
651 </varlistentry>
652
653 <varlistentry id="java-rmi.cgi">
654 <term><command>java-rmi.cgi</command></term>
655 <listitem>
656 <para>is the Java RMI client.</para>
657 <indexterm zone="jdk java-rmi.cgi">
658 <primary sortas="b-java-rmi.cgi">java-rmi.cgi</primary>
659 </indexterm>
660 </listitem>
661 </varlistentry>
662
663 <varlistentry id="javaws">
664 <term><command>javaws</command></term>
665 <listitem>
666 <para>launches Java application/applets hosted on a network.</para>
667 <indexterm zone="jdk javaws">
668 <primary sortas="b-javaws">javaws</primary>
669 </indexterm>
670 </listitem>
671 </varlistentry>
672
673 <varlistentry id="jconsole">
674 <term><command>jconsole</command></term>
675 <listitem>
676 <para>is a graphical console tool to monitor and manage both
677 local and remote Java applications and virtual machines.</para>
678 <indexterm zone="jdk jconsole">
679 <primary sortas="b-jconsole">jconsole</primary>
680 </indexterm>
681 </listitem>
682 </varlistentry>
683
684 <varlistentry id="jdb">
685 <term><command>jdb</command></term>
686 <listitem>
687 <para>is a simple command-line debugger for Java classes.</para>
688 <indexterm zone="jdk jdb">
689 <primary sortas="b-jdb">jdb</primary>
690 </indexterm>
691 </listitem>
692 </varlistentry>
693
694 <varlistentry id="jhat">
695 <term><command>jhat</command></term>
696 <listitem>
697 <para>parses a java heap dump file and allows viewing
698 in a webbrowser.</para>
699 <indexterm zone="jdk jhat">
700 <primary sortas="b-jhat">jhat</primary>
701 </indexterm>
702 </listitem>
703 </varlistentry>
704
705 <varlistentry id="jinfo">
706 <term><command>jinfo</command></term>
707 <listitem>
708 <para>prints Java configuration information for a given Java
709 process, core file, or a remote debug server.</para>
710 <indexterm zone="jdk jinfo">
711 <primary sortas="b-jinfo">jinfo</primary>
712 </indexterm>
713 </listitem>
714 </varlistentry>
715
716 <varlistentry id="jmap">
717 <term><command>jmap</command></term>
718 <listitem>
719 <para>prints shared object memory maps or heap memory details
720 of a given process, core file, or a remote debug server.</para>
721 <indexterm zone="jdk jmap">
722 <primary sortas="b-jmap">jmap</primary>
723 </indexterm>
724 </listitem>
725 </varlistentry>
726
727 <varlistentry id="jps">
728 <term><command>jps</command></term>
729 <listitem>
730 <para>lists the instrumented JVMs on the target system.</para>
731 <indexterm zone="jdk jps">
732 <primary sortas="b-jps">jps</primary>
733 </indexterm>
734 </listitem>
735 </varlistentry>
736
737 <varlistentry id="jrunscript">
738 <term><command>jrunscript</command></term>
739 <listitem>
740 <para>is a command line script shell.</para>
741 <indexterm zone="jdk jrunscript">
742 <primary sortas="b-jrunscript">jrunscript</primary>
743 </indexterm>
744 </listitem>
745 </varlistentry>
746
747 <varlistentry id="jsadebugd">
748 <term><command>jsadebugd</command></term>
749 <listitem>
750 <para>attaches to a Java process or core file and acts as a
751 debug server.</para>
752 <indexterm zone="jdk jsadebugd">
753 <primary sortas="b-jsadebugd">jsadebugd</primary>
754 </indexterm>
755 </listitem>
756 </varlistentry>
757
758 <varlistentry id="jstack">
759 <term><command>jstack</command></term>
760 <listitem>
761 <para>prints Java stack traces of Java threads for a given
762 Java process, core file, or a remote debug server.</para>
763 <indexterm zone="jdk jstack">
764 <primary sortas="b-jstack">jstack</primary>
765 </indexterm>
766 </listitem>
767 </varlistentry>
768
769 <varlistentry id="jstat">
770 <term><command>jstat</command></term>
771 <listitem>
772 <para>displays performance statistics for an instrumented JVM.</para>
773 <indexterm zone="jdk jstat">
774 <primary sortas="b-jstat">jstat</primary>
775 </indexterm>
776 </listitem>
777 </varlistentry>
778
779 <varlistentry id="jstatd">
780 <term><command>jstatd</command></term>
781 <listitem>
782 <para>is an RMI server application that monitors for the creation
783 and termination of instrumented JVMs.</para>
784 <indexterm zone="jdk jstatd">
785 <primary sortas="b-jstatd">jstatd</primary>
786 </indexterm>
787 </listitem>
788 </varlistentry>
789
790 <varlistentry id="keytool">
791 <term><command>keytool</command></term>
792 <listitem>
793 <para>is a key and certificate management utility.</para>
794 <indexterm zone="jdk keytool">
795 <primary sortas="b-keytool">keytool</primary>
796 </indexterm>
797 </listitem>
798 </varlistentry>
799
800 <varlistentry id="native2ascii">
801 <term><command>native2ascii</command></term>
802 <listitem>
803 <para> converts files that contain non-supported character encoding
804 into files containing Latin-1 or Unicode-encoded characters.</para>
805 <indexterm zone="jdk native2ascii">
806 <primary sortas="b-native2ascii">native2ascii</primary>
807 </indexterm>
808 </listitem>
809 </varlistentry>
810
811 <varlistentry id="orbd">
812 <term><command>orbd</command></term>
813 <listitem>
814 <para>is used to enable clients to transparently locate and invoke
815 persistent objects on servers in the CORBA environment.</para>
816 <indexterm zone="jdk orbd">
817 <primary sortas="b-orbd">orbd</primary>
818 </indexterm>
819 </listitem>
820 </varlistentry>
821
822 <varlistentry id="pack200">
823 <term><command>pack200</command></term>
824 <listitem>
825 <para>is a Java application that transforms a jar file into a
826 compressed pack200 file using the Java gzip compressor.</para>
827 <indexterm zone="jdk pack200">
828 <primary sortas="b-pack200">pack200</primary>
829 </indexterm>
830 </listitem>
831 </varlistentry>
832
833 <varlistentry id="policytool">
834 <term><command>policytool</command></term>
835 <listitem>
836 <para>creates and manages a policy file graphically.</para>
837 <indexterm zone="jdk policytool">
838 <primary sortas="b-policytool">policytool</primary>
839 </indexterm>
840 </listitem>
841 </varlistentry>
842
843 <varlistentry id="rmic">
844 <term><command>rmic</command></term>
845 <listitem>
846 <para>generates stub and skeleton class files for remote objects
847 from the names of compiled Java classes that contain remote
848 object implementations.</para>
849 <indexterm zone="jdk rmic">
850 <primary sortas="b-rmic">rmic</primary>
851 </indexterm>
852 </listitem>
853 </varlistentry>
854
855 <varlistentry id="rmid">
856 <term><command>rmid</command></term>
857 <listitem>
858 <para>starts the activation system daemon.</para>
859 <indexterm zone="jdk rmid">
860 <primary sortas="b-rmid">rmid</primary>
861 </indexterm>
862 </listitem>
863 </varlistentry>
864
865 <varlistentry id="rmiregistry">
866 <term><command>rmiregistry</command></term>
867 <listitem>
868 <para>creates and starts a remote object registry on the specified
869 port on the current host.</para>
870 <indexterm zone="jdk rmiregistry">
871 <primary sortas="b-rmiregistry">rmiregistry</primary>
872 </indexterm>
873 </listitem>
874 </varlistentry>
875
876 <varlistentry id="schemagen">
877 <term><command>schemagen</command></term>
878 <listitem>
879 <para>is a Java XML binding schema generator.</para>
880 <indexterm zone="jdk schemagen">
881 <primary sortas="b-schemagen">schemagen</primary>
882 </indexterm>
883 </listitem>
884 </varlistentry>
885
886 <varlistentry id="serialver">
887 <term><command>serialver</command></term>
888 <listitem>
889 <para>returns the serialVersionUID for one or more classes in a
890 form suitable for copying into an evolving class.</para>
891 <indexterm zone="jdk serialver">
892 <primary sortas="b-serialver">serialver</primary>
893 </indexterm>
894 </listitem>
895 </varlistentry>
896
897 <varlistentry id="servertool">
898 <term><command>servertool</command></term>
899 <listitem>
900 <para>provides an ease-of-use interface for application programmers
901 to register, unregister, startup and shutdown a server.</para>
902 <indexterm zone="jdk servertool">
903 <primary sortas="b-servertool">servertool</primary>
904 </indexterm>
905 </listitem>
906 </varlistentry>
907
908 <varlistentry id="tnameserv">
909 <term><command>tnameserv</command></term>
910 <listitem>
911 <para>starts the Java IDL name server.</para>
912 <indexterm zone="jdk tnameserv">
913 <primary sortas="b-tnameserv">tnameserv</primary>
914 </indexterm>
915 </listitem>
916 </varlistentry>
917
918 <varlistentry id="unpack200">
919 <term><command>unpack200</command></term>
920 <listitem>
921 <para>is a native implementation that transforms a packed file
922 produced by <application>pack200</application> into a jar
923 file.</para>
924 <indexterm zone="jdk unpack200">
925 <primary sortas="b-unpack200">unpack200</primary>
926 </indexterm>
927 </listitem>
928 </varlistentry>
929
930 <varlistentry id="wsgen">
931 <term><command>wsgen</command></term>
932 <listitem>
933 <para>generates JAX-WS portable artifacts used in JAX-WS
934 web services.</para>
935 <indexterm zone="jdk wsgen">
936 <primary sortas="b-wsgen">wsgen</primary>
937 </indexterm>
938 </listitem>
939 </varlistentry>
940
941 <varlistentry id="wsimport">
942 <term><command>wsimport</command></term>
943 <listitem>
944 <para>generates JAX-WS portable artifacts.</para>
945 <indexterm zone="jdk wsimport">
946 <primary sortas="b-wsimport">wsimport</primary>
947 </indexterm>
948 </listitem>
949 </varlistentry>
950
951 <varlistentry id="xjc">
952 <term><command>xjc</command></term>
953 <listitem>
954 <para>is a Java XML binding compiler.</para>
955 <indexterm zone="jdk xjc">
956 <primary sortas="b-xjc">xjc</primary>
957 </indexterm>
958 </listitem>
959 </varlistentry>
960
961 </variablelist>
962
963 </sect2>
964
965</sect1>
Note: See TracBrowser for help on using the repository browser.