.\" -*- coding: UTF-8 -*- '\" t .\" Title: readprofile .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.15 .\" Date: 2022-05-11 .\" Manual: System Administration .\" Source: util-linux 2.38.1 .\" Language: English .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH READPROFILE 8 "11. Mai 2022" "util\-linux 2.38.1" System\-Administration .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 BEZEICHNUNG readprofile \- Profilbildungs\-Informationen des Kernels lesen .SH ÜBERSICHT .sp \fBreadprofile\fP [Optionen] .SH VERSION .sp Diese Handbuchseite dokumentiert Version 2.0 des Programms. .SH BESCHREIBUNG .sp Der Befehl \fBreadprofile\fP verwendet die Informationen in \fI/proc/profile\fP zum Ausgeben von ASCII\-Daten auf der Standardausgabe. Die Ausgabe ist in drei Spalten geordnet: die erste bezeichnet die Anzahl der Clock\-Ticks, die zweite den Namen der C\-Funktion im Kernel, in der diese Anzahl Ticks auftrat und die dritte ist die normalisierte »Last« der Prozedur, berechnet als Verhältnis zwischen der Anzahl der Ticks und der Länge der Prozedur. Die Ausgabe wird mit Leerzeichen aufgefüllt, um die Lesbarkeit zu verbessern. .SH OPTIONEN .sp \fB\-a\fP, \fB\-\-all\fP .RS 4 gibt alle Symbole in der Map\-Datei aus. Per Vorgabe werden die Prozeduren nicht ausgegeben, für die 0 Ticks gemeldet wurden. .RE .sp \fB\-b\fP, \fB\-\-histbin\fP .RS 4 gibt individuelle Anzahlen für die Histogrammskalierung aus. .RE .sp \fB\-i\fP, \fB\-\-info\fP .RS 4 aktiviert die reine Info\-Ausgabe. Dies veranlasst \fBreadprofile\fP, nur die vom Kernel verwendete Profilbildungs\-Schrittweite auszugeben. Diese Schrittweite ist die Auflösung des Profilbildungs\-Puffers und wird während der Kernel\-Konfiguration gewählt (mit \fBmake config\fP) oder in der Befehlszeile des Kernels. Falls das Argument \fB\-t\fP (terse) zusammen mit \fB\-i\fP verwendet wird, dann wird nur die Dezimalzahl ausgegeben. .RE .sp \fB\-m\fP, \fB\-\-mapfile\fP \fIMap\-Datei\fP .RS 4 gibt eine Map\-Datei an, Vorgabe ist \fI/usr/src/linux/System.map\fP. Sie sollten die Map\-Datei in der Befehlszeile angeben, falls Ihr aktueller Kernel nicht derjenige ist, den Sie zuletzt kompiliert haben, oder die Datei System.map an einem anderen Ort gespeichert ist. Falls der Name der Map\-Datei mit \fI.gz\fP endet, wird diese unmittelbar entpackt. .RE .sp \fB\-M\fP, \fB\-\-multiplier\fP \fIMultiplikator\fP .RS 4 Auf einigen Architekturen ist es möglich, die Frequenz der Profilbildungs\-Interrupts zu ändern, die der Kernel an jede CPU liefert. Diese Option erlaubt das Festlegen der Frequenz als Multiplikator der Frequenz der Systemuhr in Hz. Unter Linux 2.6.16 wurde die Unterstützung von Multiplikatoren für die meisten Systeme entfernt. Diese Option setzt auch den Profilbildungs\-Puffer zurück, was Administratorrechte erfordert. .RE .sp \fB\-p\fP, \fB\-\-profile\fP \fIpro\-Datei\fP .RS 4 gibt einen alternativen Profilbildungs\-Puffer an, Vorgabe ist \fI/proc/profile\fP. Die Verwendung einer alternativen Datei ist sinnvoll, wenn Sie die Kernel\-Profilbildung an einem bestimmten Punkt »einfrieren« und später lesen wollen. Die Datei \fI/proc/profile\fP kann mit \fBcat\fP(1) oder \fBcp\fP(1) kopiert werden. Komprimierte Profilbildungs\-Puffer werden nicht mehr unterstützt, wie dies in \fBreadprofile\-1.1\fP noch der Fall war, da das Programm vorher die Größe des Puffers kennen muss. .RE .sp \fB\-r\fP, \fB\-\-reset\fP .RS 4 setzt den Profilbildungs\-Puffer zurück. Dies kann nur mit Administratorrechten aufgerufen werden, da \fI/proc/profile\fP durch alle Benutzer gelesen werden kann, aber nur der Administrator über Schreibrechte dafür verfügt. Dennoch können Sie \fBreadprofile\fP set\-user\-ID 0 machen, um den Puffer zurücksetzen, ohne Privilegien dafür zu erlangen. .RE .sp \fB\-s, \-\-counters\fP .RS 4 gibt individuelle Zähler in Funktionen aus. .RE .sp \fB\-v\fP, \fB\-\-verbose\fP .RS 4 aktiviert die ausführliche Ausgabe. Diese wird in vier Spalten geordnet und mit Leerzeichen gefüllt. Die erste Spalte enthält die RAM\-Adressen einer Kernel\-Funktion, die zweite den Namen der Funktion, die dritte die Anzahl der Clock\-Ticks und die letzte die normalisierte Last. .RE .sp \fB\-h\fP, \fB\-\-help\fP .RS 4 zeigt einen Hilfetext an und beendet das Programm. .RE .sp \fB\-V\fP, \fB\-\-version\fP .RS 4 zeigt die Versionsnummer an und beendet das Programm. .RE .SH DATEIEN .sp \fI/proc/profile\fP .RS 4 Ein binärer Schnappschuss des Profilbildungs\-Puffers. .RE .sp \fI/usr/src/linux/System.map\fP .RS 4 Die Symboltabelle für den Kernel. .RE .sp \fI/usr/src/linux/*\fP .RS 4 Das zu untersuchende Programm :\-) .RE .SH FEHLER .sp \fBreadprofile\fP funktioniert nur mit Kerneln der Version 1.3.x oder neuer, da \fI/proc/profile\fP beim Versionssprung von 1.2 auf 1.3 geändert wurde. .sp Dieses Programm funktioniert nur mit ELF\-Kerneln. Die Änderung für a.out\-Kernels ist trivial und muss von dem Benutzer von a.out vorgenommen werden. .sp Um die Profilbildung zu ermöglichen, muss der Kernel neu gebootet werden, da kein Profilbildungs\-Modul verfügbar ist und dies nicht leicht zu bauen ist. Für die Aktivierung geben Sie \fBprofile\fP=\fI2\fP (oder eine andere Zahl) in der Befehlszeile des Kernels an. Die angegebene Zahl ist der Exponent zur Basis 2, der als Profilbildungs\-Schrittweite verwendet wird. .sp Die Profilbildung wird deaktiviert, wenn Interrupts gehemmt sind. Das bedeutet, dass viele Profilbildungs\-Informations\-Ticks wieder erscheinen, wenn die Interrupts wieder aktiviert werden. Achten Sie auf solche irreführenden Informationen. .SH BEISPIEL .sp So durchsuchen Sie den Profilbildungs\-Puffer, geordnet nach Clock\-Ticks: .sp .if n .RS 4 .nf .fam C readprofile | sort \-nr | less .fam .fi .if n .RE .sp So zeigen Sie die 20 am häufigsten geladenen Prozeduren an: .sp .if n .RS 4 .nf .fam C readprofile | sort \-nr +2 | head \-20 .fam .fi .if n .RE .sp So wird nur das Dateisystemprofil ausgegeben: .sp .if n .RS 4 .nf .fam C readprofile | grep _ext2 .fam .fi .if n .RE .sp So zeigen Sie alle Kernel\-Informationen einschließlich Speicheradressen an: .sp .if n .RS 4 .nf .fam C readprofile \-av | less .fam .fi .if n .RE .sp So durchsuchen Sie einen »eingefrorenen« Profilbildungs\-Puffer für einen derzeit nicht aktiven Kernel: .sp .if n .RS 4 .nf .fam C readprofile \-p ~/profile.freeze \-m /zImage.map.gz .fam .fi .if n .RE .sp So starten Sie die Profilbildung mit 2kHz pro CPU und setzen den Profilbildungs\-Puffer zurück: .sp .if n .RS 4 .nf .fam C sudo readprofile \-M 20 .fam .fi .if n .RE .SH "FEHLER MELDEN" .sp Verwenden Sie zum Melden von Fehlern das Fehlererfassungssystem auf .URL https://github.com/util\-linux/util\-linux/issues "" . .SH VERFÜGBARKEIT .sp Der Befehl \fBreadprofile\fP ist Teil des Pakets util\-linux, welches heruntergeladen werden kann von: .URL https://www.kernel.org/pub/linux/utils/util\-linux/ "Linux Kernel Archive" . .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .