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.

STANDARDS

GNU.

VERSIONEN

Glibc 2.0.

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 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.