'\" t
.\"     Title: readprofile
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: Administration Système
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "READPROFILE" "8" "2024-04-27" "util\-linux 2.40" "Administration Système"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NOM"
readprofile \- Lire les informations de profilage du noyau
.SH "SYNOPSIS"
.sp
\fBreadprofile\fP [options]
.SH "VERSIONS"
.sp
Cette page de manuel documente la version\(rs 2.0 du programme.
.SH "DESCRIPTION"
.sp
La commande \fBreadprofile\fP utilise les informations disponibles dans \fI/proc/profile\fP pour afficher des données au format ASCII sur la sortie standard. La sortie est organisée en trois colonnes\(rs : la première affiche le nombre de tics d\(cqhorloge, 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 «\(rs charge\(rs » 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é.
.SH "OPTIONS"
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Afficher tous les symboles de la carte. Par défaut, les procédures avec des tics signalés ne sont pas affichées.
.RE
.sp
\fB\-b\fP, \fB\-\-histbin\fP
.RS 4
Afficher les compteurs de chaque intervalle (classe) de l\(cqhistogramme.
.RE
.sp
\fB\-i\fP, \fB\-\-info\fP
.RS 4
Afficher des informations. Seule l\(cqétape de profilage utilisée par le noyau est affichée. L\(cqétape de profilage consiste en la résolution du tampon de profilage et est choisie lors de la configuration du noyau (avec «\(rs make config\(rs ») ou avec la ligne de commande du noyau. Si l\(cqoption \fB\-t\fP (abrégé) est utilisée avec l\(cqoption \fB\-i\fP, seul le nombre décimal est affiché.
.RE
.sp
\fB\-m\fP, \fB\-\-mapfile\fP \fIcarte\fP
.RS 4
Indiquer une \fIcarte\fP, qui par défaut sera \fI/usr/src/linux/System.map\fP. La carte doit être précisée sur la ligne de commande si le noyau actuel n\(cqest pas le dernier à avoir été compilé, ou si le fichier \fISystem.map\fP se trouve ailleurs. Si le nom de la carte se termine par \fI.gz\fP, celle\-ci est décompressée à la volée.
.RE
.sp
\fB\-M\fP, \fB\-\-multiplier\fP \fImultiplicateur\fP
.RS 4
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 \fImultiplicateur\fP de la fréquence de l\(cqhorloge du système. L\(cqunité 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.
.RE
.sp
\fB\-p\fP, \fB\-\-profile\fP \fIfichier_profil\fP
.RS 4
Indiquer un tampon de profilage différent (par défaut \fI/proc/profile\fP). Utiliser un \fIfichier_profil\fP différent est utile pour «\(rs geler\(rs » le profilage du noyau à un moment, afin de le lire plus tard. Le fichier \fI/proc/profile\fP peut être copié en utilisant \fBcat\fP(1) ou \fBcp\fP(1). Les tampons de profil compressé ne sont plus gérés, comme cela était le cas avec \fBreadprofile\-1.1\fP, car le programme doit connaître à l\(cqavance la taille du tampon.
.RE
.sp
\fB\-r\fP, \fB\-\-reset\fP
.RS 4
Réinitialiser le tampon de profilage. Cette option n\(cqest utilisable que par le superutilisateur car \fI/proc/profile\fP est lisible par tout le monde mais n\(cqest ouvert en écriture qu\(cqau superutilisateur. Cependant, vous pouvez mettre le bit set\-user\-ID de \fBreadprofile\fP à 0 pour réinitialiser le tampon sans augmentation de privilège.
.RE
.sp
\fB\-s, \-\-counters\fP
.RS 4
Afficher les compteurs individuels dans les fonctions.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
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\(cqadresse RAM d\(cqune fonction du noyau, la seconde contient le nom de cette fonction, la troisième affiche le nombre de tics d\(cqhorloge et la dernière la charge normalisée.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afficher l’aide\-mémoire puis quitter.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Afficher le numéro de version et quitter.
.RE
.SH "FICHIERS"
.sp
\fI/proc/profile\fP
.RS 4
A binary snapshot of the profiling buffer.
.RE
.sp
\fI/usr/src/linux/System.map\fP
.RS 4
The symbol table for the kernel.
.RE
.sp
\fI/usr/src/linux/*\fP
.RS 4
The program being profiled :\-)
.RE
.SH "BOGUES"
.sp
\fBreadprofile\fP only works with a 1.3.x or newer kernel, because \fI/proc/profile\fP changed in the step from 1.2 to 1.3.
.sp
Ce programme ne fonctionne qu\(cqavec les noyaux ELF. Le changement pour les noyaux a.out est trivial et laissé comme exercice à l\(cqutilisateur de ces noyaux.
.sp
Pour activer le profilage, le noyau doit être redémarré car aucun module de profilage n\(cqest disponible et la construction d\(cqun tel module n\(cqest pas triviale. Pour activer le profilage, vous pouvez ajouter \fBprofile\fP=\fI2\fP (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\(cqétape de profilage.
.sp
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.
.SH "EXEMPLE"
.sp
Parcourir le tampon de profilage selon le nombre de tics d\(cqhorloge :
.sp
.if n .RS 4
.nf
.fam C
   readprofile | sort \-nr | less
.fam
.fi
.if n .RE
.sp
Afficher les 20\(rs procédures ayant les plus grandes charges\(rs :
.sp
.if n .RS 4
.nf
.fam C
   readprofile | sort \-nr +2 | head \-20
.fam
.fi
.if n .RE
.sp
N\(cqafficher que le profil du système de fichiers\(rs :
.sp
.if n .RS 4
.nf
.fam C
   readprofile | grep _ext2
.fam
.fi
.if n .RE
.sp
Afficher toutes les informations du noyau avec les adresses RAM\(rs :
.sp
.if n .RS 4
.nf
.fam C
   readprofile \-av | less
.fam
.fi
.if n .RE
.sp
Parcourir un tampon de profil «\(rs gelé\(rs » pour un noyau différent de l\(cqactuel\(rs :
.sp
.if n .RS 4
.nf
.fam C
   readprofile \-p ~/profile.freeze \-m /zImage.map.gz
.fam
.fi
.if n .RE
.sp
Demander un profilage à 2\(rs kHz par processeur et réinitialiser le tampon de profilage\(rs :
.sp
.if n .RS 4
.nf
.fam C
   sudo readprofile \-M 20
.fam
.fi
.if n .RE
.SH "SIGNALER DES BOGUES"
.sp
Pour signaler un bogue, utilisez le gestionnaire de bogues sur \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "DISPONIBILITÉ"
.sp
La commande \fBreadprofile\fP fait partie du paquet util\-linux, elle est disponible sur \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "l’archive du noyau Linux" "."