llvm-cov-3.6 – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

llvm-cov – Abdeckungsinformationen ausgeben

ZUSAMMENFASSUNG

llvm-cov [Optionen] QUELLDATEI

BESCHREIBUNG

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

Um llvm-cov verwenden zu können, müssen Sie zunächst eine instrumentierte Version Ihrer Anwendung erstellen
sammelt während der Ausführung Abdeckungsdaten. 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,
(was diese beiden anderen Optionen enthält.) Sie sollten mit Debugging-Informationen kompilieren
(-g) und ohne Optimierung (-O0); Andernfalls können die Abdeckungsdaten nicht genau sein
auf den Quellcode zurückgebildet.

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, in denen llvm-cov sie erwartet.

Nachdem Sie die Abdeckungsdatendateien generiert haben, führen Sie llvm-cov für jede Hauptquelldatei aus
wo Sie die Abdeckungsergebnisse überprüfen möchten. Dies sollte im selben Verzeichnis ausgeführt werden
wo Sie zuvor den Compiler ausgeführt haben. Die Ergebnisse für die angegebene Quelldatei sind
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 llvm-cov-Ausgabedatei ist eine Kopie der Quelldatei mit einer
Ausführungsanzahl und Zeilennummer werden jeder Zeile vorangestellt. Die Ausführungsanzahl wird als angezeigt -
wenn eine Zeile keinen ausführbaren Code enthält. Wenn eine Zeile Code enthält, dieser Code jedoch vorhanden war
nie ausgeführt, die Anzahl wird 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 gibt 1 zurück, wenn Eingabedateien nicht gelesen werden können. Andernfalls wird es mit Null beendet.

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