source: general/prog/openjdk.xml@ e6974d1

lazarus
Last change on this file since e6974d1 was c8af588, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Typo

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