BEZEICHNUNG

       alloca - Speicher reservieren, der automatisch freigegeben wird

ÜBERSICHT

       #include <alloca.h>

       void *alloca( size_t groesse);

BESCHREIBUNG

       Die  Funktion  alloca()  reserviert  groesse  Byte auf dem Stapelspeicher des Aufrufenden.
       Dieser temporäre Bereich wird automatisch freigegeben, wenn  die  Funktion,  die  alloca()
       aufrief, zum Aufrufenden zurückkehrt.

RÜCKGABEWERT

       Die  Funktion  alloca() gibt einen Zeiger auf den Anfang des reservierten Bereichs zurück.
       Falls das Reservieren einen Überlauf des Stapelspeichers verursachte,  ist  das  Verhalten
       des Programms undefiniert.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

       ┌──────────────┬───────────────────────┬─────────┐
       │Schnittstelle │ Attribut              │ Wert    │
       ├──────────────┼───────────────────────┼─────────┤
       │alloca()      │ Multithread-Fähigkeit │ MT-Safe │
       └──────────────┴───────────────────────┴─────────┘

KONFORM ZU

       Diese Funktion ist nicht in POSIX.1 enthalten.

       Es  ist  bekannt,  dass die Funktion alloca() in 32V, PWB, BWB.2, 3BSD und 4BSD erschienen
       ist. Es gibt unter 4.3BSD eine Handbuchseite dafür. Linux verwendet die GNU-Version.

ANMERKUNGEN

       Die Funktion alloca() ist maschinen- und compilerabhängig. Für bestimmte Anwendungen  kann
       ihre  Benutzung  die Leistungsfähigkeit im Vergleich zu malloc(3) plus free(3) erhöhen. In
       bestimmten  Fällen  kann  sie  außerdem  das  Freigeben  von   Speicher   in   Anwendungen
       vereinfachen,  die  longjmp(3)  oder  siglongjmp(3)  benutzen.  Andernfalls wird von ihrem
       Gebrauch abgeraten.

       Da der durch alloca() reservierte Bereich innerhalb des Stapelspeichers liegt, wird dieser
       Bereich   automatisch  freigegeben,  wenn  die  Funktionsrückkehr  durch  den  Aufruf  von
       longjmp(3) oder siglongjmp(3) übersprungen wird.

       Der mittels alloca() reservierte Bereich wird nicht  automatisch  freigegeben,  falls  der
       Zeiger, der sich darauf bezieht, den Geltungsbereich verlässt.

       Versuchen Sie nicht, mit free(3) Speicher freizugeben, der mit alloca() reserviert wurde!

   Bemerkungen zur GNU-Version
       Normalerweise übersetzt gcc(1) Aufrufe von alloca() mit »Inlined-Code«. Dies ist nicht so,
       wenn entweder die Option -ansi, -std=c89, -std=c99 oder -std=c11 angegeben und der  Header
       <alloca.h>  nicht eingebunden ist. Andernfalls (ohne Option -ansi oder -std=c*) bindet die
       Glibc-Version von <stdlib.h> <alloca.h> ein und dieser Header enthält die Zeilen

           #ifdef  __GNUC__
           #define alloca(size)   __builtin_alloca (size)
           #endif

       mit chaotischen Konsequenzen, wenn jemand eine private Version dieser Funktion hat.

       Die Tatsache, dass der Code inlined ist, bedeutet,  dass  es  unmöglich  ist  die  Adresse
       dieser  Funktion  zu  bekommen  oder  ihr  Verhalten  zu  ändern,  indem mit einer anderen
       Bibliothek gelinkt wird.

       Der  »Inlined-Code«  besteht  oft  aus  einer  einzelnen  Anweisung   zum   Anpassen   des
       Stapelspeicher-Zeigers  und  prüft  nicht,  ob ein Stapelspeicher-Überlauf auftritt. Daher
       gibt es dort keine NULL-Fehler-Rückkehr.

FEHLER

       Es gibt keine Fehleranzeige, wenn der Stapelspeicher nicht  erweitert  werden  kann.  (Das
       Programm   wird   jedoch  wahrscheinlich  nach  einer  fehlgeschlagenen  Reservierung  ein
       SIGSEGV-Signal  empfangen,  wenn  es  versucht  auf  den   nicht   reservierten   Speicher
       zuzugreifen.)

       Auf  vielen  Systemen  kann  alloca()  nicht  innerhalb der Argumenteliste der aufrufenden
       Funktion benutzt werden, weil der durch alloca() reservierte Bereich  des  Stapelspeichers
       in der Mitte des Bereichs für die Funktionsarumente liegen würde.

SIEHE AUCH

       brk(2), longjmp(3), malloc(3)

KOLOPHON

       Diese  Seite  ist  Teil  der  Veröffentlichung  5.03  des  Projekts  Linux-man-pages. Eine
       Beschreibung des Projekts, Informationen, wie Fehler  gemeldet  werden  können  sowie  die
       aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die  deutsche Übersetzung dieser Handbuchseite wurde von Ralf Demmer <rdemmer@rdemmer.de>,
       Chris Leick <c.leick@vollbio.de>,  Mario  Blättermann  <mario.blaettermann@gmail.com>  und
       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 <debian-l10n-german@lists.debian.org>.