malloc_info - Exporter l'état de malloc vers un flux
Bibliothèque C standard (
libc,
-lc)
#include <malloc.h>
int malloc_info(int options, FILE *stream);
La fonction
malloc_info() exporte une chaîne XML décrivant
l'état actuel de l'allocation mémoire pour l'appelant. Cette
chaîne est écrite dans le flux
stream. La chaîne
exportée contient des informations concernant toutes les domaines de
mémoires (« arenas », consultez
malloc(3)).
Dans la mise en œuvre actuelle, le paramètre
options doit
être nul.
En cas de succès,
malloc_info() renvoie
0. En cas d'erreur,
-1 est renvoyé et
errno contient le code d'erreur.
- EINVAL
- Le paramètre options n'était pas
nul.
malloc_info() was added in glibc 2.10.
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
| Interface |
Attribut |
Valeur |
|
malloc_info() |
Sécurité des threads |
MT-Safe |
Cette fonction est une extension GNU.
L'information d'allocation mémoire est fournie sous forme de flux XML
(plutôt que de structure C), car les informations fournies
pourront évoluer dans le futur, en raison de modifications dans le code
mis en œuvre. La sortie XML comporte un champ de version.
La fonction
open_memstream(3) peut être utilisée pour
envoyer la sortie de
malloc_info() directement dans un tampon en
mémoire plutôt que dans un fichier.
La fonction
malloc_info() est conçue pour combler les manques de
malloc_stats(3) et
mallinfo(3).
Le programme ci-dessous accepte jusqu'à quatre paramètres en ligne
de commande dont les trois premiers sont obligatoires. Le premier
paramètre indique le nombre de processus légers
(« threads ») que le programme doit créer.
Tous les threads, thread principal compris, allouent le nombre de blocs de
mémoire indiqué en deuxième paramètre. Le
troisième paramètre contrôle la taille des blocs à
allouer. Le thread principal crée des blocs de cette taille, le
deuxième thread créé par le programme alloue des blocs
deux fois plus grands, le troisième thread alloue des blocs trois fois
plus grands et ainsi de suite.
Le programme appelle
malloc_info() deux fois pour afficher l'état
de l'allocation mémoire. Le premier appel est effectué avant la
création d’un thread ou l'allocation de mémoire. Le
deuxième appel est effectué une fois que tous les threads ont
alloué de la mémoire.
Dans l'exemple suivant, les paramètres commandent la création d'un
thread additionnel, allouant 10 000 blocs de mémoire,
comme le thread principal. Une fois les blocs de mémoire
alloués,
malloc_info() affiche l'état des deux domaines
de mémoire.
$ getconf GNU_LIBC_VERSION
glibc 2.13
$ ./a.out 1 10000 100
============ Avant allocation des blocs ============
<malloc version="1">
<heap nr="0">
<sizes>
</sizes>
<total type="fast" count="0" size="0"/>
<total type="rest" count="0" size="0"/>
<system type="current" size="135168"/>
<system type="max" size="135168"/>
<aspace type="total" size="135168"/>
<aspace type="mprotect" size="135168"/>
</heap>
<total type="fast" count="0" size="0"/>
<total type="rest" count="0" size="0"/>
<system type="current" size="135168"/>
<system type="max" size="135168"/>
<aspace type="total" size="135168"/>
<aspace type="mprotect" size="135168"/>
</malloc>
============ Après allocation des blocs ============
<malloc version="1">
<heap nr="0">
<sizes>
</sizes>
<total type="fast" count="0" size="0"/>
<total type="rest" count="0" size="0"/>
<system type="current" size="1081344"/>
<system type="max" size="1081344"/>
<aspace type="total" size="1081344"/>
<aspace type="mprotect" size="1081344"/>
</heap>
<heap nr="1">
<sizes>
</sizes>
<total type="fast" count="0" size="0"/>
<total type="rest" count="0" size="0"/>
<system type="current" size="1032192"/>
<system type="max" size="1032192"/>
<aspace type="total" size="1032192"/>
<aspace type="mprotect" size="1032192"/>
</heap>
<total type="fast" count="0" size="0"/>
<total type="rest" count="0" size="0"/>
<system type="current" size="2113536"/>
<system type="max" size="2113536"/>
<aspace type="total" size="2113536"/>
<aspace type="mprotect" size="2113536"/>
</malloc>
#include <err.h>
#include <errno.h>
#include <malloc.h>
#include <pthread.h>
#include <stdlib.h>
#include <unistd.h>
static size_t blockSize;
static size_t numThreads;
static unsigned int numBlocks;
static void *
thread_func(void *arg)
{
int tn = (int) arg;
/* The multiplier '(2 + tn)' ensures that each thread (including
the main thread) allocates a different amount of memory. */
for (unsigned int j = 0; j < numBlocks; j++)
if (malloc(blockSize * (2 + tn)) == NULL)
err(EXIT_FAILURE, "malloc-thread");
sleep(100); /* Attendre que le thread principal se termine. */
return NULL;
}
int
main(int argc, char *argv[])
{
int sleepTime;
pthread_t *thr;
if (argc < 4) {
fprintf(stderr,
"%s nb-threads nb-blocs taille-bloc [tps-sommeil]\n",
argv[0]);
exit(EXIT_FAILURE);
}
nbThreads = atoi(argv[1]);
nbBlocs = atoi(argv[2]);
tailleBloc = atoi(argv[3]);
tpsSommeil = (argc > 4) ? atoi(argv[4]) : 0;
thr = calloc(numThreads, sizeof(*thr));
if (thr == NULL)
err(EXIT_FAILURE, "calloc");
printf("============ Avant allocation des blocs ============\n");
malloc_info(0, stdout);
/* Créer les threads allouant des quantités de mémoire différentes. */
for (size_t tn = 0; tn < numThreads; tn++) {
errno = pthread_create(&thr[tn], NULL, thread_func,
(void *) tn);
if (errno != 0)
err(EXIT_FAILURE, "pthread_create");
/* If we add a sleep interval after the start-up of each
thread, the threads likely won't contend for malloc
mutexes, and therefore additional arenas won't be
allocated (see malloc(3)). */
if (tpsSommeil > 0)
sleep(tpsSommeil);
}
/* Le thread principal alloue également de la mémoire. */
for (unsigned int j = 0; j < numBlocks; j++)
if (malloc(blockSize) == NULL)
err(EXIT_FAILURE, "malloc");
sleep(2); /* Donner à tous les threads une chance
de terminer les allocations. */
printf("\n============ Après allocation des blocs ============\n");
malloc_info(0, stdout);
exit(EXIT_SUCCESS);
}
mallinfo(3),
malloc(3),
malloc_stats(3),
mallopt(3),
open_memstream(3)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Grégoire Scano <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 concernant les conditions de copie
et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
[email protected]