Provided by: util-linux-locales_2.41-4ubuntu3_all 
NOM
readprofile - Lire les informations de profilage du noyau
SYNOPSIS
readprofile [options]
VERSIONS
Cette page de manuel documente la version\ 2.0 du programme.
DESCRIPTION
La commande readprofile utilise les informations disponibles dans /proc/profile pour afficher des données
au format ASCII sur la sortie standard. La sortie est organisée en trois colonnes\ : la première affiche
le nombre de tics d’horloge, la deuxième contient le nom de la fonction C du noyau au sein de laquelle
ces tics ont eu lieu et la troisième représente la «\ charge\ » normalisée de la procédure, calculée
comme le quotient entre le nombre de tics et la durée de la procédure. La sortie est complétée par des
blancs pour améliorer la lisibilité.
OPTIONS
-a, --all
Afficher tous les symboles de la carte. Par défaut, les procédures avec des tics signalés ne sont pas
affichées.
-b, --histbin
Afficher les compteurs de chaque intervalle (classe) de l’histogramme.
-i, --info
Afficher des informations. Seule l’étape de profilage utilisée par le noyau est affichée. L’étape de
profilage consiste en la résolution du tampon de profilage et est choisie lors de la configuration du
noyau (avec «\ make config\ ») ou avec la ligne de commande du noyau. Si l’option -t (abrégé) est
utilisée avec l’option -i, seul le nombre décimal est affiché.
-m, --mapfile carte
Indiquer une carte, qui par défaut sera /usr/src/linux/System.map. La carte doit être précisée sur la
ligne de commande si le noyau actuel n’est pas le dernier à avoir été compilé, ou si le fichier
System.map se trouve ailleurs. Si le nom de la carte se termine par .gz, celle-ci est décompressée à
la volée.
-M, --multiplier multiplicateur
Sur certaines architectures, il est possible de modifier la fréquence à laquelle le noyau délivre les
interruptions de profilage pour chaque processeur. Cette option permet de définir la fréquence en
tant que multiplicateur de la fréquence de l’horloge du système. L’unité est le hertz. Linux 2.6.16 a
supprimé sa prise en charge pour la plupart des systèmes. Cette option réinitialise également le
tampon de profilage et nécessite les privilèges du superutilisateur.
-p, --profile fichier_profil
Indiquer un tampon de profilage différent (par défaut /proc/profile). Utiliser un fichier_profil
différent est utile pour «\ geler\ » le profilage du noyau à un moment, afin de le lire plus tard. Le
fichier /proc/profile peut être copié en utilisant cat(1) ou cp(1). Les tampons de profil compressé
ne sont plus gérés, comme cela était le cas avec readprofile-1.1, car le programme doit connaître à
l’avance la taille du tampon.
-r, --reset
Réinitialiser le tampon de profilage. Cette option n’est utilisable que par le superutilisateur car
/proc/profile est lisible par tout le monde mais n’est ouvert en écriture qu’au superutilisateur.
Cependant, vous pouvez mettre le bit set-user-ID de readprofile à 0 pour réinitialiser le tampon sans
augmentation de privilège.
-s, --counters
Afficher les compteurs individuels dans les fonctions.
-v, --verbose
Utiliser une sortie en mode verbeux. Celle-ci est alors organisée en quatre colonnes et complétée
avec des blancs. La première colonne est l’adresse RAM d’une fonction du noyau, la seconde contient
le nom de cette fonction, la troisième affiche le nombre de tics d’horloge et la dernière la charge
normalisée.
-h, --help
Afficher l’aide-mémoire puis quitter.
-V, --version
Afficher la version et quitter.
FICHIERS
/proc/profile
A binary snapshot of the profiling buffer.
/usr/src/linux/System.map
The symbol table for the kernel.
/usr/src/linux/*
The program being profiled :-)
BOGUES
readprofile only works with a 1.3.x or newer kernel, because /proc/profile changed in the step from 1.2
to 1.3.
Ce programme ne fonctionne qu’avec les noyaux ELF. Le changement pour les noyaux a.out est trivial et
laissé comme exercice à l’utilisateur de ces noyaux.
Pour activer le profilage, le noyau doit être redémarré car aucun module de profilage n’est disponible et
la construction d’un tel module n’est pas triviale. Pour activer le profilage, vous pouvez ajouter
profile=2 (ou un autre nombre) à la ligne de commande du noyau. Le nombre que vous indiquez sera utilisé
comme exposant de 2 pour définir l’étape de profilage.
Le profilage est désactivé lorsque les interruptions sont interdites. Cela signifie que beaucoup de tics
de profilage ont lieu lorsque les interruptions sont réactivées. Prenez garde aux informations erronées.
EXEMPLE
Parcourir le tampon de profilage selon le nombre de tics d’horloge :
readprofile | sort -nr | less
Afficher les 20\ procédures ayant les plus grandes charges\ :
readprofile | sort -nr +2 | head -20
N’afficher que le profil du système de fichiers\ :
readprofile | grep _ext2
Afficher toutes les informations du noyau avec les adresses RAM\ :
readprofile -av | less
Parcourir un tampon de profil «\ gelé\ » pour un noyau différent de l’actuel\ :
readprofile -p ~/profile.freeze -m /zImage.map.gz
Demander un profilage à 2\ kHz par processeur et réinitialiser le tampon de profilage\ :
sudo readprofile -M 20
SIGNALER DES BOGUES
Pour signaler un bogue, utilisez le gestionnaire de bogues
<https://github.com/util-linux/util-linux/issues>.
DISPONIBILITÉ
La commande readprofile fait partie du paquet util-linux, elle est disponible sur l’archive du noyau
Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.
util-linux 2.41 2025-07-02 READPROFILE(8)