llvm-cov-3.7 – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

llvm-cov – Abdeckungsinformationen ausgeben

ZUSAMMENFASSUNG

llvm-cov Befehl [Argumente...]

BESCHREIBUNG

Das llvm-cov Das Tool zeigt Informationen zur Codeabdeckung für Programme an, die instrumentiert sind
Profildaten ausgeben. Es kann zum Arbeiten verwendet werden gcov-Style-Abdeckung oder mit Klappern's
instrumentierungsbasiertes Profiling.

Wenn das Programm mit einem Basisnamen aufgerufen wird gcov, es wird sich so verhalten, als ob llvm-cov gcov
Befehl wurden aufgerufen. Andernfalls sollte ein Befehl bereitgestellt werden.

BEFEHLE

· gcov

· erklären

· berichten

GCOV COMMAND

ZUSAMMENFASSUNG
llvm-cov gcov [Optionen] QUELLDATEI

BESCHREIBUNG
Das llvm-cov gcov Das Tool liest Dateien mit Codeabdeckungsdaten und zeigt die Abdeckung an
Informationen für eine angegebene Quelldatei. Es ist kompatibel mit dem gcov Werkzeug ab Version
4.2 von GCC und ist möglicherweise auch mit einigen späteren Versionen von kompatibel gcov.

So verwenden Sie llvm-cov gcov, müssen Sie zunächst eine instrumentierte Version Ihrer Anwendung erstellen
das während der Ausführung Abdeckungsdaten sammelt. Kompilieren Sie mit dem -fprofile-Bögen und
-Ftest-Abdeckung Optionen zum Hinzufügen der Instrumentierung. (Alternativ können Sie auch die verwenden
--Abdeckung Option, die diese beiden anderen Optionen enthält.) Sie sollten mit kompilieren
Debugging-Informationen (-g) und ohne Optimierung (-O0); andernfalls die Abdeckungsdaten
kann nicht genau auf den Quellcode zurückgeführt werden.

Wenn Sie den instrumentierten Code kompilieren, a .gcnr Die Datendatei wird für generiert
jede Objektdatei. Diese .gcnr Dateien enthalten die Hälfte der Abdeckungsdaten. Die andere Hälfte
Die Daten stammen von .ggda Dateien, die generiert werden, wenn Sie das instrumentierte Programm ausführen,
mit einem separaten .ggda Datei für jede Objektdatei. Jedes Mal, wenn Sie das Programm ausführen, wird die
Die Anzahl der Ausführungen wird zu allen vorhandenen addiert .ggda Entfernen Sie daher unbedingt alle alten Dateien
Dateien, wenn Sie nicht möchten, dass deren Inhalt einbezogen wird.

Standardmäßig ist die .ggda Dateien werden in dasselbe Verzeichnis wie die Objektdateien geschrieben, aber
Sie können dies überschreiben, indem Sie die festlegen GCOV_PREFIX und GCOV_PREFIX_STRIP Umwelt
Variablen. Die GCOV_PREFIX_STRIP Variable gibt eine Anzahl von Verzeichniskomponenten an
vom Anfang des absoluten Pfads zum Objektdateiverzeichnis entfernt. Nach dem Strippen
Diese Verzeichnisse, das Präfix aus dem GCOV_PREFIX Variable wird hinzugefügt. Diese Umgebung
Mit Variablen können Sie das instrumentierte Programm auf einem Computer ausführen, auf dem sich das ursprüngliche Objekt befindet
Auf die Dateiverzeichnisse kann nicht zugegriffen werden, Sie müssen sie dann aber kopieren .ggda Dateien zurück
zu den Objektdateiverzeichnissen, wo llvm-cov gcov erwartet, sie zu finden.

Sobald Sie die Abdeckungsdatendateien generiert haben, führen Sie sie aus llvm-cov gcov für jede Hauptquelle
Datei, in der Sie die Abdeckungsergebnisse überprüfen möchten. Dies sollte von demselben ausgeführt werden
Verzeichnis, in dem Sie zuvor den Compiler ausgeführt haben. Die Ergebnisse für die angegebene Quelldatei
werden durch Anhängen von a in eine Datei mit dem Namen geschrieben .gcov Suffix. Eine separate Ausgabedatei ist ebenfalls vorhanden
erstellt für jede Datei, die in der Hauptquelldatei enthalten ist, auch mit a .gcov Suffix hinzugefügt.

Der grundlegende Inhalt einer .gcov Die Ausgabedatei ist eine Kopie der Quelldatei mit einer Ausführung
Anzahl und Zeilennummer werden jeder Zeile vorangestellt. Die Ausführungsanzahl wird als angezeigt - wenn eine Zeile
enthält keinen ausführbaren Code. Wenn eine Zeile Code enthält, dieser Code jedoch nie vorhanden war
ausgeführt wird, wird die Anzahl als angezeigt #####.

OPTIONAL
-a, --alle-blöcke
Alle Grundbausteine ​​anzeigen. Wenn es mehrere Blöcke für eine einzelne Quellzeile gibt
Im Code bewirkt diese Option, dass llvm-cov die Anzahl für jeden Block anzeigt und nicht nur
eine Zählung für die gesamte Zeile.

-B, --branch-wahrscheinlichkeiten
Zeigen Sie bedingte Verzweigungswahrscheinlichkeiten und eine Zusammenfassung der Verzweigungsinformationen an.

-C, --Branchenzählungen
Zweiganzahlen anstelle von Wahrscheinlichkeiten anzeigen (erfordert -b).

-F, --Funktionszusammenfassungen
Zeigen Sie eine Zusammenfassung der Abdeckung für jede Funktion an, anstatt nur eine Zusammenfassung für eine
gesamte Quelldatei.

--help Verfügbare Optionen anzeigen (--help-hidden für mehr).

- l, --lange-Dateinamen
Für die Coverage-Ausgabe von Dateien, die in der Hauptquelldatei enthalten sind, fügen Sie die Hauptdatei hinzu
Name gefolgt von ## als Präfix für die Ausgabedateinamen. Dies kann mit kombiniert werden
die Option --preserve-paths, um vollständige Pfade sowohl für die Hauptdatei als auch für die Datei zu verwenden
enthaltene Datei.

-nicht, --keine Leistung
Keine ausgeben .gcov Dateien. Zusammenfassende Informationen werden weiterhin angezeigt.

-o= , --object-directory= , --object-file=
Finden Sie Objekte im DIR oder basierend auf dem FILE-Pfad. Wenn Sie ein bestimmtes Objekt angeben
wird erwartet, dass die Coverage-Datendateien denselben Basisnamen haben .gcnr
und .ggda Erweiterungen. Wenn Sie ein Verzeichnis angeben, werden die Dateien darin erwartet
Verzeichnis mit demselben Basisnamen wie die Quelldatei.

-P, --preserve-pfade
Behalten Sie Pfadkomponenten bei der Benennung der Coverage-Ausgabedateien bei. In Ergänzung zu
Geben Sie den Namen der Quelldatei an und schließen Sie die Verzeichnisse aus dem Pfad zu dieser Datei ein. Der
Verzeichnisse sind durch getrennt # Zeichen, mit . Verzeichnisse entfernt und ..
Verzeichnisse ersetzt durch ^ Figuren. Bei Verwendung mit der Option --long-file-names
Dies gilt sowohl für den Hauptdateinamen als auch für den enthaltenen Dateinamen.

-du, --unconditional-branches
Fügen Sie bedingungslose Verzweigungen in die Ausgabe für die Option --branch-probabilities ein.

-Ausführung
Zeigt die Version von llvm-cov an.

EXIT STATUS
llvm-cov gcov gibt 1 zurück, wenn Eingabedateien nicht gelesen werden können. Andernfalls wird es mit Null beendet.

SHOW COMMAND

ZUSAMMENFASSUNG
llvm-cov erklären [Optionen] -instr-profile PROFIL BIN [QUELLEN]

BESCHREIBUNG
Das llvm-cov erklären Der Befehl zeigt Zeile für Zeile die Abdeckung einer Binärdatei an BIN Verwenden des Profils
technische Daten PROFIL. Es kann optional gefiltert werden, um nur die Abdeckung für die aufgelisteten Dateien anzuzeigen
in QUELLEN.

So verwenden Sie llvm-cov erklären, benötigen Sie ein Programm, das mit der zu emittierenden Instrumentierung kompiliert ist
Profil- und Abdeckungsdaten. Um ein solches Programm zu erstellen Klappern verwenden Sie die
-fprofile-instr-generate und -fcoverage-mapping Flaggen. Bei einer Verlinkung mit dem Klappern Treiber,
passieren -fprofile-instr-generate bis zur Link-Phase, um die erforderliche Laufzeit sicherzustellen
Bibliotheken sind eingebunden.

Die Abdeckungsinformationen werden in der erstellten ausführbaren Datei oder Bibliothek selbst gespeichert
worauf Sie übergehen sollten llvm-cov erklären wie die BIN Streit. Die Profildaten werden generiert
indem Sie dieses instrumentierte Programm normal ausführen. Wenn das Programm beendet wird, wird ein ausgegeben
Rohprofildatei, normalerweise aufgerufen default.profraw, das in ein Format konvertiert werden kann
das ist passend für die PROFIL Argument mit der llvm-profdata fusionieren Werkzeug.

OPTIONAL
-show-line-counts
Zeigen Sie die Ausführungsanzahl für jede Zeile an. Dies ist standardmäßig aktiviert, sofern nicht anders angegeben
-Show Option verwendet wird.

-Show-Erweiterungen
Erweitern Sie Einschlüsse wie Präprozessormakros oder Texteinschlüsse inline im
Anzeige der Quelldatei.

-show-Instantiierungen
Für Quellregionen, die mehrfach instanziiert werden, z. B. Vorlagen in C + +,
Zeigen Sie jede Instanziierung einzeln sowie die kombinierte Zusammenfassung an.

-Regionen anzeigen
Zeigen Sie die Ausführungsanzahl für jede Region an, indem Sie ein Caret anzeigen, das auf die zeigt
Zeichen, wo die Region beginnt.

-show-line-counts-or-regions
Zeigt die Ausführungsanzahl für jede Zeile an, wenn es nur einen Bereich in der Zeile gibt.
Zeigen Sie jedoch die einzelnen Regionen an, wenn mehrere in der Zeile vorhanden sind.

-use-color[=VALUE]
Farbausgabe aktivieren oder deaktivieren. Standardmäßig wird dies automatisch erkannt.

-arch=
Wenn es sich bei der abgedeckten Binärdatei um eine universelle Binärdatei handelt, wählen Sie die zu verwendende Architektur aus. Es ist
ein Fehler bei der Angabe einer Architektur, die nicht in der universellen Binärdatei enthalten ist oder
eine Architektur zu verwenden, die nicht zu einer nicht-universellen Binärdatei passt.

-name=
Codeabdeckung nur für Funktionen mit dem angegebenen Namen anzeigen.

-name-regex=
Codeabdeckung nur für Funktionen anzeigen, die dem angegebenen regulären Ausdruck entsprechen.

-line-coverage-gt=
Codeabdeckung nur für Funktionen anzeigen, deren Zeilenabdeckung größer als die angegebene ist
Schwelle.

-line-coverage-lt=
Codeabdeckung nur für Funktionen anzeigen, deren Zeilenabdeckung geringer als die angegebene ist
Schwelle.

-region-coverage-gt=
Codeabdeckung nur für Funktionen anzeigen, deren Regionsabdeckung größer als die angegebene ist
Schwelle.

-region-coverage-lt=
Codeabdeckung nur für Funktionen anzeigen, deren Regionsabdeckung geringer als die angegebene ist
Schwelle.

BERICHT COMMAND

ZUSAMMENFASSUNG
llvm-cov berichten [Optionen] -instr-profile PROFIL BIN [QUELLEN]

BESCHREIBUNG
Das llvm-cov berichten Der Befehl zeigt eine Zusammenfassung der Abdeckung einer Binärdatei an BIN Verwendung der
Profildaten PROFIL. Es kann optional gefiltert werden, um nur die Abdeckung für anzuzeigen
Dateien aufgelistet in QUELLEN.

Wenn keine Quelldateien bereitgestellt werden, wird für jede Datei im Coverage eine Zusammenfassungszeile gedruckt
Daten. Wenn Dateien bereitgestellt werden, werden in den aufgelisteten Dateien Zusammenfassungen für jede Funktion angezeigt
stattdessen.

Informationen zum Zusammenstellen von Programmen zur Abdeckung und zum Generieren von Profildaten finden Sie unter SHOW
COMMAND.

OPTIONAL
-use-color[=VALUE]
Farbausgabe aktivieren oder deaktivieren. Standardmäßig wird dies automatisch erkannt.

-arch=
Wenn es sich bei der abgedeckten Binärdatei um eine universelle Binärdatei handelt, wählen Sie die zu verwendende Architektur aus. Es ist
ein Fehler bei der Angabe einer Architektur, die nicht in der universellen Binärdatei enthalten ist oder
eine Architektur zu verwenden, die nicht zu einer nicht-universellen Binärdatei passt.

Verwenden Sie llvm-cov-3.7 online über die Dienste von onworks.net