source: general/prog/openjdk.xml@ 8ddea36

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.7 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 8ddea36 was 718593a, checked in by Pierre Labastie <pieere@…>, 9 years ago

Tags

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