READPROFILE(8)

NOM
readprofile - Lire les informations de profilage du noyau

SYNOPSIS
readprofile [options]

VERSION
Cette page de manuel documente la version 2.0 du programme.

DESCRIPTION
The readprofile command uses the /proc/profile information to print ascii data on standard output. The output is organized in three columns: the first is the number of clock ticks, the second is the name of the C function in the kernel where those many ticks occurred, and the third is the normalized `load' of the procedure, calculated as a ratio between the number of ticks and the length of the procedure. The output is filled with blanks to ease readability.

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 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
    Specify a mapfile, which by default is /usr/src/linux/System.map. You should specify the map file on cmdline if your current kernel isn't the last one you compiled, or if you keep System.map elsewhere. If the name of the map file ends with `.gz' it is decompressed on the fly.

-M, --multiplier multiplicateur
    On some architectures it is possible to alter the frequency at which the kernel delivers profiling interrupts to each CPU. This option allows you to set the frequency, as a multiplier of the system clock frequency, HZ. Linux 2.6.16 dropped multiplier support for most systems. This option also resets the profiling buffer, and requires superuser privileges.

-p, --profile fichier_profil
    Specify a different profiling buffer, which by default is /proc/profile. Using a different pro-file is useful if you want to `freeze' the kernel profiling at some time and read it later. The /proc/profile file can be copied using `cat' or `cp'. There is no more support for compressed profile buffers, like in readprofile-1.1, because the program needs to know the size of the buffer in advance.

-r, --reset
    Reset the profiling buffer. This can only be invoked by root, because /proc/profile is readable by everybody but writable only by the superuser. However, you can make readprofile set-user-ID 0, in order to reset the buffer without gaining privileges.

-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.

-V, --version
    Afficher le nom et la version du logiciel et quitter.

-h, --help
    Afficher l’aide-mémoire puis quitter.

FICHIERS
/proc/profile              Instantané binaire du tampon de profilage.
/usr/src/linux/System.map  Table de symboles pour le noyau.
/usr/src/linux/*           Le programme en cours de profilage :-).

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
Browse a `frozen' profile buffer for a non current kernel:
   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

DISPONIBILITÉ
The readprofile command is part of the util-linux package and is available from Linux Kernel Archive (https://www.kernel.org/pub/linux/utils/util-linux/).

TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess <ccb@club-internet.fr>, Michel Quercia <quercia AT cal DOT enst DOT fr>, Thierry Vignaud <tvignaud@mandriva.com>, Frédéric Delanoy <delanoy_f@yahoo.com>, Thierry Vignaud <tvignaud@mandriva.com>, Christophe Sauthier <christophe@sauthier.com>, Sébastien Blanchet, Jérôme Perzyna <jperzyna@yahoo.fr>, Aymeric Nys <aymeric AT nnx POINT com>, Alain Portal <aportal@univ-montp2.fr>, Thomas Huriaux <thomas.huriaux@gmail.com>, Yves Rütschlé <l10n@rutschle.net>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Philippe Piette <foudre-blanche@skynet.be>, Jean-Baka Domelevo-Entfellner <domelevo@gmail.com>, Nicolas Haller <nicolas@boiteameuh.org>, Sylvain Archenault <sylvain.archenault@laposte.net>, Valéry Perrin <valery.perrin.debian@free.fr>, Jade Alglave <jade.alglave@ens-lyon.org>, Nicolas François <nicolas.francois@centraliens.net>, Alexandre Kuoch <alex.kuoch@gmail.com>, Lyes Zemmouche <iliaas@hotmail.fr>, Florentin Duneau <fduneau@gmail.com>, Alexandre Normand <aj.normand@free.fr> et David Prévot <david@tilapin.org> 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>.