source: general/prog/openjdk.xml@ 30b7db74

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 30b7db74 was 30b7db74, checked in by DJ Lucas <dj@…>, 8 years ago

Use mk-ca-bundle.pl from curl for CA Certificates generation.

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