source: general/prog/openjdk.xml@ 7985ac6c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 7985ac6c was 7985ac6c, checked in by Pierre Labastie <pieere@…>, 7 years ago

Openjdk-1.8.0.121

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