malloc_trim(3)

BEZEICHNUNG
malloc_trim - Freien Speicher vom Heap freigeben

BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT
#include <malloc.h>

int malloc_trim(size_t Block);

BESCHREIBUNG
Die Funktion malloc_trim() versucht, freien Speicher vom Heap freizugeben (durch Aufruf von sbrk(2) oder madvise(2) mit geeigneten Argumenten).

Das Argument Block legt die Menge von freiem Speicher fest, die oben beim Heap unbeschnitten bleiben soll. Falls dieses Argument 0 ist, wird nur die minimale Menge oben am Heap belassen (d.h. nur eine Seite oder weniger). Ein von Null verschiedenes Argument kann dazu verwandt werden, etwas nachlaufenden Platz oben am Heap zu belassen, um zukünftige Belegungen zu ermöglichen, ohne den Heap mit sbrk(2) erweitern zu müssen.

RÜCKGABEWERT
Die Funktion malloc_trim() liefert 1 zurück, falls Speicher tatsächlich dem System zurückgegeben wurde oder 0, falls es nicht möglich war, Speicher freizugeben.

FEHLER
Es sind keine Fehler definiert.

ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
Schnittstelle | Attribut | Wert
malloc_trim() | Multithread-Fähigkeit | MT-Safe

STANDARDS
Diese Funktion ist eine GNU-Erweiterung.

ANMERKUNGEN
Nur der Haupt-Heap (mittels sbrk(2)) berücksichtigt das Argument Block; Thread-Heaps machen dies nicht.

Seit Glibc 2.8 gibt diese Funktion Speicher in allen Arenen und in allen Stücken mit vollständigen freien Seiten frei.

Vor Glibc 2.8 gab diese Funktion nur Speicher am Anfang des Heaps in der Haupt-Arena frei.

SIEHE AUCH
sbrk(2), malloc(3), mallopt(3)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer (debian-l10n-german@lists.debian.org).