Context Navigation

openjdk.xml@ 4a16903

Visit:

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 nosym 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 4a16903 was 4a16903, checked in by DJ Lucas <dj@…>, 7 years ago

Introduce complete PKI seutp for CA Certificates page. Fixes #8507.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17975 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 "112">
8	<!ENTITY ojdk-bd "b15">
9	<!ENTITY ojdk-tarball "jdk8u&ojdk-upd;-&ojdk-bd;.tar.bz2">
10	<!ENTITY ojdk-repo "http://hg.openjdk.java.net/jdk8u/jdk8u">
11	<!ENTITY ojdk-download "&ojdk-repo;/archive/&ojdk-tarball;">
12
13	<!ENTITY anduin-download "&sources-anduin-http;/OpenJDK/OpenJDK-&openjdk-version;">
14
15	<!ENTITY ojdk-md5sum "d2c9c29c00609a56ec68b0f91e34a455">
16	<!ENTITY ojdk-size "401 KB">
17
18	<!ENTITY corba-md5sum "9bf02dac9f3f79a220af140778ed003e">
19	<!ENTITY hotspot-md5sum "41f78a61f81ca93d1110d417d06454b2">
20	<!ENTITY jaxp-md5sum "2fd39b1985c8ac9af222af34d8e5f945">
21	<!ENTITY jaxws-md5sum "15a8b60355209145680a8da1aee9b12d">
22	<!ENTITY jdk-md5sum "b8da9095c290358a85f533a089570b66">
23	<!ENTITY langtools-md5sum "ced983a635486e02a2a7bc3c2a9416dd">
24	<!ENTITY nashorn-md5sum "d34ca91c7e0040635aaf9e9d9b5f86b6">
25	<!ENTITY total-download-size "63 MB">
26
27	<!ENTITY jtreg-version "4.2-b03-675">
28	<!ENTITY jtreg-download "&anduin-download;/jtreg-&jtreg-version;.tar.gz">
29	<!ENTITY jtreg-md5sum "af4d3fc659cac0c4f5e2f78c57790345">
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 413 MB for tests)">
35	<!ENTITY ojdk-time "5 SBU with 4 jobs in parallel (additional 84 SBU for tests)">
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 > subprojects.md5 << EOF &&
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
223	EOF
224
225	for subproject in corba hotspot jaxp jaxws langtools jdk nashorn; do
226	wget -c &ojdk-repo;/${subproject}/archive/&ojdk-tarball; \
227	-O ${subproject}.tar.bz2
228	done &&
229
230	md5sum -c subprojects.md5 &&
231
232	for subproject in corba hotspot jaxp jaxws langtools jdk nashorn; do
233	mkdir -pv ${subproject} &&
234	tar -xf ${subproject}.tar.bz2 --strip-components=1 -C ${subproject}
235	done</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
244	this 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 &&
269	sh ./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" &&
278	make DEBUG_BINARIES=true SCTP_WERROR= all &&
279	find 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"
300	but 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
304	fi
305	export DISPLAY=:20
306	nohup Xvfb $DISPLAY \
307	-fbdir $(pwd) \
308	-pixdepths 8 16 24 32 > Xvfb.out 2>&1 &
309	echo $! > Xvfb.pid
310	echo Waiting for Xvfb to initialize; sleep 1
311	nohup twm -display $DISPLAY \
312	-f /dev/null > twm.out 2>&1 &
313	echo $! > twm.pid
314	echo Waiting for twm to initialize; sleep 1
315	xhost +</userinput></screen>
316
317	<para>
318	Then, it is necessary to modify some files<!-- (replace <N> with the
319	number of JAVA VM allowed to run concurrently)-->:
320	</para>
321
322	<screen role='nodump'><userinput>echo -e "
323	jdk_all = :jdk_core \\
324	:jdk_svc \\
325	:jdk_beans \\
326	:jdk_imageio \\
327	:jdk_sound \\
328	:jdk_sctp \\
329	com/sun/awt \\
330	javax/accessibility \\
331	javax/print \\
332	sun/pisces \\
333	com/sun/java/swing" >> jdk/test/TEST.groups &&
334	sed -e 's/all:.jck./all: jtreg/' \
335	-e '/^JTREG /s@\$(JT_PLATFORM)/@@' \
336	-i langtools/test/Makefile<!-- &&
337	sed -i 's@/win32@@' jdk/test/Makefile &&
338	sed -e 's@JTREG_HOME@JT_PLATFORM="" &@' \
339	-e 's@TEST="@CONCURRENCY=<N> &@' \
340	-i test/Makefile--></userinput></screen>
341
342	<para>
343	Some variables have to be set:
344	</para>
345
346	<screen role='nodump'><userinput>JT_JAVA=$(type -p javac \| sed 's@/bin.*@@') &&
347	JT_HOME=$(pwd)/jtreg &&
348	PRODUCT_HOME=$(echo $(pwd)/build/*/images/j2sdk-image)</userinput></screen>
349
350	<para>
351	The tests are run as follows:
352	</para>
353
354	<!-- no && here either, because the first "make" may return an error -->
355	<screen role='nodump'><userinput>LANG=C make -k -C test \
356	JT_HOME=${JT_HOME} \
357	JT_JAVA=${JT_JAVA} \
358	PRODUCT_HOME=${PRODUCT_HOME} all
359	LANG=C ${JT_HOME}/bin/jtreg -a -v:fail,error \
360	-dir:$(pwd)/hotspot/test \
361	-k:\!ignore \
362	-jdk:${PRODUCT_HOME} \
363	<!-- -agentvm -conc:<N> \
364	--> :jdk</userinput></screen>
365
366	<para>
367	The test results can be compared to <ulink
368	url="http://download.java.net/openjdk/testresults/8/">these
369	results</ulink>, although they usually are run on a newer version. Some
370	failures can be expected, the number of which depends on various
371	conditions, like whether the computer is connected to network. Also, some
372	tests may timeout if the machine is under load. Those are the reasons for
373	considering the tests optional, although we would rather recommend them.
374	</para>
375
376	<para>
377	Next some cleanup has to be done. The instructions below only stop the
378	frame buffer, but it has been reported that some java VM may be left
379	running after the tests, so it is necessary to check orphaned processes:
380	</para>
381
382	<screen role='nodump'><userinput>kill -9 `cat twm.pid` &&
383	kill -9 `cat Xvfb.pid` &&
384	rm -f Xvfb.out twm.out &&
385	rm -f Xvfb.pid twm.pid &&
386	if [ -n "$OLD_DISP" ]; then
387	DISPLAY=$OLD_DISP
388	fi</userinput></screen>
389
390	<para>Install the package with the following commands as the
391	<systemitem class="username">root</systemitem> user:</para>
392
393	<screen role="root"><userinput>cp -RT build/*/images/j2sdk-image /opt/OpenJDK-&openjdk-version; &&
394	chown -R root:root /opt/OpenJDK-&openjdk-version;</userinput></screen>
395
396	<para>
397	There are now two <application>OpenJDK</application> SDKs installed
398	in <filename class="directory">/opt</filename>. You should decide on
399	which one you would like to use as the default. Normally, you would opt
400	for the just installed <application>OpenJDK</application>. If so, do
401	the following as the <systemitem class="username">root</systemitem>
402	user:
403	</para>
404
405	<screen role="root"><userinput>ln -v -nsf OpenJDK-&openjdk-version; /opt/jdk</userinput></screen>
406
407	<para>If desired, you may install a .desktop file corresponding to an entry
408	in a desktop menu for <command>policytool</command>. First, you need to
409	obtain an icon from <xref linkend="icedtea-web"/>:</para>
410
411	<screen><userinput>tar -xf ../icedtea-web-&icedtea-web-version;.tar.gz \
412	icedtea-web-&icedtea-web-version;/javaws.png \
413	--strip-components=1</userinput></screen>
414
415	<para>Now, as <systemitem class="username">root</systemitem> user:</para>
416
417	<screen role="root"><userinput>mkdir -pv /usr/share/applications &&
418
419	cat > /usr/share/applications/openjdk-8-policytool.desktop << "EOF" &&
420	<literal>[Desktop Entry]
421	Name=OpenJDK Java Policy Tool
422	Name[pt_BR]=OpenJDK Java - Ferramenta de Política
423	Comment=OpenJDK Java Policy Tool
424	Comment[pt_BR]=OpenJDK Java - Ferramenta de Política
425	Exec=/opt/jdk/bin/policytool
426	Terminal=false
427	Type=Application
428	Icon=javaws
429	Categories=Settings;</literal>
430	EOF
431
432	install -v -Dm0644 javaws.png /usr/share/pixmaps/javaws.png</userinput></screen>
433
434	<para>The choice of pt_BR is just an example. You can add any translation
435	by adding lines corresponding to your locale, e.g. for fr_FR,
436	<quote>Name[fr_FR]=</quote> and <quote>Comment[fr_FR]=</quote> with the
437	appropriate text as values.</para>
438
439	</sect2>
440
441	<sect2 role="commands">
442	<title>Command Explanations</title>
443
444	<para>
445	<command>sh configure...</command>: the top level
446	<filename>configure</filename> is a wrapper around the autotools one.
447	It is not executable and must be run through <command>sh</command>.
448	</para>
449
450	<para>
451	<option>--with-boot-jdk</option>: This switch provides the
452	location of the temporary <application>JDK</application>. It is normally
453	not needed if <command>java</command> is found in the <envar>PATH</envar>.
454	</para>
455
456	<para>
457	<parameter>--with-update-version</parameter>: Currently, the build
458	system does not include the update number in the version string. It has
459	to be specified here.
460	</para>
461
462	<para>
463	<parameter>--with-build-number</parameter>: Again, the build
464	system does not include the build number in the version string. It has
465	to be specified here too.
466	</para>
467
468	<para>
469	<parameter>--with-milestone</parameter>: Used to customize the
470	version string.
471	</para>
472
473	<para>
474	<parameter>--enable-unlimited-crypto</parameter>: Because of limitations
475	on the usage of cryptography in some countries, there is the possibility
476	to limit the size of encryption keys and the use of some algorithms in a
477	policy file. This switch allows to ship a policy file with no
478	restriction. It is the responsibility of the user to ensure proper
479	adherence to the law.
480	</para>
481
482	<para>
483	<parameter>--with-zlib=system, --with-giflib=system</parameter>: Allows
484	to use the system libraries instead of the bundled ones.
485	</para>
486
487	<para>
488	<parameter>--with-extra-cflags=... --with-extra-cxxflags=...</parameter>:
489	Works around some defects in the code brought to light by the GCC 6
490	more rigorous checking of the C/C++ constructs. Remove those switches
491	if compiling with GCC 5.
492	</para>
493
494	<para>
495	<option>--with-jobs=N</option>: Allows setting the number
496	of jobs for <command>make</command> equal to N. The default is the
497	result of a calculation involving the available memory and the number
498	of processors. Note that even if you specify N=1, some parallelization
499	may be used during the build. The SBU given above are with N=4, on
500	a single processor, 4-core, virtual machine, with 4 GB of memory.
501	</para>
502
503	<para>
504	<option>--with-cacerts-file=...</option>: Specifies where to find a
505	<filename>cacerts</filename> file, typically <filename>
506	/opt/jdk/jre/lib/security</filename>. Otherwise, an empty one is created.
507	You can get it from an earlier version of the package, or use the
508	script below to generate one.
509	</para>
510
511	<para>
512	<command>make DEBUG_BINARIES=true SCTP_WERROR= all</command>: The build
513	fails on 32 bit machines if DEBUG_BINARIES is not set to true. Unsetting
514	SCTP_WERROR is part of the workarounds needed to use GCC 6. You may omit
515	that part of the command if using GCC 5.
516	</para>
517
518	<para>
519	<command>find ... -iname '*.diz' -delete</command>: This command
520	removes redundant files.
521	</para>
522
523	</sect2>
524
525	<sect2 role="configuration"
526	id="openjdk-config"
527	xreflabel="Configuring OpenJDK">
528	<title>Configuring OpenJDK</title>
529
530	<sect3>
531	<title>Configuration Information</title>
532
533	<para>
534	Normally, the JAVA environment has been configured after installing
535	the binary version, and can be used with the just built package as well.
536	Review <xref linkend="ojdk-conf"/> in case you want to modify
537	something.
538	</para>
539
540	<para>
541	To test if the man pages are correctly installed, issue
542	<command>source /etc/profile</command> and <command>man java</command>
543	to display the respective man page.
544	</para>
545
546	</sect3>
547
548	<sect3 id='ojdk-certs' xreflabel='JRE Certificate Authority Certificates'>
549	<title>Install or update the JRE Certificate Authority Certificates
550	(cacerts) file</title>
551
552	<para>
553	<application>OpenJDK</application> uses its own format for the
554	CA certificates. Those certificates are located in a file named
555	<filename>/etc/ssl/java/cacerts</filename>. That file should be
556	generated using the system PKI trust store. The instructions
557	on the <xref linkend="cacerts"/> page should be used to update the file
558	located in <filename>/etc/ssl/java</filename>. Setup a symlink in the
559	defualt location as the <systemitem class="username">root</systemitem>
560	user:
561	</para>
562
563	<screen role="root"><userinput>ln -sfv /etc/ssl/java/cacerts /opt/jdk/jre/lib/security/cacerts</userinput></screen>
564
565	<para>Use the following commands to check if the
566	<filename>cacerts</filename> file has been successfully installed:</para>
567
568	<screen role="root"><userinput>cd /opt/jdk
569	bin/keytool -list -keystore /etc/ssl/java/cacerts</userinput></screen>
570
571	<para>At the prompt "Enter keystore password:", enter "changeit" (the
572	default). If the <filename>cacerts</filename> file was installed
573	correctly, you will see a list of the certificates with related
574	information for each one. If not, you need to reinstall them.</para>
575
576	</sect3>
577
578	</sect2>
579
580	<sect2 role="content">
581	<title>Contents</title>
582
583	<segmentedlist>
584	<segtitle>Installed Programs</segtitle>
585	<segtitle>Installed Libraries</segtitle>
586	<segtitle>Installed Directory</segtitle>
587
588	<seglistitem>
589	<seg>appletviewer, extcheck, idlj, jar,
590	jarsigner, java, javac, javadoc, javah, javap, java-rmi.cgi,
591	jcmd, jconsole, jdb, jdeps, jhat, jinfo, jjs, jmap, jps,
592	jrunscript, jsadebugd, jstack, jstat, jstatd, keytool,
593	native2ascii, orbd, pack200, policytool, rmic, rmid, rmiregistry,
594	schemagen, serialver, servertool, tnameserv, unpack200,
595	wsgen, wsimport, and xjc</seg>
596	<seg>/opt/OpenJDK-&openjdk-version;/lib/*, and
597	/opt/OpenJDK-&openjdk-version;/jre/lib/*</seg>
598	<seg>/opt/OpenJDK-&openjdk-version;</seg>
599	</seglistitem>
600	</segmentedlist>
601
602	<variablelist>
603	<bridgehead renderas="sect3">Short Descriptions</bridgehead>
604	<?dbfo list-presentation="list"?>
605	<?dbhtml list-presentation="table"?>
606
607	<varlistentry id="appletviewer">
608	<term><command>appletviewer</command></term>
609	<listitem>
610	<para>allows to run applets outside of a web browser.</para>
611	<indexterm zone="openjdk appletviewer">
612	<primary sortas="b-appletviewer">appletviewer</primary>
613	</indexterm>
614	</listitem>
615	</varlistentry>
616
617	<varlistentry id="extcheck">
618	<term><command>extcheck</command></term>
619	<listitem>
620	<para>checks a specified jar file for title and version conflicts
621	with any extensions installed in the
622	<application>OpenJDK</application> software.</para>
623	<indexterm zone="openjdk extcheck">
624	<primary sortas="b-extcheck">extcheck</primary>
625	</indexterm>
626	</listitem>
627	</varlistentry>
628
629	<varlistentry id="idlj">
630	<term><command>idlj</command></term>
631	<listitem>
632	<para>generates Java bindings from a given IDL file.</para>
633	<indexterm zone="openjdk idlj">
634	<primary sortas="b-idlj">idlj</primary>
635	</indexterm>
636	</listitem>
637	</varlistentry>
638
639	<varlistentry id="jar">
640	<term><command>jar</command></term>
641	<listitem>
642	<para>combines multiple files into a single jar archive.</para>
643	<indexterm zone="openjdk jar">
644	<primary sortas="b-jar">jar</primary>
645	</indexterm>
646	</listitem>
647	</varlistentry>
648
649	<varlistentry id="jarsigner">
650	<term><command>jarsigner</command></term>
651	<listitem>
652	<para>signs jar files and verifies the signatures and integrity
653	of a signed jar file.</para>
654	<indexterm zone="openjdk jarsigner">
655	<primary sortas="b-jarsigner">jarsigner</primary>
656	</indexterm>
657	</listitem>
658	</varlistentry>
659
660	<varlistentry id="java-prog">
661	<term><command>java</command></term>
662	<listitem>
663	<para>launches a Java application by starting a Java runtime
664	environment, loading a specified class and invoking its main
665	method.</para>
666	<indexterm zone="openjdk java-prog">
667	<primary sortas="b-java-prog">java</primary>
668	</indexterm>
669	</listitem>
670	</varlistentry>
671
672	<varlistentry id="javac">
673	<term><command>javac</command></term>
674	<listitem>
675	<para>reads class and interface definitions, written in the
676	Java programming language, and compiles them into bytecode
677	class files.</para>
678	<indexterm zone="openjdk javac">
679	<primary sortas="b-javac">javac</primary>
680	</indexterm>
681	</listitem>
682	</varlistentry>
683
684	<varlistentry id="javadoc">
685	<term><command>javadoc</command></term>
686	<listitem>
687	<para>parses the declarations and documentation comments in a
688	set of Java source files and produces a corresponding set of
689	HTML pages describing the classes, interfaces, constructors,
690	methods, and fields.</para>
691	<indexterm zone="openjdk javadoc">
692	<primary sortas="b-javadoc">javadoc</primary>
693	</indexterm>
694	</listitem>
695	</varlistentry>
696
697	<varlistentry id="javah">
698	<term><command>javah</command></term>
699	<listitem>
700	<para>generates C header and source files
701	that are needed to implement native methods.</para>
702	<indexterm zone="openjdk javah">
703	<primary sortas="b-javah">javah</primary>
704	</indexterm>
705	</listitem>
706	</varlistentry>
707
708	<varlistentry id="javap">
709	<term><command>javap</command></term>
710	<listitem>
711	<para>disassembles a Java class file.</para>
712	<indexterm zone="openjdk javap">
713	<primary sortas="b-javap">javap</primary>
714	</indexterm>
715	</listitem>
716	</varlistentry>
717
718	<varlistentry id="java-rmi.cgi">
719	<term><command>java-rmi.cgi</command></term>
720	<listitem>
721	<para>is the Java RMI client.</para>
722	<indexterm zone="openjdk java-rmi.cgi">
723	<primary sortas="b-java-rmi.cgi">java-rmi.cgi</primary>
724	</indexterm>
725	</listitem>
726	</varlistentry>
727
728	<varlistentry id="jcmd">
729	<term><command>jcmd</command></term>
730	<listitem>
731	<para>is a utility to send diagnostic command requests to a running
732	Java Virtual Machine.</para>
733	<indexterm zone="openjdk jcmd">
734	<primary sortas="b-jcmd">jcmd</primary>
735	</indexterm>
736	</listitem>
737	</varlistentry>
738
739	<varlistentry id="jconsole">
740	<term><command>jconsole</command></term>
741	<listitem>
742	<para>is a graphical console tool to monitor and manage both
743	local and remote Java applications and virtual machines.</para>
744	<indexterm zone="openjdk jconsole">
745	<primary sortas="b-jconsole">jconsole</primary>
746	</indexterm>
747	</listitem>
748	</varlistentry>
749
750	<varlistentry id="jdb">
751	<term><command>jdb</command></term>
752	<listitem>
753	<para>is a simple command-line debugger for Java classes.</para>
754	<indexterm zone="openjdk jdb">
755	<primary sortas="b-jdb">jdb</primary>
756	</indexterm>
757	</listitem>
758	</varlistentry>
759
760	<varlistentry id="jdeps">
761	<term><command>jdeps</command></term>
762	<listitem>
763	<para>shows the package-level or class-level dependencies of
764	Java class files.</para>
765	<indexterm zone="openjdk jdeps">
766	<primary sortas="b-jdeps">jdeps</primary>
767	</indexterm>
768	</listitem>
769	</varlistentry>
770
771	<varlistentry id="jhat">
772	<term><command>jhat</command></term>
773	<listitem>
774	<para>parses a java heap dump file and allows viewing it
775	in a web browser.</para>
776	<indexterm zone="openjdk jhat">
777	<primary sortas="b-jhat">jhat</primary>
778	</indexterm>
779	</listitem>
780	</varlistentry>
781
782	<varlistentry id="jinfo">
783	<term><command>jinfo</command></term>
784	<listitem>
785	<para>prints Java configuration information for a given Java
786	process, core file, or a remote debug server.</para>
787	<indexterm zone="openjdk jinfo">
788	<primary sortas="b-jinfo">jinfo</primary>
789	</indexterm>
790	</listitem>
791	</varlistentry>
792
793	<varlistentry id="jjs">
794	<term><command>jjs</command></term>
795	<listitem>
796	<para>is a command-line tool used to invoke the Nashorn engine. It
797	can be used to interpret one or several script files, or to run
798	an interactive shell.</para>
799	<indexterm zone="openjdk jjs">
800	<primary sortas="b-jjs">jjs</primary>
801	</indexterm>
802	</listitem>
803	</varlistentry>
804
805	<varlistentry id="jmap">
806	<term><command>jmap</command></term>
807	<listitem>
808	<para>prints shared object memory maps or heap memory details
809	of a given process, core file, or a remote debug server.</para>
810	<indexterm zone="openjdk jmap">
811	<primary sortas="b-jmap">jmap</primary>
812	</indexterm>
813	</listitem>
814	</varlistentry>
815
816	<varlistentry id="jps">
817	<term><command>jps</command></term>
818	<listitem>
819	<para>lists the instrumented JVMs on the target system.</para>
820	<indexterm zone="openjdk jps">
821	<primary sortas="b-jps">jps</primary>
822	</indexterm>
823	</listitem>
824	</varlistentry>
825
826	<varlistentry id="jrunscript">
827	<term><command>jrunscript</command></term>
828	<listitem>
829	<para>is a command line script shell.</para>
830	<indexterm zone="openjdk jrunscript">
831	<primary sortas="b-jrunscript">jrunscript</primary>
832	</indexterm>
833	</listitem>
834	</varlistentry>
835
836	<varlistentry id="jsadebugd">
837	<term><command>jsadebugd</command></term>
838	<listitem>
839	<para>attaches to a Java process or core file and acts as a
840	debug server.</para>
841	<indexterm zone="openjdk jsadebugd">
842	<primary sortas="b-jsadebugd">jsadebugd</primary>
843	</indexterm>
844	</listitem>
845	</varlistentry>
846
847	<varlistentry id="jstack">
848	<term><command>jstack</command></term>
849	<listitem>
850	<para>prints Java stack traces of Java threads for a given
851	Java process, core file, or a remote debug server.</para>
852	<indexterm zone="openjdk jstack">
853	<primary sortas="b-jstack">jstack</primary>
854	</indexterm>
855	</listitem>
856	</varlistentry>
857
858	<varlistentry id="jstat">
859	<term><command>jstat</command></term>
860	<listitem>
861	<para>displays performance statistics for an instrumented JVM.</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>is an RMI server application that monitors for the creation
872	and termination of instrumented JVMs.</para>
873	<indexterm zone="openjdk jstatd">
874	<primary sortas="b-jstatd">jstatd</primary>
875	</indexterm>
876	</listitem>
877	</varlistentry>
878
879	<varlistentry id="keytool">
880	<term><command>keytool</command></term>
881	<listitem>
882	<para>is a key and certificate management utility.</para>
883	<indexterm zone="openjdk keytool">
884	<primary sortas="b-keytool">keytool</primary>
885	</indexterm>
886	</listitem>
887	</varlistentry>
888
889	<varlistentry id="native2ascii">
890	<term><command>native2ascii</command></term>
891	<listitem>
892	<para> converts files that contain non-supported character encoding
893	into files containing Latin-1 or Unicode-encoded characters.</para>
894	<indexterm zone="openjdk native2ascii">
895	<primary sortas="b-native2ascii">native2ascii</primary>
896	</indexterm>
897	</listitem>
898	</varlistentry>
899
900	<varlistentry id="orbd">
901	<term><command>orbd</command></term>
902	<listitem>
903	<para>is used to enable clients to transparently locate and invoke
904	persistent objects on servers in the CORBA environment.</para>
905	<indexterm zone="openjdk orbd">
906	<primary sortas="b-orbd">orbd</primary>
907	</indexterm>
908	</listitem>
909	</varlistentry>
910
911	<varlistentry id="pack200">
912	<term><command>pack200</command></term>
913	<listitem>
914	<para>is a Java application that transforms a jar file into a
915	compressed pack200 file using the Java gzip compressor.</para>
916	<indexterm zone="openjdk pack200">
917	<primary sortas="b-pack200">pack200</primary>
918	</indexterm>
919	</listitem>
920	</varlistentry>
921
922	<varlistentry id="policytool">
923	<term><command>policytool</command></term>
924	<listitem>
925	<para>creates and manages a policy file graphically.</para>
926	<indexterm zone="openjdk policytool">
927	<primary sortas="b-policytool">policytool</primary>
928	</indexterm>
929	</listitem>
930	</varlistentry>
931
932	<varlistentry id="rmic">
933	<term><command>rmic</command></term>
934	<listitem>
935	<para>generates stub and skeleton class files for remote objects
936	from the names of compiled Java classes that contain remote
937	object implementations.</para>
938	<indexterm zone="openjdk rmic">
939	<primary sortas="b-rmic">rmic</primary>
940	</indexterm>
941	</listitem>
942	</varlistentry>
943
944	<varlistentry id="rmid">
945	<term><command>rmid</command></term>
946	<listitem>
947	<para>starts the activation system daemon.</para>
948	<indexterm zone="openjdk rmid">
949	<primary sortas="b-rmid">rmid</primary>
950	</indexterm>
951	</listitem>
952	</varlistentry>
953
954	<varlistentry id="rmiregistry">
955	<term><command>rmiregistry</command></term>
956	<listitem>
957	<para>creates and starts a remote object registry on the specified
958	port on the current host.</para>
959	<indexterm zone="openjdk rmiregistry">
960	<primary sortas="b-rmiregistry">rmiregistry</primary>
961	</indexterm>
962	</listitem>
963	</varlistentry>
964
965	<varlistentry id="schemagen">
966	<term><command>schemagen</command></term>
967	<listitem>
968	<para>is a Java XML binding schema generator.</para>
969	<indexterm zone="openjdk schemagen">
970	<primary sortas="b-schemagen">schemagen</primary>
971	</indexterm>
972	</listitem>
973	</varlistentry>
974
975	<varlistentry id="serialver">
976	<term><command>serialver</command></term>
977	<listitem>
978	<para>returns the serialVersionUID for one or more classes in a
979	form suitable for copying into an evolving class.</para>
980	<indexterm zone="openjdk serialver">
981	<primary sortas="b-serialver">serialver</primary>
982	</indexterm>
983	</listitem>
984	</varlistentry>
985
986	<varlistentry id="servertool">
987	<term><command>servertool</command></term>
988	<listitem>
989	<para>provides an ease-of-use interface for application programmers
990	to register, unregister, startup and shutdown a server.</para>
991	<indexterm zone="openjdk servertool">
992	<primary sortas="b-servertool">servertool</primary>
993	</indexterm>
994	</listitem>
995	</varlistentry>
996
997	<varlistentry id="tnameserv">
998	<term><command>tnameserv</command></term>
999	<listitem>
1000	<para>starts the Java IDL name server.</para>
1001	<indexterm zone="openjdk tnameserv">
1002	<primary sortas="b-tnameserv">tnameserv</primary>
1003	</indexterm>
1004	</listitem>
1005	</varlistentry>
1006
1007	<varlistentry id="unpack200">
1008	<term><command>unpack200</command></term>
1009	<listitem>
1010	<para>is a native implementation that transforms a packed file
1011	produced by <application>pack200</application> into a jar
1012	file.</para>
1013	<indexterm zone="openjdk unpack200">
1014	<primary sortas="b-unpack200">unpack200</primary>
1015	</indexterm>
1016	</listitem>
1017	</varlistentry>
1018
1019	<varlistentry id="wsgen">
1020	<term><command>wsgen</command></term>
1021	<listitem>
1022	<para>generates JAX-WS portable artifacts used in JAX-WS
1023	web services.</para>
1024	<indexterm zone="openjdk wsgen">
1025	<primary sortas="b-wsgen">wsgen</primary>
1026	</indexterm>
1027	</listitem>
1028	</varlistentry>
1029
1030	<varlistentry id="wsimport">
1031	<term><command>wsimport</command></term>
1032	<listitem>
1033	<para>generates JAX-WS portable artifacts.</para>
1034	<indexterm zone="openjdk wsimport">
1035	<primary sortas="b-wsimport">wsimport</primary>
1036	</indexterm>
1037	</listitem>
1038	</varlistentry>
1039
1040	<varlistentry id="xjc">
1041	<term><command>xjc</command></term>
1042	<listitem>
1043	<para>is a Java XML binding compiler.</para>
1044	<indexterm zone="openjdk xjc">
1045	<primary sortas="b-xjc">xjc</primary>
1046	</indexterm>
1047	</listitem>
1048	</varlistentry>
1049
1050	</variablelist>
1051
1052	</sect2>
1053
1054	</sect1>

Note: See TracBrowser for help on using the repository browser.

Context Navigation

source: general/prog/openjdk.xml@ 4a16903

Download in other formats: