MALLOC(3)                 Manuel du programmeur Linux                MALLOC(3)
 
NOM
       malloc,  calloc, free, realloc - Allocation et libération dynamiques de
       mémoire.
 
SYNOPSIS
       #include <stdlib.h>
 
       void *calloc (size_t nmemb, size_t size);
       void *malloc (size_t size);
       void free (void *ptr);
       void *realloc (void *ptr, size_t size);
 
DESCRIPTION
       calloc() alloue la mémoire nécessaire pour un tableau  nmemb  éléments,
       chacun  d'eux  représentant size octets, et renvoie un pointeur vers la
       mémoire allouée.  Cette zone est remplie avec des zéros.
 
       malloc() alloue size octets, et renvoie  un  pointeur  sur  la  mémoire
       allouée.  Le contenu de la zone de mémoire n'est pas initialisé.
 
       free()  libère  l'espace  mémoire pointé par ptr, qui a été obtenu lors
       d'un appel antérieur à malloc(), calloc() ou realloc().  Si le pointeur
       ptr  n'a  pas  été  obtenu  par l'un de ces appels, ou si il a déjà été
       libéré avec free(), le comportement est indéterminé.  Si ptr est  NULL,
       aucune tentative de libération n'a lieu.
 
       realloc()  modifie  la  taille  du  bloc de mémoire pointé par ptr pour
       l'amener à une taille de size octets.  realloc() conserve le contenu de
       la zone mémoire minimum entre la nouvelle et l'ancienne taille. Le con-
       tenu de la zone de mémoire nouvellement allouée n'est  pas  initialisé.
       Si  ptr  est  NULL, l'appel de realloc() est équivalent à malloc(size).
       Si size vaut zéro, l'appel est équivalent à free(ptr).   Si  ptr  n'est
       pas  NULL,  il doit avoir été obtenu par un appel antérieur à malloc(),
       calloc() ou realloc().
 
VALEUR RENVOYÉE
       Pour calloc() et malloc(), la valeur renvoyée est un  pointeur  sur  la
       mémoire  allouée, qui est correctement alignée pour n'importe quel type
       de variable, ou NULL si la demande échoue.
 
       free() ne renvoie pas de valeur.
 
       realloc() renvoie un pointeur sur la mémoire nouvellement allouée,  qui
       est  correctement  alignée pour n'importe quel type de variable, et qui
       peut être différent de ptr, ou NULL si la demande échoue,  ou  si  size
       vaut  zéro. Si realloc() échoue, le bloc mémoire original reste intact,
       il n'est ni libéré ni déplacé.
 
CONFORMITÉ
       ANSI-C
 
VOIR AUSSI
       brk(2)
 
NOTES
       Le standard Unix98 réclame que malloc(), calloc(), et  realloc()  posi-
       tionne  errno  à  ENOMEM  en cas d'échec. La Glibc suppose qu'il en est
       ainsi (et les versions  glibc  de  cette  routine  le  font).  Si  vous
       utilisez une implémentation personnelle de malloc qui ne positionne pas
       errno, certaines routines de bibliothèques peuvent échouer sans  donner
       de raison dans errno.
 
       Lorsqu'un  programme  se plante durant un appel à malloc(), calloc() ou
       realloc(), ceci est presque toujours le signe d'une corruption  du  tas
       (zone de mémoire dans laquelle sont allouées les variables dynamiques).
       Ceci survient généralement en cas  de  débordement  d'un  bloc  mémoire
       alloué, ou en libérant deux fois le même pointeur.
 
       Les  versions récentes de la bibliothèque C de Linux (libc postérieures
       à 5.4.23) et la bibliothèque GNU libc 2.x incluent  une  implémentation
       de  malloc()  dont on peut configurer le comportement à l'aide de vari-
       ables d'environnement.  Quand la  variable  MALLOC_CHECK_  existe,  les
       appels à malloc() emploient une implémentation spéciale, moins efficace
       mais plus tolérante à l'encontre des bugs simples comme le double appel
       de  free() avec le même argument, ou un débordement de buffer d'un seul
       octet (bugs de surpassement d'une unité, ou oubli  d'un  caractère  nul
       final d'une chaîne).  Il n'est toutefois pas possible de pallier toutes
       les erreurs de ce type, et l'on risque de voir des fuites de mémoire se
       produire.
 
       Si  la  variable MALLOC_CHECK_ vaut zéro, toutes les corruptions du tas
       détectées sont ignorées silencieusement; Si elle vaut 1 un  message  de
       diagnostique est affiché sur stderr. Si cette variable vaut 2, la fonc-
       tion abort() est appelée immédiatement.  Ce  comportement  est  partic-
       ulièrement  utile  car  un crash pourrait sinon se produire ultérieure-
       ment, et serait très difficile à diagnostiquer.
 
TRADUCTION
       Christophe Blaess, 1997.
 
GNU                              9 Avril 1999                        MALLOC(3)