source: general/prog/openjdk.xml@ 9b36a3a

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

Add a variable to allow building openjdk on Linux-4, and tag for gcc-5

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