source: general/prog/openjdk.xml@ 82d1b9d1

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 82d1b9d1 was 82d1b9d1, checked in by Pierre Labastie <pieere@…>, 9 years ago

Remove warning about tests

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@15949 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 48.2 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 <note>
364 <para>
365 Testing will involve the interplay of pairs of JVMs using the
366 networking interface, so networking must be started. If it
367 isn't, not only will these tests fail, but the test cleanup
368 will leave orphaned JVMs running. There will be many of
369 them. Rebooting may be the easiest recovery.
370 </para>
371 </note>
372
373 <para>
374 Testing the newly built JVM involves several steps.
375 First, it is better to run the test suite in a frame buffer on a
376 different display, using Xvfb:
377 </para>
378
379<!-- Careful with the && below:
380"export DISPLAY=... && somecommand &" exports only DISPLAY to "somecommand"
381but not to the current environment, and
382"echo $! .... &&" does not echo the right PID. SO all && suppressed.-->
383<screen role='nodump'><userinput>if [ -n "$DISPLAY" ]; then
384 OLD_DISP=$DISPLAY
385fi
386export DISPLAY=:20
387nohup Xvfb $DISPLAY \
388 -fbdir $(pwd) \
389 -pixdepths 8 16 24 32 > Xvfb.out 2>&amp;1 &amp;
390echo $! > Xvfb.pid
391echo Waiting for Xvfb to initialize; sleep 1
392nohup twm -display $DISPLAY \
393 -f /dev/null > twm.out 2>&amp;1 &amp;
394echo $! > twm.pid
395echo Waiting for twm to initialize; sleep 1
396xhost +</userinput></screen>
397
398 <para>
399 Then, it is necessary to modify some files<!-- (replace &lt;N&gt; with the
400 number of JAVA VM allowed to run concurrently)-->:
401 </para>
402
403<screen role='nodump'><userinput>echo -e "
404jdk_all = :jdk_core \\
405 :jdk_svc \\
406 :jdk_beans \\
407 :jdk_imageio \\
408 :jdk_sound \\
409 :jdk_sctp \\
410 com/sun/awt \\
411 javax/accessibility \\
412 javax/print \\
413 sun/pisces \\
414 com/sun/java/swing" >> jdk/test/TEST.groups &amp;&amp;
415sed -e 's/all:.*jck.*/all: jtreg/' \
416 -e '/^JTREG /s@\$(JT_PLATFORM)/@@' \
417 -i langtools/test/Makefile<!-- &amp;&amp;
418sed -i 's@/win32@@' jdk/test/Makefile &amp;&amp;
419sed -e 's@JTREG_HOME@JT_PLATFORM="" &amp;@' \
420 -e 's@TEST="@CONCURRENCY=&lt;N&gt; &amp;@' \
421 -i test/Makefile--></userinput></screen>
422
423 <para>
424 Some variables have to be set:
425 </para>
426
427<screen role='nodump'><userinput>JT_JAVA=$(type -p javac | sed 's@/bin.*@@') &amp;&amp;
428JT_HOME=$(pwd)/jtreg &amp;&amp;
429PRODUCT_HOME=$(echo $(pwd)/build/*/images/j2sdk-image)</userinput></screen>
430
431 <para>
432 The tests are run as follows:
433 </para>
434
435<!-- no && here either, because the first "make" may return an error -->
436<screen role='nodump'><userinput>LANG=C make -k -C test \
437 JT_HOME=${JT_HOME} \
438 JT_JAVA=${JT_JAVA} \
439 PRODUCT_HOME=${PRODUCT_HOME} all
440LANG=C ${JT_HOME}/bin/jtreg -a -v:fail,error \
441 -dir:$(pwd)/hotspot/test \
442 -k:\!ignore \
443 -jdk:${PRODUCT_HOME} \
444<!-- -agentvm -conc:&lt;N&gt; \
445--> :jdk</userinput></screen>
446
447 <para>
448 The test results can be compared to
449 <ulink url="http://download.java.net/openjdk/testresults/8/">these
450 results</ulink>, although they usually are run on a newer version.
451 Some failures can be expected, the number of which depends on various
452 conditions, like whether the computer is connected to network. Also, some
453 tests may timeout if the machine is under load.
454 </para>
455
456 <para>
457 Next some cleanup has to be done. The instructions below only stop the
458 frame buffer, but it has been reported that some java VM may be left running
459 after the tests, so it is necessary to check orphaned processes:
460 </para>
461
462<screen role='nodump'><userinput>kill -9 `cat twm.pid` &amp;&amp;
463kill -9 `cat Xvfb.pid` &amp;&amp;
464rm -f Xvfb.out twm.out &amp;&amp;
465rm -f Xvfb.pid twm.pid &amp;&amp;
466if [ -n "$OLD_DISP" ]; then
467 DISPLAY=$OLD_DISP
468fi</userinput></screen>
469
470 <para>Install the package with the following commands as the
471 <systemitem class="username">root</systemitem> user:</para>
472
473<screen role="root"><userinput>cp -R build/*/images/j2sdk-image /opt/OpenJDK-&openjdk-version; &amp;&amp;
474chown -R root:root /opt/OpenJDK-&openjdk-version;</userinput></screen>
475
476 <para>
477 There are now two <application>OpenJDK</application> SDKs installed
478 in <filename class="directory">/opt</filename>. You should decide on
479 which one you would like to use as the default. Normally, you would opt
480 for the just installed <application>OpenJDK</application>. If so, do
481 the following as the <systemitem class="username">root</systemitem>
482 user:
483 </para>
484
485<screen role="root"><userinput>ln -v -nsf OpenJDK-&openjdk-version; /opt/jdk</userinput></screen>
486
487 <para>If desired, you may install a .desktop file corresponding to an entry
488 in a desktop menu for <command>policytool</command>. First, you need to
489 obtain an icon from <xref linkend="icedtea-web"/>:</para>
490
491<screen><userinput>tar -xf ../icedtea-web-&icedtea-web-version;.tar.gz \
492 icedtea-web-&icedtea-web-version;/javaws.png \
493 --strip-components=1</userinput></screen>
494
495 <para>Now, as <systemitem class="username">root</systemitem> user:</para>
496
497<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
498
499cat &gt; /usr/share/applications/openjdk-8-policytool.desktop &lt;&lt; "EOF" &amp;&amp;
500<literal>[Desktop Entry]
501Name=OpenJDK Java Policy Tool
502Name[pt_BR]=OpenJDK Java - Ferramenta de Pol&#237;tica
503Comment=OpenJDK Java Policy Tool
504Comment[pt_BR]=OpenJDK Java - Ferramenta de Pol&#237;tica
505Exec=/opt/jdk/bin/policytool
506Terminal=false
507Type=Application
508Icon=javaws
509Categories=Settings;</literal>
510EOF
511
512install -v -Dm0644 javaws.png /usr/share/pixmaps/javaws.png</userinput></screen>
513
514 <para>The choice of pt_BR is just an example. You can add any translation
515 by adding lines corresponding to your locale, e.g. for fr_FR,
516 <quote>Name[fr_FR]=</quote> and <quote>Comment[fr_FR]=</quote> with the
517 appropriate text as values.</para>
518
519 </sect2>
520
521 <sect2 role="commands">
522 <title>Command Explanations</title>
523
524 <para>
525 <command>sh configure...</command>: the top level
526 <filename>configure</filename> is a wrapper around the autotools one.
527 It is not executable and must be run through <command>sh</command>.
528 </para>
529
530 <para>
531 <option>--with-boot-jdk</option>: This switch provides the
532 location of the temporary <application>JDK</application>. It is normally
533 not needed if <command>java</command> is found in the <envar>PATH</envar>.
534 </para>
535
536 <para>
537 <parameter>--with-update-version</parameter>: Currently, the build
538 system does not include the update number in the version string. It has
539 to be specified here.
540 </para>
541
542 <para>
543 <parameter>--with-build-number</parameter>: Again, the build
544 system does not include the build number in the version string. It has
545 to be specified here too.
546 </para>
547
548 <para>
549 <parameter>--with-milestone</parameter>: Used to customize the
550 version string.
551 </para>
552
553 <para>
554 <parameter>--enable-unlimited-crypto</parameter>: Because of limitations
555 on the usage of cryptography in some countries, there is the possibility
556 to limit the size of encryption keys and the use of some algorithms in a
557 policy file. This switch allows to ship a policy file with no
558 restriction. It is the responsability of the user to ensure proper
559 adherence to the law.
560 </para>
561
562 <para>
563 <parameter>--with-zlib=system, --with-giflib=system</parameter>: Allows
564 to use the system libraries instead of the bundled ones.
565 </para>
566
567 <para>
568 <option>--with-jobs=N</option>: Allows setting the number
569 of jobs for <command>make</command> equal to N. The default is the
570 result of a calculation involving the available memory and the number
571 of processors. Note that even if you specify N=1, some parallelization
572 may be used during the build. The SBU given above are with parallel jobs
573 disabled, on a single processor, single core, virtual machine.
574 </para>
575
576 <para>
577 <option>--with-cacerts-file=...</option>: Specifies where to find a
578 <filename>cacerts</filename> file, typically <filename>
579 /opt/jdk/jre/lib/security</filename>. Otherwise, an empty one is created.
580 You can get it from an earlier version of the package, or use the
581 script below to generate one.
582 </para>
583
584 <para>
585 <command>make DEBUG_BINARIES=true all</command>: The build fails
586 if DEBUG_BINARIES is not set to true.
587 </para>
588
589 <para>
590 <command>find ... -iname '*.diz' -delete</command>: This command
591 removes redundant files.
592 </para>
593
594 </sect2>
595
596 <sect2 role="configuration"
597 id="openjdk-config"
598 xreflabel="Configuring OpenJDK">
599 <title>Configuring OpenJDK</title>
600
601 <sect3>
602 <title>Configuration Information</title>
603
604 <para>Normally, the JAVA environment has been configured after installing
605 the binary version, and can be used with the just built package as well.
606 Review <xref linkend="ojdk-conf"/> in case you want to modify
607 something.</para>
608
609 <para>To test if the man pages are correctly installed, issue
610 <command>source /etc/profile</command> and <command>man java</command> to
611 display the respective man page.</para>
612
613 </sect3>
614
615 <sect3 id='ojdk-certs' xreflabel='JRE Certificate Authorithy Certificates'>
616 <title>Install or update the JRE Certificate Authority Certificates
617 (cacerts) file</title>
618
619 <para>
620 <application>OpenJDK</application> uses its own format for the
621 CA certificates. Those certificates are located in a file named <filename>
622 /opt/jdk/jre/lib/security/cacerts</filename>. That file may be generated
623 from the one installed using the instructions on the <xref
624 linkend="cacerts"/> page, using the following procedure.
625 First, generate the <command>mkcacerts</command> script
626 as the <systemitem class="username">root</systemitem> user:
627 </para>
628
629<screen role="root"><userinput>cat &gt; /opt/jdk/bin/mkcacerts &lt;&lt; "EOF"
630<literal>#!/bin/sh
631# Simple script to extract x509 certificates and create a JRE cacerts file.
632
633function get_args()
634 {
635 if test -z "${1}" ; then
636 showhelp
637 exit 1
638 fi
639
640 while test -n "${1}" ; do
641 case "${1}" in
642 -f | --cafile)
643 check_arg $1 $2
644 CAFILE="${2}"
645 shift 2
646 ;;
647 -d | --cadir)
648 check_arg $1 $2
649 CADIR="${2}"
650 shift 2
651 ;;
652 -o | --outfile)
653 check_arg $1 $2
654 OUTFILE="${2}"
655 shift 2
656 ;;
657 -k | --keytool)
658 check_arg $1 $2
659 KEYTOOL="${2}"
660 shift 2
661 ;;
662 -s | --openssl)
663 check_arg $1 $2
664 OPENSSL="${2}"
665 shift 2
666 ;;
667 -h | --help)
668 showhelp
669 exit 0
670 ;;
671 *)
672 showhelp
673 exit 1
674 ;;
675 esac
676 done
677 }
678
679function check_arg()
680 {
681 echo "${2}" | grep -v "^-" > /dev/null
682 if [ -z "$?" -o ! -n "$2" ]; then
683 echo "Error: $1 requires a valid argument."
684 exit 1
685 fi
686 }
687
688# The date binary is not reliable on 32bit systems for dates after 2038
689function mydate()
690 {
691 local y=$( echo $1 | cut -d" " -f4 )
692 local M=$( echo $1 | cut -d" " -f1 )
693 local d=$( echo $1 | cut -d" " -f2 )
694 local m
695
696 if [ ${d} -lt 10 ]; then d="0${d}"; fi
697
698 case $M in
699 Jan) m="01";;
700 Feb) m="02";;
701 Mar) m="03";;
702 Apr) m="04";;
703 May) m="05";;
704 Jun) m="06";;
705 Jul) m="07";;
706 Aug) m="08";;
707 Sep) m="09";;
708 Oct) m="10";;
709 Nov) m="11";;
710 Dec) m="12";;
711 esac
712
713 certdate="${y}${m}${d}"
714 }
715
716function showhelp()
717 {
718 echo "`basename ${0}` creates a valid cacerts file for use with IcedTea."
719 echo ""
720 echo " -f --cafile The path to a file containing PEM"
721 echo " formated CA certificates. May not be"
722 echo " used with -d/--cadir."
723 echo ""
724 echo " -d --cadir The path to a directory of PEM formatted"
725 echo " CA certificates. May not be used with"
726 echo " -f/--cafile."
727 echo ""
728 echo " -o --outfile The path to the output file."
729 echo ""
730 echo " -k --keytool The path to the java keytool utility."
731 echo ""
732 echo " -s --openssl The path to the openssl utility."
733 echo ""
734 echo " -h --help Show this help message and exit."
735 echo ""
736 echo ""
737 }
738
739# Initialize empty variables so that the shell does not pollute the script
740CAFILE=""
741CADIR=""
742OUTFILE=""
743OPENSSL=""
744KEYTOOL=""
745certdate=""
746date=""
747today=$( date +%Y%m%d )
748
749# Process command line arguments
750get_args ${@}
751
752# Handle common errors
753if test "${CAFILE}x" == "x" -a "${CADIR}x" == "x" ; then
754 echo "ERROR! You must provide an x509 certificate store!"
755 echo "\'$(basename ${0}) --help\' for more info."
756 echo ""
757 exit 1
758fi
759
760if test "${CAFILE}x" != "x" -a "${CADIR}x" != "x" ; then
761 echo "ERROR! You cannot provide two x509 certificate stores!"
762 echo "\'$(basename ${0}) --help\' for more info."
763 echo ""
764 exit 1
765fi
766
767if test "${KEYTOOL}x" == "x" ; then
768 echo "ERROR! You must provide a valid keytool program!"
769 echo "\'$(basename ${0}) --help\' for more info."
770 echo ""
771 exit 1
772fi
773
774if test "${OPENSSL}x" == "x" ; then
775 echo "ERROR! You must provide a valid path to openssl!"
776 echo "\'$(basename ${0}) --help\' for more info."
777 echo ""
778 exit 1
779fi
780
781if test "${OUTFILE}x" == "x" ; then
782 echo "ERROR! You must provide a valid output file!"
783 echo "\'$(basename ${0}) --help\' for more info."
784 echo ""
785 exit 1
786fi
787
788# Get on with the work
789
790# If using a CAFILE, split it into individual files in a temp directory
791if test "${CAFILE}x" != "x" ; then
792 TEMPDIR=`mktemp -d`
793 CADIR="${TEMPDIR}"
794
795 # Get a list of staring lines for each cert
796 CERTLIST=`grep -n "^-----BEGIN" "${CAFILE}" | cut -d ":" -f 1`
797
798 # Get a list of ending lines for each cert
799 ENDCERTLIST=`grep -n "^-----END" "${CAFILE}" | cut -d ":" -f 1`
800
801 # Start a loop
802 for certbegin in `echo "${CERTLIST}"` ; do
803 for certend in `echo "${ENDCERTLIST}"` ; do
804 if test "${certend}" -gt "${certbegin}"; then
805 break
806 fi
807 done
808 sed -n "${certbegin},${certend}p" "${CAFILE}" > "${CADIR}/${certbegin}.pem"
809 keyhash=`${OPENSSL} x509 -noout -in "${CADIR}/${certbegin}.pem" -hash`
810 echo "Generated PEM file with hash: ${keyhash}."
811 done
812fi
813
814# Write the output file
815for cert in `find "${CADIR}" -type f -name "*.pem" -o -name "*.crt"`
816do
817
818 # Make sure the certificate date is valid...
819 date=$( ${OPENSSL} x509 -enddate -in "${cert}" -noout | sed 's/^notAfter=//' )
820 mydate "${date}"
821 if test "${certdate}" -lt "${today}" ; then
822 echo "${cert} expired on ${certdate}! Skipping..."
823 unset date certdate
824 continue
825 fi
826 unset date certdate
827 ls "${cert}"
828 tempfile=`mktemp`
829 certbegin=`grep -n "^-----BEGIN" "${cert}" | cut -d ":" -f 1`
830 certend=`grep -n "^-----END" "${cert}" | cut -d ":" -f 1`
831 sed -n "${certbegin},${certend}p" "${cert}" > "${tempfile}"
832 echo yes | env LC_ALL=C "${KEYTOOL}" -import \
833 -alias `basename "${cert}"` \
834 -keystore "${OUTFILE}" \
835 -storepass 'changeit' \
836 -file "${tempfile}"
837 rm "${tempfile}"
838done
839
840if test "${TEMPDIR}x" != "x" ; then
841 rm -rf "${TEMPDIR}"
842fi
843exit 0</literal>
844EOF
845
846chmod -c 0755 /opt/jdk/bin/mkcacerts</userinput></screen>
847
848 <note>
849 <para>
850 Doing a very large copy/paste directly to a terminal may result in a
851 corrupted file. Copying to an editor may overcome this issue.
852 </para>
853 </note>
854
855 <para>
856 Generate the <application>OpenJDK</application> <filename>cacerts</filename>
857 file as the <systemitem class="username">root</systemitem> user:
858 </para>
859
860<screen role="root"><userinput>if [ -f /opt/jdk/jre/lib/security/cacerts ]; then
861 mv /opt/jdk/jre/lib/security/cacerts \
862 /opt/jdk/jre/lib/security/cacerts.bak
863fi &amp;&amp;
864/opt/jdk/bin/mkcacerts \
865 -d "/etc/ssl/certs/" \
866 -k "/opt/jdk/bin/keytool" \
867 -s "/usr/bin/openssl" \
868 -o "/opt/jdk/jre/lib/security/cacerts"</userinput></screen>
869
870 <para>Use the following commands to check if the
871 <filename>cacerts</filename> file has been successfully installed:</para>
872
873<screen role="root"><userinput>cd /opt/jdk
874bin/keytool -list -keystore jre/lib/security/cacerts</userinput></screen>
875
876 <para>At the prompt "Enter keystore password:", press the "Enter" key if
877 there is no keystore password defined. If the <filename>cacerts</filename>
878 file was installed correctly, you will see a list of the certificates with
879 related information for each one. If not, you need to reinstall
880 them.</para>
881
882 </sect3>
883
884 </sect2>
885
886 <sect2 role="content">
887 <title>Contents</title>
888
889 <segmentedlist>
890 <segtitle>Installed Programs</segtitle>
891 <segtitle>Installed Libraries</segtitle>
892 <segtitle>Installed Directory</segtitle>
893
894 <seglistitem>
895 <seg>appletviewer, extcheck, idlj, jar,
896 jarsigner, java, javac, javadoc, javah, javap, java-rmi.cgi,
897 jcmd, jconsole, jdb, jdeps, jhat, jinfo, jjs, jmap, jps,
898 jrunscript, jsadebugd, jstack, jstat, jstatd, keytool, mkcacerts,
899 native2ascii, orbd, pack200, policytool, rmic, rmid, rmiregistry,
900 schemagen, serialver, servertool, tnameserv, unpack200,
901 wsgen, wsimport, and xjc</seg>
902 <seg>/opt/OpenJDK-&openjdk-version;/lib/*, and
903 /opt/OpenJDK-&openjdk-version;/jre/lib/*</seg>
904 <seg>/opt/OpenJDK-&openjdk-version;</seg>
905 </seglistitem>
906 </segmentedlist>
907
908 <variablelist>
909 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
910 <?dbfo list-presentation="list"?>
911 <?dbhtml list-presentation="table"?>
912
913 <varlistentry id="appletviewer">
914 <term><command>appletviewer</command></term>
915 <listitem>
916 <para>allows to run applets outside of a web browser.</para>
917 <indexterm zone="openjdk appletviewer">
918 <primary sortas="b-appletviewer">appletviewer</primary>
919 </indexterm>
920 </listitem>
921 </varlistentry>
922
923 <varlistentry id="extcheck">
924 <term><command>extcheck</command></term>
925 <listitem>
926 <para>checks a specified jar file for title and version conflicts
927 with any extensions installed in the
928 <application>OpenJDK</application> software.</para>
929 <indexterm zone="openjdk extcheck">
930 <primary sortas="b-extcheck">extcheck</primary>
931 </indexterm>
932 </listitem>
933 </varlistentry>
934
935 <varlistentry id="idlj">
936 <term><command>idlj</command></term>
937 <listitem>
938 <para>generates Java bindings from a given IDL file.</para>
939 <indexterm zone="openjdk idlj">
940 <primary sortas="b-idlj">idlj</primary>
941 </indexterm>
942 </listitem>
943 </varlistentry>
944
945 <varlistentry id="jar">
946 <term><command>jar</command></term>
947 <listitem>
948 <para>combines multiple files into a single jar archive.</para>
949 <indexterm zone="openjdk jar">
950 <primary sortas="b-jar">jar</primary>
951 </indexterm>
952 </listitem>
953 </varlistentry>
954
955 <varlistentry id="jarsigner">
956 <term><command>jarsigner</command></term>
957 <listitem>
958 <para>signs jar files and verifies the signatures and integrity
959 of a signed jar file.</para>
960 <indexterm zone="openjdk jarsigner">
961 <primary sortas="b-jarsigner">jarsigner</primary>
962 </indexterm>
963 </listitem>
964 </varlistentry>
965
966 <varlistentry id="java-prog">
967 <term><command>java</command></term>
968 <listitem>
969 <para>launches a Java application by starting a Java runtime
970 environment, loading a specified class and invoking its main
971 method.</para>
972 <indexterm zone="openjdk java-prog">
973 <primary sortas="b-java-prog">java</primary>
974 </indexterm>
975 </listitem>
976 </varlistentry>
977
978 <varlistentry id="javac">
979 <term><command>javac</command></term>
980 <listitem>
981 <para>reads class and interface definitions, written in the
982 Java programming language, and compiles them into bytecode
983 class files.</para>
984 <indexterm zone="openjdk javac">
985 <primary sortas="b-javac">javac</primary>
986 </indexterm>
987 </listitem>
988 </varlistentry>
989
990 <varlistentry id="javadoc">
991 <term><command>javadoc</command></term>
992 <listitem>
993 <para>parses the declarations and documentation comments in a
994 set of Java source files and produces a corresponding set of
995 HTML pages describing the classes, interfaces, constructors,
996 methods, and fields.</para>
997 <indexterm zone="openjdk javadoc">
998 <primary sortas="b-javadoc">javadoc</primary>
999 </indexterm>
1000 </listitem>
1001 </varlistentry>
1002
1003 <varlistentry id="javah">
1004 <term><command>javah</command></term>
1005 <listitem>
1006 <para>generates C header and source files
1007 that are needed to implement native methods.</para>
1008 <indexterm zone="openjdk javah">
1009 <primary sortas="b-javah">javah</primary>
1010 </indexterm>
1011 </listitem>
1012 </varlistentry>
1013
1014 <varlistentry id="javap">
1015 <term><command>javap</command></term>
1016 <listitem>
1017 <para>disassembles a Java class file.</para>
1018 <indexterm zone="openjdk javap">
1019 <primary sortas="b-javap">javap</primary>
1020 </indexterm>
1021 </listitem>
1022 </varlistentry>
1023
1024 <varlistentry id="java-rmi.cgi">
1025 <term><command>java-rmi.cgi</command></term>
1026 <listitem>
1027 <para>is the Java RMI client.</para>
1028 <indexterm zone="openjdk java-rmi.cgi">
1029 <primary sortas="b-java-rmi.cgi">java-rmi.cgi</primary>
1030 </indexterm>
1031 </listitem>
1032 </varlistentry>
1033
1034 <varlistentry id="jcmd">
1035 <term><command>jcmd</command></term>
1036 <listitem>
1037 <para>is a utility to send diagnostic command requests to a running
1038 Java Virtual Machine.</para>
1039 <indexterm zone="openjdk jcmd">
1040 <primary sortas="b-jcmd">jcmd</primary>
1041 </indexterm>
1042 </listitem>
1043 </varlistentry>
1044
1045 <varlistentry id="jconsole">
1046 <term><command>jconsole</command></term>
1047 <listitem>
1048 <para>is a graphical console tool to monitor and manage both
1049 local and remote Java applications and virtual machines.</para>
1050 <indexterm zone="openjdk jconsole">
1051 <primary sortas="b-jconsole">jconsole</primary>
1052 </indexterm>
1053 </listitem>
1054 </varlistentry>
1055
1056 <varlistentry id="jdb">
1057 <term><command>jdb</command></term>
1058 <listitem>
1059 <para>is a simple command-line debugger for Java classes.</para>
1060 <indexterm zone="openjdk jdb">
1061 <primary sortas="b-jdb">jdb</primary>
1062 </indexterm>
1063 </listitem>
1064 </varlistentry>
1065
1066 <varlistentry id="jdeps">
1067 <term><command>jdeps</command></term>
1068 <listitem>
1069 <para>shows the package-level or class-level dependencies of
1070 Java class files.</para>
1071 <indexterm zone="openjdk jdeps">
1072 <primary sortas="b-jdeps">jdeps</primary>
1073 </indexterm>
1074 </listitem>
1075 </varlistentry>
1076
1077 <varlistentry id="jhat">
1078 <term><command>jhat</command></term>
1079 <listitem>
1080 <para>parses a java heap dump file and allows viewing it
1081 in a web browser.</para>
1082 <indexterm zone="openjdk jhat">
1083 <primary sortas="b-jhat">jhat</primary>
1084 </indexterm>
1085 </listitem>
1086 </varlistentry>
1087
1088 <varlistentry id="jinfo">
1089 <term><command>jinfo</command></term>
1090 <listitem>
1091 <para>prints Java configuration information for a given Java
1092 process, core file, or a remote debug server.</para>
1093 <indexterm zone="openjdk jinfo">
1094 <primary sortas="b-jinfo">jinfo</primary>
1095 </indexterm>
1096 </listitem>
1097 </varlistentry>
1098
1099 <varlistentry id="jjs">
1100 <term><command>jjs</command></term>
1101 <listitem>
1102 <para>is a command-line tool used to invoke the Nashorn engine. It
1103 can be used to interpret one or several script files, or to run
1104 an interactive shell.</para>
1105 <indexterm zone="openjdk jjs">
1106 <primary sortas="b-jjs">jjs</primary>
1107 </indexterm>
1108 </listitem>
1109 </varlistentry>
1110
1111 <varlistentry id="jmap">
1112 <term><command>jmap</command></term>
1113 <listitem>
1114 <para>prints shared object memory maps or heap memory details
1115 of a given process, core file, or a remote debug server.</para>
1116 <indexterm zone="openjdk jmap">
1117 <primary sortas="b-jmap">jmap</primary>
1118 </indexterm>
1119 </listitem>
1120 </varlistentry>
1121
1122 <varlistentry id="jps">
1123 <term><command>jps</command></term>
1124 <listitem>
1125 <para>lists the instrumented JVMs on the target system.</para>
1126 <indexterm zone="openjdk jps">
1127 <primary sortas="b-jps">jps</primary>
1128 </indexterm>
1129 </listitem>
1130 </varlistentry>
1131
1132 <varlistentry id="jrunscript">
1133 <term><command>jrunscript</command></term>
1134 <listitem>
1135 <para>is a command line script shell.</para>
1136 <indexterm zone="openjdk jrunscript">
1137 <primary sortas="b-jrunscript">jrunscript</primary>
1138 </indexterm>
1139 </listitem>
1140 </varlistentry>
1141
1142 <varlistentry id="jsadebugd">
1143 <term><command>jsadebugd</command></term>
1144 <listitem>
1145 <para>attaches to a Java process or core file and acts as a
1146 debug server.</para>
1147 <indexterm zone="openjdk jsadebugd">
1148 <primary sortas="b-jsadebugd">jsadebugd</primary>
1149 </indexterm>
1150 </listitem>
1151 </varlistentry>
1152
1153 <varlistentry id="jstack">
1154 <term><command>jstack</command></term>
1155 <listitem>
1156 <para>prints Java stack traces of Java threads for a given
1157 Java process, core file, or a remote debug server.</para>
1158 <indexterm zone="openjdk jstack">
1159 <primary sortas="b-jstack">jstack</primary>
1160 </indexterm>
1161 </listitem>
1162 </varlistentry>
1163
1164 <varlistentry id="jstat">
1165 <term><command>jstat</command></term>
1166 <listitem>
1167 <para>displays performance statistics for an instrumented JVM.</para>
1168 <indexterm zone="openjdk jstat">
1169 <primary sortas="b-jstat">jstat</primary>
1170 </indexterm>
1171 </listitem>
1172 </varlistentry>
1173
1174 <varlistentry id="jstatd">
1175 <term><command>jstatd</command></term>
1176 <listitem>
1177 <para>is an RMI server application that monitors for the creation
1178 and termination of instrumented JVMs.</para>
1179 <indexterm zone="openjdk jstatd">
1180 <primary sortas="b-jstatd">jstatd</primary>
1181 </indexterm>
1182 </listitem>
1183 </varlistentry>
1184
1185 <varlistentry id="keytool">
1186 <term><command>keytool</command></term>
1187 <listitem>
1188 <para>is a key and certificate management utility.</para>
1189 <indexterm zone="openjdk keytool">
1190 <primary sortas="b-keytool">keytool</primary>
1191 </indexterm>
1192 </listitem>
1193 </varlistentry>
1194
1195 <varlistentry id="mkcacerts">
1196 <term><command>mkcacerts</command></term>
1197 <listitem>
1198 <para> is a simple script to extract x509 certificates and create
1199 a JRE cacerts file using <command>keytool</command>.</para>
1200 <indexterm zone="openjdk mkcacerts">
1201 <primary sortas="b-mkcacerts">mkcacerts</primary>
1202 </indexterm>
1203 </listitem>
1204 </varlistentry>
1205
1206 <varlistentry id="native2ascii">
1207 <term><command>native2ascii</command></term>
1208 <listitem>
1209 <para> converts files that contain non-supported character encoding
1210 into files containing Latin-1 or Unicode-encoded characters.</para>
1211 <indexterm zone="openjdk native2ascii">
1212 <primary sortas="b-native2ascii">native2ascii</primary>
1213 </indexterm>
1214 </listitem>
1215 </varlistentry>
1216
1217 <varlistentry id="orbd">
1218 <term><command>orbd</command></term>
1219 <listitem>
1220 <para>is used to enable clients to transparently locate and invoke
1221 persistent objects on servers in the CORBA environment.</para>
1222 <indexterm zone="openjdk orbd">
1223 <primary sortas="b-orbd">orbd</primary>
1224 </indexterm>
1225 </listitem>
1226 </varlistentry>
1227
1228 <varlistentry id="pack200">
1229 <term><command>pack200</command></term>
1230 <listitem>
1231 <para>is a Java application that transforms a jar file into a
1232 compressed pack200 file using the Java gzip compressor.</para>
1233 <indexterm zone="openjdk pack200">
1234 <primary sortas="b-pack200">pack200</primary>
1235 </indexterm>
1236 </listitem>
1237 </varlistentry>
1238
1239 <varlistentry id="policytool">
1240 <term><command>policytool</command></term>
1241 <listitem>
1242 <para>creates and manages a policy file graphically.</para>
1243 <indexterm zone="openjdk policytool">
1244 <primary sortas="b-policytool">policytool</primary>
1245 </indexterm>
1246 </listitem>
1247 </varlistentry>
1248
1249 <varlistentry id="rmic">
1250 <term><command>rmic</command></term>
1251 <listitem>
1252 <para>generates stub and skeleton class files for remote objects
1253 from the names of compiled Java classes that contain remote
1254 object implementations.</para>
1255 <indexterm zone="openjdk rmic">
1256 <primary sortas="b-rmic">rmic</primary>
1257 </indexterm>
1258 </listitem>
1259 </varlistentry>
1260
1261 <varlistentry id="rmid">
1262 <term><command>rmid</command></term>
1263 <listitem>
1264 <para>starts the activation system daemon.</para>
1265 <indexterm zone="openjdk rmid">
1266 <primary sortas="b-rmid">rmid</primary>
1267 </indexterm>
1268 </listitem>
1269 </varlistentry>
1270
1271 <varlistentry id="rmiregistry">
1272 <term><command>rmiregistry</command></term>
1273 <listitem>
1274 <para>creates and starts a remote object registry on the specified
1275 port on the current host.</para>
1276 <indexterm zone="openjdk rmiregistry">
1277 <primary sortas="b-rmiregistry">rmiregistry</primary>
1278 </indexterm>
1279 </listitem>
1280 </varlistentry>
1281
1282 <varlistentry id="schemagen">
1283 <term><command>schemagen</command></term>
1284 <listitem>
1285 <para>is a Java XML binding schema generator.</para>
1286 <indexterm zone="openjdk schemagen">
1287 <primary sortas="b-schemagen">schemagen</primary>
1288 </indexterm>
1289 </listitem>
1290 </varlistentry>
1291
1292 <varlistentry id="serialver">
1293 <term><command>serialver</command></term>
1294 <listitem>
1295 <para>returns the serialVersionUID for one or more classes in a
1296 form suitable for copying into an evolving class.</para>
1297 <indexterm zone="openjdk serialver">
1298 <primary sortas="b-serialver">serialver</primary>
1299 </indexterm>
1300 </listitem>
1301 </varlistentry>
1302
1303 <varlistentry id="servertool">
1304 <term><command>servertool</command></term>
1305 <listitem>
1306 <para>provides an ease-of-use interface for application programmers
1307 to register, unregister, startup and shutdown a server.</para>
1308 <indexterm zone="openjdk servertool">
1309 <primary sortas="b-servertool">servertool</primary>
1310 </indexterm>
1311 </listitem>
1312 </varlistentry>
1313
1314 <varlistentry id="tnameserv">
1315 <term><command>tnameserv</command></term>
1316 <listitem>
1317 <para>starts the Java IDL name server.</para>
1318 <indexterm zone="openjdk tnameserv">
1319 <primary sortas="b-tnameserv">tnameserv</primary>
1320 </indexterm>
1321 </listitem>
1322 </varlistentry>
1323
1324 <varlistentry id="unpack200">
1325 <term><command>unpack200</command></term>
1326 <listitem>
1327 <para>is a native implementation that transforms a packed file
1328 produced by <application>pack200</application> into a jar
1329 file.</para>
1330 <indexterm zone="openjdk unpack200">
1331 <primary sortas="b-unpack200">unpack200</primary>
1332 </indexterm>
1333 </listitem>
1334 </varlistentry>
1335
1336 <varlistentry id="wsgen">
1337 <term><command>wsgen</command></term>
1338 <listitem>
1339 <para>generates JAX-WS portable artifacts used in JAX-WS
1340 web services.</para>
1341 <indexterm zone="openjdk wsgen">
1342 <primary sortas="b-wsgen">wsgen</primary>
1343 </indexterm>
1344 </listitem>
1345 </varlistentry>
1346
1347 <varlistentry id="wsimport">
1348 <term><command>wsimport</command></term>
1349 <listitem>
1350 <para>generates JAX-WS portable artifacts.</para>
1351 <indexterm zone="openjdk wsimport">
1352 <primary sortas="b-wsimport">wsimport</primary>
1353 </indexterm>
1354 </listitem>
1355 </varlistentry>
1356
1357 <varlistentry id="xjc">
1358 <term><command>xjc</command></term>
1359 <listitem>
1360 <para>is a Java XML binding compiler.</para>
1361 <indexterm zone="openjdk xjc">
1362 <primary sortas="b-xjc">xjc</primary>
1363 </indexterm>
1364 </listitem>
1365 </varlistentry>
1366
1367 </variablelist>
1368
1369 </sect2>
1370
1371</sect1>
Note: See TracBrowser for help on using the repository browser.