Skip to content

Commit 4af048a

Browse files
pshiptonpshipton
authored
Merge pull request #18523 from Sreekala-Gopakumar/42RelNote
Release note for 0.42.0 release
2 parents 9b5f025 + c952d96 commit 4af048a

File tree

1 file changed

+121
-0
lines changed

1 file changed

+121
-0
lines changed

‎doc/release-notes/0.42/0.42.md‎

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
<!--
2+
* Copyright (c) 2023 IBM Corp. and others
3+
*
4+
* This program and the accompanying materials are made
5+
* available under the terms of the Eclipse Public License 2.0
6+
* which accompanies this distribution and is available at
7+
* https://www.eclipse.org/legal/epl-2.0/ or the Apache
8+
* License, Version 2.0 which accompanies this distribution and
9+
* is available at https://www.apache.org/licenses/LICENSE-2.0.
10+
*
11+
* This Source Code may also be made available under the
12+
* following Secondary Licenses when the conditions for such
13+
* availability set forth in the Eclipse Public License, v. 2.0
14+
* are satisfied: GNU General Public License, version 2 with
15+
* the GNU Classpath Exception [1] and GNU General Public
16+
* License, version 2 with the OpenJDK Assembly Exception [2].
17+
*
18+
* [1] https://www.gnu.org/software/classpath/license.html
19+
* [2] https://openjdk.org/legal/assembly-exception.html
20+
*
21+
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0 OR GPL-2.0-only WITH OpenJDK-assembly-exception-1.0
22+
-->
23+
24+
# Eclipse OpenJ9 version 0.42.0 release notes
25+
26+
These release notes support the [Eclipse OpenJ9&trade; 0.42.0 release plan](https://projects.eclipse.org/projects/technology.openj9/releases/0.42.0/plan).
27+
28+
## Supported environments
29+
30+
OpenJ9 release 0.42.0 supports OpenJDK 21.
31+
32+
All releases are tested against the OpenJ9 functional verification (FV) test suite, the OpenJDK test suites, and additional tests provided by Adoptium.
33+
34+
To learn more about support for OpenJ9 releases, including OpenJDK levels and platform support, see [Supported environments](https://eclipse.org/openj9/docs/openj9_support/index.html).
35+
36+
## Notable changes in this release
37+
38+
The following table covers notable changes in v0.42.0. Further information about these changes can be found in the [user documentation](https://www.eclipse.org/openj9/docs/version0.42/).
39+
40+
<table cellpadding="4" cellspacing="0" summary="" width="100%" rules="all" frame="border" border="1"><thead align="left">
41+
<tr>
42+
<th valign="bottom">Issue number</th>
43+
<th valign="bottom">Description</th>
44+
<th valign="bottom">Version / Platform</th>
45+
<th valign="bottom">Impact</th>
46+
</tr>
47+
</thead>
48+
<tbody>
49+
50+
<tr>
51+
<td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/18193">#18193</a></td>
52+
<td valign="top">The dump extractor tool, OpenJ9 <tt>jextract</tt>, is removed.</td>
53+
<td valign="top">OpenJDK 21 and later</td>
54+
<td valign="top">The dump extractor tool, OpenJ9 <tt>jextract</tt>, that was deprecated since the 0.26.0 release is now removed from Java 21 and later. The <tt>jpackcore</tt> tool replaced the OpenJ9 <tt>jextract</tt> tool after its deprecation. </td>
55+
</tr>
56+
57+
<tr>
58+
<td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/18044">#18044</a></td>
59+
<td valign="top">The <tt>System.gc()</tt> call behavior is changed.</td>
60+
<td valign="top">All versions</td>
61+
<td valign="top">Earlier, the <tt>System.gc()</tt> call had to be called twice explicitly to ensure that all unreachable objects are identified and cleared. Now, the <tt>System.gc()</tt> call triggers the GC cycle twice internally to clear the unreachable objects that were not identified during the first GC cycle. The call also triggers finalization of the objects in the Finalization queues.</td>
62+
</tr>
63+
64+
<tr>
65+
<td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/18381">#18381</a></td>
66+
<td valign="top">The <tt>-XX:[+|-]IProfileDuringStartupPhase</tt> option is added to control the collection of the profiling information during the startup phase.</td>
67+
<td valign="top">All versions</td>
68+
<td valign="top">The VM uses heuristics to decide whether to collect interpreter profiling information during the VM startup. You can now overrule the heuristics and control the collection of the profiling information during the startup phase by using the <tt>-XX:[+|-]IProfileDuringStartupPhase</tt> option.</td>
69+
</tr>
70+
</tbody>
71+
</table>
72+
73+
## Known issues
74+
75+
The v0.42.0 release contains the following known issues and limitations:
76+
77+
<table cellpadding="4" cellspacing="0" summary="" width="100%" rules="all" frame="border" border="1">
78+
<thead align="left">
79+
<tr>
80+
<th valign="bottom">Issue number</th>
81+
<th valign="bottom">Description</th>
82+
<th valign="bottom">Platform</th>
83+
<th valign="bottom">Impact</th>
84+
<th valign="bottom">Workaround</th>
85+
</tr>
86+
</thead>
87+
88+
<tbody>
89+
<tr>
90+
<td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/15011">#15011</a></td>
91+
<td valign="top">The default stack size for the main thread is a smaller platform-dependent value.</td>
92+
<td valign="top">All</td>
93+
<td valign="top">The main thread stack size was 1 MB in releases before 0.32. In the 0.32 release and later it was modified to a smaller
94+
platform-dependent value, the same value as the <tt>-Xmso</tt> setting. The 0.33 release increased the default <tt>-Xmso</tt> stack size
95+
on x64 platforms, but builds with OpenJDK 17 and later also require more stack space to run. These changes might result in a
96+
<tt>java.lang.StackOverflowError: operating system stack overflow</tt>.</td>
97+
<td valign="top">Use <tt>-Xmso</tt> to set the default stack size. See the default value by using <tt>-verbose:sizes</tt>.</td>
98+
</tr>
99+
100+
<tr>
101+
<td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/13767">#13767</a></td>
102+
<td valign="top">Compressed references mode is not available.</td>
103+
<td valign="top">Apple silicon macOS</td>
104+
<td valign="top">You can use only the large heap (non-compressed references) mode.</td>
105+
<td valign="top">None</td>
106+
</tr>
107+
108+
<tr>
109+
<td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/14803">#14803</a></td>
110+
<td valign="top">Using the <tt>-XX:+ShowHiddenFrames</tt> option in an OpenJ9 release that is built with OpenJDK 18 and later causes errors.</td>
111+
<td valign="top">All platforms</td>
112+
<td valign="top">Wrong exception might be thrown when using the Reflection API.</td>
113+
<td valign="top">Avoid using the <tt>-XX:+ShowHiddenFrames</tt> option with OpenJDK 18 and later.</td>
114+
</tr>
115+
116+
</tbody>
117+
</table>
118+
119+
## Other changes
120+
121+
A full commit history for 0.42.0 release is available at [Eclipse OpenJ9 v0.42.0](https://github.com/eclipse-openj9/openj9/releases/tag/openj9-0.42.0).

0 commit comments

Comments
 (0)