slabinfo(5) | File Formats Manual | slabinfo(5) |
NOM
slabinfo - Statistiques de l'allocateur slab du noyau
SYNOPSIS
cat /proc/slabinfo
DESCRIPTION
Les objets fréquemment utilisés dans le noyau Linux (en-têtes de tampon, inœuds, entrées de répertoire…) ont leur propre cache. Le fichier /proc/slabinfo en fournit les statistiques. La sortie (abrégée) suivante fournit un exemple du contenu de ce fichier :
$ sudo cat /proc/slabinfo slabinfo - version: 2.1 # name <active_objs> <num_objs> <objsize> <objperslab> <pagesperslab> ... sigqueue 100 100 160 25 1 : tunables 0 0 0 : slabdata 4 4 0 sighand_cache 355 405 2112 15 8 : tunables 0 0 0 : slabdata 27 27 0 kmalloc-8192 96 96 8192 4 8 : tunables 0 0 0 : slabdata 24 24 0 ...
La première ligne de cette sortie fournit le numéro de version qui permet à une application lisant ce fichier de gérer les modifications de format du fichier (consulter VERSIONS ci-après). La ligne suivante affiche les noms des colonnes pour les autres lignes.
Chacune des autres lignes affiche des informations à propos d’un cache particulier. Après le nom du cache, sont affichés, dans chaque ligne et pour chaque cache, trois volets :
- statistiques ;
- modifiables (tunable) ;
- données de slab (slabdata).
Les statistiques sont les suivantes ;
- active_objs
- le nombre d’objets actuellement actifs (c’est-à-dire en cours d’utilisation) ;
- num_objs
- le nombre total d’objets alloués (c’est-à-dire les objets en cours d’utilisation et ceux qui ne le sont pas) ;
- objsize
- la taille des objets de ce slab, en octets ;
- objperslab
- le nombre d’objets stockés dans chaque slab ;
- pagesperslab
- le nombre de pages allouées pour chaque slab.
Les entrées modifiables (tunable) dans chaque ligne affichent les paramètres modifiables dans le cache correspondant. Lors de l’utilisation de l’allocateur SLUB, il n’y a pas d’« entrées modifiables », le fichier /proc/slabinfo n’est pas éditable et ces champs contiennent la valeur zéro. Lors de l’utilisation de l’allocateur SLAB plus ancien, les « entrées modifiables » pour un cache particulier peuvent être définies en écrivant des lignes de la forme suivante dans /proc/slabinfo :
# echo 'name limit batchcount sharedfactor' > /proc/slabinfo
Ici, name est le nom du cache et limit, batchcount et sharedfactor sont des entiers définissant de nouvelles valeurs pour les « entrées modifiables » correspondantes. La valeur limit doit être une valeur positive, batchcount doit être une valeur positive inférieure ou égale à limit et sharedfactor ne doit pas être une valeur négative. Si une des valeurs indiquées n’est pas valable, les définitions du cache sont inchangées.
Les entrées modifiables dans chaque ligne contiennent les champs suivants :
- limit
- le nombre maximal d’objets qui seront mis en cache ;
- batchcount
- sur les systèmes SMP, c’est le nombre d’objets à transférer à un certain moment lors du rafraichissement de la liste d’objets disponibles ;
- [À documenter]
Les entrées slabdata dans chaque ligne contiennent les champs suivants :
- active_slabs
- le nombre de slabs actifs ;
- nums_slabs
- le nombre total de slabs ;
- [À documenter]
Notez qu'en raison de l'alignement des objets et de la surcharge due au cache de slabs, les objets ne sont habituellement pas étroitement accolés dans les pages. Même les pages n'ayant qu'un seul objet en cours d'utilisation sont considérées comme utilisées et ne peuvent pas être libérées.
Les noyaux ayant été compilés avec l'option CONFIG_DEBUG_SLAB auront des champs de statistique supplémentaires dans chaque ligne et la première ligne du fichier contiendra la chaine « statistics ». Le champ statistics inclut : le nombre maximal d’objets actifs, le nombre de fois que les objets ont été alloués, le nombre de fois que le cache a grossi (nouvelles pages ajoutées à ce cache), le nombre de fois que le cache a diminué (pages inutilisées retirées de ce cache) et le nombre de fois qu’une erreur s’est produite lors de l’allocation de nouvelles pages pour ce cache.
VERSIONS
Le fichier /proc/slabinfo est apparu dans Linux 2.1.23. Au cours du temps ce fichier a évolué et ses versions ont des présentations différentes :
- 1.0
- format de la série 2.2.x du noyau Linux ;
- 1.1
- format de la série 2.4.x du noyau Linux ;
- 1.2
- format brièvement présent dans la série 2.5 de développement du noyau Linux ;
- 2.0
- format présent dans les noyaux 2.6.x de Linux jusqu’à la version 2.6.9 incluse ;
- 2.1
- format actuel apparu dans Linux 2.6.10.
NOTES
Seul le superutilisateur peut lire et, si le noyau est configuré avec CONFIG_SLAB, éditer le fichier /proc/slabinfo.
Le montant total de mémoire allouée au cache SLAB/SLUB est affiché dans le champ Slab de /proc/meminfo.
VOIR AUSSI
Le fichier des sources du noyau Documentation/vm/slub.txt et tools/vm/slabinfo.c.
TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess https://www.blaess.fr/christophe/, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>
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 à debian-l10n-french@lists.debian.org.
2 mai 2024 | Pages du manuel de Linux 6.9.1 |