Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] posix_memalign, memalign, valloc - Allocation de mémoire alignée. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <stdlib.h>[/b] [b][i]int posix_memalign(void ** memptr , size_t alignment , size_t size );[/i][/b] [b][i]void memalign(size_t boundary , size_t size );[/i][/b] [b][i]void valloc(size_t size );[/i][/b] .nl .fi [size=18] [b]Description[/b] [/size] La fonction [b]posix_memalign()[/b] alloue [i]size[/i] octets et place l'adresse de la mémoire allouée dans [b]memptr.[/b] L'adresse de la mémoire allouée est un multiple de [b]alignment,[/b] qui doit lui même être une puissance de deux et un multiple de [b]sizeof(void ).[/b] La fonction obsolète [b]memalign()[/b] alloue [i]size[/i] octets et renvoie un pointeur vers la mémoire allouée. L'adresse mémoire est alors un multiple de [b]boundary,[/b] qui doit être une puissance de deux. La fonction obsolète [b]valloc()[/b] alloue [i]size[/i] octets et renvoie un pointeur vers la mémoire allouée. L'adresse mémoire est alors un multiple de la taille de page. Cette fonction est équivalente à [b]memalign(sysconf(_SC_PAGESIZE),size) .[/b] Pour ces trois routines, la mémoire n'est pas initialisée à zéro. [size=18] [b]Valeur renvoyée[/b] [/size] [b]memalign()[/b] et [b]valloc()[/b] renvoient un pointeur sur la mémoire allouée, ou bien [b]NULL[/b] si la requête échoue. [b]posix_memalign()[/b] renvoie zéro en cas de succès, ou l'une des valeurs d'erreurs répertoriées dans la section suivante en cas d'échec. Notez que [b]errno[/b] n'est pas affectée par cette fonction. [size=18] [b]Erreurs[/b] [/size] [b]EINVAL[/b] [table][row][col]    [/col][col]Le paramètre [b]alignment[/b] n'est pas une puissance de deux, ou n'est pas un multiple de [b]sizeof(void *) .[/b][/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Mémoire insuffisante pour réaliser la demande d'allocation. [/col][/row][/table] [size=18] [b]Notes[/b] [/size] [b]posix_memalign()[/b] vérifie que [b]alignment[/b] répond bien aux exigences détaillées ci dessus. [b]memalign()[/b] est susceptible de ne pas contrôler que le paramètre [b]boundary[/b] est correct. La norme POSIX impose que la mémoire obtenue par un appel à [b]posix_memalign()[/b] puisse être libérée en utilisant [b]free ().[/b] Certains systèmes ne fournissent aucun moyen afin de libérer la mémoire allouée par [b]memalign ()[/b] ou [b]valloc ()[/b] (parce que l'on peut seulement passer comme paramètre à [b]free ()[/b] un pointeur obtenu via [b]malloc (),[/b] Alors que e.g. [b]memalign ()[/b] pourrait appeler [b]malloc ()[/b] et aligner par la suite la valeur obtenue). La libc GNU permet de libérer la mémoire obtenue par n'importe laquelle de ces trois fonctions par appel à [b]free ().[/b] La version libc GNU de [b]malloc()[/b] renvoie toujours des adresses mémoire alignées sur 8-octets, ainsi ces routines ne sont nécessaires qu'en cas de besoin de valeurs d'alignement plus grandes. [size=18] [b]Historique[/b] [/size] Les fonctions [b]memalign ()[/b] et [b]valloc ()[/b] sont disponibles dans toutes les bibliothèques libc de Linux. La fonction [b]posix_memalign ()[/b] est disponible depuis la glibc 2.1.91. [size=18] [b]Conformité[/b] [/size] La fonction [b]valloc ()[/b] est apparue dans BSD 3.0. Elle est qualifiée d'obsolète dans BSD 4.3, et de légende dans SUSv2. Elle n'apparaît plus dans SUSv3. La fonction [b]memalign ()[/b] est apparue dans SunOS 4.1.3 mais pas dans BSD 4.4. La fonction [b]posix_memalign()[/b] provient de POSIX 1003.1d. [size=18] [b]Voir aussi[/b] [/size] [b]malloc (3),[/b] [b]free (3),[/b] [b]getpagesize(2),[/b] [b]brk (2)[/b] [size=18] [b]Traduction[/b] [/size] Stéphan Rafin, 2002.
Fichier