.\" -*- coding: UTF-8 -*- .\" Copyright (c) 2012 by Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH mallopt 3 "2 mai 2024" "Pages du manuel de Linux 6.8" .SH NOM mallopt \- Définir les paramètres d'allocation de mémoire .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .P \fBint mallopt(int \fP\fIparam\fP\fB, int \fP\fIvalue\fP\fB);\fP .fi .SH DESCRIPTION La fonction \fBmallopt\fP() ajuste les paramètres qui contrôlent le comportement des fonctions liées à l'allocation de mémoire (voir \fBmalloc\fP(3)). Le paramètre \fIparam\fP indique le paramètre à modifier, et \fIvalue\fP indique la nouvelle valeur pour ce paramètre. .P Les valeurs suivantes peuvent être assignées à \fIparam\fP : .TP \fBM_ARENA_MAX\fP Si ce paramètre à une valeur non nulle, il définit une limite dure sur le nombre maximal d'arènes qui peuvent être créées. Une arène représente une réserve de mémoire qui peut être utilisée par des appels à \fBmalloc\fP(3) (et fonctions similaires) pour répondre à des requêtes d'allocation. Les arènes sont sécurisées vis\-à\-vis des fils d'exécution et peuvent répondre à de multiples requêtes concurrentes. Un compromis est à trouver entre le nombre de fils d'exécution et le nombre d'arènes. Plus il y a d'arènes et plus la compétition par fil d'exécution est basse au détriment d'une consommation mémoire plus élevée. .IP La valeur par défaut de ce paramètre est \fI0\fP, ce qui signifie que la limite du nombre d'arènes est déterminée conformément à la valeur de \fBM_ARENA_TEST\fP. .IP Ce paramètre est disponible depuis la glibc 2.10 à l’aide de \fB\-\-enable\-experimental\-malloc\fP, et par défaut depuis la glibc 2.15. Dans certaines versions de l’allocateur il n'y avait pas de limite sur le nombre d'arènes créées (sur CentOS 5 et RHEL 5 par exemple). .IP Lors de l'utilisation de versions plus récentes de la glibc, les applications peuvent dans certains cas faire preuve d’une grande compétition lors de l'accès aux arènes. Dans ces cas, il peut être bénéfique d'augmenter \fBM_ARENA_MAX\fP pour la faire correspondre au nombre de fils d'exécution. Il s'agit d'un comportement similaire aux stratégies appliquées par tcmalloc et jemalloc (à des réserves d'allocation par fil d'exécution par exemple). .TP \fBM_ARENA_TEST\fP Ce paramètre définit, en nombre d'arènes créées, la valeur pour laquelle la configuration du système sera examinée afin de déterminer une limite dure sur le nombre d'arènes créées. Consultez \fBM_ARENA_MAX\fP pour la définition d'une arène. .IP Le calcul de la limite dure du nombre d'arènes est définit par l'implémentation et est généralement un multiple du nombre de CPU disponibles. Le résultat est définitif une fois la limite dure calculée, et il contraint le nombre total d'arènes. .IP La valeur par défaut du paramètre \fBM_ARENA_TEST\fP est 2 sur les systèmes où \fIsizeof(long)\fP vaut 4 ; autrement, la valeur par défaut est 8. .IP Ce paramètre est disponible depuis la glibc 2.10 à l’aide de \fB\-\-enable\-experimental\-malloc\fP, et par défaut depuis la glibc 2.15. .IP La valeur de \fBM_ARENA_TEST\fP n'est pas utilisée lorsque \fBM_ARENA_MAX\fP a une valeur non nulle. .TP \fBM_CHECK_ACTION\fP Ce paramètre contrôle le comportement de la glibc lorsque des erreurs de programmation sont détectées (par exemple, lors qu'un pointeur est libéré plusieurs fois). Les 3 bits de poids faible (bits 2, 1 et 0) de cette valeur ont les significations suivantes : .RS .TP Bit 0 Lorsque ce bit est positionné, un message d'une ligne détaillant l'erreur est affiché sur \fIstderr\fP. Le message commence par la chaîne "***\ glibc detected\ ***", suivi par le nom du programme, le nom de la fonction de l'allocation mémoire qui a détecté l'erreur, une brève description de l'erreur, puis l'adresse mémoire où l'erreur a été détectée. .TP Bit 1 Lorsque ce bit est positionné, après avoir affiché un message d'erreur configuré par le bit 0, le programme est terminé en appelant \fBabort\fP(3). Depuis la glibc 2.4, si le bit 0 est également positionné, alors le programme affiche également — entre l'affichage d'un message d'erreur et l'abandon du programme — l'état de la pile à la manière de \fBbacktrace\fP(3) et les projections en mémoire du processus à la manière de \fI/proc/\fPpid\fI/maps\fP (voir \fBproc\fP(5)). .TP Bit 2 (depuis la glibc 2.4) Ce bit a un effet uniquement si le bit 0 est également positionné. Lorsqu'il est positionné, alors le message d'erreur d'une ligne décrivant l'erreur est simplifié et contient uniquement le nom de la fonction où l'erreur a été détectée ainsi qu'une brève description de l'erreur. .RE .IP Les autres bits de \fIvalue\fP sont ignorés. .IP La combinaison des bits décrits ci\-dessus permet de configurer \fBM_CHECK_ACTION\fP avec les valeurs suivantes : .RS 12 .TP \fB0\fP Ignorer les erreurs et continuer l'exécution (sans résultats définis). .TP \fB1\fP Afficher un message d'erreur détaillé et continuer l'exécution. .TP \fB2\fP Interrompre le programme. .TP \fB3\fP Afficher un message d'erreur détaillé, l'état de la pile et des projections en mémoire, puis interrompre le programme. .TP \fB5\fP Afficher un message d'erreur simple et continuer l'exécution. .TP \fB7\fP Afficher un message d'erreur simple, l'état de la pile et des projections en mémoire, puis interrompre le programme. .RE .IP Depuis la glibc 2.3.4, \fBM_CHECK_ACTION\fP a pour valeur par défaut 3. Dans la glibc 2.3.3 et antérieures, la valeur par défaut est 1). .IP Il est recommandé d'utiliser une valeur \fBM_CHECK_ACTION\fP non nulle, car sinon l'arrêt impromptu du programme risque d'être différé, ce qui rend très difficile de retrouver l'origine du problème. .TP \fBM_MMAP_MAX\fP .\" The following text adapted from comments in the glibc source: Ce paramètre indique le nombre maximal de requêtes d'allocation qui peuvent être servies simultanément avec \fBmmap\fP(2). Il permet de préserver les performances de certains systèmes qui ont un nombre limité de tables internes à disposition de \fBmmap\fP(2). .IP La valeur par défaut est 65 536, valeur qui n'a pas de sens particulier mais sert seulement de protection. Configurer ce paramètre à 0 désactive l'utilisation de \fBmmap\fP(2) pour servir de grandes requêtes d'allocation. .TP \fBM_MMAP_THRESHOLD\fP Lorsqu'une requête d'allocation supérieure ou égale au seuil \fBM_MMAP_THRESHOLD\fP (en octets) ne peut être satisfaite depuis la liste de blocs libres, les fonctions d'allocation de mémoire utilisent \fBmmap\fP(2) plutôt que d'augmenter la taille du segment de données avec \fBsbrk\fP(2). .IP Allouer de la mémoire avec \fBmmap\fP(2) permet toujours aux blocs de mémoire alloués d'être rendus de manière indépendante au système. Cela représente un avantage significatif comparé au tas qui ne peut être désalloué que si la mémoire est libérée par le haut. D'autre part, il y a certains inconvénients à utiliser \fBmmap\fP(2) : l'espace désalloué n'est pas considéré comme libéré, l'empêchant d'être réutilisé pour de futures allocations ; de la mémoire peut être gaspillée car les allocations à l’aide de \fBmmap\fP(2) doivent être alignées sur une taille de page ; et le noyau doit effectuer la tâche coûteuse de remise à zéro de la mémoire allouée par \fBmmap\fP(2). Trouver un compromis entre ces effets mène à une valeur du paramètre \fBM_MMAP_THRESHOLD\fP par défaut à 128*1024. .IP La limite basse de ce paramètre est 0. La limite haute est \fBDEFAULT_MMAP_THRESHOLD_MAX\fP : c'est\-à\-dire 512*1024 sur les systèmes 32 bits ou \fI4*1024*1024*sizeof(long)\fP sur les systèmes 64 bits. .IP \fINote\fP : de nos jours, la glibc configure ce seuil dynamiquement. La valeur initiale est 128*1024, mais lorsque sont libérés des blocs de taille supérieure au seuil mais inférieure ou égale à \fBDEFAULT_MMAP_THRESHOLD_MAX\fP, le seuil est ajusté à la taille du bloc libéré. Quand le mécanisme de seuil dynamique est activé, le seuil de désallocation du tas est également configuré dynamiquement à deux fois le seuil mmap. L'ajustement dynamique du seuil mmap est désactivé dès lors qu'un des paramètres \fBM_TRIM_THRESHOLD\fP, \fBM_TOP_PAD\fP, \fBM_MMAP_THRESHOLD\fP, ou \fBM_MMAP_MAX\fP est configuré. .TP \fBM_MXFAST\fP (depuis glibc 2.3) .\" The following text adapted from comments in the glibc sources: Définir la limite supérieure (en octets) pour les requêtes d'allocation mémoire qui sont satisfaites en utilisant des «\ fastbins\ ». Les «\ fastbins\ » sont des espaces de stockage qui contiennent des blocs de mémoire désalloués de même taille, sans fusion des blocs libres adjacents. La réallocation ultérieure de blocs de cette taille peut être effectuée très rapidement en allouant à partir du «\ fastbin \», bien que d'un autre côté la fragmentation de la mémoire et l'empreinte mémoire totale du programme puissent augmenter. .IP La valeur par défaut de ce paramètre est \fI64*sizeof(size_t)/4\fP (c'est\-à\-dire \fI64\fP sur les architectures 32 bits). La plage de ce paramètre va de \fI0\fP à \fI80*sizeof(size_t)/4\fP. Fixer \fBM_MXFAST\fP à \fI0\fP désactive l'utilisation des « fastbins ». .TP \fBM_PERTURB\fP (depuis glibc 2.4) Si ce paramètre est configuré à une valeur non nulle, tous les octets de mémoire allouée (autrement qu'avec \fBcalloc\fP(3)) sont initialisés au complément de la valeur de l'octet le moins significatif de \fIvalue\fP. Lorsque la mémoire allouée est libérée avec \fBfree\fP(3), les octets libérés prennent tous la valeur de l'octet le moins significatif de \fIvalue\fP. Cette fonctionnalité permet de détecter des erreurs lorsque les programmes supposent que la mémoire allouée a été initialisée à zéro, ou réutilisent des valeurs depuis une zone mémoire précédemment libérée. .IP La valeur par défaut de ce paramètre est 0. .TP \fBM_TOP_PAD\fP Ce paramètre définit la quantité en octets de bourrage à utiliser lors de l'appel à \fBsbrk\fP(2) pour modifier la taille du segment de données. Ce paramètre a un effet dans les circonstances suivantes\ : .RS .IP \- 3 Lorsque la taille du segment de données est augmentée, \fBM_TOP_PAD\fP octets sont ajoutés à la requête \fBsbrk\fP(2). .IP \- Lorsque le tas est désalloué suite à l'appel \fBfree\fP(3) (voir \fBM_TRIM_THRESHOLD\fP), cet espace supplémentaire est préservé en haut du tas. .RE .IP Dans tous les cas, la quantité de bourrage est toujours arrondie à la taille d'une page système. .IP La valeur \fBM_TOP_PAD\fP résulte d'un compromis entre l'augmentation du nombre d'appels système (avec une valeur faible) et le gaspillage de mémoire inutilisée en haut du tas (avec une valeur élevée). .IP .\" DEFAULT_TOP_PAD in glibc source La valeur par défaut de ce paramètre est 128*1024. .TP \fBM_TRIM_THRESHOLD\fP Lorsque la quantité de mémoire libre et contigüe en haut du tas dépasse ce seuil, \fBfree\fP(3) utilise \fBsbrk\fP(2) pour rendre cette mémoire au système d'exploitation. (Cela peut être utile pour les programmes qui sont exécutés encore longtemps après avoir libéré une quantité importante de mémoire.)Le paramètre \fBM_TRIM_THRESHOLD\fP indique la taille minimale (en octet) que ce bloc de mémoire doit atteindre avant que \fBsbrk\fP(2) ne soit utilisé pourréduire le tas. .IP La valeur par défaut de ce paramètre est 128*1024, en octets. Une valeur de \fB\-1\fP désactive complètement la désallocation. .IP .\" La valeur \fBM_TRIM_THRESHOLD\fP résulte d'un compromis entre l'augmentation du nombre d'appels système (avec une valeur faible) et le gaspillage de mémoire inutilisée en haut du tas (avec une valeur élevée). .SS "Variables d'environnement" Un certain nombre des paramètres de \fBmallopt\fP() peuvent être modifiés à travers de variables d'environnement. Ces variables ont l'avantage de ne pas nécessiter la modification du code source du programme. Pour être prises en compte, ces variables doivent être définies avant le premier appel à une fonction d'allocation mémoire. Les paramètres passés par la fonction \fBmallopt\fP() sont prioritaires devant ceux issus des variables d'environnement. Pour des raisons de sécurité, ces variables sont ignorées dans le cas de programmes \fIsetuid\fP ou \fIsetgid\fP. .P Les variables d'environnement sont les suivantes (notez le caractère de soulignement (« underscore ») qui les termine) : .TP \fBMALLOC_ARENA_MAX\fP Contrôle du même paramètre que \fBM_ARENA_MAX\fP de \fBmallopt\fP(). .TP \fBMALLOC_ARENA_TEST\fP Contrôle du même paramètre que \fBM_ARENA_TEST\fP de \fBmallopt\fP(). .TP \fBMALLOC_CHECK_\fP .\" On glibc 2.12/x86, a simple malloc()+free() loop is about 70% slower .\" when MALLOC_CHECK_ was set. Cette variable d'environnement contrôle le même paramètre que \fBM_CHECK_ACTION\fP de \fBmallopt\fP(). Si elle est configurée à une valeur non nulle, une mise en œuvre spécifique des fonctions d'allocation mémoire est utilisée, grâce à la fonctionnalité \fBmalloc_hook\fP(3). Cette mise en œuvre effectue des vérifications d'erreurs supplémentaires, au prix d'un ralentissement par rapport au jeu standard de fonctions d'allocation mémoire. Cependant, elle ne détecte pas toutes les erreurs possibles : des fuites mémoires peuvent encore se produire. .IP La valeur de cette variable d'environnement doit être un seul chiffre, dont le sens est comme décrit pour \fBM_CHECK_ACTION\fP. Tout caractère au\-delà du premier chiffre est ignoré. .IP Pour des raisons de sécurité, \fBMALLOC_CHECK_\fP est ignoré par défaut dans le cas de programmes \fIsetuid\fP ou \fIsetgid\fP. Cependant, si le fichier \fI/etc/suid\-debug\fP existe (peu importe son contenu), alors la valeur de \fBMALLOC_CHECK_\fP est prise en compte pour les programmes \fIsetuid\fP ou \fIsetgid\fP. .TP \fBMALLOC_MMAP_MAX_\fP Contrôle du même paramètre que \fBM_MMAP_MAX\fP de \fBmallopt\fP(). .TP \fBMALLOC_MMAP_THRESHOLD_\fP Contrôle du même paramètre que \fBM_MMAP_THRESHOLD\fP de \fBmallopt\fP(). .TP \fBMALLOC_PERTURB_\fP Contrôle du même paramètre que \fBM_PERTURB\fP de \fBmallopt\fP(). .TP \fBMALLOC_TRIM_THRESHOLD_\fP Contrôle du même paramètre que \fBM_TRIM_THRESHOLD\fP de \fBmallopt\fP(). .TP \fBMALLOC_TOP_PAD_\fP Contrôle du même paramètre que \fBM_TOP_PAD\fP de \fBmallopt\fP(). .SH "VALEUR RENVOYÉE" En cas de succès, \fBmallopt\fP() renvoie \fB1\fP. En cas d'erreur, il renvoie \fB0\fP. .SH ERREURS En cas d'erreur, \fIerrno\fP n'est pas positionné. .SH VERSIONS Une fonction similaire existe sur de nombreux dérivés de System V, mais les valeurs permises de \fIparam\fP varient d'un système à l'autre. SVID définit les options \fBM_MXFAST\fP, \fBM_NLBLKS\fP, \fBM_GRAIN\fP et \fBM_KEEP\fP, mais seule la première d'entre elles est disponible dans la glibc. .SH STANDARDS Aucun. .SH HISTORIQUE glibc 2.0. .SH BOGUES Indiquer une valeur non valable pour \fIparam\fP ne génère pas d'erreur. .P .\" FIXME . This looks buggy: .\" setting the M_MXFAST limit rounds up: (s + SIZE_SZ) & ~MALLOC_ALIGN_MASK) .\" malloc requests are rounded up: .\" (req) + SIZE_SZ + MALLOC_ALIGN_MASK) & ~MALLOC_ALIGN_MASK .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=12129 Une erreur de calcul dans la mise en œuvre glibc implique qu'un appel de la forme suivante : .P .in +4n .EX mallopt(M_MXFAST, n) .EE .in .P .\" Bins are multiples of 2 * sizeof(size_t) + sizeof(size_t) n'active pas les « fastbins » pour toutes les allocations d'une taille jusqu'à \fIn\fP. Pour obtenir l'effet attendu, \fIn\fP doit être arrondi à un multiple supérieur ou égal à \fI(2k+1)*sizeof(size_t)\fP, où \fIk\fP est un entier. .P .\" FIXME . https://www.sourceware.org/bugzilla/show_bug.cgi?id=12140 Si \fBmallopt\fP() est utilisé pour configurer \fBM_PERTURB\fP, tous les octets de mémoire alloués sont initialisés au complément de \fIvalue\fP, puis lorsque la mémoire est libérée les octets sont initialisés à \fIvalue\fP. Cependant, une erreur de \fIsizeof(size_t)\fP est présente dans le code mis en œuvre : au lieu d'initialiser précisément le bloc de mémoire libéré par l'appel \fIfree(p)\fP, c'est le bloc démarrant à \fIp+sizeof(size_t)\fP qui est initialisé. .SH EXEMPLES Le programme ci\-dessous illustre l'utilisation de \fBM_CHECK_ACTION\fP. Si le programme est appelé avec un paramètre (entier), alors celui\-ci est utilisé pour \fBM_CHECK_ACTION\fP. Le programme alloue un bloc de mémoire, puis le libère deux fois, ce qui constitue une erreur. .P L'exemple de session ci\-dessous montre ce qu'il se passe lorsqu'un programme est exécuté avec la glibc et la valeur par défaut de \fBM_CHECK_ACTION\fP : .P .in +4n .EX $ \fB./a.out\fP main(): fin du premier appel free() *** glibc detected *** ./a.out: double free or corruption (top): 0x09d30008 *** ======= Backtrace: ========= /lib/libc.so.6(+0x6c501)[0x523501] /lib/libc.so.6(+0x6dd70)[0x524d70] /lib/libc.so.6(cfree+0x6d)[0x527e5d] \&./a.out[0x80485db] /lib/libc.so.6(__libc_start_main+0xe7)[0x4cdce7] \&./a.out[0x8048471] ======= Memory map: ======== 001e4000\-001fe000 r\-xp 00000000 08:06 1083555 /lib/libgcc_s.so.1 001fe000\-001ff000 r\-\-p 00019000 08:06 1083555 /lib/libgcc_s.so.1 [some lines omitted] b7814000\-b7817000 rw\-p 00000000 00:00 0 bff53000\-bff74000 rw\-p 00000000 00:00 0 [stack] Abandon .EE .in .P L'exemple suivant montre les cas d'autres valeurs de \fBM_CHECK_ACTION\fP: .P .in +4n .EX $ \fB./a.out 1\fP # Diagnostique l'erreur et continue main(): fin du premier appel free() *** glibc detected *** ./a.out: double free or corruption (top): 0x09cbe008 *** main(): fin du second appel free() $ \fB./a.out 2\fP # Interrompt le programme sans message d'erreur main(): fin du premier appel free() Abandon $ \fB./a.out 0\fP # Ignore l'erreur et continue main(): fin du premier appel free() main(): fin du second appel free() .EE .in .P L'exemple suivant montre comment configurer le même paramètre avec la variable d'environnement \fBMALLOC_CHECK_\fP : .P .in +4n .EX $ \fBMALLOC_CHECK_=1 ./a.out\fP main(): fin du premier appel free() *** glibc detected *** ./a.out: free(): invalid pointer: 0x092c2008 *** main(): fin du second appel free() .EE .in .SS "Source du programme" .\" SRC BEGIN (mallopt.c) \& .EX #include #include #include \& int main(int argc, char *argv[]) { char *p; \& if (argc > 1) { if (mallopt(M_CHECK_ACTION, atoi(argv[1])) != 1) { fprintf(stderr, "échec de mallopt()"); exit(EXIT_FAILURE); } } \& p = malloc(1000); if (p == NULL) { fprintf(stderr, "échec de malloc()"); exit(EXIT_FAILURE); } \& free(p); printf("%s(): fin du premier appel free()\en", __func__); \& free(p); printf("%s(): fin du second appel free()\en", __func__); \& exit(EXIT_SUCCESS); } .EE .\" SRC END .SH "VOIR AUSSI" .ad l .nh \fBmmap\fP(2), \fBsbrk\fP(2), \fBmallinfo\fP(3), \fBmalloc\fP(3), \fBmalloc_hook\fP(3), \fBmalloc_info\fP(3), \fBmalloc_stats\fP(3), \fBmalloc_trim\fP(3), \fBmcheck\fP(3), \fBmtrace\fP(3), \fBposix_memalign\fP(3) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Grégoire Scano . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .