tau_reduce – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

tau_reduce – generiert selektive Instrumentierungsregeln basierend auf Profildaten

ZUSAMMENFASSUNG

tau_reduce {-f Dateinamen} [-n] [-r Dateinamen] [-o Dateinamen] [-v] [-p]

BESCHREIBUNG

tau_reduce ist eine Anwendung, die eine Reihe benutzerdefinierter Regeln auf einen pprof-Dump anwendet
Datei (pprof -d), um eine Auswahldatei zu erstellen, die eine Ausschlussliste für enthält
selektive Implementierung für TAU. Der Benutzer muss den Namen der pprof-Dump-Datei angeben
die diese Anwendung verwenden wird. Dies geschieht mit dem Dateinamen-Flag -f. Wenn keine Regeldatei vorhanden ist
angegeben, wird eine einzelne Standardregel auf die Datei angewendet. Diese Regel lautet: Numcalls
> 1000000 & usecs/call < 2, wodurch mindestens alle aufgerufenen Routinen ausgeschlossen werden
1,000,000 Mal und durchschnittlich weniger als zwei Mikrosekunden pro Anruf. Wenn eine Regeldatei ist
angegeben, wird diese Regel nicht angewendet. Wenn keine Ausgabedatei angegeben ist, dann die Ergebnisse
wird auf dem Bildschirm ausgedruckt.

REGELN

Benutzer können eine Reihe von Regeln angeben, die tau_reduce anwenden soll. Die Regeln sollten in angegeben werden
eine separate Datei, eine Regel pro Zeile, und der Dateiname sollte mit angegeben werden
entsprechende Option in der Befehlszeile. Die Grammatik für eine Regel lautet: [GROUPNAME:]FIELD
BEDIENERNUMMER. Der Gruppenname gefolgt vom Doppelpunkt (:) ist optional. Falls enthalten, die
Die Regel wird nur auf Routinen angewendet, die Mitglied der angegebenen Gruppe sind. Einziger
Auf jede Regel kann ein Gruppenname angewendet werden, und eine Regel muss einem Gruppennamen folgen. Wenn nur ein
Wenn der Gruppenname angegeben ist, wird ein Fehler „Unbekanntes Feld“ zurückgegeben. Wenn gewünscht
Der Effekt besteht darin, alle Routinen auszuschließen, die zu einer bestimmten Gruppe gehören. Dann ist eine triviale Regel,
Es kann beispielsweise GROUP:numcalls > -1 angewendet werden. Wenn ein Gruppenname angegeben ist, die Daten jedoch nicht
Wenn sie Gruppennamendaten enthalten, wird eine Fehlermeldung ausgegeben, die Regel jedoch
weiterhin auf das Datum angewendet werden, wobei die Angabe des Gruppennamens ignoriert wird. Ein FELD ist eines davon
Routineattribute, die in der folgenden Tabelle aufgeführt sind:

BEDEUTUNG DES Attributnamens
numcalls Anzahl der Aufrufe der Routine
numsubrs Anzahl der Unterroutinen, die die Routine enthält
Prozent Prozentsatz der gesamten Implementierungszeit
usec Exklusive Routinelaufzeit in Mikrosekunden
cumusec Inklusive Routinelaufzeit in Mikrosekunden
count Exklusive Hardware-Anzahl
totalcount Inklusive Hardwareanzahl
stddev Standardabweichung
usecs/call Mikrosekunden pro Anruf
Anzahl/Anruf Hardware-Anzahl pro Anruf

Einige FELDER sind nur für bestimmte Dateien verfügbar. Wenn Hardwarezähler verwendet werden, dann
usec, cumusec, usecs/pro Aufruf sind nicht anwendbar und es wird ein Fehler gemeldet. Das Gegenteil ist der Fall
true, wenn Timing-Daten anstelle von Hardware-Zählern verwendet werden. Außerdem ist nur stddev verfügbar
für bestimmte Dateien, die diese Daten enthalten.

Ein OPERATOR ist einer der folgenden Werte: < (kleiner als), > (größer als) oder = (gleich).

Eine Zahl ist eine beliebige Zahl.

Eine zusammengesetzte Regel kann durch die Verwendung des Symbols & (und) zwischen zwei einfachen Regeln gebildet werden.
Es gibt kein „ODER“, da zwischen zwei einzelnen einfachen Regeln ein implizites Oder besteht
eine separate Zeile. (d. h. die zusammengesetzte Regel usec < 1000 OR numcalls = 1 ist dieselbe wie die beiden
einfache Regeln „usec < 1000“ und „numcalls = 1“).

REGEL Beispiele:

#Alle Routinen ausschließen, die Mitglieder von TAU_USER sind und weniger als haben
#1000 Mikrosekunden
TAU_USER:usec < 1000

#exclude alle Routinen, die weniger als 1000 Mikrosekunden haben und sind
#nur einmal angerufen.
usec < 1000 & numcalls = 1

#schließt alle Routinen aus, die weniger als 1000 Usecs pro Aufruf haben ODER einen Prozentsatz haben
#weniger als 5
usecs/Anruf < 1000
Prozent < 5

HINWEIS: Jede Zeile in der Regeldatei, die mit einem # beginnt, ist eine Kommentarzeile. Aus Gründen der Übersichtlichkeit leer
Zeilen können zwischen Regeln eingefügt werden und werden ebenfalls ignoriert.

OPTIONAL

-f Dateiname Geben Sie den Dateinamen der pprof-Dump-Datei an

-p Gibt alle Funktionen mit ihren Attributen aus

-o Dateiname Geben Sie den Dateinamen für die Ausgabe der ausgewählten Datei an (Standard: Auf dem Bildschirm drucken).

-r Dateiname Geben Sie den Dateinamen für die Regeldatei an

-v Ausführlicher Modus (für jede Regel die Regel und alle darin ausgeschlossenen Funktionen ausdrucken)

Beispiele:

Zum Ausdrucken der selektiven Instrumentierungsliste für die Paraprof-Dump-Datei auf dem Bildschirm
app.prf mit Standardauswahlregeln verwenden:

tau_reduce -f app.prf

So erstellen Sie mithilfe von Regeln eine Auswahldatei, app.sel, aus der Paraprof-Dump-Datei app.prf
In foo.rlf angegebene Verwendung:

tau_reduce -f app.prf -r foo.rlf -o app.sel

Nutzen Sie tau_reduce online über die Dienste von onworks.net