GC
Note: this API is unstable and may change in any release.
Kotlin/Native uses tracing garbage collector (GC) that is executed periodically to collect objects that are not reachable from the "roots", like local and global variables. See documentation to learn more about Kotlin/Native memory management.
This object provides a set of functions and properties that allows to tune garbage collector.
Legacy memory manager
Kotlin/Native relies upon reference counting for object management, however it could not collect cyclical garbage, so we perform periodic garbage collection. This may slow down application, so this interface provides control over how garbage collector activates and runs. Garbage collector can be in one of the following states:
running
suspended (so cycle candidates are collected, but GC is not performed until resume)
stopped (all cyclical garbage is hopelessly lost) Immediately after startup GC is in running state. Depending on application needs it may select to suspend GC for certain phases of its lifetime, and resume it later on, or just completely turn it off, if GC pauses are less desirable than cyclical garbage leaks.
Since Kotlin
1.9Types
This objects allows to customize the behavior of the finalizer processor that runs on the main thread.
Properties
The GC is scheduled when Kotlin heap overflows heapTriggerCoefficient * targetHeapBytes.
Returns statistics of the last finished garbage collection run. This information is supposed to be used for testing and debugging purposes only
The maximum value for targetHeapBytes. Only used if autotune is true. See targetHeapBytes for more details.
The minimum value for targetHeapBytes Only used if autotune is true. See targetHeapBytes for more details.
If true, the GC will pause Kotlin threads when Kotlin heap overflows targetHeapBytes and will resume them only after current GC is done.
When Kotlin code is not allocating enough to trigger GC, the GC scheduler uses timer to drive collection. Timer-triggered collection will happen roughly in regularGCInterval .. 2 * regularGCInterval since any previous collection.
Total amount of heap available for Kotlin objects. The GC tries to schedule execution so that Kotlin heap doesn't overflow this heap. Automatically adjusts when autotune is true: after each collection the targetHeapBytes is set to heapBytes / targetHeapUtilization and capped between minHeapBytes and maxHeapBytes, where heapBytes is heap usage after the garbage is collected. Note, that if after a collection heapBytes targetHeapBytes (which may happen if autotune is false, or maxHeapBytes is set too low), the next collection will be triggered almost immediately.
What fraction of the Kotlin heap should be populated. Only used if autotune is true. See targetHeapBytes for more details.