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

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

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

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  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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 ⟨⟩.