Package ch.bailu.gtk.gio
Class MemoryMonitor
java.lang.Object
ch.bailu.gtk.type.Type
ch.bailu.gtk.type.Pointer
ch.bailu.gtk.gobject.Object
ch.bailu.gtk.type.Interface
ch.bailu.gtk.gio.MemoryMonitor
- All Implemented Interfaces:
PointerInterface
#GMemoryMonitor will monitor system memory and suggest to the application
when to free memory so as to leave more room for other applications.
It is implemented on Linux using the [Low Memory Monitor](https://gitlab.freedesktop.org/hadess/low-memory-monitor/)
([API documentation](https://hadess.pages.freedesktop.org/low-memory-monitor/)).
There is also an implementation for use inside Flatpak sandboxes.
Possible actions to take when the signal is received are:
- Free caches
- Save files that haven't been looked at in a while to disk, ready to be reopened when needed
- Run a garbage collection cycle
- Try and compress fragmented allocations
- Exit on idle if the process has no reason to stay around
- Call [`malloc_trim(3)`](man:malloc_trim) to return cached heap pages to
the kernel (if supported by your libc)
Note that some actions may not always improve system performance, and so
should be profiled for your application. `malloc_trim()`, for example, may
make future heap allocations slower (due to releasing cached heap pages back
to the kernel).
See #GMemoryMonitorWarningLevel for details on the various warning levels.
Don't forget to disconnect the #GMemoryMonitor::low-memory-warning
signal, and unref the #GMemoryMonitor itself when exiting.
when to free memory so as to leave more room for other applications.
It is implemented on Linux using the [Low Memory Monitor](https://gitlab.freedesktop.org/hadess/low-memory-monitor/)
([API documentation](https://hadess.pages.freedesktop.org/low-memory-monitor/)).
There is also an implementation for use inside Flatpak sandboxes.
Possible actions to take when the signal is received are:
- Free caches
- Save files that haven't been looked at in a while to disk, ready to be reopened when needed
- Run a garbage collection cycle
- Try and compress fragmented allocations
- Exit on idle if the process has no reason to stay around
- Call [`malloc_trim(3)`](man:malloc_trim) to return cached heap pages to
the kernel (if supported by your libc)
Note that some actions may not always improve system performance, and so
should be profiled for your application. `malloc_trim()`, for example, may
make future heap allocations slower (due to releasing cached heap pages back
to the kernel).
See #GMemoryMonitorWarningLevel for details on the various warning levels.
<!-- language="C" --> static void warning_cb (GMemoryMonitor *m, GMemoryMonitorWarningLevel level) { g_debug ("Warning level: %d", level); if (warning_level > G_MEMORY_MONITOR_WARNING_LEVEL_LOW) drop_caches (); } static GMemoryMonitor * monitor_low_memory (void) { GMemoryMonitor *m; m = g_memory_monitor_dup_default (); g_signal_connect (G_OBJECT (m), "low-memory-warning", G_CALLBACK (warning_cb), NULL); return m; }
Don't forget to disconnect the #GMemoryMonitor::low-memory-warning
signal, and unref the #GMemoryMonitor itself when exiting.
-
Nested Class Summary
Nested classes/interfaces inherited from class ch.bailu.gtk.gobject.Object
Object.OnBindingTransformFunc, Object.OnDestroyNotify, Object.OnDuplicateFunc, Object.OnNotify, Object.OnToggleNotify, Object.OnWeakNotify
-
Field Summary
Fields inherited from class ch.bailu.gtk.gobject.Object
SIGNAL_ON_NOTIFY
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic MemoryMonitor
Gets a reference to the default #GMemoryMonitor for the system.static ClassHandler
static int
static long
static TypeSystem.TypeSize
static long
static TypeSystem.TypeSize
Connect to signal "low-memory-warning".Methods inherited from class ch.bailu.gtk.gobject.Object
addToggleRef, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, disconnect, disconnect, dupData, dupData, dupQdata, forceFloating, freezeNotify, get, get, getData, getData, getProperty, getProperty, getQdata, interfaceFindProperty, interfaceInstallProperty, isFloating, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, replaceData, replaceData, replaceQdata, runDispose, set, set, setData, setData, setDataFull, setDataFull, setProperty, setProperty, setQdata, setQdataFull, stealData, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref
Methods inherited from class ch.bailu.gtk.type.Pointer
asCPointer, cast, connectSignal, disconnectSignals, disconnectSignals, equals, hashCode, throwIfNull, throwNullPointerException, toString, unregisterCallbacks, unregisterCallbacks
Methods inherited from class ch.bailu.gtk.type.Type
asCPointer, asCPointer, asCPointerNotNull, asJnaPointer, asJnaPointer, asPointer, asPointer, cast, cast, throwIfNull
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface ch.bailu.gtk.type.PointerInterface
asCPointerNotNull, asJnaPointer, asPointer, isNotNull, isNull
-
Field Details
-
SIGNAL_ON_LOW_MEMORY_WARNING
- See Also:
-
-
Constructor Details
-
MemoryMonitor
-
-
Method Details
-
getClassHandler
-
onLowMemoryWarning
Connect to signal "low-memory-warning".
SeeMemoryMonitor.OnLowMemoryWarning.onLowMemoryWarning(int)
for signal description.
FieldSIGNAL_ON_LOW_MEMORY_WARNING
contains original signal name and can be used as resource reference.- Parameters:
signal
- callback function (lambda).- Returns:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
dupDefault
Gets a reference to the default #GMemoryMonitor for the system.- Returns:
- a new reference to the default #GMemoryMonitor
-
getTypeID
public static long getTypeID() -
getParentTypeID
public static long getParentTypeID() -
getTypeSize
-
getParentTypeSize
-
getInstanceSize
public static int getInstanceSize()
-