Provided by: manpages-fr-extra_20101103_all bug

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.