RFR: 8356716: ZGC: Cleanup Uncommit Logic [v9]

Erik Österlund eosterlund at openjdk.org
Tue Jun 3 07:22:55 UTC 2025


On Tue, 3 Jun 2025 05:24:03 GMT, Axel Boldt-Christmas <aboldtch at openjdk.org> wrote:

>> [JDK-8350441](https://bugs.openjdk.org/browse/JDK-8350441) required changing the way ZGC handle memory uncommitting (returning physical memory to the OS). Previously ZGC tracked how recently used memory was on a ZPage level. [JDK-8350441](https://bugs.openjdk.org/browse/JDK-8350441) did away with the ZPage abstraction for unused memory. But because of this ZGC does not have a convenient way of tracking the usage of a specific memory range. Instead [JDK-8350441](https://bugs.openjdk.org/browse/JDK-8350441) opted to keep a watermark in the cache unused mapped memory, to keep track of the amount of memory that was not used within the last ZUncommitDelay, and use this when deciding how much to uncommit.
>> 
>> Because this measurement is not as granular as previously, and because uncommitting memory is something we want to do conservatively, as a response to low memory utilization, [JDK-8350441](https://bugs.openjdk.org/browse/JDK-8350441) was written with the intent to spread out the uncommitting over some time interval.
>> 
>> The actual implementation in [JDK-8350441](https://bugs.openjdk.org/browse/JDK-8350441) has a few issues which this RFE tries to address:
>>   * Missing wait, the uncommitting is not actually spread out, but happens all at once.
>>   * Reactivity, if the process starts using memory that was below the previous watermark, uncommitting should stop.
>>   * Structure, the current implementation has a lot of different dependencies and has state spread out over multiple classes. Refactor to keep the logic contained to the ZUncommitter, and provide better named facilitating functions on the ZPartition and ZMappedCache. And make the lifecycle of ZUncommitter more explicit.
>>   * Events, overhaul the JFR uncommit events to be sent (and track the time for) a chunk of uncommits without any waits.
>> 
>> An alternative discussed has been to do uncommitting based on GC triggers rather than a periodically. So rather than using ZUncommitDelay, we could have our proactive GCs actually trigger and track uncommitting. This might be a future RFE, but it was not attempted here as it would change user facing APIs. [JDK-8329758](https://bugs.openjdk.org/browse/JDK-8329758) will more than likely overhaul the uncommit triggers as well, and the whole concept of ZUncommitDelay and having to tune how to uncommit will go away.
>
> Axel Boldt-Christmas has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 31 commits:
> 
>  - Merge remote-tracking branch 'upstream_jdk/master' into JDK-8356716
>  - Check termination before deactivate
>  - Merge remote-tracking branch 'upstream_jdk/master' into JDK-8356716
>  - Extract update_statistics
>  - Rename uncommit_watermark to min_size_watermark
>  - Reduce the amount of should_continue checks
>  - Update src/hotspot/share/gc/z/zUncommitter.cpp
>    
>    Co-authored-by: Joel Sikström <joel.sikstrom at oracle.com>
>  - Avoid excessive logging if ZUncommitDelay == 0
>  - Move uncommit logic from MappedCache to Uncommitter + cleanup and comment
>  - Better cycle activate / deactivate scoping
>  - ... and 21 more: https://git.openjdk.org/jdk/compare/832c5b06...9ae37064

Marked as reviewed by eosterlund (Reviewer).

-------------

PR Review: https://git.openjdk.org/jdk/pull/25198#pullrequestreview-2891035578


More information about the hotspot-gc-dev mailing list