source: general/prog/openjdk.xml

trunk
Last change on this file was 619c3b1, checked in by Douglas R. Reno <renodr@…>, 2 months ago

Tag OpenJDK

  • Property mode set to 100644
File size: 31.7 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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-tarball "jdk-&openjdk-version;-ga.tar.gz">
8 <!ENTITY ojdk-repo "https://github.com/openjdk/jdk21u">
9 <!ENTITY ojdk-download "&ojdk-repo;/archive/&ojdk-tarball;">
10
11 <!ENTITY anduin-download "&sources-anduin-http;/OpenJDK/OpenJDK-&openjdk-version;">
12
13 <!ENTITY ojdk-md5sum "6b714196cac31ebf31a0fc1a910ccb87">
14 <!ENTITY ojdk-size "107 MB">
15
16 <!ENTITY jtreg-version "7.3.1+1">
17 <!ENTITY jtreg-download "&anduin-download;/jtreg-&jtreg-version;.tar.gz">
18 <!ENTITY jtreg-md5sum "0038551ecaf37d0cd99832217f79e56d">
19 <!ENTITY jtreg-size "9.0 MB">
20
21 <!ENTITY ojdk-bdsize "3.7 GB (add 557 MB for tests)">
22 <!ENTITY ojdk-time "5.2 SBU with 4 jobs (add 32 SBU for tests with 4 jobs)">
23]>
24
25<sect1 id="openjdk" xreflabel="OpenJDK-&openjdk-version;">
26 <?dbhtml filename="openjdk.html" ?>
27
28
29 <title>OpenJDK-&openjdk-version;</title>
30
31 <indexterm zone="openjdk">
32 <primary sortas="a-OpenJDK">OpenJDK</primary>
33 </indexterm>
34
35 <sect2 role="package">
36 <title>Introduction to OpenJDK</title>
37
38 <para>
39 <application>OpenJDK</application> is an open-source implementation
40 of Oracle's Java Standard Edition platform.
41 <application>OpenJDK</application> is useful for developing
42 <application>Java</application> programs, and provides a complete
43 runtime environment to run <application>Java</application> programs.
44 </para>
45
46 &lfs121_checked;
47
48 <para>
49 OpenJDK is GPL'd code, with a special exception made for non-free
50 projects to use these classes in their proprietary products.
51 In similar fashion to the LGPL, which allows non-free programs to link
52 to libraries provided by free software, the
53 <ulink url="https://openjdk.org/legal/gplv2+ce.html">GNU
54 General Public License, version 2, with the Classpath Exception</ulink>
55 allows third party programs to use classes provided by free software
56 without the requirement that the third party software also be free. As
57 with the LGPL, any modifications made to the free software portions of a
58 third party application, must also be made freely available.
59 </para>
60
61 <note>
62 <para>
63 The <application>OpenJDK</application> source includes a very
64 thorough, open source test suite using the
65 <application>JTreg</application> test harness. The testing instructions
66 below allow testing the just built JDK for reasonable compatibility
67 with the proprietary Oracle JDK. However, in order for an independent
68 implementation to claim compatibility, it must pass a proprietary
69 <application>JCK/TCK</application> test suite. No claims of
70 compatibility, or even partial compatibility, may be made without passing
71 an approved test suite.
72 </para>
73
74 <para>
75 Oracle does provide free community access, on a case-by-case basis, to
76 a closed toolkit to ensure 100% compatibility with its proprietary JDK.
77 Neither the binary version provided on the <xref linkend="java"/> page
78 nor the JVM built with the instructions below have been tested against
79 the <ulink
80 url="https://openjdk.java.net/groups/conformance/JckAccess/jck-access.html">
81 TCK</ulink>. Any version that is built using the instructions given,
82 cannot claim to be compatible with the proprietary JDK, without the
83 user applying for, and completing the compatibility tests themselves.
84 </para>
85
86 <para>
87 With that in mind, the binaries produced using this build method are
88 regularly tested against the TCK by the members listed on the site
89 above. In addition to the community license above, an educational,
90 non-commercial license for the TCK can be obtained <ulink
91 url="https://www.oracle.com/java/scholarship-program.html">
92 here</ulink>.
93 </para>
94 </note>
95
96 <bridgehead renderas="sect3">Package Information</bridgehead>
97 <itemizedlist spacing="compact">
98 <listitem>
99 <para>
100 Download (HTTP): <ulink url="&ojdk-download;"/>
101 </para>
102 </listitem>
103 <listitem>
104 <para>
105 Download (FTP): <ulink url=" "/>
106 </para>
107 </listitem>
108 <listitem>
109 <para>
110 Download MD5 sum: &ojdk-md5sum;
111 </para>
112 </listitem>
113 <listitem>
114 <para>
115 Download Size: &ojdk-size;
116 </para>
117 </listitem>
118 <listitem>
119 <para>
120 Estimated disk space required: &ojdk-bdsize;
121 </para>
122 </listitem>
123 <listitem>
124 <para>
125 Estimated build time: &ojdk-time;
126 </para>
127 </listitem>
128 </itemizedlist>
129
130 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
131
132 <para>
133 <emphasis role="strong">Optional test harness</emphasis>
134 </para>
135
136 <itemizedlist spacing='compact'>
137 <listitem>
138 <para>
139 <ulink url="&jtreg-download;"/>
140 </para>
141 </listitem>
142 <listitem>
143 <para>
144 Download MD5 sum: &jtreg-md5sum;
145 </para>
146 </listitem>
147 <listitem>
148 <para>
149 Download Size: &jtreg-size;
150 </para>
151 </listitem>
152 </itemizedlist>
153<!--
154 <bridgehead renderas="sect4">Required patch</bridgehead>
155
156 <itemizedlist spacing='compact'>
157 <listitem>
158 <para>
159 <ulink url="&patch-root;/openjdk-&openjdk-version;-make_4.3_fix-1.patch"/>
160 </para>
161 </listitem>
162 </itemizedlist>
163-->
164 <bridgehead renderas="sect3">OpenJDK Dependencies</bridgehead>
165
166 <bridgehead renderas="sect4">Required Dependencies</bridgehead>
167 <para role="required">
168 An existing binary (<xref linkend="java"/> or an earlier built
169 version of this package. The instructions below assume that
170 you are using <xref linkend="ojdk-conf"/>),
171 <xref linkend="alsa-lib"/>,
172 <xref linkend="cpio"/>,
173 <xref linkend="cups"/>,
174 <xref linkend="unzip"/>,
175 <xref linkend="which"/>,
176 <xref linkend="xorg7-lib"/>, and
177 <xref linkend="zip"/>
178 </para>
179
180 <bridgehead renderas="sect4">Recommended</bridgehead>
181 <para role="recommended">
182 <xref linkend="make-ca"/>,
183 <xref linkend="giflib"/>,
184 <xref linkend="harfbuzz"/>,
185 <xref linkend="lcms2"/>,
186 <xref linkend="libjpeg"/>,
187 <xref linkend="libpng"/>, and
188 <xref linkend="wget"/>
189 </para>
190
191 <bridgehead renderas="sect4">Optional</bridgehead>
192 <para role="optional">
193 <xref linkend="git"/>,
194 <xref linkend="graphviz"/>,
195 <xref linkend="mercurial"/>,
196<!-- not needed now, it seems
197 an X Window manager such as <xref linkend="twm"/> (for the tests), and
198-->
199 <ulink url="https://ccache.dev/">ccache</ulink>,
200 <ulink url="https://pandoc.org/">pandoc</ulink>, and
201 <ulink url="https://zlib.net/pigz">pigz</ulink>
202 </para>
203
204
205 </sect2>
206
207 <sect2 role="installation">
208 <title>Installation of OpenJDK</title>
209
210 <para>
211 If you have downloaded the optional test harness, unpack it now:
212 </para>
213
214<screen><userinput>tar -xf ../jtreg-&jtreg-version;.tar.gz</userinput></screen>
215<!--
216 <para>
217 Apply a patch to allow building with make-4.3:
218 </para>
219
220<screen><userinput>patch -p1 -i ../openjdk-&openjdk-version;-make_4.3_fix-1.patch</userinput></screen>
221
222 <para>
223 Fix an issue coming from a removed header in glibc-2.32:
224 </para>
225
226<screen><userinput>sed -i /sysctl/d \
227 src/jdk.incubator.jpackage/unix/native/libapplauncher/PosixPlatform.cpp</userinput></screen>
228-->
229 <note>
230 <para>
231 Before proceeding, you should ensure that your environment
232 <envar>PATH</envar> variable contains the location of the Java
233 compiler used for bootstrapping <application>OpenJDK</application>.
234 This is the only requirement for the environment. Modern Java
235 installations do not need <envar>JAVA_HOME</envar> and
236 <envar>CLASSPATH</envar> is not used here. Furthermore, OpenJDK
237 developers recommend unsetting <envar>JAVA_HOME</envar>.
238 </para>
239
240 <para>
241 The build system does not allow the <option>-j</option> switch in
242 <envar>MAKEFLAGS</envar>. See the command explanation for
243 <option>--with-jobs=</option>
244 for more information on customizing parallelization.
245 </para>
246 </note>
247
248 <para>
249 Configure and build the package with the following commands:
250 </para>
251
252<screen><userinput>unset JAVA_HOME &amp;&amp;
253bash configure --enable-unlimited-crypto \
254 --disable-warnings-as-errors \
255 --with-stdc++lib=dynamic \
256 --with-giflib=system \
257 --with-harfbuzz=system \
258 --with-jtreg=$PWD/jtreg \
259 --with-lcms=system \
260 --with-libjpeg=system \
261 --with-libpng=system \
262 --with-zlib=system \
263 --with-version-build="&openjdk-build;" \
264 --with-version-pre="" \
265 --with-version-opt="" \
266 --with-cacerts-file=/etc/pki/tls/java/cacerts &amp;&amp;
267make images</userinput></screen>
268
269 <para>
270 To test the results, you will need to execute the jtreg program.
271 You can set the number of concurrent tests by adding the
272 <parameter>-conc:<replaceable>&lt;X&gt;</replaceable></parameter>
273 value in the below command (tests will run sequentially otherwise):
274 </para>
275
276<screen remap="test"><userinput>export JT_JAVA=$(echo $PWD/build/*/jdk) &amp;&amp;
277jtreg/bin/jtreg -jdk:$JT_JAVA -automatic -ignore:quiet -v1 \
278 test/jdk:tier1 test/langtools:tier1 &amp;&amp;
279unset JT_JAVA</userinput></screen>
280
281 <para>
282 For more control over the test suite, review the documentation
283 available in <filename>jtreg/doc/jtreg/usage.txt</filename>. To review
284 the results, see the files
285 <filename>JTreport/test_{jdk,langtools}/text/stats.txt</filename> and
286 <filename>JTreport/test_{jdk,langtools}/text/summary.txt</filename>.
287 You should expect to see around 60 failures and 10 errors.
288 </para>
289 <!--
290 14.0.1+7:
291 for x86_64: passed: 5,836; failed: 42; error: 50
292 17.0.2+8:
293 for x86_64: passed: 6,238; failed: 48; error: 13
294 for i686: passed: 6,208; failed: 29; error: 6
295 18.0.1+10:
296 for x86_64: passed: 6,323; failed: 53; error: 14
297 for i686: passed: 6,290; failed: 29; error: 11
298 18.0.1.1+2:
299 for x86_64: passed: 6,323; failed: 53; error: 14
300 for i686: passed: 6,290; failed: 29; error: 11
301 18.0.2+8:
302 for x86_64: passed: 6,329; failed: 50; error: 14
303 for i686: passed: 6,289; failed: 31; error: 13
304 19.0.1+10:
305 for x86_64: passed: 6,423; failed: 58; error: 15
306 for i686: passed: 6,376; failed: 31; error: 12
307 19.0.2+7:
308 for x86_64: passed: 6,426; failed: 61; error: 14
309 for i686: passed: 6,377; failed: 34; error: 11
310 20.0.1+9:
311 for x86_64: passed: 6,515; failed: 65; error: 13
312 for i686: passed: 6,520; failed: 60; error: 13
313 20.0.2+9:
314 for x86_64: passed: 6,515; failed: 65; error: 14
315 for i686: passed: 6,446; failed: 33; error: 12
316 21+35:
317 for x86_64: passed: 6,699; failed: 72; error: 13
318 for i686: passed: 6,627; failed: 30; error: 10
319 21.0.1+12:
320 for x86_64: passed: 6,706; failed: 72; error: 14
321 for i686: passed: 6,636; failed: 29; error: 11
322 21.0.2+13:
323 for x86_64: passed: 6,698; failed: 71; error: 13
324 for i686: passed: 6,606; failed: 30; error: 34
325 -->
326
327 <para>
328 Install the package with the following commands as the
329 <systemitem class="username">root</systemitem> user:
330 </para>
331
332<screen role="root"><userinput>install -vdm755 /opt/jdk-&openjdk-version;+&openjdk-build; &amp;&amp;
333cp -Rv build/*/images/jdk/* /opt/jdk-&openjdk-version;+&openjdk-build; &amp;&amp;
334chown -R root:root /opt/jdk-&openjdk-version;+&openjdk-build; &amp;&amp;
335for s in 16 24 32 48; do
336 install -vDm644 src/java.desktop/unix/classes/sun/awt/X11/java-icon${s}.png \
337 /usr/share/icons/hicolor/${s}x${s}/apps/java.png
338done</userinput></screen>
339
340 <note>
341 <para>
342 If you only wish to install the Java Runtime Environment, you can
343 substitute <filename>build/*/images/jre</filename> in the above
344 <command>cp</command> command.
345 </para>
346 </note>
347
348 <para>
349 There are now two <application>OpenJDK</application> SDKs installed
350 in <filename class="directory">/opt</filename>. You should decide on
351 which one you would like to use as the default. Normally, you would opt
352 for the just installed <application>OpenJDK</application>. If so, do
353 the following as the <systemitem class="username">root</systemitem>
354 user:
355 </para>
356
357<screen role="root"><userinput>ln -v -nsf jdk-&openjdk-version;+&openjdk-build; /opt/jdk</userinput></screen>
358
359 <para>
360 If desired, you can create .desktop files to add entries
361 in the menu for <command>java</command>
362 and <command>jconsole</command>. The needed icons have already been
363 installed. As the <systemitem class="username">root</systemitem> user:
364 </para>
365
366<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
367
368cat &gt; /usr/share/applications/openjdk-java.desktop &lt;&lt; "EOF" &amp;&amp;
369<literal>[Desktop Entry]
370Name=OpenJDK Java &openjdk-version; Runtime
371Comment=OpenJDK Java &openjdk-version; Runtime
372Exec=/opt/jdk/bin/java -jar
373Terminal=false
374Type=Application
375Icon=java
376MimeType=application/x-java-archive;application/java-archive;application/x-jar;
377NoDisplay=true</literal>
378EOF
379cat &gt; /usr/share/applications/openjdk-jconsole.desktop &lt;&lt; "EOF"
380<literal>[Desktop Entry]
381Name=OpenJDK Java &openjdk-version; Console
382Comment=OpenJDK Java &openjdk-version; Console
383Keywords=java;console;monitoring
384Exec=/opt/jdk/bin/jconsole
385Terminal=false
386Type=Application
387Icon=java
388Categories=Application;System;</literal>
389EOF</userinput></screen>
390
391 </sect2>
392
393 <sect2 role="commands">
394 <title>Command Explanations</title>
395
396 <para>
397 <command>bash configure...</command>: the top level
398 <filename>configure</filename> is a wrapper around the autotools one.
399 It is not executable and must be run through <command>bash</command>.
400 </para>
401<!-- Not needed in openjdk-15
402 <para>
403 <parameter>- -with-extra-cflags=-fcommon</parameter>: Allows building
404 with GCC 10.
405 </para>
406-->
407 <para>
408 <parameter>--enable-unlimited-crypto</parameter>: Because of limitations
409 on the usage of cryptography in some countries, there is the possibility
410 to limit the size of encryption keys and the use of some algorithms in a
411 policy file. This switch allows to ship a policy file with no
412 restriction. It is the responsibility of the user to ensure proper
413 adherence to the law.
414 </para>
415
416 <para>
417 <parameter>--disable-warnings-as-errors</parameter>: This switch disables
418 use of <envar>-Werror</envar> in the build.
419 </para>
420
421 <para>
422 <parameter>--with-stdc++lib=dynamic</parameter>: This switch forces the
423 build system to link to <filename>libstdc++.so</filename> (dynamic)
424 instead of <filename>libstdc++.a</filename> (static).
425 </para>
426
427 <para>
428 <option>--with-jobs=<replaceable>&lt;X&gt;</replaceable></option>:
429 The <parameter>-j</parameter> passed to make does not work with make as
430 invoked here. By default, the build system will use the number of
431 CPUs - 1.
432 </para>
433
434 <para>
435 <parameter>--with-jtreg=$PWD/jtreg</parameter>: This switch tells
436 configure where to find jtreg. Omit if you have not downloaded the
437 optional test suite.
438 </para>
439
440 <para>
441 <parameter>--with-{giflib,harfbuzz,lcms,libjpeg,libpng,zlib}=system</parameter>:
442 These switches force the build system to use the system libraries instead
443 of the bundled versions.
444 </para>
445
446 <para>
447 <parameter>--with-version-build</parameter>: Currently, the build
448 system does not include the build number in the version string. It has
449 to be specified here.
450 </para>
451
452 <para>
453 <parameter>--with-version-pre</parameter>: This switch allows you to
454 prefix the version string with a custom string.
455 </para>
456
457 <para>
458 <parameter>--with-version-opt</parameter>: This switch allows you to add
459 an optional build description to the version string.
460 </para>
461
462 <para>
463 <parameter>--with-cacerts-file=/etc/pki/tls/java/cacerts</parameter>:
464 Specifies where to find a <filename>cacerts</filename> file,
465 <filename>/etc/pki/tls/java/</filename> on a BLFS system. Otherwise, an
466 empty one is created. You can use the
467 <command>/usr/sbin/make-ca --force</command> command to generate it, once
468 you have installed the Java binaries.
469 </para>
470
471 <para>
472 <option>--with-boot-jdk</option>: This switch provides the
473 location of the temporary <application>JDK</application>. It is normally
474 not needed if <command>java</command> is found in the <envar>PATH</envar>.
475 </para>
476<!-- Seems to have disappeared
477 <para>
478 <command>find ... -iname '*.diz' -delete</command>: This command
479 removes redundant files.
480 </para>
481-->
482 </sect2>
483
484 <sect2 role="configuration"
485 id="openjdk-config"
486 xreflabel="Configuring OpenJDK">
487 <title>Configuring OpenJDK</title>
488
489 <sect3>
490 <title>Configuration Information</title>
491
492 <para>
493 Normally, the Java environment has been configured after installing
494 the binary version, and can be used with the just built package as well.
495 Review <xref linkend="ojdk-conf"/> in case you want to modify
496 something.
497 </para>
498
499 <para>
500 To test if the man pages are correctly installed, issue
501 <command>source /etc/profile</command> and <command>man java</command>
502 to display the respective man page.
503 </para>
504
505 </sect3>
506
507 <sect3>
508 <title>
509 Setting up the JRE Certificate Authority Certificates (cacerts) file
510 </title>
511
512 <para>
513 If you have run the instructions on the <xref linkend="make-ca"/> page,
514 you only need to create a symlink in the default location for the
515 <filename>cacerts</filename> file. As user <systemitem
516 class="username">root</systemitem>:
517 </para>
518
519<screen role="root"><userinput>ln -sfv /etc/pki/tls/java/cacerts /opt/jdk/lib/security/cacerts</userinput></screen>
520
521 <para>
522 To check the installation, issue:
523 </para>
524
525<screen role="root"><userinput>cd /opt/jdk
526bin/keytool -list -cacerts</userinput></screen>
527
528 <para>
529 At the prompt <computeroutput>Enter keystore password:</computeroutput>,
530 enter <userinput>changeit</userinput> (the default) or just press the
531 <quote>Enter</quote> key. If the <filename>cacerts</filename> file was
532 installed correctly, you will see a list of the certificates with
533 related information for each one. If not, you need to reinstall them.
534 </para>
535
536 </sect3>
537
538 </sect2>
539
540 <sect2 role="content">
541 <title>Contents</title>
542
543 <segmentedlist>
544 <segtitle>Installed Programs</segtitle>
545 <segtitle>Installed Libraries</segtitle>
546 <segtitle>Installed Directory</segtitle>
547
548 <seglistitem>
549 <seg>jar, jarsigner, java, javac, javadoc, javap, jcmd,
550 jconsole, jdb, jdeprscan, jdeps, jfr, jhsdb, jimage, jinfo,
551 jlink, jmap, jmod, jpackage, jps, jrunscript, jshell, jstack,
552 jstat, jstatd, jwebserver, keytool, rmiregistry, and serialver</seg>
553 <seg>37 libraries in /opt/jdk-&openjdk-version;+&openjdk-build;/lib/</seg>
554 <seg>/opt/jdk-&openjdk-version;+&openjdk-build;</seg>
555 </seglistitem>
556 </segmentedlist>
557
558 <variablelist>
559 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
560 <?dbfo list-presentation="list"?>
561 <?dbhtml list-presentation="table"?>
562
563 <varlistentry id="jar">
564 <term><command>jar</command></term>
565 <listitem>
566 <para>
567 combines multiple files into a single jar archive
568 </para>
569 <indexterm zone="openjdk jar">
570 <primary sortas="b-jar">jar</primary>
571 </indexterm>
572 </listitem>
573 </varlistentry>
574
575 <varlistentry id="jarsigner">
576 <term><command>jarsigner</command></term>
577 <listitem>
578 <para>
579 signs jar files and verifies the signatures and integrity
580 of a signed jar file
581 </para>
582 <indexterm zone="openjdk jarsigner">
583 <primary sortas="b-jarsigner">jarsigner</primary>
584 </indexterm>
585 </listitem>
586 </varlistentry>
587
588 <varlistentry id="java-prog">
589 <term><command>java</command></term>
590 <listitem>
591 <para>
592 launches a Java application by starting a Java runtime
593 environment, loading a specified class and invoking its main
594 method
595 </para>
596 <indexterm zone="openjdk java-prog">
597 <primary sortas="b-java-prog">java</primary>
598 </indexterm>
599 </listitem>
600 </varlistentry>
601
602 <varlistentry id="javac">
603 <term><command>javac</command></term>
604 <listitem>
605 <para>
606 reads class and interface definitions, written in the
607 Java programming language, and compiles them into bytecode
608 class files
609 </para>
610 <indexterm zone="openjdk javac">
611 <primary sortas="b-javac">javac</primary>
612 </indexterm>
613 </listitem>
614 </varlistentry>
615
616 <varlistentry id="javadoc">
617 <term><command>javadoc</command></term>
618 <listitem>
619 <para>
620 parses the declarations and documentation comments in a
621 set of Java source files and produces a corresponding set of
622 HTML pages describing the classes, interfaces, constructors,
623 methods, and fields
624 </para>
625 <indexterm zone="openjdk javadoc">
626 <primary sortas="b-javadoc">javadoc</primary>
627 </indexterm>
628 </listitem>
629 </varlistentry>
630
631 <varlistentry id="javap">
632 <term><command>javap</command></term>
633 <listitem>
634 <para>
635 disassembles a Java class file
636 </para>
637 <indexterm zone="openjdk javap">
638 <primary sortas="b-javap">javap</primary>
639 </indexterm>
640 </listitem>
641 </varlistentry>
642
643 <varlistentry id="jcmd">
644 <term><command>jcmd</command></term>
645 <listitem>
646 <para>
647 is a utility to send diagnostic command requests to a running
648 Java Virtual Machine
649 </para>
650 <indexterm zone="openjdk jcmd">
651 <primary sortas="b-jcmd">jcmd</primary>
652 </indexterm>
653 </listitem>
654 </varlistentry>
655
656 <varlistentry id="jconsole">
657 <term><command>jconsole</command></term>
658 <listitem>
659 <para>
660 is a graphical console tool to monitor and manage both
661 local and remote Java applications and virtual machines
662 </para>
663 <indexterm zone="openjdk jconsole">
664 <primary sortas="b-jconsole">jconsole</primary>
665 </indexterm>
666 </listitem>
667 </varlistentry>
668
669 <varlistentry id="jdb">
670 <term><command>jdb</command></term>
671 <listitem>
672 <para>
673 is a simple command-line debugger for Java classes
674 </para>
675 <indexterm zone="openjdk jdb">
676 <primary sortas="b-jdb">jdb</primary>
677 </indexterm>
678 </listitem>
679 </varlistentry>
680
681 <varlistentry id="jdeprscan">
682 <term><command>jdeprscan</command></term>
683 <listitem>
684 <para>
685 scans class or jar files for uses of deprecated API elements
686 </para>
687 <indexterm zone="openjdk jdeprscan">
688 <primary sortas="b-jdeprscan">jdeprscan</primary>
689 </indexterm>
690 </listitem>
691 </varlistentry>
692
693 <varlistentry id="jdeps">
694 <term><command>jdeps</command></term>
695 <listitem>
696 <para>
697 shows the package-level or class-level dependencies of
698 Java class files
699 </para>
700 <indexterm zone="openjdk jdeps">
701 <primary sortas="b-jdeps">jdeps</primary>
702 </indexterm>
703 </listitem>
704 </varlistentry>
705
706 <varlistentry id="jfr">
707 <term><command>jfr</command></term>
708 <listitem>
709 <para>
710 is a tool for working with <quote>Flight Recorder</quote> files
711 </para>
712 <indexterm zone="openjdk jfr">
713 <primary sortas="b-jfr">jfr</primary>
714 </indexterm>
715 </listitem>
716 </varlistentry>
717
718 <varlistentry id="jhsdb">
719 <term><command>jhsdb</command></term>
720 <listitem>
721 <para>
722 is a tool to analyze the content of a core dump from a
723 crashed Java Virtual Machine (JVM)
724 </para>
725 <indexterm zone="openjdk jhsdb">
726 <primary sortas="b-jhsdb">jhsdb</primary>
727 </indexterm>
728 </listitem>
729 </varlistentry>
730
731 <varlistentry id="jimage">
732 <term><command>jimage</command></term>
733 <listitem>
734 <para>
735 is used to list, extract, verify, or get information about
736 modules in <emphasis>jimage</emphasis> format
737 </para>
738 <indexterm zone="openjdk jimage">
739 <primary sortas="b-jimage">jimage</primary>
740 </indexterm>
741 </listitem>
742 </varlistentry>
743
744 <varlistentry id="jinfo">
745 <term><command>jinfo</command></term>
746 <listitem>
747 <para>
748 prints Java configuration information for a given Java
749 process, core file, or a remote debug server
750 </para>
751 <indexterm zone="openjdk jinfo">
752 <primary sortas="b-jinfo">jinfo</primary>
753 </indexterm>
754 </listitem>
755 </varlistentry>
756
757 <varlistentry id="jlink">
758 <term><command>jlink</command></term>
759 <listitem>
760 <para>
761 is used to assemble and optimize a set of modules and their
762 dependencies into a custom runtime image
763 </para>
764 <indexterm zone="openjdk jlink">
765 <primary sortas="b-jlink">jlink</primary>
766 </indexterm>
767 </listitem>
768 </varlistentry>
769
770 <varlistentry id="jmap">
771 <term><command>jmap</command></term>
772 <listitem>
773 <para>
774 prints shared object memory maps or heap memory details
775 of a given process, core file, or a remote debug server
776 </para>
777 <indexterm zone="openjdk jmap">
778 <primary sortas="b-jmap">jmap</primary>
779 </indexterm>
780 </listitem>
781 </varlistentry>
782
783 <varlistentry id="jmod">
784 <term><command>jmod</command></term>
785 <listitem>
786 <para>
787 creates JMOD files and lists the content of existing JMOD files
788 </para>
789 <indexterm zone="openjdk jmod">
790 <primary sortas="b-jmod">jmod</primary>
791 </indexterm>
792 </listitem>
793 </varlistentry>
794
795 <varlistentry id="jpackage">
796 <term><command>jpackage</command></term>
797 <listitem>
798 <para>
799 generates java application packages and images
800 </para>
801 <indexterm zone="openjdk jpackage">
802 <primary sortas="b-jpackage">jpackage</primary>
803 </indexterm>
804 </listitem>
805 </varlistentry>
806
807 <varlistentry id="jps">
808 <term><command>jps</command></term>
809 <listitem>
810 <para>
811 lists the instrumented JVMs on the target system
812 </para>
813 <indexterm zone="openjdk jps">
814 <primary sortas="b-jps">jps</primary>
815 </indexterm>
816 </listitem>
817 </varlistentry>
818
819 <varlistentry id="jrunscript">
820 <term><command>jrunscript</command></term>
821 <listitem>
822 <para>
823 is a command line script shell
824 </para>
825 <indexterm zone="openjdk jrunscript">
826 <primary sortas="b-jrunscript">jrunscript</primary>
827 </indexterm>
828 </listitem>
829 </varlistentry>
830
831 <varlistentry id="jshell">
832 <term><command>jshell</command></term>
833 <listitem>
834 <para>
835 is an interactive tool for learning the Java programming
836 language and prototyping Java code
837 </para>
838 <indexterm zone="openjdk jshell">
839 <primary sortas="b-jshell">jshell</primary>
840 </indexterm>
841 </listitem>
842 </varlistentry>
843
844 <varlistentry id="jstack">
845 <term><command>jstack</command></term>
846 <listitem>
847 <para>
848 prints Java stack traces of Java threads for a given
849 Java process, core file, or a remote debug server
850 </para>
851 <indexterm zone="openjdk jstack">
852 <primary sortas="b-jstack">jstack</primary>
853 </indexterm>
854 </listitem>
855 </varlistentry>
856
857 <varlistentry id="jstat">
858 <term><command>jstat</command></term>
859 <listitem>
860 <para>
861 displays performance statistics for an instrumented JVM
862 </para>
863 <indexterm zone="openjdk jstat">
864 <primary sortas="b-jstat">jstat</primary>
865 </indexterm>
866 </listitem>
867 </varlistentry>
868
869 <varlistentry id="jstatd">
870 <term><command>jstatd</command></term>
871 <listitem>
872 <para>
873 is an RMI server application that monitors for the creation
874 and termination of instrumented JVMs
875 </para>
876 <indexterm zone="openjdk jstatd">
877 <primary sortas="b-jstatd">jstatd</primary>
878 </indexterm>
879 </listitem>
880 </varlistentry>
881
882 <varlistentry id="jwebserver">
883 <term><command>jwebserver</command></term>
884 <listitem>
885 <para>
886 provides a minimal HTTP server, designed to be used for
887 prototyping, testing, and debugging
888 </para>
889 <indexterm zone="openjdk jwebserver">
890 <primary sortas="b-jwebserver">jwebserver</primary>
891 </indexterm>
892 </listitem>
893 </varlistentry>
894
895 <varlistentry id="keytool">
896 <term><command>keytool</command></term>
897 <listitem>
898 <para>
899 is a key and certificate management utility
900 </para>
901 <indexterm zone="openjdk keytool">
902 <primary sortas="b-keytool">keytool</primary>
903 </indexterm>
904 </listitem>
905 </varlistentry>
906
907 <varlistentry id="rmiregistry">
908 <term><command>rmiregistry</command></term>
909 <listitem>
910 <para>
911 creates and starts a remote object registry on the specified
912 port on the current host
913 </para>
914 <indexterm zone="openjdk rmiregistry">
915 <primary sortas="b-rmiregistry">rmiregistry</primary>
916 </indexterm>
917 </listitem>
918 </varlistentry>
919
920 <varlistentry id="serialver">
921 <term><command>serialver</command></term>
922 <listitem>
923 <para>
924 returns the serialVersionUID for one or more classes in a
925 form suitable for copying into an evolving class
926 </para>
927 <indexterm zone="openjdk serialver">
928 <primary sortas="b-serialver">serialver</primary>
929 </indexterm>
930 </listitem>
931 </varlistentry>
932 </variablelist>
933
934 </sect2>
935
936</sect1>
Note: See TracBrowser for help on using the repository browser.