source: general/prog/openjdk.xml@ aeb0a9c

trunk
Last change on this file since aeb0a9c was d85bdea, checked in by Douglas R. Reno <renodr@…>, 3 weeks ago

Tags

  • Property mode set to 100644
File size: 31.9 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/jdk22u">
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 "13b4e71252055e6d78ae12b8db5021d4">
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 625 MB for tests)">
22 <!ENTITY ojdk-time "5.2 SBU with 4 jobs (add 34 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 &lfs122_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 22.0.1+8:
326 for x86_64: passed: 6,776; failed: 77; error: 14
327 for i686: passed: 6,703; failed: 76; error: 21
328 22.0.2+9:
329 for x86_64: passed: 6,772; failed: 82; error: 15
330 for i686: passed: 6,704; failed: 79; error: 17
331 -->
332
333 <para>
334 Install the package with the following commands as the
335 <systemitem class="username">root</systemitem> user:
336 </para>
337
338<screen role="root"><userinput>install -vdm755 /opt/jdk-&openjdk-version;+&openjdk-build; &amp;&amp;
339cp -Rv build/*/images/jdk/* /opt/jdk-&openjdk-version;+&openjdk-build; &amp;&amp;
340chown -R root:root /opt/jdk-&openjdk-version;+&openjdk-build; &amp;&amp;
341for s in 16 24 32 48; do
342 install -vDm644 src/java.desktop/unix/classes/sun/awt/X11/java-icon${s}.png \
343 /usr/share/icons/hicolor/${s}x${s}/apps/java.png
344done</userinput></screen>
345
346 <note>
347 <para>
348 If you only wish to install the Java Runtime Environment, you can
349 substitute <filename>build/*/images/jre</filename> in the above
350 <command>cp</command> command.
351 </para>
352 </note>
353
354 <para>
355 There are now two <application>OpenJDK</application> SDKs installed
356 in <filename class="directory">/opt</filename>. You should decide on
357 which one you would like to use as the default. Normally, you would opt
358 for the just installed <application>OpenJDK</application>. If so, do
359 the following as the <systemitem class="username">root</systemitem>
360 user:
361 </para>
362
363<screen role="root"><userinput>ln -v -nsf jdk-&openjdk-version;+&openjdk-build; /opt/jdk</userinput></screen>
364
365 <para>
366 If desired, you can create .desktop files to add entries
367 in the menu for <command>java</command>
368 and <command>jconsole</command>. The needed icons have already been
369 installed. As the <systemitem class="username">root</systemitem> user:
370 </para>
371
372<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
373
374cat &gt; /usr/share/applications/openjdk-java.desktop &lt;&lt; "EOF" &amp;&amp;
375<literal>[Desktop Entry]
376Name=OpenJDK Java &openjdk-version; Runtime
377Comment=OpenJDK Java &openjdk-version; Runtime
378Exec=/opt/jdk/bin/java -jar
379Terminal=false
380Type=Application
381Icon=java
382MimeType=application/x-java-archive;application/java-archive;application/x-jar;
383NoDisplay=true</literal>
384EOF
385cat &gt; /usr/share/applications/openjdk-jconsole.desktop &lt;&lt; "EOF"
386<literal>[Desktop Entry]
387Name=OpenJDK Java &openjdk-version; Console
388Comment=OpenJDK Java &openjdk-version; Console
389Keywords=java;console;monitoring
390Exec=/opt/jdk/bin/jconsole
391Terminal=false
392Type=Application
393Icon=java
394Categories=Application;System;</literal>
395EOF</userinput></screen>
396
397 </sect2>
398
399 <sect2 role="commands">
400 <title>Command Explanations</title>
401
402 <para>
403 <command>bash configure...</command>: the top level
404 <filename>configure</filename> is a wrapper around the autotools one.
405 It is not executable and must be run through <command>bash</command>.
406 </para>
407<!-- Not needed in openjdk-15
408 <para>
409 <parameter>- -with-extra-cflags=-fcommon</parameter>: Allows building
410 with GCC 10.
411 </para>
412-->
413 <para>
414 <parameter>--enable-unlimited-crypto</parameter>: Because of limitations
415 on the usage of cryptography in some countries, there is the possibility
416 to limit the size of encryption keys and the use of some algorithms in a
417 policy file. This switch allows to ship a policy file with no
418 restriction. It is the responsibility of the user to ensure proper
419 adherence to the law.
420 </para>
421
422 <para>
423 <parameter>--disable-warnings-as-errors</parameter>: This switch disables
424 use of <envar>-Werror</envar> in the build.
425 </para>
426
427 <para>
428 <parameter>--with-stdc++lib=dynamic</parameter>: This switch forces the
429 build system to link to <filename>libstdc++.so</filename> (dynamic)
430 instead of <filename>libstdc++.a</filename> (static).
431 </para>
432
433 <para>
434 <option>--with-jobs=<replaceable>&lt;X&gt;</replaceable></option>:
435 The <parameter>-j</parameter> passed to make does not work with make as
436 invoked here. By default, the build system will use the number of
437 CPUs - 1.
438 </para>
439
440 <para>
441 <parameter>--with-jtreg=$PWD/jtreg</parameter>: This switch tells
442 configure where to find jtreg. Omit if you have not downloaded the
443 optional test suite.
444 </para>
445
446 <para>
447 <parameter>--with-{giflib,harfbuzz,lcms,libjpeg,libpng,zlib}=system</parameter>:
448 These switches force the build system to use the system libraries instead
449 of the bundled versions.
450 </para>
451
452 <para>
453 <parameter>--with-version-build</parameter>: Currently, the build
454 system does not include the build number in the version string. It has
455 to be specified here.
456 </para>
457
458 <para>
459 <parameter>--with-version-pre</parameter>: This switch allows you to
460 prefix the version string with a custom string.
461 </para>
462
463 <para>
464 <parameter>--with-version-opt</parameter>: This switch allows you to add
465 an optional build description to the version string.
466 </para>
467
468 <para>
469 <parameter>--with-cacerts-file=/etc/pki/tls/java/cacerts</parameter>:
470 Specifies where to find a <filename>cacerts</filename> file,
471 <filename>/etc/pki/tls/java/</filename> on a BLFS system. Otherwise, an
472 empty one is created. You can use the
473 <command>/usr/sbin/make-ca --force</command> command to generate it, once
474 you have installed the Java binaries.
475 </para>
476
477 <para>
478 <option>--with-boot-jdk</option>: This switch provides the
479 location of the temporary <application>JDK</application>. It is normally
480 not needed if <command>java</command> is found in the <envar>PATH</envar>.
481 </para>
482<!-- Seems to have disappeared
483 <para>
484 <command>find ... -iname '*.diz' -delete</command>: This command
485 removes redundant files.
486 </para>
487-->
488 </sect2>
489
490 <sect2 role="configuration"
491 id="openjdk-config"
492 xreflabel="Configuring OpenJDK">
493 <title>Configuring OpenJDK</title>
494
495 <sect3>
496 <title>Configuration Information</title>
497
498 <para>
499 Normally, the Java environment has been configured after installing
500 the binary version, and can be used with the just built package as well.
501 Review <xref linkend="ojdk-conf"/> in case you want to modify
502 something.
503 </para>
504
505 <para>
506 To test if the man pages are correctly installed, issue
507 <command>source /etc/profile</command> and <command>man java</command>
508 to display the respective man page.
509 </para>
510
511 </sect3>
512
513 <sect3>
514 <title>
515 Setting up the JRE Certificate Authority Certificates (cacerts) file
516 </title>
517
518 <para>
519 If you have run the instructions on the <xref linkend="make-ca"/> page,
520 you only need to create a symlink in the default location for the
521 <filename>cacerts</filename> file. As user <systemitem
522 class="username">root</systemitem>:
523 </para>
524
525<screen role="root"><userinput>ln -sfv /etc/pki/tls/java/cacerts /opt/jdk/lib/security/cacerts</userinput></screen>
526
527 <para>
528 To check the installation, issue:
529 </para>
530
531<screen role="root"><userinput>cd /opt/jdk
532bin/keytool -list -cacerts</userinput></screen>
533
534 <para>
535 At the prompt <computeroutput>Enter keystore password:</computeroutput>,
536 enter <userinput>changeit</userinput> (the default) or just press the
537 <quote>Enter</quote> key. If the <filename>cacerts</filename> file was
538 installed correctly, you will see a list of the certificates with
539 related information for each one. If not, you need to reinstall them.
540 </para>
541
542 </sect3>
543
544 </sect2>
545
546 <sect2 role="content">
547 <title>Contents</title>
548
549 <segmentedlist>
550 <segtitle>Installed Programs</segtitle>
551 <segtitle>Installed Libraries</segtitle>
552 <segtitle>Installed Directory</segtitle>
553
554 <seglistitem>
555 <seg>jar, jarsigner, java, javac, javadoc, javap, jcmd,
556 jconsole, jdb, jdeprscan, jdeps, jfr, jhsdb, jimage, jinfo,
557 jlink, jmap, jmod, jpackage, jps, jrunscript, jshell, jstack,
558 jstat, jstatd, jwebserver, keytool, rmiregistry, and serialver</seg>
559 <seg>38 libraries in /opt/jdk-&openjdk-version;+&openjdk-build;/lib/</seg>
560 <seg>/opt/jdk-&openjdk-version;+&openjdk-build;</seg>
561 </seglistitem>
562 </segmentedlist>
563
564 <variablelist>
565 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
566 <?dbfo list-presentation="list"?>
567 <?dbhtml list-presentation="table"?>
568
569 <varlistentry id="jar">
570 <term><command>jar</command></term>
571 <listitem>
572 <para>
573 combines multiple files into a single jar archive
574 </para>
575 <indexterm zone="openjdk jar">
576 <primary sortas="b-jar">jar</primary>
577 </indexterm>
578 </listitem>
579 </varlistentry>
580
581 <varlistentry id="jarsigner">
582 <term><command>jarsigner</command></term>
583 <listitem>
584 <para>
585 signs jar files and verifies the signatures and integrity
586 of a signed jar file
587 </para>
588 <indexterm zone="openjdk jarsigner">
589 <primary sortas="b-jarsigner">jarsigner</primary>
590 </indexterm>
591 </listitem>
592 </varlistentry>
593
594 <varlistentry id="java-prog">
595 <term><command>java</command></term>
596 <listitem>
597 <para>
598 launches a Java application by starting a Java runtime
599 environment, loading a specified class and invoking its main
600 method
601 </para>
602 <indexterm zone="openjdk java-prog">
603 <primary sortas="b-java-prog">java</primary>
604 </indexterm>
605 </listitem>
606 </varlistentry>
607
608 <varlistentry id="javac">
609 <term><command>javac</command></term>
610 <listitem>
611 <para>
612 reads class and interface definitions, written in the
613 Java programming language, and compiles them into bytecode
614 class files
615 </para>
616 <indexterm zone="openjdk javac">
617 <primary sortas="b-javac">javac</primary>
618 </indexterm>
619 </listitem>
620 </varlistentry>
621
622 <varlistentry id="javadoc">
623 <term><command>javadoc</command></term>
624 <listitem>
625 <para>
626 parses the declarations and documentation comments in a
627 set of Java source files and produces a corresponding set of
628 HTML pages describing the classes, interfaces, constructors,
629 methods, and fields
630 </para>
631 <indexterm zone="openjdk javadoc">
632 <primary sortas="b-javadoc">javadoc</primary>
633 </indexterm>
634 </listitem>
635 </varlistentry>
636
637 <varlistentry id="javap">
638 <term><command>javap</command></term>
639 <listitem>
640 <para>
641 disassembles a Java class file
642 </para>
643 <indexterm zone="openjdk javap">
644 <primary sortas="b-javap">javap</primary>
645 </indexterm>
646 </listitem>
647 </varlistentry>
648
649 <varlistentry id="jcmd">
650 <term><command>jcmd</command></term>
651 <listitem>
652 <para>
653 is a utility to send diagnostic command requests to a running
654 Java Virtual Machine
655 </para>
656 <indexterm zone="openjdk jcmd">
657 <primary sortas="b-jcmd">jcmd</primary>
658 </indexterm>
659 </listitem>
660 </varlistentry>
661
662 <varlistentry id="jconsole">
663 <term><command>jconsole</command></term>
664 <listitem>
665 <para>
666 is a graphical console tool to monitor and manage both
667 local and remote Java applications and virtual machines
668 </para>
669 <indexterm zone="openjdk jconsole">
670 <primary sortas="b-jconsole">jconsole</primary>
671 </indexterm>
672 </listitem>
673 </varlistentry>
674
675 <varlistentry id="jdb">
676 <term><command>jdb</command></term>
677 <listitem>
678 <para>
679 is a simple command-line debugger for Java classes
680 </para>
681 <indexterm zone="openjdk jdb">
682 <primary sortas="b-jdb">jdb</primary>
683 </indexterm>
684 </listitem>
685 </varlistentry>
686
687 <varlistentry id="jdeprscan">
688 <term><command>jdeprscan</command></term>
689 <listitem>
690 <para>
691 scans class or jar files for uses of deprecated API elements
692 </para>
693 <indexterm zone="openjdk jdeprscan">
694 <primary sortas="b-jdeprscan">jdeprscan</primary>
695 </indexterm>
696 </listitem>
697 </varlistentry>
698
699 <varlistentry id="jdeps">
700 <term><command>jdeps</command></term>
701 <listitem>
702 <para>
703 shows the package-level or class-level dependencies of
704 Java class files
705 </para>
706 <indexterm zone="openjdk jdeps">
707 <primary sortas="b-jdeps">jdeps</primary>
708 </indexterm>
709 </listitem>
710 </varlistentry>
711
712 <varlistentry id="jfr">
713 <term><command>jfr</command></term>
714 <listitem>
715 <para>
716 is a tool for working with <quote>Flight Recorder</quote> files
717 </para>
718 <indexterm zone="openjdk jfr">
719 <primary sortas="b-jfr">jfr</primary>
720 </indexterm>
721 </listitem>
722 </varlistentry>
723
724 <varlistentry id="jhsdb">
725 <term><command>jhsdb</command></term>
726 <listitem>
727 <para>
728 is a tool to analyze the content of a core dump from a
729 crashed Java Virtual Machine (JVM)
730 </para>
731 <indexterm zone="openjdk jhsdb">
732 <primary sortas="b-jhsdb">jhsdb</primary>
733 </indexterm>
734 </listitem>
735 </varlistentry>
736
737 <varlistentry id="jimage">
738 <term><command>jimage</command></term>
739 <listitem>
740 <para>
741 is used to list, extract, verify, or get information about
742 modules in <emphasis>jimage</emphasis> format
743 </para>
744 <indexterm zone="openjdk jimage">
745 <primary sortas="b-jimage">jimage</primary>
746 </indexterm>
747 </listitem>
748 </varlistentry>
749
750 <varlistentry id="jinfo">
751 <term><command>jinfo</command></term>
752 <listitem>
753 <para>
754 prints Java configuration information for a given Java
755 process, core file, or a remote debug server
756 </para>
757 <indexterm zone="openjdk jinfo">
758 <primary sortas="b-jinfo">jinfo</primary>
759 </indexterm>
760 </listitem>
761 </varlistentry>
762
763 <varlistentry id="jlink">
764 <term><command>jlink</command></term>
765 <listitem>
766 <para>
767 is used to assemble and optimize a set of modules and their
768 dependencies into a custom runtime image
769 </para>
770 <indexterm zone="openjdk jlink">
771 <primary sortas="b-jlink">jlink</primary>
772 </indexterm>
773 </listitem>
774 </varlistentry>
775
776 <varlistentry id="jmap">
777 <term><command>jmap</command></term>
778 <listitem>
779 <para>
780 prints shared object memory maps or heap memory details
781 of a given process, core file, or a remote debug server
782 </para>
783 <indexterm zone="openjdk jmap">
784 <primary sortas="b-jmap">jmap</primary>
785 </indexterm>
786 </listitem>
787 </varlistentry>
788
789 <varlistentry id="jmod">
790 <term><command>jmod</command></term>
791 <listitem>
792 <para>
793 creates JMOD files and lists the content of existing JMOD files
794 </para>
795 <indexterm zone="openjdk jmod">
796 <primary sortas="b-jmod">jmod</primary>
797 </indexterm>
798 </listitem>
799 </varlistentry>
800
801 <varlistentry id="jpackage">
802 <term><command>jpackage</command></term>
803 <listitem>
804 <para>
805 generates java application packages and images
806 </para>
807 <indexterm zone="openjdk jpackage">
808 <primary sortas="b-jpackage">jpackage</primary>
809 </indexterm>
810 </listitem>
811 </varlistentry>
812
813 <varlistentry id="jps">
814 <term><command>jps</command></term>
815 <listitem>
816 <para>
817 lists the instrumented JVMs on the target system
818 </para>
819 <indexterm zone="openjdk jps">
820 <primary sortas="b-jps">jps</primary>
821 </indexterm>
822 </listitem>
823 </varlistentry>
824
825 <varlistentry id="jrunscript">
826 <term><command>jrunscript</command></term>
827 <listitem>
828 <para>
829 is a command line script shell
830 </para>
831 <indexterm zone="openjdk jrunscript">
832 <primary sortas="b-jrunscript">jrunscript</primary>
833 </indexterm>
834 </listitem>
835 </varlistentry>
836
837 <varlistentry id="jshell">
838 <term><command>jshell</command></term>
839 <listitem>
840 <para>
841 is an interactive tool for learning the Java programming
842 language and prototyping Java code
843 </para>
844 <indexterm zone="openjdk jshell">
845 <primary sortas="b-jshell">jshell</primary>
846 </indexterm>
847 </listitem>
848 </varlistentry>
849
850 <varlistentry id="jstack">
851 <term><command>jstack</command></term>
852 <listitem>
853 <para>
854 prints Java stack traces of Java threads for a given
855 Java process, core file, or a remote debug server
856 </para>
857 <indexterm zone="openjdk jstack">
858 <primary sortas="b-jstack">jstack</primary>
859 </indexterm>
860 </listitem>
861 </varlistentry>
862
863 <varlistentry id="jstat">
864 <term><command>jstat</command></term>
865 <listitem>
866 <para>
867 displays performance statistics for an instrumented JVM
868 </para>
869 <indexterm zone="openjdk jstat">
870 <primary sortas="b-jstat">jstat</primary>
871 </indexterm>
872 </listitem>
873 </varlistentry>
874
875 <varlistentry id="jstatd">
876 <term><command>jstatd</command></term>
877 <listitem>
878 <para>
879 is an RMI server application that monitors for the creation
880 and termination of instrumented JVMs
881 </para>
882 <indexterm zone="openjdk jstatd">
883 <primary sortas="b-jstatd">jstatd</primary>
884 </indexterm>
885 </listitem>
886 </varlistentry>
887
888 <varlistentry id="jwebserver">
889 <term><command>jwebserver</command></term>
890 <listitem>
891 <para>
892 provides a minimal HTTP server, designed to be used for
893 prototyping, testing, and debugging
894 </para>
895 <indexterm zone="openjdk jwebserver">
896 <primary sortas="b-jwebserver">jwebserver</primary>
897 </indexterm>
898 </listitem>
899 </varlistentry>
900
901 <varlistentry id="keytool">
902 <term><command>keytool</command></term>
903 <listitem>
904 <para>
905 is a key and certificate management utility
906 </para>
907 <indexterm zone="openjdk keytool">
908 <primary sortas="b-keytool">keytool</primary>
909 </indexterm>
910 </listitem>
911 </varlistentry>
912
913 <varlistentry id="rmiregistry">
914 <term><command>rmiregistry</command></term>
915 <listitem>
916 <para>
917 creates and starts a remote object registry on the specified
918 port on the current host
919 </para>
920 <indexterm zone="openjdk rmiregistry">
921 <primary sortas="b-rmiregistry">rmiregistry</primary>
922 </indexterm>
923 </listitem>
924 </varlistentry>
925
926 <varlistentry id="serialver">
927 <term><command>serialver</command></term>
928 <listitem>
929 <para>
930 returns the serialVersionUID for one or more classes in a
931 form suitable for copying into an evolving class
932 </para>
933 <indexterm zone="openjdk serialver">
934 <primary sortas="b-serialver">serialver</primary>
935 </indexterm>
936 </listitem>
937 </varlistentry>
938 </variablelist>
939
940 </sect2>
941
942</sect1>
Note: See TracBrowser for help on using the repository browser.