source: general/prog/openjdk.xml@ df15e9f

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since df15e9f was df15e9f, checked in by Pierre Labastie <pieere@…>, 9 years ago

Improve wording and explanations for OpenJDK tests and cacerts generation. Adapted
from an HTML patch by Paul Rogers.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@15947 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 48.5 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 ojdk-upd "45">
8 <!ENTITY ojdk-bd "b14">
9 <!ENTITY ojdk-tarball "jdk8u&ojdk-upd;-&ojdk-bd;.tar.bz2">
10 <!ENTITY ojdk-repo "http://hg.openjdk.java.net/jdk8u/jdk8u">
11 <!ENTITY ojdk-download "&ojdk-repo;/archive/&ojdk-tarball;">
12
13 <!ENTITY anduin-download "http://anduin.linuxfromscratch.org/files/BLFS/OpenJDK-&openjdk-version;">
14
15 <!ENTITY ojdk-md5sum "4809dd6f1cae5c87e855a21506d43012">
16 <!ENTITY ojdk-size "388 KB">
17
18 <!ENTITY corba-download "&anduin-download;/corba.tar.xz">
19 <!ENTITY corba-md5sum "af5baa04d025fb96a39a0ea0a5b187f4">
20 <!ENTITY corba-size "917 KB">
21
22 <!ENTITY hotspot-download "&anduin-download;/hotspot.tar.xz">
23 <!ENTITY hotspot-md5sum "16b2feeedf3b3d097f51a25af09bb8e1">
24 <!ENTITY hotspot-size "6.3 MB">
25
26 <!ENTITY jaxp-download "&anduin-download;/jaxp.tar.xz">
27 <!ENTITY jaxp-md5sum "3a23fa9cc06fc130c83597c10da9ac29">
28 <!ENTITY jaxp-size "2.2 MB">
29
30 <!ENTITY jaxws-download "&anduin-download;/jaxws.tar.xz">
31 <!ENTITY jaxws-md5sum "9769cc527f8c73ea624afa27e86acde9">
32 <!ENTITY jaxws-size "2.2 MB">
33
34 <!ENTITY jdk-download "&anduin-download;/jdk.tar.xz">
35 <!ENTITY jdk-md5sum "813df5653cc634095e88db5243f5351a">
36 <!ENTITY jdk-size "36.4 MB">
37
38 <!ENTITY langtools-download "&anduin-download;/langtools.tar.xz">
39 <!ENTITY langtools-md5sum "ebb9bc974506248642a983ca16986425">
40 <!ENTITY langtools-size "2.0 MB">
41
42 <!ENTITY nashorn-download "&anduin-download;/nashorn.tar.xz">
43 <!ENTITY nashorn-md5sum "e9b1252034e47023ddaf44b4c8fd9a75">
44 <!ENTITY nashorn-size "2.1 MB">
45
46 <!ENTITY jtreg-version "4.1-b11-273">
47 <!ENTITY jtreg-download "&anduin-download;/jtreg&jtreg-version;.tar.xz">
48 <!ENTITY jtreg-md5sum "2f84934b6e9efcbc9060109729e569d1">
49 <!ENTITY jtreg-size "7.2 MB">
50
51 <!ENTITY icedtea-web-download "http://icedtea.classpath.org/download/source/icedtea-web-&icedtea-web-version;.tar.gz">
52
53 <!ENTITY ojdk-buildsize "3.9 GB (additional 361 MB for tests)">
54 <!ENTITY ojdk-time "10 SBU (additional 110 SBU for tests)">
55]>
56
57<sect1 id="openjdk"
58 xreflabel="OpenJDK-&openjdk-version;">
59 <?dbhtml filename="openjdk.html" ?>
60
61 <sect1info>
62 <othername>$LastChangedBy$</othername>
63 <date>$Date$</date>
64 </sect1info>
65
66 <title>OpenJDK-&openjdk-version;</title>
67
68 <indexterm zone="openjdk">
69 <primary sortas="a-OpenJDK">OpenJDK</primary>
70 </indexterm>
71
72 <sect2 role="package">
73 <title>Introduction to OpenJDK</title>
74
75 <para>
76 <application>OpenJDK</application> is an open-source implementation
77 of Oracle's Java Standard Edition platform.
78 <application>OpenJDK</application> is useful for developing
79 <application>Java</application> programs, and provides a complete
80 runtime environment to run <application>Java</application> programs.
81 </para>
82
83 &lfs77_checked;
84
85 <note>
86 <para>
87 A browser plugin and webstart implementation, as well as a
88 pulseaudio sound backend are provided by the Icedtea project. To provide
89 a complete implementation, you will need to later install
90 <xref linkend="icedtea-web"/> and <xref linkend="icedtea-sound"/>.
91 </para>
92 </note>
93
94 <para>
95 OpenJDK is GPL'd code, with a special exception made for non-free
96 projects to use these classes in their proprietary products.
97 In similar fashion to the LGPL, which allows non-free programs to link
98 to libraries provided by free software, the
99 <ulink url="http://openjdk.java.net/legal/gplv2+ce.html">GNU
100 General Public License, version 2, with the Classpath Exception</ulink>
101 allows third party programs to use classes provided by free software
102 without the requirement that the third party software also be free. As
103 with the LGPL, any modifications made to the free software portions of a
104 third party application, must also be made freely available.
105 </para>
106
107 <note>
108 <para>
109 The <application>OpenJDK</application> source includes a very
110 thorough, open source test suite using the
111 <application>JTreg</application> test harness. The testing instructions
112 below allow to test the just built JDK for reasonable compatibility
113 with the proprietary Oracle JDK. However, in order for an independent
114 implementation to claim compatibility, it must pass a proprietary
115 <application>JCK/TCK</application> test suite. No claims of
116 compatibility, even partial compatibility, may be made without passing
117 an approved test suite.
118 </para>
119
120 <para>
121 Oracle does provide free community access, on a case by case basis, to
122 a closed toolkit to ensure 100% compatibility with its proprietary JDK.
123 Neither the binary version provided on the <xref linkend="java"/> page
124 nor the JVM built with the instructions below have been tested against
125 the <ulink
126 url="http://openjdk.java.net/groups/conformance/JckAccess/jck-access.html">
127 TCK</ulink>. Any version that is built using the instructions given,
128 cannot claim to be compatible with the proprietary JDK, without the
129 user applying for, and completing the compatibility tests themselves.
130 </para>
131
132 <para>
133 With that in mind, the binaries produced using this build method are
134 regularly tested against the TCK by the members listed on the site
135 above. In addition to the community license above, an educational,
136 non-commercial license for the TCK can be obtained from <ulink
137 url="http://www.oracle.com/technetwork/java/index-137188.html">
138 here</ulink>.
139 </para>
140 </note>
141
142 <bridgehead renderas="sect3">Source Package Information</bridgehead>
143 <itemizedlist spacing="compact">
144 <listitem>
145 <para>OpenJDK Root Package
146 <simplelist>
147 <member>Download: <ulink url="&ojdk-download;"/></member>
148 <member>Download MD5 sum: &ojdk-md5sum;</member>
149 <member>Download Size: &ojdk-size;</member>
150 </simplelist>
151 </para>
152 </listitem>
153 </itemizedlist>
154
155 <para>
156 The following files may be downladed from the OpenJDK mercurial
157 repository using the addresses <ulink
158 url="&ojdk-repo;/&lt;component&gt;/archive/&ojdk-tarball;"/>,
159 where &lt;component&gt; is the name of the JVM component (corba,
160 hostspot, and so on), but that involves renaming the downloaded files,
161 and renaming the extracted directories.
162 For convenience, the BLFS editors have made the files available in an LFS
163 website.
164 </para>
165
166 <itemizedlist spacing="compact">
167 <listitem>
168 <para>Corba Source
169 <simplelist>
170 <member>Download: <ulink url="&corba-download;"/></member>
171 <member>Download MD5 sum: &corba-md5sum;</member>
172 <member>Download Size: &corba-size;</member>
173 </simplelist>
174 </para>
175 </listitem>
176 <listitem>
177 <para>Hotspot Source
178 <simplelist>
179 <member>Download: <ulink url="&hotspot-download;"/></member>
180 <member>Download MD5 sum: &hotspot-md5sum;</member>
181 <member>Download Size: &hotspot-size;</member>
182 </simplelist>
183 </para>
184 </listitem>
185 <listitem>
186 <para>JAXP Source
187 <simplelist>
188 <member>Download: <ulink url="&jaxp-download;"/></member>
189 <member>Download MD5 sum: &jaxp-md5sum;</member>
190 <member>Download Size: &jaxp-size;</member>
191 </simplelist>
192 </para>
193 </listitem>
194 <listitem>
195 <para>JAXWS Source
196 <simplelist>
197 <member>Download: <ulink url="&jaxws-download;"/></member>
198 <member>Download MD5 sum: &jaxws-md5sum;</member>
199 <member>Download Size: &jaxws-size;</member>
200 </simplelist>
201 </para>
202 </listitem>
203 <listitem>
204 <para>Langtools Source
205 <simplelist>
206 <member>Download: <ulink url="&langtools-download;"/></member>
207 <member>Download MD5 sum: &langtools-md5sum;</member>
208 <member>Download Size: &langtools-size;</member>
209 </simplelist>
210 </para>
211 </listitem>
212 <listitem>
213 <para>JDK Source
214 <simplelist>
215 <member>Download: <ulink url="&jdk-download;"/></member>
216 <member>Download MD5 sum: &jdk-md5sum;</member>
217 <member>Download Size: &jdk-size;</member>
218 </simplelist>
219 </para>
220 </listitem>
221 <listitem>
222 <para>Nashorn Source
223 <simplelist>
224 <member>Download: <ulink url="&nashorn-download;"/></member>
225 <member>Download MD5 sum: &nashorn-md5sum;</member>
226 <member>Download Size: &nashorn-size;</member>
227 </simplelist>
228 </para>
229 </listitem>
230 <listitem>
231 <para>Estimated disk space required: &ojdk-buildsize;</para>
232 </listitem>
233 <listitem>
234 <para>Estimated build time: &ojdk-time;</para>
235 </listitem>
236 </itemizedlist>
237
238 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
239
240 <itemizedlist spacing='compact'>
241 <listitem>
242 <para>
243 Optional package (to get an icon for the
244 <filename>openjdk-8-policytool.desktop</filename> file):
245 <ulink url="&icedtea-web-download;"/>
246 </para>
247 </listitem>
248 <listitem>
249 <para>
250 Recommended test harness: <ulink url="&jtreg-download;"/>
251 </para>
252 </listitem>
253 </itemizedlist>
254
255 <bridgehead renderas="sect3">OpenJDK Dependencies</bridgehead>
256
257 <bridgehead renderas="sect4">Required Dependencies</bridgehead>
258 <para role="required">
259 An existing binary (<xref linkend="java"/> or an earlier built
260 version of this package),
261 <xref linkend="alsa-lib"/>,
262 <xref linkend="cpio"/>,
263 <xref linkend="cups"/>,
264 <xref linkend="unzip"/>,
265 <xref linkend="which"/>,
266 <xref linkend="xorg7-lib"/>, and
267 <xref linkend="zip"/>
268 </para>
269
270 <bridgehead renderas="sect4">Recommended</bridgehead>
271 <para role="recommended">
272 <xref linkend="cacerts"/> and
273 <xref linkend="giflib"/>
274 </para>
275
276 <bridgehead renderas="sect4">Optional</bridgehead>
277 <para role="optional">
278 <xref linkend="mercurial"/> and
279 an X Window manager such as <xref linkend="twm"/> (for the tests)
280 </para>
281
282 <para condition="html" role="usernotes">User Notes:
283 <ulink url="&blfs-wiki;/openjdk"/></para>
284
285 </sect2>
286
287 <sect2 role="installation">
288 <title>Installation of OpenJDK</title>
289
290 <para>
291 Unlike other packages in BLFS, the <application>OpenJDK</application>
292 source packages are distributed in multiple tar balls. You need to first
293 extract the source root from <filename>&ojdk-tarball;</filename>, change
294 into the extracted directory, then proceed with the following
295 instructions:
296 </para>
297
298<screen><userinput>tar -xf ../corba.tar.xz &amp;&amp;
299tar -xf ../hotspot.tar.xz &amp;&amp;
300tar -xf ../jaxp.tar.xz &amp;&amp;
301tar -xf ../jaxws.tar.xz &amp;&amp;
302tar -xf ../jdk.tar.xz &amp;&amp;
303tar -xf ../langtools.tar.xz &amp;&amp;
304tar -xf ../nashorn.tar.xz</userinput></screen>
305
306 <para>
307 If you have downloaded the recommended test harness, unpack it too:
308 </para>
309
310<screen><userinput>tar -xf ../jtreg&jtreg-version;.tar.xz</userinput></screen>
311
312<!--TODO: it might be better to add instructions for the cacerts file at
313this place and to use the switch "with-cacerts-file" -->
314
315 <para>
316 Fix an issue with the new (since 5.1.0) giflib API:
317 </para>
318
319<screen><userinput>sed -e 's/DGifCloseFile(gif/&amp;, NULL/' \
320 -e '/DGifOpen/s/c)/c, NULL)/' \
321 -i jdk/src/share/native/sun/awt/splashscreen/splashscreen_gif.c</userinput></screen>
322<!-- Seems to be corrected
323 <para>
324 Fix a bug in a shell script used to set the flags for
325 <command>make</command>:
326 </para>
327
328<screen><userinput>sed 's/\([ \t]\)\]\([^\]\)/\1I]\2/g' \
329 -i hotspot/make/linux/makefiles/adjust-mflags.sh</userinput></screen>
330-->
331 <note>
332 <para>
333 Before proceeding, you should ensure that your environment
334 <envar>PATH</envar> variable contains the location of the Java
335 compilers used for bootstrapping <application>OpenJDK</application>.
336 This is the only requirement for the environment. Modern Java
337 installations do not need <envar>JAVA_HOME</envar> and
338 <envar>CLASSPATH</envar> is not used here. Furthermore, OpenJDK
339 developers recommand to unset <envar>JAVA_HOME</envar>.
340 </para>
341
342 <para>
343 The build system does not support the <option>-j</option> switch in
344 <envar>MAKEFLAGS</envar>.
345 </para>
346 </note>
347
348 <para>Configure and build the package with the following commands
349 (--with-milestone value can be modified to fit user preferences):</para>
350
351<screen><userinput>unset JAVA_HOME &amp;&amp;
352sh ./configure \
353 --with-update-version=&ojdk-upd; \
354 --with-build-number=&ojdk-bd; \
355 --with-milestone=BLFS \
356 --enable-unlimited-crypto \
357 --with-zlib=system \
358 --with-giflib=system &amp;&amp;
359make DEBUG_BINARIES=true all &amp;&amp;
360find build/*/images/j2sdk-image -iname \*.diz -delete
361</userinput></screen>
362
363 <warning>
364 <para>
365 Although the test infrastructure of <application>OpenJDK</application>
366 is not easy to use, it is recommended to run the tests in order to
367 make sure that the JVM runs fine. A malfunctionning JVM may have
368 catastrophic consequences in term of security.
369 </para>
370 </warning>
371 <note>
372 <para>
373 Testing will involve the interplay of pairs of JVMs using the
374 networking interface, so networking must be started. If it
375 isn't, not only will these tests fail, but the test cleanup
376 will leave orphaned JVMs running. There will be many of
377 them. Rebooting may be the easiest recovery.
378 </para>
379 </note>
380
381 <para>
382 Testing the newly built JVM involves several steps.
383 First, it is better to run the test suite in a frame buffer on a
384 different display, using Xvfb:
385 </para>
386
387<!-- Careful with the && below:
388"export DISPLAY=... && somecommand &" exports only DISPLAY to "somecommand"
389but not to the current environment, and
390"echo $! .... &&" does not echo the right PID. SO all && suppressed.-->
391<screen role='nodump'><userinput>if [ -n "$DISPLAY" ]; then
392 OLD_DISP=$DISPLAY
393fi
394export DISPLAY=:20
395nohup Xvfb $DISPLAY \
396 -fbdir $(pwd) \
397 -pixdepths 8 16 24 32 > Xvfb.out 2>&amp;1 &amp;
398echo $! > Xvfb.pid
399echo Waiting for Xvfb to initialize; sleep 1
400nohup twm -display $DISPLAY \
401 -f /dev/null > twm.out 2>&amp;1 &amp;
402echo $! > twm.pid
403echo Waiting for twm to initialize; sleep 1
404xhost +</userinput></screen>
405
406 <para>
407 Then, it is necessary to modify some files<!-- (replace &lt;N&gt; with the
408 number of JAVA VM allowed to run concurrently)-->:
409 </para>
410
411<screen role='nodump'><userinput>echo -e "
412jdk_all = :jdk_core \\
413 :jdk_svc \\
414 :jdk_beans \\
415 :jdk_imageio \\
416 :jdk_sound \\
417 :jdk_sctp \\
418 com/sun/awt \\
419 javax/accessibility \\
420 javax/print \\
421 sun/pisces \\
422 com/sun/java/swing" >> jdk/test/TEST.groups &amp;&amp;
423sed -e 's/all:.*jck.*/all: jtreg/' \
424 -e '/^JTREG /s@\$(JT_PLATFORM)/@@' \
425 -i langtools/test/Makefile<!-- &amp;&amp;
426sed -i 's@/win32@@' jdk/test/Makefile &amp;&amp;
427sed -e 's@JTREG_HOME@JT_PLATFORM="" &amp;@' \
428 -e 's@TEST="@CONCURRENCY=&lt;N&gt; &amp;@' \
429 -i test/Makefile--></userinput></screen>
430
431 <para>
432 Some variables have to be set:
433 </para>
434
435<screen role='nodump'><userinput>JT_JAVA=$(type -p javac | sed 's@/bin.*@@') &amp;&amp;
436JT_HOME=$(pwd)/jtreg &amp;&amp;
437PRODUCT_HOME=$(echo $(pwd)/build/*/images/j2sdk-image)</userinput></screen>
438
439 <para>
440 The tests are run as follows:
441 </para>
442
443<!-- no && here either, because the first "make" may return an error -->
444<screen role='nodump'><userinput>LANG=C make -k -C test \
445 JT_HOME=${JT_HOME} \
446 JT_JAVA=${JT_JAVA} \
447 PRODUCT_HOME=${PRODUCT_HOME} all
448LANG=C ${JT_HOME}/bin/jtreg -a -v:fail,error \
449 -dir:$(pwd)/hotspot/test \
450 -k:\!ignore \
451 -jdk:${PRODUCT_HOME} \
452<!-- -agentvm -conc:&lt;N&gt; \
453--> :jdk</userinput></screen>
454
455 <para>
456 The test results can be compared to
457 <ulink url="http://download.java.net/openjdk/testresults/8/">these
458 results</ulink>, although they usually are run on a newer version.
459 Some failures can be expected, the number of which depends on various
460 conditions, like whether the computer is connected to network. Also, some
461 tests may timeout if the machine is under load.
462 </para>
463
464 <para>
465 Next some cleanup has to be done. The instructions below only stop the
466 frame buffer, but it has been reported that some java VM may be left running
467 after the tests, so it is necessary to check orphaned processes:
468 </para>
469
470<screen role='nodump'><userinput>kill -9 `cat twm.pid` &amp;&amp;
471kill -9 `cat Xvfb.pid` &amp;&amp;
472rm -f Xvfb.out twm.out &amp;&amp;
473rm -f Xvfb.pid twm.pid &amp;&amp;
474if [ -n "$OLD_DISP" ]; then
475 DISPLAY=$OLD_DISP
476fi</userinput></screen>
477
478 <para>Install the package with the following commands as the
479 <systemitem class="username">root</systemitem> user:</para>
480
481<screen role="root"><userinput>cp -R build/*/images/j2sdk-image /opt/OpenJDK-&openjdk-version; &amp;&amp;
482chown -R root:root /opt/OpenJDK-&openjdk-version;</userinput></screen>
483
484 <para>
485 There are now two <application>OpenJDK</application> SDKs installed
486 in <filename class="directory">/opt</filename>. You should decide on
487 which one you would like to use as the default. Normally, you would opt
488 for the just installed <application>OpenJDK</application>. If so, do
489 the following as the <systemitem class="username">root</systemitem>
490 user:
491 </para>
492
493<screen role="root"><userinput>ln -v -nsf OpenJDK-&openjdk-version; /opt/jdk</userinput></screen>
494
495 <para>If desired, you may install a .desktop file corresponding to an entry
496 in a desktop menu for <command>policytool</command>. First, you need to
497 obtain an icon from <xref linkend="icedtea-web"/>:</para>
498
499<screen><userinput>tar -xf ../icedtea-web-&icedtea-web-version;.tar.gz \
500 icedtea-web-&icedtea-web-version;/javaws.png \
501 --strip-components=1</userinput></screen>
502
503 <para>Now, as <systemitem class="username">root</systemitem> user:</para>
504
505<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
506
507cat &gt; /usr/share/applications/openjdk-8-policytool.desktop &lt;&lt; "EOF" &amp;&amp;
508<literal>[Desktop Entry]
509Name=OpenJDK Java Policy Tool
510Name[pt_BR]=OpenJDK Java - Ferramenta de Pol&#237;tica
511Comment=OpenJDK Java Policy Tool
512Comment[pt_BR]=OpenJDK Java - Ferramenta de Pol&#237;tica
513Exec=/opt/jdk/bin/policytool
514Terminal=false
515Type=Application
516Icon=javaws
517Categories=Settings;</literal>
518EOF
519
520install -v -Dm0644 javaws.png /usr/share/pixmaps/javaws.png</userinput></screen>
521
522 <para>The choice of pt_BR is just an example. You can add any translation
523 by adding lines corresponding to your locale, e.g. for fr_FR,
524 <quote>Name[fr_FR]=</quote> and <quote>Comment[fr_FR]=</quote> with the
525 appropriate text as values.</para>
526
527 </sect2>
528
529 <sect2 role="commands">
530 <title>Command Explanations</title>
531
532 <para>
533 <command>sh configure...</command>: the top level
534 <filename>configure</filename> is a wrapper around the autotools one.
535 It is not executable and must be run through <command>sh</command>.
536 </para>
537
538 <para>
539 <option>--with-boot-jdk</option>: This switch provides the
540 location of the temporary <application>JDK</application>. It is normally
541 not needed if <command>java</command> is found in the <envar>PATH</envar>.
542 </para>
543
544 <para>
545 <parameter>--with-update-version</parameter>: Currently, the build
546 system does not include the update number in the version string. It has
547 to be specified here.
548 </para>
549
550 <para>
551 <parameter>--with-build-number</parameter>: Again, the build
552 system does not include the build number in the version string. It has
553 to be specified here too.
554 </para>
555
556 <para>
557 <parameter>--with-milestone</parameter>: Used to customize the
558 version string.
559 </para>
560
561 <para>
562 <parameter>--enable-unlimited-crypto</parameter>: Because of limitations
563 on the usage of cryptography in some countries, there is the possibility
564 to limit the size of encryption keys and the use of some algorithms in a
565 policy file. This switch allows to ship a policy file with no
566 restriction. It is the responsability of the user to ensure proper
567 adherence to the law.
568 </para>
569
570 <para>
571 <parameter>--with-zlib=system, --with-giflib=system</parameter>: Allows
572 to use the system libraries instead of the bundled ones.
573 </para>
574
575 <para>
576 <option>--with-jobs=N</option>: Allows setting the number
577 of jobs for <command>make</command> equal to N. The default is the
578 result of a calculation involving the available memory and the number
579 of processors. Note that even if you specify N=1, some parallelization
580 may be used during the build. The SBU given above are with parallel jobs
581 disabled, on a single processor, single core, virtual machine.
582 </para>
583
584 <para>
585 <option>--with-cacerts-file=...</option>: Specifies where to find a
586 <filename>cacerts</filename> file, typically <filename>
587 /opt/jdk/jre/lib/security</filename>. Otherwise, an empty one is created.
588 You can get it from an earlier version of the package, or use the
589 script below to generate one.
590 </para>
591
592 <para>
593 <command>make DEBUG_BINARIES=true all</command>: The build fails
594 if DEBUG_BINARIES is not set to true.
595 </para>
596
597 <para>
598 <command>find ... -iname '*.diz' -delete</command>: This command
599 removes redundant files.
600 </para>
601
602 </sect2>
603
604 <sect2 role="configuration"
605 id="openjdk-config"
606 xreflabel="Configuring OpenJDK">
607 <title>Configuring OpenJDK</title>
608
609 <sect3>
610 <title>Configuration Information</title>
611
612 <para>Normally, the JAVA environment has been configured after installing
613 the binary version, and can be used with the just built package as well.
614 Review <xref linkend="ojdk-conf"/> in case you want to modify
615 something.</para>
616
617 <para>To test if the man pages are correctly installed, issue
618 <command>source /etc/profile</command> and <command>man java</command> to
619 display the respective man page.</para>
620
621 </sect3>
622
623 <sect3 id='ojdk-certs' xreflabel='JRE Certificate Authorithy Certificates'>
624 <title>Install or update the JRE Certificate Authority Certificates
625 (cacerts) file</title>
626
627 <para>
628 <application>OpenJDK</application> uses its own format for the
629 CA certificates. Those certificates are located in a file named <filename>
630 /opt/jdk/jre/lib/security/cacerts</filename>. That file may be generated
631 from the one installed using the instructions on the <xref
632 linkend="cacerts"/> page, using the following procedure.
633 First, generate the <command>mkcacerts</command> script
634 as the <systemitem class="username">root</systemitem> user:
635 </para>
636
637<screen role="root"><userinput>cat &gt; /opt/jdk/bin/mkcacerts &lt;&lt; "EOF"
638<literal>#!/bin/sh
639# Simple script to extract x509 certificates and create a JRE cacerts file.
640
641function get_args()
642 {
643 if test -z "${1}" ; then
644 showhelp
645 exit 1
646 fi
647
648 while test -n "${1}" ; do
649 case "${1}" in
650 -f | --cafile)
651 check_arg $1 $2
652 CAFILE="${2}"
653 shift 2
654 ;;
655 -d | --cadir)
656 check_arg $1 $2
657 CADIR="${2}"
658 shift 2
659 ;;
660 -o | --outfile)
661 check_arg $1 $2
662 OUTFILE="${2}"
663 shift 2
664 ;;
665 -k | --keytool)
666 check_arg $1 $2
667 KEYTOOL="${2}"
668 shift 2
669 ;;
670 -s | --openssl)
671 check_arg $1 $2
672 OPENSSL="${2}"
673 shift 2
674 ;;
675 -h | --help)
676 showhelp
677 exit 0
678 ;;
679 *)
680 showhelp
681 exit 1
682 ;;
683 esac
684 done
685 }
686
687function check_arg()
688 {
689 echo "${2}" | grep -v "^-" > /dev/null
690 if [ -z "$?" -o ! -n "$2" ]; then
691 echo "Error: $1 requires a valid argument."
692 exit 1
693 fi
694 }
695
696# The date binary is not reliable on 32bit systems for dates after 2038
697function mydate()
698 {
699 local y=$( echo $1 | cut -d" " -f4 )
700 local M=$( echo $1 | cut -d" " -f1 )
701 local d=$( echo $1 | cut -d" " -f2 )
702 local m
703
704 if [ ${d} -lt 10 ]; then d="0${d}"; fi
705
706 case $M in
707 Jan) m="01";;
708 Feb) m="02";;
709 Mar) m="03";;
710 Apr) m="04";;
711 May) m="05";;
712 Jun) m="06";;
713 Jul) m="07";;
714 Aug) m="08";;
715 Sep) m="09";;
716 Oct) m="10";;
717 Nov) m="11";;
718 Dec) m="12";;
719 esac
720
721 certdate="${y}${m}${d}"
722 }
723
724function showhelp()
725 {
726 echo "`basename ${0}` creates a valid cacerts file for use with IcedTea."
727 echo ""
728 echo " -f --cafile The path to a file containing PEM"
729 echo " formated CA certificates. May not be"
730 echo " used with -d/--cadir."
731 echo ""
732 echo " -d --cadir The path to a directory of PEM formatted"
733 echo " CA certificates. May not be used with"
734 echo " -f/--cafile."
735 echo ""
736 echo " -o --outfile The path to the output file."
737 echo ""
738 echo " -k --keytool The path to the java keytool utility."
739 echo ""
740 echo " -s --openssl The path to the openssl utility."
741 echo ""
742 echo " -h --help Show this help message and exit."
743 echo ""
744 echo ""
745 }
746
747# Initialize empty variables so that the shell does not pollute the script
748CAFILE=""
749CADIR=""
750OUTFILE=""
751OPENSSL=""
752KEYTOOL=""
753certdate=""
754date=""
755today=$( date +%Y%m%d )
756
757# Process command line arguments
758get_args ${@}
759
760# Handle common errors
761if test "${CAFILE}x" == "x" -a "${CADIR}x" == "x" ; then
762 echo "ERROR! You must provide an x509 certificate store!"
763 echo "\'$(basename ${0}) --help\' for more info."
764 echo ""
765 exit 1
766fi
767
768if test "${CAFILE}x" != "x" -a "${CADIR}x" != "x" ; then
769 echo "ERROR! You cannot provide two x509 certificate stores!"
770 echo "\'$(basename ${0}) --help\' for more info."
771 echo ""
772 exit 1
773fi
774
775if test "${KEYTOOL}x" == "x" ; then
776 echo "ERROR! You must provide a valid keytool program!"
777 echo "\'$(basename ${0}) --help\' for more info."
778 echo ""
779 exit 1
780fi
781
782if test "${OPENSSL}x" == "x" ; then
783 echo "ERROR! You must provide a valid path to openssl!"
784 echo "\'$(basename ${0}) --help\' for more info."
785 echo ""
786 exit 1
787fi
788
789if test "${OUTFILE}x" == "x" ; then
790 echo "ERROR! You must provide a valid output file!"
791 echo "\'$(basename ${0}) --help\' for more info."
792 echo ""
793 exit 1
794fi
795
796# Get on with the work
797
798# If using a CAFILE, split it into individual files in a temp directory
799if test "${CAFILE}x" != "x" ; then
800 TEMPDIR=`mktemp -d`
801 CADIR="${TEMPDIR}"
802
803 # Get a list of staring lines for each cert
804 CERTLIST=`grep -n "^-----BEGIN" "${CAFILE}" | cut -d ":" -f 1`
805
806 # Get a list of ending lines for each cert
807 ENDCERTLIST=`grep -n "^-----END" "${CAFILE}" | cut -d ":" -f 1`
808
809 # Start a loop
810 for certbegin in `echo "${CERTLIST}"` ; do
811 for certend in `echo "${ENDCERTLIST}"` ; do
812 if test "${certend}" -gt "${certbegin}"; then
813 break
814 fi
815 done
816 sed -n "${certbegin},${certend}p" "${CAFILE}" > "${CADIR}/${certbegin}.pem"
817 keyhash=`${OPENSSL} x509 -noout -in "${CADIR}/${certbegin}.pem" -hash`
818 echo "Generated PEM file with hash: ${keyhash}."
819 done
820fi
821
822# Write the output file
823for cert in `find "${CADIR}" -type f -name "*.pem" -o -name "*.crt"`
824do
825
826 # Make sure the certificate date is valid...
827 date=$( ${OPENSSL} x509 -enddate -in "${cert}" -noout | sed 's/^notAfter=//' )
828 mydate "${date}"
829 if test "${certdate}" -lt "${today}" ; then
830 echo "${cert} expired on ${certdate}! Skipping..."
831 unset date certdate
832 continue
833 fi
834 unset date certdate
835 ls "${cert}"
836 tempfile=`mktemp`
837 certbegin=`grep -n "^-----BEGIN" "${cert}" | cut -d ":" -f 1`
838 certend=`grep -n "^-----END" "${cert}" | cut -d ":" -f 1`
839 sed -n "${certbegin},${certend}p" "${cert}" > "${tempfile}"
840 echo yes | env LC_ALL=C "${KEYTOOL}" -import \
841 -alias `basename "${cert}"` \
842 -keystore "${OUTFILE}" \
843 -storepass 'changeit' \
844 -file "${tempfile}"
845 rm "${tempfile}"
846done
847
848if test "${TEMPDIR}x" != "x" ; then
849 rm -rf "${TEMPDIR}"
850fi
851exit 0</literal>
852EOF
853
854chmod -c 0755 /opt/jdk/bin/mkcacerts</userinput></screen>
855
856 <note>
857 <para>
858 Doing a very large copy/paste directly to a terminal may result in a
859 corrupted file. Copying to an editor may overcome this issue.
860 </para>
861 </note>
862
863 <para>
864 Generate the <application>OpenJDK</application> <filename>cacerts</filename>
865 file as the <systemitem class="username">root</systemitem> user:
866 </para>
867
868<screen role="root"><userinput>if [ -f /opt/jdk/jre/lib/security/cacerts ]; then
869 mv /opt/jdk/jre/lib/security/cacerts \
870 /opt/jdk/jre/lib/security/cacerts.bak
871fi &amp;&amp;
872/opt/jdk/bin/mkcacerts \
873 -d "/etc/ssl/certs/" \
874 -k "/opt/jdk/bin/keytool" \
875 -s "/usr/bin/openssl" \
876 -o "/opt/jdk/jre/lib/security/cacerts"</userinput></screen>
877
878 <para>Use the following commands to check if the
879 <filename>cacerts</filename> file has been successfully installed:</para>
880
881<screen role="root"><userinput>cd /opt/jdk
882bin/keytool -list -keystore jre/lib/security/cacerts</userinput></screen>
883
884 <para>At the prompt "Enter keystore password:", press the "Enter" key if
885 there is no keystore password defined. If the <filename>cacerts</filename>
886 file was installed correctly, you will see a list of the certificates with
887 related information for each one. If not, you need to reinstall
888 them.</para>
889
890 </sect3>
891
892 </sect2>
893
894 <sect2 role="content">
895 <title>Contents</title>
896
897 <segmentedlist>
898 <segtitle>Installed Programs</segtitle>
899 <segtitle>Installed Libraries</segtitle>
900 <segtitle>Installed Directory</segtitle>
901
902 <seglistitem>
903 <seg>appletviewer, extcheck, idlj, jar,
904 jarsigner, java, javac, javadoc, javah, javap, java-rmi.cgi,
905 jcmd, jconsole, jdb, jdeps, jhat, jinfo, jjs, jmap, jps,
906 jrunscript, jsadebugd, jstack, jstat, jstatd, keytool, mkcacerts,
907 native2ascii, orbd, pack200, policytool, rmic, rmid, rmiregistry,
908 schemagen, serialver, servertool, tnameserv, unpack200,
909 wsgen, wsimport, and xjc</seg>
910 <seg>/opt/OpenJDK-&openjdk-version;/lib/*, and
911 /opt/OpenJDK-&openjdk-version;/jre/lib/*</seg>
912 <seg>/opt/OpenJDK-&openjdk-version;</seg>
913 </seglistitem>
914 </segmentedlist>
915
916 <variablelist>
917 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
918 <?dbfo list-presentation="list"?>
919 <?dbhtml list-presentation="table"?>
920
921 <varlistentry id="appletviewer">
922 <term><command>appletviewer</command></term>
923 <listitem>
924 <para>allows to run applets outside of a web browser.</para>
925 <indexterm zone="openjdk appletviewer">
926 <primary sortas="b-appletviewer">appletviewer</primary>
927 </indexterm>
928 </listitem>
929 </varlistentry>
930
931 <varlistentry id="extcheck">
932 <term><command>extcheck</command></term>
933 <listitem>
934 <para>checks a specified jar file for title and version conflicts
935 with any extensions installed in the
936 <application>OpenJDK</application> software.</para>
937 <indexterm zone="openjdk extcheck">
938 <primary sortas="b-extcheck">extcheck</primary>
939 </indexterm>
940 </listitem>
941 </varlistentry>
942
943 <varlistentry id="idlj">
944 <term><command>idlj</command></term>
945 <listitem>
946 <para>generates Java bindings from a given IDL file.</para>
947 <indexterm zone="openjdk idlj">
948 <primary sortas="b-idlj">idlj</primary>
949 </indexterm>
950 </listitem>
951 </varlistentry>
952
953 <varlistentry id="jar">
954 <term><command>jar</command></term>
955 <listitem>
956 <para>combines multiple files into a single jar archive.</para>
957 <indexterm zone="openjdk jar">
958 <primary sortas="b-jar">jar</primary>
959 </indexterm>
960 </listitem>
961 </varlistentry>
962
963 <varlistentry id="jarsigner">
964 <term><command>jarsigner</command></term>
965 <listitem>
966 <para>signs jar files and verifies the signatures and integrity
967 of a signed jar file.</para>
968 <indexterm zone="openjdk jarsigner">
969 <primary sortas="b-jarsigner">jarsigner</primary>
970 </indexterm>
971 </listitem>
972 </varlistentry>
973
974 <varlistentry id="java-prog">
975 <term><command>java</command></term>
976 <listitem>
977 <para>launches a Java application by starting a Java runtime
978 environment, loading a specified class and invoking its main
979 method.</para>
980 <indexterm zone="openjdk java-prog">
981 <primary sortas="b-java-prog">java</primary>
982 </indexterm>
983 </listitem>
984 </varlistentry>
985
986 <varlistentry id="javac">
987 <term><command>javac</command></term>
988 <listitem>
989 <para>reads class and interface definitions, written in the
990 Java programming language, and compiles them into bytecode
991 class files.</para>
992 <indexterm zone="openjdk javac">
993 <primary sortas="b-javac">javac</primary>
994 </indexterm>
995 </listitem>
996 </varlistentry>
997
998 <varlistentry id="javadoc">
999 <term><command>javadoc</command></term>
1000 <listitem>
1001 <para>parses the declarations and documentation comments in a
1002 set of Java source files and produces a corresponding set of
1003 HTML pages describing the classes, interfaces, constructors,
1004 methods, and fields.</para>
1005 <indexterm zone="openjdk javadoc">
1006 <primary sortas="b-javadoc">javadoc</primary>
1007 </indexterm>
1008 </listitem>
1009 </varlistentry>
1010
1011 <varlistentry id="javah">
1012 <term><command>javah</command></term>
1013 <listitem>
1014 <para>generates C header and source files
1015 that are needed to implement native methods.</para>
1016 <indexterm zone="openjdk javah">
1017 <primary sortas="b-javah">javah</primary>
1018 </indexterm>
1019 </listitem>
1020 </varlistentry>
1021
1022 <varlistentry id="javap">
1023 <term><command>javap</command></term>
1024 <listitem>
1025 <para>disassembles a Java class file.</para>
1026 <indexterm zone="openjdk javap">
1027 <primary sortas="b-javap">javap</primary>
1028 </indexterm>
1029 </listitem>
1030 </varlistentry>
1031
1032 <varlistentry id="java-rmi.cgi">
1033 <term><command>java-rmi.cgi</command></term>
1034 <listitem>
1035 <para>is the Java RMI client.</para>
1036 <indexterm zone="openjdk java-rmi.cgi">
1037 <primary sortas="b-java-rmi.cgi">java-rmi.cgi</primary>
1038 </indexterm>
1039 </listitem>
1040 </varlistentry>
1041
1042 <varlistentry id="jcmd">
1043 <term><command>jcmd</command></term>
1044 <listitem>
1045 <para>is a utility to send diagnostic command requests to a running
1046 Java Virtual Machine.</para>
1047 <indexterm zone="openjdk jcmd">
1048 <primary sortas="b-jcmd">jcmd</primary>
1049 </indexterm>
1050 </listitem>
1051 </varlistentry>
1052
1053 <varlistentry id="jconsole">
1054 <term><command>jconsole</command></term>
1055 <listitem>
1056 <para>is a graphical console tool to monitor and manage both
1057 local and remote Java applications and virtual machines.</para>
1058 <indexterm zone="openjdk jconsole">
1059 <primary sortas="b-jconsole">jconsole</primary>
1060 </indexterm>
1061 </listitem>
1062 </varlistentry>
1063
1064 <varlistentry id="jdb">
1065 <term><command>jdb</command></term>
1066 <listitem>
1067 <para>is a simple command-line debugger for Java classes.</para>
1068 <indexterm zone="openjdk jdb">
1069 <primary sortas="b-jdb">jdb</primary>
1070 </indexterm>
1071 </listitem>
1072 </varlistentry>
1073
1074 <varlistentry id="jdeps">
1075 <term><command>jdeps</command></term>
1076 <listitem>
1077 <para>shows the package-level or class-level dependencies of
1078 Java class files.</para>
1079 <indexterm zone="openjdk jdeps">
1080 <primary sortas="b-jdeps">jdeps</primary>
1081 </indexterm>
1082 </listitem>
1083 </varlistentry>
1084
1085 <varlistentry id="jhat">
1086 <term><command>jhat</command></term>
1087 <listitem>
1088 <para>parses a java heap dump file and allows viewing it
1089 in a web browser.</para>
1090 <indexterm zone="openjdk jhat">
1091 <primary sortas="b-jhat">jhat</primary>
1092 </indexterm>
1093 </listitem>
1094 </varlistentry>
1095
1096 <varlistentry id="jinfo">
1097 <term><command>jinfo</command></term>
1098 <listitem>
1099 <para>prints Java configuration information for a given Java
1100 process, core file, or a remote debug server.</para>
1101 <indexterm zone="openjdk jinfo">
1102 <primary sortas="b-jinfo">jinfo</primary>
1103 </indexterm>
1104 </listitem>
1105 </varlistentry>
1106
1107 <varlistentry id="jjs">
1108 <term><command>jjs</command></term>
1109 <listitem>
1110 <para>is a command-line tool used to invoke the Nashorn engine. It
1111 can be used to interpret one or several script files, or to run
1112 an interactive shell.</para>
1113 <indexterm zone="openjdk jjs">
1114 <primary sortas="b-jjs">jjs</primary>
1115 </indexterm>
1116 </listitem>
1117 </varlistentry>
1118
1119 <varlistentry id="jmap">
1120 <term><command>jmap</command></term>
1121 <listitem>
1122 <para>prints shared object memory maps or heap memory details
1123 of a given process, core file, or a remote debug server.</para>
1124 <indexterm zone="openjdk jmap">
1125 <primary sortas="b-jmap">jmap</primary>
1126 </indexterm>
1127 </listitem>
1128 </varlistentry>
1129
1130 <varlistentry id="jps">
1131 <term><command>jps</command></term>
1132 <listitem>
1133 <para>lists the instrumented JVMs on the target system.</para>
1134 <indexterm zone="openjdk jps">
1135 <primary sortas="b-jps">jps</primary>
1136 </indexterm>
1137 </listitem>
1138 </varlistentry>
1139
1140 <varlistentry id="jrunscript">
1141 <term><command>jrunscript</command></term>
1142 <listitem>
1143 <para>is a command line script shell.</para>
1144 <indexterm zone="openjdk jrunscript">
1145 <primary sortas="b-jrunscript">jrunscript</primary>
1146 </indexterm>
1147 </listitem>
1148 </varlistentry>
1149
1150 <varlistentry id="jsadebugd">
1151 <term><command>jsadebugd</command></term>
1152 <listitem>
1153 <para>attaches to a Java process or core file and acts as a
1154 debug server.</para>
1155 <indexterm zone="openjdk jsadebugd">
1156 <primary sortas="b-jsadebugd">jsadebugd</primary>
1157 </indexterm>
1158 </listitem>
1159 </varlistentry>
1160
1161 <varlistentry id="jstack">
1162 <term><command>jstack</command></term>
1163 <listitem>
1164 <para>prints Java stack traces of Java threads for a given
1165 Java process, core file, or a remote debug server.</para>
1166 <indexterm zone="openjdk jstack">
1167 <primary sortas="b-jstack">jstack</primary>
1168 </indexterm>
1169 </listitem>
1170 </varlistentry>
1171
1172 <varlistentry id="jstat">
1173 <term><command>jstat</command></term>
1174 <listitem>
1175 <para>displays performance statistics for an instrumented JVM.</para>
1176 <indexterm zone="openjdk jstat">
1177 <primary sortas="b-jstat">jstat</primary>
1178 </indexterm>
1179 </listitem>
1180 </varlistentry>
1181
1182 <varlistentry id="jstatd">
1183 <term><command>jstatd</command></term>
1184 <listitem>
1185 <para>is an RMI server application that monitors for the creation
1186 and termination of instrumented JVMs.</para>
1187 <indexterm zone="openjdk jstatd">
1188 <primary sortas="b-jstatd">jstatd</primary>
1189 </indexterm>
1190 </listitem>
1191 </varlistentry>
1192
1193 <varlistentry id="keytool">
1194 <term><command>keytool</command></term>
1195 <listitem>
1196 <para>is a key and certificate management utility.</para>
1197 <indexterm zone="openjdk keytool">
1198 <primary sortas="b-keytool">keytool</primary>
1199 </indexterm>
1200 </listitem>
1201 </varlistentry>
1202
1203 <varlistentry id="mkcacerts">
1204 <term><command>mkcacerts</command></term>
1205 <listitem>
1206 <para> is a simple script to extract x509 certificates and create
1207 a JRE cacerts file using <command>keytool</command>.</para>
1208 <indexterm zone="openjdk mkcacerts">
1209 <primary sortas="b-mkcacerts">mkcacerts</primary>
1210 </indexterm>
1211 </listitem>
1212 </varlistentry>
1213
1214 <varlistentry id="native2ascii">
1215 <term><command>native2ascii</command></term>
1216 <listitem>
1217 <para> converts files that contain non-supported character encoding
1218 into files containing Latin-1 or Unicode-encoded characters.</para>
1219 <indexterm zone="openjdk native2ascii">
1220 <primary sortas="b-native2ascii">native2ascii</primary>
1221 </indexterm>
1222 </listitem>
1223 </varlistentry>
1224
1225 <varlistentry id="orbd">
1226 <term><command>orbd</command></term>
1227 <listitem>
1228 <para>is used to enable clients to transparently locate and invoke
1229 persistent objects on servers in the CORBA environment.</para>
1230 <indexterm zone="openjdk orbd">
1231 <primary sortas="b-orbd">orbd</primary>
1232 </indexterm>
1233 </listitem>
1234 </varlistentry>
1235
1236 <varlistentry id="pack200">
1237 <term><command>pack200</command></term>
1238 <listitem>
1239 <para>is a Java application that transforms a jar file into a
1240 compressed pack200 file using the Java gzip compressor.</para>
1241 <indexterm zone="openjdk pack200">
1242 <primary sortas="b-pack200">pack200</primary>
1243 </indexterm>
1244 </listitem>
1245 </varlistentry>
1246
1247 <varlistentry id="policytool">
1248 <term><command>policytool</command></term>
1249 <listitem>
1250 <para>creates and manages a policy file graphically.</para>
1251 <indexterm zone="openjdk policytool">
1252 <primary sortas="b-policytool">policytool</primary>
1253 </indexterm>
1254 </listitem>
1255 </varlistentry>
1256
1257 <varlistentry id="rmic">
1258 <term><command>rmic</command></term>
1259 <listitem>
1260 <para>generates stub and skeleton class files for remote objects
1261 from the names of compiled Java classes that contain remote
1262 object implementations.</para>
1263 <indexterm zone="openjdk rmic">
1264 <primary sortas="b-rmic">rmic</primary>
1265 </indexterm>
1266 </listitem>
1267 </varlistentry>
1268
1269 <varlistentry id="rmid">
1270 <term><command>rmid</command></term>
1271 <listitem>
1272 <para>starts the activation system daemon.</para>
1273 <indexterm zone="openjdk rmid">
1274 <primary sortas="b-rmid">rmid</primary>
1275 </indexterm>
1276 </listitem>
1277 </varlistentry>
1278
1279 <varlistentry id="rmiregistry">
1280 <term><command>rmiregistry</command></term>
1281 <listitem>
1282 <para>creates and starts a remote object registry on the specified
1283 port on the current host.</para>
1284 <indexterm zone="openjdk rmiregistry">
1285 <primary sortas="b-rmiregistry">rmiregistry</primary>
1286 </indexterm>
1287 </listitem>
1288 </varlistentry>
1289
1290 <varlistentry id="schemagen">
1291 <term><command>schemagen</command></term>
1292 <listitem>
1293 <para>is a Java XML binding schema generator.</para>
1294 <indexterm zone="openjdk schemagen">
1295 <primary sortas="b-schemagen">schemagen</primary>
1296 </indexterm>
1297 </listitem>
1298 </varlistentry>
1299
1300 <varlistentry id="serialver">
1301 <term><command>serialver</command></term>
1302 <listitem>
1303 <para>returns the serialVersionUID for one or more classes in a
1304 form suitable for copying into an evolving class.</para>
1305 <indexterm zone="openjdk serialver">
1306 <primary sortas="b-serialver">serialver</primary>
1307 </indexterm>
1308 </listitem>
1309 </varlistentry>
1310
1311 <varlistentry id="servertool">
1312 <term><command>servertool</command></term>
1313 <listitem>
1314 <para>provides an ease-of-use interface for application programmers
1315 to register, unregister, startup and shutdown a server.</para>
1316 <indexterm zone="openjdk servertool">
1317 <primary sortas="b-servertool">servertool</primary>
1318 </indexterm>
1319 </listitem>
1320 </varlistentry>
1321
1322 <varlistentry id="tnameserv">
1323 <term><command>tnameserv</command></term>
1324 <listitem>
1325 <para>starts the Java IDL name server.</para>
1326 <indexterm zone="openjdk tnameserv">
1327 <primary sortas="b-tnameserv">tnameserv</primary>
1328 </indexterm>
1329 </listitem>
1330 </varlistentry>
1331
1332 <varlistentry id="unpack200">
1333 <term><command>unpack200</command></term>
1334 <listitem>
1335 <para>is a native implementation that transforms a packed file
1336 produced by <application>pack200</application> into a jar
1337 file.</para>
1338 <indexterm zone="openjdk unpack200">
1339 <primary sortas="b-unpack200">unpack200</primary>
1340 </indexterm>
1341 </listitem>
1342 </varlistentry>
1343
1344 <varlistentry id="wsgen">
1345 <term><command>wsgen</command></term>
1346 <listitem>
1347 <para>generates JAX-WS portable artifacts used in JAX-WS
1348 web services.</para>
1349 <indexterm zone="openjdk wsgen">
1350 <primary sortas="b-wsgen">wsgen</primary>
1351 </indexterm>
1352 </listitem>
1353 </varlistentry>
1354
1355 <varlistentry id="wsimport">
1356 <term><command>wsimport</command></term>
1357 <listitem>
1358 <para>generates JAX-WS portable artifacts.</para>
1359 <indexterm zone="openjdk wsimport">
1360 <primary sortas="b-wsimport">wsimport</primary>
1361 </indexterm>
1362 </listitem>
1363 </varlistentry>
1364
1365 <varlistentry id="xjc">
1366 <term><command>xjc</command></term>
1367 <listitem>
1368 <para>is a Java XML binding compiler.</para>
1369 <indexterm zone="openjdk xjc">
1370 <primary sortas="b-xjc">xjc</primary>
1371 </indexterm>
1372 </listitem>
1373 </varlistentry>
1374
1375 </variablelist>
1376
1377 </sect2>
1378
1379</sect1>
Note: See TracBrowser for help on using the repository browser.