Provided by:
manpages-fr-extra_20101103_all 
NOM
readprofile - Utilitaire pour lire les informations de profilage du
noyau
SYNOPSIS
readprofile [options]
VERSION
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 donnees au format ascii sur la sortie
standard. La sortie est organisee en trois colonnes : la premiere
affiche le nombre de sauts d'horloge, la deuxieme contient le nom de la
fonction C du noyau au sein de laquelle ces sauts ont eu lieu, et la
troisieme represente la << charge >> normalisee de la procedure,
calculee comme le quotient entre le nombre de sauts et la duree de la
procedure. La sortie est completee par des blancs pour ameliorer la
lisibilite.
Les options disponibles en ligne de commandes sont les suivantes :
-m mapfile
Indiquer une carte, qui par defaut sera
/usr/src/linux/System.map. La carte doit etre precisee dans la
ligne de commande si le noyau actuel n'est pas le dernier a
avoir ete compile, ou si le fichier System.map se trouve
ailleurs. Si le nom de la carte se termine par << .gz >>,
celle-ci est immediatement decompressee.
-p pro-file
Indiquer un tampon de profil different (par defaut
/proc/profile). Utiliser un profil different est utile pour
<< geler >> le profilage du noyau a un moment, afin de le lire
plus tard. Le fichier /proc/profile peut etre copie en utilisant
<< cat >> ou << cp >>. Les tampons de profils compresses ne sont
plus geres, comme cela etait le cas avec readprofile-1.1, car le
programme doit connaitre a l'avance la taille du tampon.
-i Afficher des informations. Seule l'etape de profilage utilisee
par le noyau est affichee. L'etape de profilage consiste en la
resolution du tampon de profilage et est choisie lors de la
configuration du noyau (avec << make config >>), ou avec la
ligne de commandes du noyau. Si l'option -t (abrege) est
utilisee avec l'option -i, seul le nombre decimal est affiche.
-a Afficher tous les symboles de la carte. Par defaut, les
procedures ayant 0 saut ne sont pas affichees.
-b Afficher des comptages individuels.
-r Reinitialiser 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 ecriture qu'au
superutilisateur. Cependant, vous pouvez mettre le bit setuid de
readprofile a 0, pour reinitialiser le tampon sans obtenir de
privilege.
-M multiplicateur
Sur certaines architectures, il est possible de modifier la
frequence a laquelle le noyau delivre les interruptions de
profilage pour chaque processeur. Cette option permet de definir
la frequence en tant que multiplicateur de la frequence de
l'horloge du systeme. L'unite est le Hertz. Ceci est gere sur
les systemes i386-SMP (noyaux 2.2 et 2.4) ainsi que sur les
sparc-SMP et sparc64-SMP (noyau 2.4). Cette option reinitialise
egalement le tampon de profilage et necessite les privileges du
superutilisateur.
-v Utiliser une sortie en mode verbeux. Celle-ci est alors
organisee en quatre colonnes et completee avec des blancs. La
premiere colonne est l'adresse RAM d'une fonction du noyau, la
seconde contient le nom de cette fonction, la troisieme affiche
le nombre de sauts d'horloge et la derniere la charge
normalisee.
-V Afficher le numero de version de readprofile et quitter.
EXEMPLES
Parcourir le tampon de profilage selon le nombre de sauts d'horloge :
readprofile | sort -nr | less
Afficher les 20 procedures ayant les plus petites charges :
readprofile | sort -nr +2 | head -20
N'afficher que le profil du systeme de fichiers :
readprofile | grep _ext2
Afficher toutes les informations du noyau, avec les adresses RAM :
readprofile -av | less
Parcourir un tampon de profil << gele >> pour un noyau different de
l'actuel :
readprofile -p ~/profile.freeze -m /zImage.map.gz
Demander un profilage a 2 kHz par processeur, et reinitialiser le
tampon de profilage :
sudo readprofile -M 20
BOGUES
readprofile ne fonctionne qu'avec les noyaux 1.3.x et superieurs, car
/proc/profile a change 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 laisse a l'utilisateur de ces noyaux.
Pour activer le profilage, le noyau doit etre redemarre, 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) a la ligne de commandes du
noyau. Le nombre que vous indiquez sera utilise comme exposant de 2
pour definir l'etape de profilage.
Le profilage est desactive lorsque les interruptions sont interdites.
Cela signifie que beaucoup de sauts de profilage ont lieu lorsque les
interruptions sont reactivees. Faites attention aux informations
erronees.
FICHIERS
/proc/profile Instantane binaire du tampon de profilage.
/usr/src/linux/System.map Table de symboles pour le noyau.
/usr/src/linux/* Le programme profile :-)
DISPONIBILIT'E
La commande readprofile fait partie du paquet util-linux-ng, elle est
disponible sur ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.
TRADUCTION
Cette page de manuel a ete traduite et est maintenue par Thomas Huriaux
<thomas.huriaux@gmail.com> et les membres de la liste
<debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler
toute erreur de traduction par un rapport de bogue sur le paquet
manpages-fr-extra.