source: general/prog/openjdk.xml@ 784a1a7f

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 784a1a7f was 784a1a7f, checked in by Bruce Dubbs <bdubbs@…>, 11 years ago

Moved apache-ant to programming section.
Created sub-section in programming for java.
Added a separate section intorducing java and
doing the binary install. Marked junit, apache-ant
and openjdk as undergoing revision.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11441 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 37.3 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 anduin-download "http://anduin.linuxfromscratch.org/files/BLFS/OpenJDK-&openjdk-version;">
8 <!ENTITY openjdk-download-binary-x86 "&anduin-download;/OpenJDK-&openjdk-version;-i686-bin.tar.xz">
9 <!ENTITY openjdk-bin-md5sum-x86 "d52b7a6b1b0fcc065c661efc22022f86">
10 <!ENTITY openjdk-bin-size-x86 "159 MB">
11 <!ENTITY openjdk-bin-buildsize-x86 "464 MB">
12
13 <!ENTITY openjdk-download-binary-x64 "&anduin-download;/OpenJDK-&openjdk-version;-x86_64-bin.tar.xz">
14 <!ENTITY openjdk-bin-md5sum-x64 "d67f23dedd26d8b8fd5c0dd007cd5e37">
15 <!ENTITY openjdk-bin-size-x64 "134 MB">
16 <!ENTITY openjdk-bin-buildsize-x64 "358 MB">
17
18 <!ENTITY icedtea-download "http://icedtea.classpath.org/download/source/icedtea-&icedtea-version;.tar.gz">
19
20 <!ENTITY icedtea-md5sum "26a514047494c8697bb97eac10d83bae">
21 <!ENTITY icedtea-size "4.9 MB">
22
23 <!ENTITY corba-download "&anduin-download;/corba.tar.gz">
24 <!ENTITY corba-md5sum "be19ef74664ce672417a4ba0f91f3d04">
25 <!ENTITY corba-size "1.4 MB">
26
27 <!ENTITY hotspot-download "&anduin-download;/hotspot.tar.gz">
28 <!ENTITY hotspot-md5sum "91dec9320e95b0ab8fe00cfb5389d335">
29 <!ENTITY hotspot-size "9.2 MB">
30
31 <!ENTITY jaxp-download "&anduin-download;/jaxp.tar.gz">
32 <!ENTITY jaxp-md5sum "75c2b17d0e37b1a9aa5d913487b7da98">
33 <!ENTITY jaxp-size "3.7 MB">
34
35 <!ENTITY jaxws-download "&anduin-download;/jaxws.tar.gz">
36 <!ENTITY jaxws-md5sum "61bdab3bb55e5ab6c12cb3a0daecc199">
37 <!ENTITY jaxws-size "2.7 MB">
38
39 <!ENTITY jdk-download "&anduin-download;/jdk.tar.gz">
40 <!ENTITY jdk-md5sum "a2a793aea6d01d00150a78246a29967a">
41 <!ENTITY jdk-size "43 MB">
42
43 <!ENTITY langtools-download "&anduin-download;/langtools.tar.gz">
44 <!ENTITY langtools-md5sum "6cc42ee41fd64f531ec4aea256b67495">
45 <!ENTITY langtools-size "2.3 MB">
46
47 <!ENTITY openjdk-download "&anduin-download;/openjdk.tar.gz">
48 <!ENTITY openjdk-md5sum "43f1697a104ea383083ef7ce305b4f60">
49 <!ENTITY openjdk-size "128 KB">
50
51 <!ENTITY rhino-download "ftp://ftp.mozilla.org/pub/mozilla.org/js/rhino1_7R3.zip">
52 <!ENTITY rhino-md5sum "99d94103662a8d0b571e247a77432ac5">
53 <!ENTITY rhino-size "4.5 MB">
54
55 <!ENTITY openjdk-buildsize "5.0-7.2 GB">
56 <!ENTITY openjdk-time "45 SBU (an additional 130 SBU for testsuite)">
57
58]>
59
60<sect1 id="openjdk" xreflabel="OpenJDK-&openjdk-version;">
61 <?dbhtml filename="openjdk.html" ?>
62
63 <sect1info>
64 <othername>$LastChangedBy$</othername>
65 <date>$Date$</date>
66 </sect1info>
67
68 <title>OpenJDK-&openjdk-version;</title>
69
70 <indexterm zone="openjdk">
71 <primary sortas="a-OpenJDK">OpenJDK</primary>
72 </indexterm>
73
74 <sect2 role="package">
75 <title>Introduction to OpenJDK and IcedTea</title>
76
77 <warning><para>Under revison do not use for now.</para></warning>
78
79 <para><application>IcedTea</application> provides a build harness for the
80 <application>OpenJDK</application> package, Oracle's open-sourced
81 <application>Java</application> development environment. In order to
82 provide a completely free runtime environment, similar to Oracle's closed
83 distribution, the <application>IcedTea</application> build harness also
84 provides free, and arguably better versions of parts of the JDK which
85 have not been open-sourced to date. <application>OpenJDK</application> is
86 useful for developing <application>Java</application> programs and provides
87 a complete runtime environment to run <application>Java</application>
88 programs.</para>
89
90 &lfs72_checked;
91
92 <note><para>The browser plugin and webstart implementation have been split
93 off into a separate project. To provide a complete implementation, you will
94 need to later install <xref linkend="icedtea-web"/>.</para></note>
95
96 <para>OpenJDK is GPL'd code, however, it should be explained that there has
97 been a special exception made for non-free projects to use these classes in
98 their proprietary products. In similar fashion to the LGPL, which
99 allows non-free programs to link to libraries provided by free software,
100 the <ulink url="http://openjdk.java.net/legal/gplv2+ce.html">GNU
101 General Public License, version 2, with the Classpath Exception</ulink>
102 allows third party programs to use classes provided by free software
103 without the requirement that the third party software also be free. As with
104 the LGPL, any modifications made to the free software portions of a
105 third party application, must also be made freely available.</para>
106
107 <note>
108 <para>The IcedTea build environment includes a very thorough, open source
109 test suite titled <application>JTreg</application>.
110 <application>JTreg</application> is intended to test the just built JDK
111 for reasonable compatibility with the closed Oracle JDK. However, in
112 order for an independent implementation to claim compatibility, including
113 the Oracle sponsored <application>OpenJDK</application> project, it must
114 pass a closed <application>JCK/TCK</application> test suite. No claims
115 of compatibility, even partial compatibility, may be made without
116 passing an approved test suite.</para>
117
118 <para>Oracle does provide free community access, on a case by case basis,
119 to a closed toolkit to ensure 100% compatibility with its proprietary JDK.
120 The binary version provided here has not been tested against the
121 <ulink url="http://openjdk.java.net/groups/conformance/JckAccess/jck-access.html">
122 TCK</ulink>. Any version that is built using the instructions given,
123 cannot claim to be compatible with the proprietary JDK, without the user
124 applying for, and completing the compatibility tests themselves.</para>
125
126 <para>With that in mind, the binaries produced using this build method are
127 regularly tested against the TCK by the members listed on the site above.
128 In addition to the community license above, an educational, non-commercial
129 license for the TCK can be obtained from
130 <ulink url="http://www.oracle.com/technetwork/java/index-137188.html">
131 here</ulink>.</para>
132 </note>
133
134 <bridgehead renderas="sect3">Source Package Information</bridgehead>
135 <itemizedlist spacing="compact">
136 <listitem>
137 <para>IcedTea Source Package
138 <simplelist>
139 <member>Download: <ulink url="&icedtea-download;"/></member>
140 <member>Download MD5 sum: &icedtea-md5sum;</member>
141 <member>Download Size: &icedtea-size;</member>
142 </simplelist>
143 </para>
144 </listitem>
145 </itemizedlist>
146
147 <para>The following may be downladed separately or be done as a
148 part of the <userinput>make</userinput> process.</para>
149
150 <itemizedlist spacing="compact">
151 <listitem>
152 <para>Corba Source
153 <simplelist>
154 <member>Download: <ulink url="&corba-download;"/></member>
155 <member>Download MD5 sum: &corba-md5sum;</member>
156 <member>Download Size: &corba-size;</member>
157 </simplelist>
158 </para>
159 </listitem>
160 <listitem>
161 <para>Hotspot Source
162 <simplelist>
163 <member>Download: <ulink url="&hotspot-download;"/></member>
164 <member>Download MD5 sum: &hotspot-md5sum;</member>
165 <member>Download Size: &hotspot-size;</member>
166 </simplelist>
167 </para>
168 </listitem>
169 <listitem>
170 <para>IcedTea Build Source
171 <simplelist>
172 <member>Download: <ulink url="&openjdk-download;"/></member>
173 <member>Download MD5 sum: &openjdk-md5sum;</member>
174 <member>Download Size: &openjdk-size;</member>
175 </simplelist>
176 </para>
177 </listitem>
178 <listitem>
179 <para>JAXP Source
180 <simplelist>
181 <member>Download: <ulink url="&jaxp-download;"/></member>
182 <member>Download MD5 sum: &jaxp-md5sum;</member>
183 <member>Download Size: &jaxp-size;</member>
184 </simplelist>
185 </para>
186 </listitem>
187 <listitem>
188 <para>JAXWS Source
189 <simplelist>
190 <member>Download: <ulink url="&jaxws-download;"/></member>
191 <member>Download MD5 sum: &jaxws-md5sum;</member>
192 <member>Download Size: &jaxws-size;</member>
193 </simplelist>
194 </para>
195 </listitem>
196 <listitem>
197 <para>Langtools Source
198 <simplelist>
199 <member>Download: <ulink url="&langtools-download;"/></member>
200 <member>Download MD5 sum: &langtools-md5sum;</member>
201 <member>Download Size: &langtools-size;</member>
202 </simplelist>
203 </para>
204 </listitem>
205 <listitem>
206 <para>OpenJDK Source
207 <simplelist>
208 <member>Download: <ulink url="&jdk-download;"/></member>
209 <member>Download MD5 sum: &jdk-md5sum;</member>
210 <member>Download Size: &jdk-size;</member>
211 </simplelist>
212 </para>
213 </listitem>
214 <listitem>
215 <para>Estimated disk space required: &openjdk-buildsize;</para>
216 </listitem>
217 <listitem>
218 <para>Estimated build time: &openjdk-time;</para>
219 </listitem>
220 </itemizedlist>
221
222 <bridgehead renderas="sect3">Binary Package Information</bridgehead>
223 <itemizedlist spacing="compact">
224 <listitem>
225 <para>Binary download (x86):
226 <ulink url="&openjdk-download-binary-x86;"/></para>
227 </listitem>
228 <listitem>
229 <para>Download MD5 sum: &openjdk-bin-md5sum-x86;</para>
230 </listitem>
231 <listitem>
232 <para>Download size (binary): &openjdk-bin-size-x86;</para>
233 </listitem>
234 <listitem>
235 <para>Estimated disk space required: &openjdk-bin-buildsize-x86;</para>
236 </listitem>
237 </itemizedlist>
238 <itemizedlist spacing="compact">
239 <listitem>
240 <para>Binary download (x86_64):
241 <ulink url="&openjdk-download-binary-x64;"/></para>
242 </listitem>
243 <listitem>
244 <para>Download MD5 sum: &openjdk-bin-md5sum-x64;</para>
245 </listitem>
246 <listitem>
247 <para>Download size (binary): &openjdk-bin-size-x64;</para>
248 </listitem>
249 <listitem>
250 <para>Estimated disk space required: &openjdk-bin-buildsize-x64;</para>
251 </listitem>
252 </itemizedlist>
253
254 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
255
256 <bridgehead renderas="sect4">Required Patches</bridgehead>
257 <itemizedlist spacing='compact'>
258 <listitem>
259 <para><ulink
260 url="&patch-root;/icedtea-&icedtea-version;-add_cacerts-1.patch"/></para>
261 </listitem>
262 <listitem>
263 <para><ulink
264 url="&patch-root;/icedtea-&icedtea-version;-fixed_paths-1.patch"/></para>
265 </listitem>
266 <listitem>
267 <para><ulink
268 url="&patch-root;/icedtea-&icedtea-version;-fix_tests-1.patch"/></para>
269 </listitem>
270 </itemizedlist>
271
272 <bridgehead renderas="sect4">Required JAR</bridgehead>
273 <itemizedlist spacing='compact'>
274 <listitem>
275 <para>Rhino Java Script
276 <simplelist>
277 <member>Download: <ulink url="&rhino-download;"/></member>
278 <member>Download MD5 sum: &rhino-md5sum;</member>
279 <member>Download Size: &rhino-size;</member>
280 </simplelist>
281 </para>
282 </listitem>
283 </itemizedlist>
284 <bridgehead renderas="sect3">OpenJDK Dependencies</bridgehead>
285
286 <bridgehead renderas="sect4">Runtime Dependencies (required for
287 binary installation)</bridgehead>
288 <para role="required">
289 <xref linkend="cacerts"/>,
290 <xref linkend="cups"/>,
291 <xref linkend="gtk3"/>,
292 <xref linkend="giflib"/>,
293 <xref linkend="nspr"/>,
294 <xref linkend="pulseaudio"/> and
295 <xref linkend="xorg7-lib"/>
296 </para>
297
298 <bridgehead renderas="sect4">Additional Requirements
299 (for source build, including runtime dependencies)</bridgehead>
300 <para role="optional">
301 <xref linkend="apache-ant"/>,
302 <xref linkend="cpio"/>,
303 <xref linkend="unzip"/>,
304 <xref linkend="wget"/>,
305 <xref linkend="which"/> and
306 <xref linkend="zip"/>
307 </para>
308
309 <para condition="html" role="usernotes">User Notes:
310 <ulink url="&blfs-wiki;/openjdk"/></para>
311
312 </sect2>
313
314 <sect2 role="installation">
315 <title>Installation of OpenJDK</title>
316
317 <para>The instructions below install both the binary and source versions.
318 You may stop after installing the binary version or continue on installing
319 the source version. You can choose to keep either or both.</para>
320
321 <bridgehead renderas="sect3">OpenJDK Binary Installation</bridgehead>
322 <para>Begin by extracting the appropriate binary tarball and changing to
323 the extracted directory. Install the binary
324 <application>OpenJDK</application> with the following commands as the
325 <systemitem class="username">root</systemitem> user:</para>
326
327<screen role="root"><userinput>install -vdm755 /opt/OpenJDK-&openjdk-version;-bin &amp;&amp;
328mv -v * /opt/OpenJDK-&openjdk-version;-bin &amp;&amp;
329chown -R root:root /opt/OpenJDK-&openjdk-version;-bin</userinput></screen>
330
331 <para>Configure the temporary <application>OpenJDK</application>
332 installation with the following commands:</para>
333
334<screen><userinput>export CLASSPATH=.:/usr/share/java &amp;&amp;
335export PATH="$PATH:/opt/OpenJDK-&openjdk-version;-bin/bin"</userinput></screen>
336
337 <para>The binary version is now installed. If you don't want to compile the
338 sources, skip ahead to the configuration section.</para>
339
340 <bridgehead renderas="sect3">OpenJDK Source Installation</bridgehead>
341 <note><para>The source build of OpenJDK requires
342 <xref linkend="apache-ant"/>. You'll need to build that first to satisfy
343 the circular dependency, and return to this section to continue building
344 OpenJDK.</para></note>
345
346 <para>Unlike other packages in BLFS, the <application>OpenJDK</application>
347 source packages are distributed in multiple downloads. Since the IcedTea
348 build harness will be used to build <application>OpenJDK</application>,
349 begin by extracting the IcedTea package and changing into the
350 extracted directory.</para>
351
352 <para>The IcedTea <application>OpenJDK</application> distribution requires
353 that <filename>js.jar</filename> (from the Rhino package) be in place in
354 order to provide a java-script implementation for the free JDK. If you have
355 not installed the js.jar file in another way, do so with the following
356 commands as the <systemitem class="username">root</systemitem> user:</para>
357
358<screen role="root"><userinput>unzip ../rhino1_7R3.zip &amp;&amp;
359install -v -d -m755 /usr/share/java &amp;&amp;
360install -v -m755 rhino1_7R3/*.jar /usr/share/java</userinput></screen>
361
362 <para>As mentioned previously, <application>OpenJDK</application> is
363 composed of several individual projects of the proprietary
364 <application>JDK</application> that have been relicensed under an open
365 source license. If you have already downoaded all of the individual
366 components, place them into the source tree with the following commands:</para>
367
368<screen><userinput>cp -v ../corba.tar.gz . &amp;&amp;
369cp -v ../hotspot.tar.gz . &amp;&amp;
370cp -v ../jaxp.tar.gz . &amp;&amp;
371cp -v ../jaxws.tar.gz . &amp;&amp;
372cp -v ../jdk.tar.gz . &amp;&amp;
373cp -v ../langtools.tar.gz . &amp;&amp;
374cp -v ../openjdk.tar.gz .</userinput></screen>
375
376 <para>Apply a patch to generate a valid cacerts file using the system CA
377 certificates:</para>
378
379<screen><userinput>patch -Np1 -i ../icedtea-&icedtea-version;-add_cacerts-1.patch</userinput></screen>
380
381 <para>Apply a patch to replace fixed paths with ones appropriate for
382 BLFS:</para>
383
384<screen><userinput>patch -Np1 -i ../icedtea-&icedtea-version;-fixed_paths-1.patch</userinput></screen>
385
386 <para>Apply a patch to exclude known broken tests from the test suite:</para>
387
388<screen><userinput>patch -Np1 -i ../icedtea-&icedtea-version;-fix_tests-1.patch</userinput></screen>
389
390
391 <para>Configure and build the package with the following commands:</para>
392
393<screen><userinput>unset JAVA_HOME &amp;&amp;
394./autogen.sh &amp;&amp;
395./configure --with-jdk-home=/opt/OpenJDK-&openjdk-version;-bin \
396 --enable-nss \
397 --enable-pulse-java &amp;&amp;
398make</userinput></screen>
399
400 <note><para>If you have not installed the tarballs specified above,
401 they will be automatically downloaded here.</para></note>
402
403 <para>To test the results, issue: <command>make jtregcheck</command>. The
404 included version of <application>jtreg</application> is old, and the test
405 suite is also very dependent on the host system and the environment that it
406 is run in. You should expect to see anywhere between 40 and 100 failures in
407 jdk with up to 10 errors in the tests themselves. The majority of the
408 6000+ tests should pass. The reason for the greatly varying results is due
409 to how stringent the testing environment must be. Varying architectures,
410 different versions of dependent libraries, unexpected X Window environment
411 and window managers, the CA certificates used to generate the
412 <filename>cacerts</filename> file, and even any user input or power
413 management or screen saver interruptions during the testing can lead to
414 various failures. While the known broken tests have been removed, with the
415 fix_tests patch above, the graphics tests failures cannot be pre-determined
416 (short of removing them all). The best bet for the minimal number of
417 failures is to run the test suite in a framebuffer on a different screen
418 (Xvfb). Even still, Disk I/O can cause failures.</para>
419
420 <para>Install the package with the following commands as the
421 <systemitem class="username">root</systemitem> user:</para>
422
423<screen role="root"><userinput>chmod 0644 openjdk.build/j2sdk-image/lib/sa-jdi.jar &amp;&amp;
424cp -R openjdk.build/j2sdk-image /opt/OpenJDK-&openjdk-version; &amp;&amp;
425chown -R root:root /opt/OpenJDK-&openjdk-version;</userinput></screen>
426
427 </sect2>
428
429 <sect2 role="commands">
430 <title>Command Explanations</title>
431
432 <para><command>./autogen.sh</command>: This command forces rebuilding of
433 auto-generated files to account for new options added to
434 <filename>configure</filename>.</para>
435
436 <para><parameter>--with-jdk-home</parameter>: This switch provides the
437 location of the temporary <application>JDK</application>.</para>
438
439 <para><parameter>--enable-pulse-java</parameter>: This switch enables
440 building of the pulseaudio libraries (needed to provide a complete
441 implementation that is reasonably compatible with the proprietary
442 JDK).</para>
443
444 <para><command>chmod -v 0644 ...sa-jdi.jar</command>: Fix permissions
445 in a generated file so all users can access it.</para>
446
447 </sect2>
448
449 <sect2 role="configuration" id="openjdk-config" xreflabel="Configuring OpenJDK" >
450 <title>Configuring OpenJDK</title>
451
452 <sect3>
453 <title>Configuration Information</title>
454
455 <para>There are now two <application>OpenJDK</application> SDKs
456 installed in <filename>/opt</filename>. You should decide on which one
457 you would like to use as the default. For example if you decide to use
458 the precompiled <application>OpenJDK</application>, do the following as
459 the <systemitem class="username">root</systemitem> user:</para>
460
461<screen role="root"><userinput>ln -v -nsf OpenJDK-&openjdk-version;-bin /opt/jdk</userinput></screen>
462
463 <para>The information below assumes your system is set up using the
464 instructions found in <quote><xref
465 linkend="postlfs-config-profile"/></quote>. You may need to extract the
466 relevant information below and incorporate it into your system's startup
467 files if your system is set up differently.</para>
468
469 <para>Add the following <filename>openjdk.sh</filename> shell startup
470 file to the <filename>/etc/profile.d</filename> directory with the
471 following commands as the <systemitem class="username">root</systemitem>
472 user:</para>
473
474<screen role="root"><userinput>cat &gt; /etc/profile.d/openjdk.sh &lt;&lt; "EOF"
475<literal># Begin /etc/profile.d/openjdk.sh
476
477# Set JAVA_HOME directory
478JAVA_HOME=/opt/jdk
479
480# Adjust PATH
481pathappend $JAVA_HOME/bin PATH
482
483# Auto Java CLASSPATH
484# Copy jar files to, or create symlinks in this directory
485
486AUTO_CLASSPATH_DIR=/usr/share/java
487
488pathprepend . CLASSPATH
489
490for dir in `find ${AUTO_CLASSPATH_DIR} -type d 2>/dev/null`; do
491 pathappend $dir CLASSPATH
492done
493
494for jar in `find ${AUTO_CLASSPATH_DIR} -name "*.jar" 2>/dev/null`; do
495 pathappend $jar CLASSPATH
496done
497
498export JAVA_HOME CLASSPATH
499unset AUTO_CLASSPATH_DIR dir jar
500
501# End /etc/profile.d/openjdk.sh</literal>
502EOF</userinput></screen>
503
504 <para>Finally, add the man pages to <application>man_db</application>'s
505 configuration. As the <systemitem class="username">root</systemitem>
506 user:</para>
507
508<screen><userinput>cat &gt;&gt; /etc/man_db.conf &lt;&lt; "EOF" &amp;&amp;
509<literal>MANDATORY_MANPATH /opt/jdk/man
510MANPATH_MAP /opt/jdk/bin /opt/jdk/man
511MANDB_MAP /opt/jdk/man /var/cache/man/jdk</literal>
512EOF
513mandb -c /opt/OpenJDK/man</userinput></screen>
514
515 </sect3>
516
517 </sect2>
518
519 <sect2 role="content">
520 <title>Contents</title>
521
522 <segmentedlist>
523 <segtitle>Installed Programs</segtitle>
524 <segtitle>Installed Libraries</segtitle>
525 <segtitle>Installed Directory</segtitle>
526
527 <seglistitem>
528 <seg>appletviewer, apt, extcheck, idlj, jar,
529 jarsigner, java, javac, javadoc, javah, javap, java-rmi.cgi,
530 jcmd, jconsole, jdb, jhat, jinfo, jmap, jps,
531 jrunscript, jsadebugd, jstack, jstat, jstatd, keytool,
532 native2ascii, orbd, pack200, policytool, rmic, rmid, rmiregistry,
533 schemagen, serialver, servertool, tnameserv, unpack200,
534 wsgen, wsimport, and xjc</seg>
535 <seg>/opt/OpenJDK-&openjdk-version;/lib/*, and
536 /opt/OpenJDK-&openjdk-version;/jre/lib/*</seg>
537 <seg>/opt/OpenJDK-&openjdk-version;</seg>
538 </seglistitem>
539 </segmentedlist>
540
541 <variablelist>
542 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
543 <?dbfo list-presentation="list"?>
544 <?dbhtml list-presentation="table"?>
545
546 <varlistentry id="appletviewer">
547 <term><command>appletviewer</command></term>
548 <listitem>
549 <para>allows you to run applets outside of a web browser.</para>
550 <indexterm zone="openjdk appletviewer">
551 <primary sortas="b-appletviewer">appletviewer</primary>
552 </indexterm>
553 </listitem>
554 </varlistentry>
555
556 <varlistentry id="apt">
557 <term><command>apt</command></term>
558 <listitem>
559 <para>is an annotation processing tool.</para>
560 <indexterm zone="openjdk apt">
561 <primary sortas="b-apt">apt</primary>
562 </indexterm>
563 </listitem>
564 </varlistentry>
565
566 <varlistentry id="extcheck">
567 <term><command>extcheck</command></term>
568 <listitem>
569 <para>checks a specified jar file for title and version conflicts
570 with any extensions installed in the
571 <application>OpenJDK</application> software.</para>
572 <indexterm zone="openjdk extcheck">
573 <primary sortas="b-extcheck">extcheck</primary>
574 </indexterm>
575 </listitem>
576 </varlistentry>
577
578 <varlistentry id="idlj">
579 <term><command>idlj</command></term>
580 <listitem>
581 <para>generates Java bindings from a given IDL file.</para>
582 <indexterm zone="openjdk idlj">
583 <primary sortas="b-idlj">idlj</primary>
584 </indexterm>
585 </listitem>
586 </varlistentry>
587
588 <varlistentry id="jar">
589 <term><command>jar</command></term>
590 <listitem>
591 <para>combines multiple files into a single jar archive.</para>
592 <indexterm zone="openjdk jar">
593 <primary sortas="b-jar">jar</primary>
594 </indexterm>
595 </listitem>
596 </varlistentry>
597
598 <varlistentry id="jarsigner">
599 <term><command>jarsigner</command></term>
600 <listitem>
601 <para>signs jar files and verifies the signatures and integrity
602 of a signed jar file.</para>
603 <indexterm zone="openjdk jarsigner">
604 <primary sortas="b-jarsigner">jarsigner</primary>
605 </indexterm>
606 </listitem>
607 </varlistentry>
608
609 <varlistentry id="java-prog">
610 <term><command>java</command></term>
611 <listitem>
612 <para>launches a Java application by starting a Java runtime
613 environment, loading a specified class and invoking its main
614 method.</para>
615 <indexterm zone="openjdk java-prog">
616 <primary sortas="b-java-prog">java</primary>
617 </indexterm>
618 </listitem>
619 </varlistentry>
620
621 <varlistentry id="javac">
622 <term><command>javac</command></term>
623 <listitem>
624 <para>reads class and interface definitions, written in the
625 Java programming language, and compiles them into bytecode
626 class files.</para>
627 <indexterm zone="openjdk javac">
628 <primary sortas="b-javac">javac</primary>
629 </indexterm>
630 </listitem>
631 </varlistentry>
632
633 <varlistentry id="javadoc">
634 <term><command>javadoc</command></term>
635 <listitem>
636 <para>parses the declarations and documentation comments in a
637 set of Java source files and produces a corresponding set of
638 HTML pages describing the classes, interfaces,constructors,
639 methods, and fields.</para>
640 <indexterm zone="openjdk javadoc">
641 <primary sortas="b-javadoc">javadoc</primary>
642 </indexterm>
643 </listitem>
644 </varlistentry>
645
646 <varlistentry id="javah">
647 <term><command>javah</command></term>
648 <listitem>
649 <para>generates C header and source files
650 that are needed to implement native methods.</para>
651 <indexterm zone="openjdk javah">
652 <primary sortas="b-javah">javah</primary>
653 </indexterm>
654 </listitem>
655 </varlistentry>
656
657 <varlistentry id="javap">
658 <term><command>javap</command></term>
659 <listitem>
660 <para>disassembles a Java class file.</para>
661 <indexterm zone="openjdk javap">
662 <primary sortas="b-javap">javap</primary>
663 </indexterm>
664 </listitem>
665 </varlistentry>
666
667 <varlistentry id="java-rmi.cgi">
668 <term><command>java-rmi.cgi</command></term>
669 <listitem>
670 <para>is the Java RMI client.</para>
671 <indexterm zone="openjdk java-rmi.cgi">
672 <primary sortas="b-java-rmi.cgi">java-rmi.cgi</primary>
673 </indexterm>
674 </listitem>
675 </varlistentry>
676
677 <varlistentry id="jcmd">
678 <term><command>jcmd</command></term>
679 <listitem>
680 <para>is a utility to send diagnostic command requests to a running
681 Java Virtual Machine.</para>
682 <indexterm zone="openjdk jcmd">
683 <primary sortas="b-jcmd">jcmd</primary>
684 </indexterm>
685 </listitem>
686 </varlistentry>
687
688 <varlistentry id="jconsole">
689 <term><command>jconsole</command></term>
690 <listitem>
691 <para>is a graphical console tool to monitor and manage both
692 local and remote Java applications and virtual machines.</para>
693 <indexterm zone="openjdk jconsole">
694 <primary sortas="b-jconsole">jconsole</primary>
695 </indexterm>
696 </listitem>
697 </varlistentry>
698
699 <varlistentry id="jdb">
700 <term><command>jdb</command></term>
701 <listitem>
702 <para>is a simple command-line debugger for Java classes.</para>
703 <indexterm zone="openjdk jdb">
704 <primary sortas="b-jdb">jdb</primary>
705 </indexterm>
706 </listitem>
707 </varlistentry>
708
709 <varlistentry id="jhat">
710 <term><command>jhat</command></term>
711 <listitem>
712 <para>parses a java heap dump file and allows viewing
713 in a web browser.</para>
714 <indexterm zone="openjdk jhat">
715 <primary sortas="b-jhat">jhat</primary>
716 </indexterm>
717 </listitem>
718 </varlistentry>
719
720 <varlistentry id="jinfo">
721 <term><command>jinfo</command></term>
722 <listitem>
723 <para>prints Java configuration information for a given Java
724 process, core file, or a remote debug server.</para>
725 <indexterm zone="openjdk jinfo">
726 <primary sortas="b-jinfo">jinfo</primary>
727 </indexterm>
728 </listitem>
729 </varlistentry>
730
731 <varlistentry id="jmap">
732 <term><command>jmap</command></term>
733 <listitem>
734 <para>prints shared object memory maps or heap memory details
735 of a given process, core file, or a remote debug server.</para>
736 <indexterm zone="openjdk jmap">
737 <primary sortas="b-jmap">jmap</primary>
738 </indexterm>
739 </listitem>
740 </varlistentry>
741
742 <varlistentry id="jps">
743 <term><command>jps</command></term>
744 <listitem>
745 <para>lists the instrumented JVMs on the target system.</para>
746 <indexterm zone="openjdk jps">
747 <primary sortas="b-jps">jps</primary>
748 </indexterm>
749 </listitem>
750 </varlistentry>
751
752 <varlistentry id="jrunscript">
753 <term><command>jrunscript</command></term>
754 <listitem>
755 <para>is a command line script shell.</para>
756 <indexterm zone="openjdk jrunscript">
757 <primary sortas="b-jrunscript">jrunscript</primary>
758 </indexterm>
759 </listitem>
760 </varlistentry>
761
762 <varlistentry id="jsadebugd">
763 <term><command>jsadebugd</command></term>
764 <listitem>
765 <para>attaches to a Java process or core file and acts as a
766 debug server.</para>
767 <indexterm zone="openjdk jsadebugd">
768 <primary sortas="b-jsadebugd">jsadebugd</primary>
769 </indexterm>
770 </listitem>
771 </varlistentry>
772
773 <varlistentry id="jstack">
774 <term><command>jstack</command></term>
775 <listitem>
776 <para>prints Java stack traces of Java threads for a given
777 Java process, core file, or a remote debug server.</para>
778 <indexterm zone="openjdk jstack">
779 <primary sortas="b-jstack">jstack</primary>
780 </indexterm>
781 </listitem>
782 </varlistentry>
783
784 <varlistentry id="jstat">
785 <term><command>jstat</command></term>
786 <listitem>
787 <para>displays performance statistics for an instrumented JVM.</para>
788 <indexterm zone="openjdk jstat">
789 <primary sortas="b-jstat">jstat</primary>
790 </indexterm>
791 </listitem>
792 </varlistentry>
793
794 <varlistentry id="jstatd">
795 <term><command>jstatd</command></term>
796 <listitem>
797 <para>is an RMI server application that monitors for the creation
798 and termination of instrumented JVMs.</para>
799 <indexterm zone="openjdk jstatd">
800 <primary sortas="b-jstatd">jstatd</primary>
801 </indexterm>
802 </listitem>
803 </varlistentry>
804
805 <varlistentry id="keytool">
806 <term><command>keytool</command></term>
807 <listitem>
808 <para>is a key and certificate management utility.</para>
809 <indexterm zone="openjdk keytool">
810 <primary sortas="b-keytool">keytool</primary>
811 </indexterm>
812 </listitem>
813 </varlistentry>
814
815 <varlistentry id="native2ascii">
816 <term><command>native2ascii</command></term>
817 <listitem>
818 <para> converts files that contain non-supported character encoding
819 into files containing Latin-1 or Unicode-encoded characters.</para>
820 <indexterm zone="openjdk native2ascii">
821 <primary sortas="b-native2ascii">native2ascii</primary>
822 </indexterm>
823 </listitem>
824 </varlistentry>
825
826 <varlistentry id="orbd">
827 <term><command>orbd</command></term>
828 <listitem>
829 <para>is used to enable clients to transparently locate and invoke
830 persistent objects on servers in the CORBA environment.</para>
831 <indexterm zone="openjdk orbd">
832 <primary sortas="b-orbd">orbd</primary>
833 </indexterm>
834 </listitem>
835 </varlistentry>
836
837 <varlistentry id="pack200">
838 <term><command>pack200</command></term>
839 <listitem>
840 <para>is a Java application that transforms a jar file into a
841 compressed pack200 file using the Java gzip compressor.</para>
842 <indexterm zone="openjdk pack200">
843 <primary sortas="b-pack200">pack200</primary>
844 </indexterm>
845 </listitem>
846 </varlistentry>
847
848 <varlistentry id="policytool">
849 <term><command>policytool</command></term>
850 <listitem>
851 <para>creates and manages a policy file graphically.</para>
852 <indexterm zone="openjdk policytool">
853 <primary sortas="b-policytool">policytool</primary>
854 </indexterm>
855 </listitem>
856 </varlistentry>
857
858 <varlistentry id="rmic">
859 <term><command>rmic</command></term>
860 <listitem>
861 <para>generates stub and skeleton class files for remote objects
862 from the names of compiled Java classes that contain remote
863 object implementations.</para>
864 <indexterm zone="openjdk rmic">
865 <primary sortas="b-rmic">rmic</primary>
866 </indexterm>
867 </listitem>
868 </varlistentry>
869
870 <varlistentry id="rmid">
871 <term><command>rmid</command></term>
872 <listitem>
873 <para>starts the activation system daemon.</para>
874 <indexterm zone="openjdk rmid">
875 <primary sortas="b-rmid">rmid</primary>
876 </indexterm>
877 </listitem>
878 </varlistentry>
879
880 <varlistentry id="rmiregistry">
881 <term><command>rmiregistry</command></term>
882 <listitem>
883 <para>creates and starts a remote object registry on the specified
884 port on the current host.</para>
885 <indexterm zone="openjdk rmiregistry">
886 <primary sortas="b-rmiregistry">rmiregistry</primary>
887 </indexterm>
888 </listitem>
889 </varlistentry>
890
891 <varlistentry id="schemagen">
892 <term><command>schemagen</command></term>
893 <listitem>
894 <para>is a Java XML binding schema generator.</para>
895 <indexterm zone="openjdk schemagen">
896 <primary sortas="b-schemagen">schemagen</primary>
897 </indexterm>
898 </listitem>
899 </varlistentry>
900
901 <varlistentry id="serialver">
902 <term><command>serialver</command></term>
903 <listitem>
904 <para>returns the serialVersionUID for one or more classes in a
905 form suitable for copying into an evolving class.</para>
906 <indexterm zone="openjdk serialver">
907 <primary sortas="b-serialver">serialver</primary>
908 </indexterm>
909 </listitem>
910 </varlistentry>
911
912 <varlistentry id="servertool">
913 <term><command>servertool</command></term>
914 <listitem>
915 <para>provides an ease-of-use interface for application programmers
916 to register, unregister, startup and shutdown a server.</para>
917 <indexterm zone="openjdk servertool">
918 <primary sortas="b-servertool">servertool</primary>
919 </indexterm>
920 </listitem>
921 </varlistentry>
922
923 <varlistentry id="tnameserv">
924 <term><command>tnameserv</command></term>
925 <listitem>
926 <para>starts the Java IDL name server.</para>
927 <indexterm zone="openjdk tnameserv">
928 <primary sortas="b-tnameserv">tnameserv</primary>
929 </indexterm>
930 </listitem>
931 </varlistentry>
932
933 <varlistentry id="unpack200">
934 <term><command>unpack200</command></term>
935 <listitem>
936 <para>is a native implementation that transforms a packed file
937 produced by <application>pack200</application> into a jar
938 file.</para>
939 <indexterm zone="openjdk unpack200">
940 <primary sortas="b-unpack200">unpack200</primary>
941 </indexterm>
942 </listitem>
943 </varlistentry>
944
945 <varlistentry id="wsgen">
946 <term><command>wsgen</command></term>
947 <listitem>
948 <para>generates JAX-WS portable artifacts used in JAX-WS
949 web services.</para>
950 <indexterm zone="openjdk wsgen">
951 <primary sortas="b-wsgen">wsgen</primary>
952 </indexterm>
953 </listitem>
954 </varlistentry>
955
956 <varlistentry id="wsimport">
957 <term><command>wsimport</command></term>
958 <listitem>
959 <para>generates JAX-WS portable artifacts.</para>
960 <indexterm zone="openjdk wsimport">
961 <primary sortas="b-wsimport">wsimport</primary>
962 </indexterm>
963 </listitem>
964 </varlistentry>
965
966 <varlistentry id="xjc">
967 <term><command>xjc</command></term>
968 <listitem>
969 <para>is a Java XML binding compiler.</para>
970 <indexterm zone="openjdk xjc">
971 <primary sortas="b-xjc">xjc</primary>
972 </indexterm>
973 </listitem>
974 </varlistentry>
975
976 </variablelist>
977
978 </sect2>
979
980</sect1>
Note: See TracBrowser for help on using the repository browser.