Provided by: util-linux-locales_2.39.3-9ubuntu6_all bug

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 le numéro de 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 ne fonctionne qu’avec les noyaux\ 1.3.x et supérieurs car /proc/profile a
       changé entre les versions\ 1.2 et 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 sur
       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/>.