source: general/prog/openjdk.xml@ 120b315

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 120b315 was 120b315, checked in by DJ Lucas <dj@…>, 5 years ago

Update to make-ca-0.5.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19295 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 38.6 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 "141">
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 "df3504e95d6e88924babb3821d4210a6">
16 <!ENTITY ojdk-size "498 KB">
17
18 <!ENTITY corba-md5sum "4061c0f2dc553cf92847e4a39a03ea4e">
19 <!ENTITY hotspot-md5sum "269a0fde90b9ab5ca19fa82bdb3d6485">
20 <!ENTITY jaxp-md5sum "a1dfcd15119dd10db6e91dc2019f14e7">
21 <!ENTITY jaxws-md5sum "16f904d990cb6a3c84ebb81bd6bea1e7">
22 <!ENTITY jdk-md5sum "c4a99c9c5293bb5c174366664843c8ce">
23 <!ENTITY langtools-md5sum "4fb652cdd6fee5f2873b00404e9a01f3">
24 <!ENTITY nashorn-md5sum "c2f06cd8d6e90f3dcc57bec53f419afe">
25 <!ENTITY total-download-size "63 MB">
26
27 <!ENTITY jtreg-version "4.2-b08-891">
28 <!ENTITY jtreg-download "&anduin-download;/jtreg-&jtreg-version;.tar.gz">
29 <!ENTITY jtreg-md5sum "f409d5313b5d9aa81bb6868082fda161">
30 <!ENTITY jtreg-size "6.8 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 529 MB for tests)">
35 <!ENTITY ojdk-time "4.3 SBU with 8 jobs in parallel (up to 120 SBU for tests, see below)">
36]>
37
38<sect1 id="openjdk" xreflabel="OpenJDK-&openjdk-version;">
39 <?dbhtml filename="openjdk.html" ?>
40
41 <sect1info>
42 <othername>$LastChangedBy$</othername>
43 <date>$Date$</date>
44 </sect1info>
45
46 <title>OpenJDK-&openjdk-version;</title>
47
48 <indexterm zone="openjdk">
49 <primary sortas="a-OpenJDK">OpenJDK</primary>
50 </indexterm>
51
52 <sect2 role="package">
53 <title>Introduction to OpenJDK</title>
54
55 <para>
56 <application>OpenJDK</application> is an open-source implementation
57 of Oracle's Java Standard Edition platform.
58 <application>OpenJDK</application> is useful for developing
59 <application>Java</application> programs, and provides a complete
60 runtime environment to run <application>Java</application> programs.
61 </para>
62
63 &lfs81_checked;
64
65 <note>
66 <para>
67 A browser plugin and webstart implementation is provided by the
68 Icedtea project. To provide a complete implementation, you will
69 need to later install <xref linkend="icedtea-web"/>.
70 </para>
71 </note>
72
73 <para>
74 OpenJDK is GPL'd code, with a special exception made for non-free
75 projects to use these classes in their proprietary products.
76 In similar fashion to the LGPL, which allows non-free programs to link
77 to libraries provided by free software, the
78 <ulink url="http://openjdk.java.net/legal/gplv2+ce.html">GNU
79 General Public License, version 2, with the Classpath Exception</ulink>
80 allows third party programs to use classes provided by free software
81 without the requirement that the third party software also be free. As
82 with the LGPL, any modifications made to the free software portions of a
83 third party application, must also be made freely available.
84 </para>
85
86 <note>
87 <para>
88 The <application>OpenJDK</application> source includes a very
89 thorough, open source test suite using the
90 <application>JTreg</application> test harness. The testing instructions
91 below allow to test the just built JDK for reasonable compatibility
92 with the proprietary Oracle JDK. However, in order for an independent
93 implementation to claim compatibility, it must pass a proprietary
94 <application>JCK/TCK</application> test suite. No claims of
95 compatibility, even partial compatibility, may be made without passing
96 an approved test suite.
97 </para>
98
99 <para>
100 Oracle does provide free community access, on a case by case basis, to
101 a closed toolkit to ensure 100% compatibility with its proprietary JDK.
102 Neither the binary version provided on the <xref linkend="java"/> page
103 nor the JVM built with the instructions below have been tested against
104 the <ulink
105 url="http://openjdk.java.net/groups/conformance/JckAccess/jck-access.html">
106 TCK</ulink>. Any version that is built using the instructions given,
107 cannot claim to be compatible with the proprietary JDK, without the
108 user applying for, and completing the compatibility tests themselves.
109 </para>
110
111 <para>
112 With that in mind, the binaries produced using this build method are
113 regularly tested against the TCK by the members listed on the site
114 above. In addition to the community license above, an educational,
115 non-commercial license for the TCK can be obtained from <ulink
116 url="http://www.oracle.com/technetwork/java/index-137188.html">
117 here</ulink>.
118 </para>
119 </note>
120
121 <bridgehead renderas="sect3">Source Package Information</bridgehead>
122 <itemizedlist spacing="compact">
123 <listitem>
124 <para>OpenJDK Root Package
125 <simplelist>
126 <member>Download: <ulink url="&ojdk-download;"/></member>
127 <member>Download MD5 sum: &ojdk-md5sum;</member>
128 <member>Download Size: &ojdk-size;</member>
129 </simplelist>
130 </para>
131 </listitem>
132 <listitem>
133 <para>
134 In addition to the root package, the instructions below first
135 download seven subproject tarballs, whose total size is
136 &total-download-size;.
137 </para>
138 </listitem>
139 <listitem>
140 <para>Estimated disk space required: &ojdk-buildsize;</para>
141 </listitem>
142 <listitem>
143 <para>Estimated build time: &ojdk-time;</para>
144 </listitem>
145 </itemizedlist>
146
147 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
148
149 <itemizedlist spacing='compact'>
150 <listitem>
151 <para>Optional test harness
152 <simplelist>
153 <member>Download: <ulink url="&jtreg-download;"/></member>
154 <member>Download MD5 sum: &jtreg-md5sum;</member>
155 <member>Download Size: &jtreg-size;</member>
156 </simplelist>
157 </para>
158 </listitem>
159 <listitem>
160 <para>
161 Optional package (to get an icon for the
162 <filename>openjdk-8-policytool.desktop</filename> file):
163 <ulink url="&icedtea-web-download;"/>
164 </para>
165 </listitem>
166 </itemizedlist>
167
168 <bridgehead renderas="sect3">OpenJDK Dependencies</bridgehead>
169
170 <bridgehead renderas="sect4">Required Dependencies</bridgehead>
171 <para role="required">
172 An existing binary (<xref linkend="java"/> or an earlier built
173 version of this package. The instructions below assume that
174 you are using <xref linkend="ojdk-conf"/>),
175 <xref linkend="alsa-lib"/>,
176 <xref linkend="cpio"/>,
177 <xref linkend="cups"/>,
178 <xref linkend="unzip"/>,
179 <xref linkend="which"/>,
180 <xref linkend="xorg7-lib"/>, and
181 <xref linkend="zip"/>
182 </para>
183
184 <bridgehead renderas="sect4">Recommended</bridgehead>
185 <para role="recommended">
186 <xref linkend="cacerts"/>,
187 <xref linkend="giflib"/>, and
188 <xref linkend="wget"/>
189 </para>
190
191 <bridgehead renderas="sect4">Optional</bridgehead>
192 <para role="optional">
193 <xref linkend="mercurial"/> and
194 an X Window manager such as <xref linkend="twm"/> (for the tests)
195 </para>
196
197 <para condition="html" role="usernotes">User Notes:
198 <ulink url="&blfs-wiki;/openjdk"/></para>
199
200 </sect2>
201
202 <sect2 role="installation">
203 <title>Installation of OpenJDK</title>
204
205 <para>
206 Unlike other packages in BLFS, the <application>OpenJDK</application>
207 source packages are distributed in multiple tarballs. You need to first
208 extract the source root from <filename>&ojdk-tarball;</filename>, change
209 into the extracted directory, then proceed with the following
210 instructions:
211 </para>
212
213<screen><userinput>cat &gt; subprojects.md5 &lt;&lt; EOF &amp;&amp;
214&corba-md5sum; corba.tar.bz2
215&hotspot-md5sum; hotspot.tar.bz2
216&jaxp-md5sum; jaxp.tar.bz2
217&jaxws-md5sum; jaxws.tar.bz2
218&langtools-md5sum; langtools.tar.bz2
219&jdk-md5sum; jdk.tar.bz2
220&nashorn-md5sum; nashorn.tar.bz2
221EOF
222
223for subproject in corba hotspot jaxp jaxws langtools jdk nashorn; do
224 wget -c &ojdk-repo;/${subproject}/archive/&ojdk-tarball; \
225 -O ${subproject}.tar.bz2
226done &amp;&amp;
227
228md5sum -c subprojects.md5 &amp;&amp;
229
230for subproject in corba hotspot jaxp jaxws langtools jdk nashorn; do
231 mkdir -pv ${subproject} &amp;&amp;
232 tar -xf ${subproject}.tar.bz2 --strip-components=1 -C ${subproject}
233done</userinput></screen>
234
235 <para>
236 If you have downloaded the optional test harness, unpack it too:
237 </para>
238
239<screen><userinput>tar -xf ../jtreg-&jtreg-version;.tar.gz</userinput></screen>
240
241<!--TODO: it might be better to add instructions for the cacerts file at
242this place and to use the switch "with-cacerts-file" -->
243
244 <note>
245 <para>
246 Before proceeding, you should ensure that your environment
247 <envar>PATH</envar> variable contains the location of the Java
248 compiler used for bootstrapping <application>OpenJDK</application>.
249 This is the only requirement for the environment. Modern Java
250 installations do not need <envar>JAVA_HOME</envar> and
251 <envar>CLASSPATH</envar> is not used here. Furthermore, OpenJDK
252 developers recommend to unset <envar>JAVA_HOME</envar>.
253 </para>
254
255 <para>
256 The build system does not support the <option>-j</option> switch in
257 <envar>MAKEFLAGS</envar>.
258 </para>
259 </note>
260
261 <para>
262 Configure and build the package with the following commands
263 (--with-milestone value can be modified to fit user preferences):
264 </para>
265
266<screen><userinput>unset JAVA_HOME &amp;&amp;
267sh ./configure \
268 --with-update-version=&ojdk-upd; \
269 --with-build-number=&ojdk-bd; \
270 --with-milestone=BLFS \
271 --enable-unlimited-crypto \
272 --with-zlib=system \
273 --with-giflib=system \
274 --with-extra-cflags="-std=c++98 -Wno-error -fno-delete-null-pointer-checks -fno-lifetime-dse" \
275 --with-extra-cxxflags="-std=c++98 -fno-delete-null-pointer-checks -fno-lifetime-dse" &amp;&amp;
276make DEBUG_BINARIES=true SCTP_WERROR= all &amp;&amp;
277find build/*/images/j2sdk-image -iname \*.diz -delete
278</userinput></screen>
279
280 <note>
281 <para>
282 Testing will involve the interplay of pairs of JVMs using the
283 networking interface, so networking must be started. If it
284 isn't, not only will these tests fail, but the test cleanup
285 will leave orphaned JVMs running. There will be many of
286 them. Rebooting may be the easiest recovery.
287 </para>
288 </note>
289
290 <para>
291 Testing the newly built JVM involves several steps.
292 First, it is better to run the test suite in a frame buffer on a
293 different display, using Xvfb:
294 </para>
295
296<!-- Careful with the && below:
297"export DISPLAY=... && somecommand &" exports only DISPLAY to "somecommand"
298but not to the current environment, and
299"echo $! .... &&" does not echo the right PID. So all && suppressed.-->
300<screen role='nodump'><userinput>if [ -n "$DISPLAY" ]; then
301 OLD_DISP=$DISPLAY
302fi
303export DISPLAY=:20
304nohup Xvfb $DISPLAY \
305 -fbdir $(pwd) \
306 -pixdepths 8 16 24 32 > Xvfb.out 2>&amp;1 &amp;
307echo $! > Xvfb.pid
308echo Waiting for Xvfb to initialize; sleep 1
309nohup twm -display $DISPLAY \
310 -f /dev/null > twm.out 2>&amp;1 &amp;
311echo $! > twm.pid
312echo Waiting for twm to initialize; sleep 1
313xhost +</userinput></screen>
314
315 <para>
316 Then, it is necessary to modify some files:
317 </para>
318
319<screen role='nodump'><userinput>echo -e "
320jdk_all = :jdk_core \\
321 :jdk_svc \\
322 :jdk_beans \\
323 :jdk_imageio \\
324 :jdk_sound \\
325 :jdk_sctp \\
326 com/sun/awt \\
327 javax/accessibility \\
328 javax/print \\
329 sun/pisces \\
330 com/sun/java/swing" >> jdk/test/TEST.groups &amp;&amp;
331sed -e 's/all:.*jck.*/all: jtreg/' \
332 -e '/^JTREG /s@\$(JT_PLATFORM)/@@' \
333 -i langtools/test/Makefile</userinput></screen>
334
335 <para>
336 Some variables have to be set:
337 </para>
338
339<screen role='nodump'><userinput>JT_JAVA=$(type -p javac | sed 's@/bin.*@@') &amp;&amp;
340JT_HOME=$(pwd)/jtreg &amp;&amp;
341PRODUCT_HOME=$(echo $(pwd)/build/*/images/j2sdk-image)</userinput></screen>
342
343 <para>
344 The tests are run as follows:
345 </para>
346
347<screen role='nodump'><userinput>LANG=C make -k -C test \
348 JT_HOME=${JT_HOME} \
349 JT_JAVA=${JT_JAVA} \
350 PRODUCT_HOME=${PRODUCT_HOME} all || true
351LANG=C ${JT_HOME}/bin/jtreg -a -v:fail,error \
352 -dir:$(pwd)/hotspot/test \
353 -k:\!ignore \
354 -jdk:${PRODUCT_HOME} \
355 :jdk || true</userinput></screen>
356
357 <para>
358 Tests duration depends on various factors such as the network speed
359 and the number of concurrent VM, which is computed from the number
360 of cores and threads, and the amount of RAM installed. A maximum of
361 120 SBU has been observed, but it may be as <quote>low</quote> as 80 SBU.
362 </para>
363
364 <para>
365 The test results can be compared to <ulink
366 url="http://download.java.net/openjdk/testresults/8/">these
367 results</ulink>, although they usually are run on a newer version. About
368 30 tests are known to fail, but the exact number depends on various
369 conditions, like whether the computer is connected to network, or to a
370 printer, and on the options given to configure
371 (<parameter>--enable-unlimited-crypto</parameter> is known to trigger
372 failures, but those come from the code in the tests, not from the
373 installation). Also, some tests may timeout if the machine is under load.
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>
408 If desired, you may install a .desktop file corresponding to an entry
409 in a desktop menu for <command>policytool</command>. First, you need to
410 obtain an icon from <xref linkend="icedtea-web"/>:
411 </para>
412
413<screen><userinput>tar -xf ../icedtea-web-&icedtea-web-version;.tar.gz \
414 icedtea-web-&icedtea-web-version;/javaws.png \
415 --strip-components=1</userinput></screen>
416
417 <para>
418 Now, as <systemitem class="username">root</systemitem> user:
419 </para>
420
421<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
422
423cat &gt; /usr/share/applications/openjdk-8-policytool.desktop &lt;&lt; "EOF" &amp;&amp;
424<literal>[Desktop Entry]
425Name=OpenJDK Java Policy Tool
426Name[pt_BR]=OpenJDK Java - Ferramenta de Pol&#237;tica
427Comment=OpenJDK Java Policy Tool
428Comment[pt_BR]=OpenJDK Java - Ferramenta de Pol&#237;tica
429Exec=/opt/jdk/bin/policytool
430Terminal=false
431Type=Application
432Icon=javaws
433Categories=Settings;</literal>
434EOF
435
436install -v -Dm0644 javaws.png /usr/share/pixmaps/javaws.png</userinput></screen>
437
438 <para>
439 The choice of pt_BR is just an example. You can add any translation
440 by adding lines corresponding to your locale, e.g. for fr_FR,
441 <quote>Name[fr_FR]=</quote> and <quote>Comment[fr_FR]=</quote> with the
442 appropriate text as values.
443 </para>
444
445 </sect2>
446
447 <sect2 role="commands">
448 <title>Command Explanations</title>
449
450 <para>
451 <command>sh configure...</command>: the top level
452 <filename>configure</filename> is a wrapper around the autotools one.
453 It is not executable and must be run through <command>sh</command>.
454 </para>
455
456 <para>
457 <option>--with-boot-jdk</option>: This switch provides the
458 location of the temporary <application>JDK</application>. It is normally
459 not needed if <command>java</command> is found in the <envar>PATH</envar>.
460 </para>
461
462 <para>
463 <parameter>--with-update-version</parameter>: Currently, the build
464 system does not include the update number in the version string. It has
465 to be specified here.
466 </para>
467
468 <para>
469 <parameter>--with-build-number</parameter>: Again, the build
470 system does not include the build number in the version string. It has
471 to be specified here too.
472 </para>
473
474 <para>
475 <parameter>--with-milestone</parameter>: Used to customize the
476 version string.
477 </para>
478
479 <para>
480 <parameter>--enable-unlimited-crypto</parameter>: Because of limitations
481 on the usage of cryptography in some countries, there is the possibility
482 to limit the size of encryption keys and the use of some algorithms in a
483 policy file. This switch allows to ship a policy file with no
484 restriction. It is the responsibility of the user to ensure proper
485 adherence to the law.
486 </para>
487
488 <para>
489 <parameter>--with-zlib=system, --with-giflib=system</parameter>: Allows
490 to use the system libraries instead of the bundled ones.
491 </para>
492
493 <para>
494 <parameter>--with-extra-cflags=... --with-extra-cxxflags=...</parameter>:
495 Works around some defects in the code brought to light by the GCC 6
496 more rigorous checking of the C/C++ constructs. Remove those switches
497 if compiling with GCC 5.
498 </para>
499
500 <para>
501 <option>--with-jobs=N</option>: Allows setting the number
502 of jobs for <command>make</command> equal to N. The default is the
503 result of a calculation involving the available memory and the number
504 of processors. Note that even if you specify N=1, some parallelization
505 may be used during the build. The SBU given above are with N=4, on
506 a single processor, 4-core, virtual machine, with 4 GB of memory.
507 </para>
508
509 <para>
510 <option>--with-cacerts-file=...</option>: Specifies where to find a
511 <filename>cacerts</filename> file, <filename class="directory">
512 /etc/ssl/java/cacerts</filename> on a BLFS system. Otherwise, an empty
513 one is created. You can use the
514 <command>/usr/sbin/make-ca --force</command> command to generate it, once
515 you have installed the Java binaries.
516 </para>
517
518 <para>
519 <command>make DEBUG_BINARIES=true SCTP_WERROR= all</command>: The build
520 fails on 32 bit machines if DEBUG_BINARIES is not set to true. Unsetting
521 SCTP_WERROR is part of the workarounds needed to use GCC 6. You may omit
522 that part of the command if using GCC 5.
523 </para>
524
525 <para>
526 <command>find ... -iname '*.diz' -delete</command>: This command
527 removes redundant files.
528 </para>
529
530 </sect2>
531
532 <sect2 role="configuration"
533 id="openjdk-config"
534 xreflabel="Configuring OpenJDK">
535 <title>Configuring OpenJDK</title>
536
537 <sect3>
538 <title>Configuration Information</title>
539
540 <para>
541 Normally, the JAVA environment has been configured after installing
542 the binary version, and can be used with the just built package as well.
543 Review <xref linkend="ojdk-conf"/> in case you want to modify
544 something.
545 </para>
546
547 <para>
548 To test if the man pages are correctly installed, issue
549 <command>source /etc/profile</command> and <command>man java</command>
550 to display the respective man page.
551 </para>
552
553 </sect3>
554
555 <sect3 id='ojdk-certs' xreflabel='JRE Certificate Authority Certificates'>
556 <title>Install or update the JRE Certificate Authority Certificates
557 (cacerts) file</title>
558
559 <para>
560 <application>OpenJDK</application> uses its own format for the
561 CA certificates. Those certificates are located in a file named
562 <filename>/etc/ssl/java/cacerts</filename>. That file should be
563 generated using the system PKI trust store. The instructions
564 on the <xref linkend="cacerts"/> page should be used to update the file
565 located in <filename>/etc/ssl/java</filename>. Setup a symlink in the
566 default location as the <systemitem class="username">root</systemitem>
567 user:
568 </para>
569
570<screen role="root"><userinput>ln -sfv /etc/ssl/java/cacerts /opt/jdk/jre/lib/security/cacerts</userinput></screen>
571
572 <para>
573 Use the following commands to check if the <filename>cacerts</filename>
574 file has been successfully installed:
575 </para>
576
577<screen role="root"><userinput>cd /opt/jdk
578bin/keytool -list -keystore /etc/ssl/java/cacerts</userinput></screen>
579
580 <para>
581 At the prompt "Enter keystore password:", enter "changeit" (the
582 default). If the <filename>cacerts</filename> file was installed
583 correctly, you will see a list of the certificates with related
584 information for each one. If not, you need to reinstall them.
585 </para>
586
587 </sect3>
588
589 </sect2>
590
591 <sect2 role="content">
592 <title>Contents</title>
593
594 <segmentedlist>
595 <segtitle>Installed Programs</segtitle>
596 <segtitle>Installed Libraries</segtitle>
597 <segtitle>Installed Directory</segtitle>
598
599 <seglistitem>
600 <seg>appletviewer, extcheck, idlj, jar,
601 jarsigner, java, javac, javadoc, javah, javap, java-rmi.cgi,
602 jcmd, jconsole, jdb, jdeps, jhat, jinfo, jjs, jmap, jps,
603 jrunscript, jsadebugd, jstack, jstat, jstatd, keytool,
604 native2ascii, orbd, pack200, policytool, rmic, rmid, rmiregistry,
605 schemagen, serialver, servertool, tnameserv, unpack200,
606 wsgen, wsimport, and xjc</seg>
607 <seg>/opt/OpenJDK-&openjdk-version;/lib/*, and
608 /opt/OpenJDK-&openjdk-version;/jre/lib/*</seg>
609 <seg>/opt/OpenJDK-&openjdk-version;</seg>
610 </seglistitem>
611 </segmentedlist>
612
613 <variablelist>
614 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
615 <?dbfo list-presentation="list"?>
616 <?dbhtml list-presentation="table"?>
617
618 <varlistentry id="appletviewer">
619 <term><command>appletviewer</command></term>
620 <listitem>
621 <para>allows to run applets outside of a web browser.</para>
622 <indexterm zone="openjdk appletviewer">
623 <primary sortas="b-appletviewer">appletviewer</primary>
624 </indexterm>
625 </listitem>
626 </varlistentry>
627
628 <varlistentry id="extcheck">
629 <term><command>extcheck</command></term>
630 <listitem>
631 <para>checks a specified jar file for title and version conflicts
632 with any extensions installed in the
633 <application>OpenJDK</application> software.</para>
634 <indexterm zone="openjdk extcheck">
635 <primary sortas="b-extcheck">extcheck</primary>
636 </indexterm>
637 </listitem>
638 </varlistentry>
639
640 <varlistentry id="idlj">
641 <term><command>idlj</command></term>
642 <listitem>
643 <para>generates Java bindings from a given IDL file.</para>
644 <indexterm zone="openjdk idlj">
645 <primary sortas="b-idlj">idlj</primary>
646 </indexterm>
647 </listitem>
648 </varlistentry>
649
650 <varlistentry id="jar">
651 <term><command>jar</command></term>
652 <listitem>
653 <para>combines multiple files into a single jar archive.</para>
654 <indexterm zone="openjdk jar">
655 <primary sortas="b-jar">jar</primary>
656 </indexterm>
657 </listitem>
658 </varlistentry>
659
660 <varlistentry id="jarsigner">
661 <term><command>jarsigner</command></term>
662 <listitem>
663 <para>signs jar files and verifies the signatures and integrity
664 of a signed jar file.</para>
665 <indexterm zone="openjdk jarsigner">
666 <primary sortas="b-jarsigner">jarsigner</primary>
667 </indexterm>
668 </listitem>
669 </varlistentry>
670
671 <varlistentry id="java-prog">
672 <term><command>java</command></term>
673 <listitem>
674 <para>launches a Java application by starting a Java runtime
675 environment, loading a specified class and invoking its main
676 method.</para>
677 <indexterm zone="openjdk java-prog">
678 <primary sortas="b-java-prog">java</primary>
679 </indexterm>
680 </listitem>
681 </varlistentry>
682
683 <varlistentry id="javac">
684 <term><command>javac</command></term>
685 <listitem>
686 <para>reads class and interface definitions, written in the
687 Java programming language, and compiles them into bytecode
688 class files.</para>
689 <indexterm zone="openjdk javac">
690 <primary sortas="b-javac">javac</primary>
691 </indexterm>
692 </listitem>
693 </varlistentry>
694
695 <varlistentry id="javadoc">
696 <term><command>javadoc</command></term>
697 <listitem>
698 <para>parses the declarations and documentation comments in a
699 set of Java source files and produces a corresponding set of
700 HTML pages describing the classes, interfaces, constructors,
701 methods, and fields.</para>
702 <indexterm zone="openjdk javadoc">
703 <primary sortas="b-javadoc">javadoc</primary>
704 </indexterm>
705 </listitem>
706 </varlistentry>
707
708 <varlistentry id="javah">
709 <term><command>javah</command></term>
710 <listitem>
711 <para>generates C header and source files
712 that are needed to implement native methods.</para>
713 <indexterm zone="openjdk javah">
714 <primary sortas="b-javah">javah</primary>
715 </indexterm>
716 </listitem>
717 </varlistentry>
718
719 <varlistentry id="javap">
720 <term><command>javap</command></term>
721 <listitem>
722 <para>disassembles a Java class file.</para>
723 <indexterm zone="openjdk javap">
724 <primary sortas="b-javap">javap</primary>
725 </indexterm>
726 </listitem>
727 </varlistentry>
728
729 <varlistentry id="java-rmi.cgi">
730 <term><command>java-rmi.cgi</command></term>
731 <listitem>
732 <para>is the Java RMI client.</para>
733 <indexterm zone="openjdk java-rmi.cgi">
734 <primary sortas="b-java-rmi.cgi">java-rmi.cgi</primary>
735 </indexterm>
736 </listitem>
737 </varlistentry>
738
739 <varlistentry id="jcmd">
740 <term><command>jcmd</command></term>
741 <listitem>
742 <para>is a utility to send diagnostic command requests to a running
743 Java Virtual Machine.</para>
744 <indexterm zone="openjdk jcmd">
745 <primary sortas="b-jcmd">jcmd</primary>
746 </indexterm>
747 </listitem>
748 </varlistentry>
749
750 <varlistentry id="jconsole">
751 <term><command>jconsole</command></term>
752 <listitem>
753 <para>is a graphical console tool to monitor and manage both
754 local and remote Java applications and virtual machines.</para>
755 <indexterm zone="openjdk jconsole">
756 <primary sortas="b-jconsole">jconsole</primary>
757 </indexterm>
758 </listitem>
759 </varlistentry>
760
761 <varlistentry id="jdb">
762 <term><command>jdb</command></term>
763 <listitem>
764 <para>is a simple command-line debugger for Java classes.</para>
765 <indexterm zone="openjdk jdb">
766 <primary sortas="b-jdb">jdb</primary>
767 </indexterm>
768 </listitem>
769 </varlistentry>
770
771 <varlistentry id="jdeps">
772 <term><command>jdeps</command></term>
773 <listitem>
774 <para>shows the package-level or class-level dependencies of
775 Java class files.</para>
776 <indexterm zone="openjdk jdeps">
777 <primary sortas="b-jdeps">jdeps</primary>
778 </indexterm>
779 </listitem>
780 </varlistentry>
781
782 <varlistentry id="jhat">
783 <term><command>jhat</command></term>
784 <listitem>
785 <para>parses a java heap dump file and allows viewing it
786 in a web browser.</para>
787 <indexterm zone="openjdk jhat">
788 <primary sortas="b-jhat">jhat</primary>
789 </indexterm>
790 </listitem>
791 </varlistentry>
792
793 <varlistentry id="jinfo">
794 <term><command>jinfo</command></term>
795 <listitem>
796 <para>prints Java configuration information for a given Java
797 process, core file, or a remote debug server.</para>
798 <indexterm zone="openjdk jinfo">
799 <primary sortas="b-jinfo">jinfo</primary>
800 </indexterm>
801 </listitem>
802 </varlistentry>
803
804 <varlistentry id="jjs">
805 <term><command>jjs</command></term>
806 <listitem>
807 <para>is a command-line tool used to invoke the Nashorn engine. It
808 can be used to interpret one or several script files, or to run
809 an interactive shell.</para>
810 <indexterm zone="openjdk jjs">
811 <primary sortas="b-jjs">jjs</primary>
812 </indexterm>
813 </listitem>
814 </varlistentry>
815
816 <varlistentry id="jmap">
817 <term><command>jmap</command></term>
818 <listitem>
819 <para>prints shared object memory maps or heap memory details
820 of a given process, core file, or a remote debug server.</para>
821 <indexterm zone="openjdk jmap">
822 <primary sortas="b-jmap">jmap</primary>
823 </indexterm>
824 </listitem>
825 </varlistentry>
826
827 <varlistentry id="jps">
828 <term><command>jps</command></term>
829 <listitem>
830 <para>lists the instrumented JVMs on the target system.</para>
831 <indexterm zone="openjdk jps">
832 <primary sortas="b-jps">jps</primary>
833 </indexterm>
834 </listitem>
835 </varlistentry>
836
837 <varlistentry id="jrunscript">
838 <term><command>jrunscript</command></term>
839 <listitem>
840 <para>is a command line script shell.</para>
841 <indexterm zone="openjdk jrunscript">
842 <primary sortas="b-jrunscript">jrunscript</primary>
843 </indexterm>
844 </listitem>
845 </varlistentry>
846
847 <varlistentry id="jsadebugd">
848 <term><command>jsadebugd</command></term>
849 <listitem>
850 <para>attaches to a Java process or core file and acts as a
851 debug server.</para>
852 <indexterm zone="openjdk jsadebugd">
853 <primary sortas="b-jsadebugd">jsadebugd</primary>
854 </indexterm>
855 </listitem>
856 </varlistentry>
857
858 <varlistentry id="jstack">
859 <term><command>jstack</command></term>
860 <listitem>
861 <para>prints Java stack traces of Java threads for a given
862 Java process, core file, or a remote debug server.</para>
863 <indexterm zone="openjdk jstack">
864 <primary sortas="b-jstack">jstack</primary>
865 </indexterm>
866 </listitem>
867 </varlistentry>
868
869 <varlistentry id="jstat">
870 <term><command>jstat</command></term>
871 <listitem>
872 <para>displays performance statistics for an instrumented JVM.</para>
873 <indexterm zone="openjdk jstat">
874 <primary sortas="b-jstat">jstat</primary>
875 </indexterm>
876 </listitem>
877 </varlistentry>
878
879 <varlistentry id="jstatd">
880 <term><command>jstatd</command></term>
881 <listitem>
882 <para>is an RMI server application that monitors for the creation
883 and termination of instrumented JVMs.</para>
884 <indexterm zone="openjdk jstatd">
885 <primary sortas="b-jstatd">jstatd</primary>
886 </indexterm>
887 </listitem>
888 </varlistentry>
889
890 <varlistentry id="keytool">
891 <term><command>keytool</command></term>
892 <listitem>
893 <para>is a key and certificate management utility.</para>
894 <indexterm zone="openjdk keytool">
895 <primary sortas="b-keytool">keytool</primary>
896 </indexterm>
897 </listitem>
898 </varlistentry>
899
900 <varlistentry id="native2ascii">
901 <term><command>native2ascii</command></term>
902 <listitem>
903 <para> converts files that contain non-supported character encoding
904 into files containing Latin-1 or Unicode-encoded characters.</para>
905 <indexterm zone="openjdk native2ascii">
906 <primary sortas="b-native2ascii">native2ascii</primary>
907 </indexterm>
908 </listitem>
909 </varlistentry>
910
911 <varlistentry id="orbd">
912 <term><command>orbd</command></term>
913 <listitem>
914 <para>is used to enable clients to transparently locate and invoke
915 persistent objects on servers in the CORBA environment.</para>
916 <indexterm zone="openjdk orbd">
917 <primary sortas="b-orbd">orbd</primary>
918 </indexterm>
919 </listitem>
920 </varlistentry>
921
922 <varlistentry id="pack200">
923 <term><command>pack200</command></term>
924 <listitem>
925 <para>is a Java application that transforms a jar file into a
926 compressed pack200 file using the Java gzip compressor.</para>
927 <indexterm zone="openjdk pack200">
928 <primary sortas="b-pack200">pack200</primary>
929 </indexterm>
930 </listitem>
931 </varlistentry>
932
933 <varlistentry id="policytool">
934 <term><command>policytool</command></term>
935 <listitem>
936 <para>creates and manages a policy file graphically.</para>
937 <indexterm zone="openjdk policytool">
938 <primary sortas="b-policytool">policytool</primary>
939 </indexterm>
940 </listitem>
941 </varlistentry>
942
943 <varlistentry id="rmic">
944 <term><command>rmic</command></term>
945 <listitem>
946 <para>generates stub and skeleton class files for remote objects
947 from the names of compiled Java classes that contain remote
948 object implementations.</para>
949 <indexterm zone="openjdk rmic">
950 <primary sortas="b-rmic">rmic</primary>
951 </indexterm>
952 </listitem>
953 </varlistentry>
954
955 <varlistentry id="rmid">
956 <term><command>rmid</command></term>
957 <listitem>
958 <para>starts the activation system daemon.</para>
959 <indexterm zone="openjdk rmid">
960 <primary sortas="b-rmid">rmid</primary>
961 </indexterm>
962 </listitem>
963 </varlistentry>
964
965 <varlistentry id="rmiregistry">
966 <term><command>rmiregistry</command></term>
967 <listitem>
968 <para>creates and starts a remote object registry on the specified
969 port on the current host.</para>
970 <indexterm zone="openjdk rmiregistry">
971 <primary sortas="b-rmiregistry">rmiregistry</primary>
972 </indexterm>
973 </listitem>
974 </varlistentry>
975
976 <varlistentry id="schemagen">
977 <term><command>schemagen</command></term>
978 <listitem>
979 <para>is a Java XML binding schema generator.</para>
980 <indexterm zone="openjdk schemagen">
981 <primary sortas="b-schemagen">schemagen</primary>
982 </indexterm>
983 </listitem>
984 </varlistentry>
985
986 <varlistentry id="serialver">
987 <term><command>serialver</command></term>
988 <listitem>
989 <para>returns the serialVersionUID for one or more classes in a
990 form suitable for copying into an evolving class.</para>
991 <indexterm zone="openjdk serialver">
992 <primary sortas="b-serialver">serialver</primary>
993 </indexterm>
994 </listitem>
995 </varlistentry>
996
997 <varlistentry id="servertool">
998 <term><command>servertool</command></term>
999 <listitem>
1000 <para>provides an ease-of-use interface for application programmers
1001 to register, unregister, startup and shutdown a server.</para>
1002 <indexterm zone="openjdk servertool">
1003 <primary sortas="b-servertool">servertool</primary>
1004 </indexterm>
1005 </listitem>
1006 </varlistentry>
1007
1008 <varlistentry id="tnameserv">
1009 <term><command>tnameserv</command></term>
1010 <listitem>
1011 <para>starts the Java IDL name server.</para>
1012 <indexterm zone="openjdk tnameserv">
1013 <primary sortas="b-tnameserv">tnameserv</primary>
1014 </indexterm>
1015 </listitem>
1016 </varlistentry>
1017
1018 <varlistentry id="unpack200">
1019 <term><command>unpack200</command></term>
1020 <listitem>
1021 <para>is a native implementation that transforms a packed file
1022 produced by <application>pack200</application> into a jar
1023 file.</para>
1024 <indexterm zone="openjdk unpack200">
1025 <primary sortas="b-unpack200">unpack200</primary>
1026 </indexterm>
1027 </listitem>
1028 </varlistentry>
1029
1030 <varlistentry id="wsgen">
1031 <term><command>wsgen</command></term>
1032 <listitem>
1033 <para>generates JAX-WS portable artifacts used in JAX-WS
1034 web services.</para>
1035 <indexterm zone="openjdk wsgen">
1036 <primary sortas="b-wsgen">wsgen</primary>
1037 </indexterm>
1038 </listitem>
1039 </varlistentry>
1040
1041 <varlistentry id="wsimport">
1042 <term><command>wsimport</command></term>
1043 <listitem>
1044 <para>generates JAX-WS portable artifacts.</para>
1045 <indexterm zone="openjdk wsimport">
1046 <primary sortas="b-wsimport">wsimport</primary>
1047 </indexterm>
1048 </listitem>
1049 </varlistentry>
1050
1051 <varlistentry id="xjc">
1052 <term><command>xjc</command></term>
1053 <listitem>
1054 <para>is a Java XML binding compiler.</para>
1055 <indexterm zone="openjdk xjc">
1056 <primary sortas="b-xjc">xjc</primary>
1057 </indexterm>
1058 </listitem>
1059 </varlistentry>
1060
1061 </variablelist>
1062
1063 </sect2>
1064
1065</sect1>
Note: See TracBrowser for help on using the repository browser.