llvm-cov-3.7 - クラウドでオンライン

プログラム：

NAME

llvm-cov - カバレッジ情報の出力

SYNOPSIS

llvm-cov command [引数..。]

DESCRIPTION

　 llvm-cov ツールは、インストルメントされたプログラムのコード カバレッジ情報を表示します。
プロファイルデータを出力します。 作業に使用できます gcov-スタイルのカバレッジまたは 打ち鳴らします's
インストルメンテーションベースのプロファイリング。

プログラムがベース名で呼び出された場合、 gcov、次のように動作します。 llvm-cov gcov
コマンドが呼び出されました。 それ以外の場合は、コマンドを指定する必要があります。

コマンド

· gcov

· 表示する

· レポート

GCOV COMMAND

SYNOPSIS
llvm-cov gcov [オプション] ソースファイル

DESCRIPTION
　 llvm-cov gcov ツールはコード カバレッジ データ ファイルを読み取り、カバレッジを表示します。
指定されたソースファイルの情報。 と互換性があります。 gcov バージョンのツール
の4.2 GCC の一部の以降のバージョンとも互換性がある可能性があります。 gcov.

使用するには llvm-cov gcov、最初にアプリケーションのインストルメント化されたバージョンを構築する必要があります
実行時にカバレッジ データを収集します。 でコンパイルします -fprofile-arcs &
-ftest-カバレッジ インストルメンテーションを追加するオプション。 (または、
- カバレッジ オプションには、他のオプションの両方が含まれます。) でコンパイルする必要があります。
デバッグ情報（-g) 最適化なし (-O0); それ以外の場合は、カバレッジ データ
ソース コードに正確にマッピングし直すことはできません。

インストルメント化されたコードをコンパイルするときに、 .gcno データファイルが生成されます
各オブジェクトファイル。 これらは .gcno ファイルにはカバレッジ データの半分が含まれています。 残りの半分は
データの由来は .gcda インストルメントされたプログラムを実行すると生成されるファイル、
別途 .gcda オブジェクトファイルごとにファイルを作成します。 プログラムを実行するたびに、
実行数は既存のすべての値に合計されます。 .gcda ファイルがあるため、古いファイルは必ず削除してください
ファイルの内容を含めたくない場合は、ファイルを削除します。

デフォルトでは、 .gcda ファイルはオブジェクトファイルと同じディレクトリに書き込まれますが、
を設定することでそれをオーバーライドできます GCOV_PREFIX & GCOV_PREFIX_STRIP 環境
変数。 NS GCOV_PREFIX_STRIP 変数は、ディレクトリコンポーネントの数を指定します。
オブジェクト ファイル ディレクトリへの絶対パスの先頭から削除されます。 剥離後
それらのディレクトリ、 GCOV_PREFIX 変数が追加されます。 こういった環境
変数を使用すると、元のオブジェクトが存在するマシン上でインストルメントされたプログラムを実行できます。
ファイル ディレクトリにはアクセスできませんが、ファイル ディレクトリをコピーする必要があります。 .gcda ファイルを戻す
オブジェクト ファイル ディレクトリに移動します。 llvm-cov gcov それらを見つけることを期待しています。

カバレッジ データ ファイルを生成したら、次のコマンドを実行します。 llvm-cov gcov メインソースごとに
カバレッジ結果を確認するファイルを選択します。 これは同じから実行する必要があります
以前にコンパイラを実行したディレクトリ。 指定されたソースファイルの結果
を追加した名前のファイルに書き込まれます。 .gcov サフィックス。 別の出力ファイルもあります
メイン ソース ファイルに含まれるファイルごとに作成され、 .gcov 接尾語が追加されました。

基本的な内容は、 .gcov 出力ファイルは、実行されたソース ファイルのコピーです。
count と行番号が各行の先頭に追加されます。 実行回数は次のように表示されます。 - 行の場合
実行可能コードは含まれていません。 行にコードが含まれているが、そのコードが存在しなかった場合
実行されると、カウントは次のように表示されます。 #####.

OPTIONS
-a、 -すべてのブロック
すべての基本ブロックを表示します。 ソースの XNUMX 行に複数のブロックがある場合
コードでは、このオプションを使用すると、llvm-cov は単にブロックごとにカウントを表示するのではなく、ブロックごとにカウントを表示します。
行全体で XNUMX つのカウント。

-NS、 -ブランチ確率
条件分岐確率と分岐情報の概要を表示します。

-NS、 -ブランチカウント
確率の代わりに分岐数を表示します (-b が必要)。

-NS、 -関数-要約
XNUMX つの機能について XNUMX つの概要だけを表示するのではなく、各機能の対象範囲の概要を表示します。
ソースファイル全体。

- 助けて 利用可能なオプションを表示します (詳細については --help-hidden)。

-l、 -長いファイル名
メイン ソース ファイルからインクルードされたファイルのカバレッジ出力の場合は、メイン ファイルを追加します
名前の後に続く ## 出力ファイル名の接頭辞として使用します。 これと組み合わせることができます
--preserve-paths オプションを使用すると、メイン ファイルと
付属のファイル。

-NS、 -出力なし
何も出力しない .gcov ファイル。 概要情報は引き続き表示されます。

-o= 、 --オブジェクトディレクトリ= 、 --オブジェクトファイル=
DIR 内のオブジェクト、または FILE のパスに基づいてオブジェクトを検索します。 特定のオブジェクトを指定する場合
ファイルの場合、カバレッジ データ ファイルは、以下と同じベース名を持つことが期待されます。 .gcno
& .gcda 拡張子。 ディレクトリを指定した場合、ファイルはその中にあると想定されます。
ソースファイルと同じベース名を持つディレクトリ。

-NS、 --保存パス
カバレッジ出力ファイルに名前を付けるときにパス コンポーネントを保持します。 に加えて、
ソース ファイル名には、そのファイルへのパスからのディレクトリが含まれます。 の
ディレクトリは次のように区切られています # 文字、付き . ディレクトリが削除され、 ..
に置き換えられるディレクトリ ^ 文字。 --long-file-names オプションと一緒に使用すると、
これは、メイン ファイル名とインクルード ファイル名の両方に当てはまります。

-u、 -無条件-ブランチ
--branch-probabilities オプションの出力に無条件分岐を含めます。

-バージョン
llvm-cov のバージョンを表示します。

EXIT ステータス
llvm-cov gcov 入力ファイルを読み取れない場合は 1 を返します。 それ以外の場合は、ゼロで終了します。

SHOW COMMAND

SYNOPSIS
llvm-cov 表示する [オプション] -instr-profile プロフィール BIN [SOURCES]

DESCRIPTION
　 llvm-cov 表示する コマンドはバイナリのカバレッジを行ごとに表示します BIN プロファイルを使用して
データ プロフィール。 オプションでフィルタリングして、リストされたファイルのカバレッジのみを表示できます。
in SOURCES.

使用するには llvm-cov 表示する、出力するにはインストルメンテーションを使用してコンパイルされたプログラムが必要です。
プロフィールと取材データ。 このようなプログラムを構築するには 打ち鳴らします 使用
-fprofile-instr-generate & -fcoverage-mapping フラグ。 とリンクする場合は、 打ち鳴らします ドライバ、
パス -fprofile-instr-generate 必要なランタイムを確認するためにリンクステージに送信します
ライブラリがリンクされています。

カバレッジ情報は、ビルドされた実行可能ファイルまたはライブラリ自体に保存されます。
何を渡すべきか llvm-cov 表示する として BIN 口論。 プロファイルデータが生成される
このインスツルメントされたプログラムを通常どおり実行することによって。 プログラムが終了すると、
生のプロファイル ファイル (通常は次のように呼ばれます) デフォルト.profraw形式に変換できます。
それはに適しています プロフィール を使用した引数 llvm-profdata マージ ツール。

OPTIONS
-show-行数
各行の実行数を表示します。 これは、別の場合を除き、デフォルトで有効になっています。
-公演 オプションが使用されます。

-show-expansions
プリプロセッサ マクロやテキスト インクルードなどのインクルードをインラインで展開します。
ソースファイルの表示。

-show-インスタンス化
複数回インスタンス化されるソース領域の場合 (テンプレートなど) C + +,
各インスタンス化を個別に表示するだけでなく、結合された概要も表示します。

-show-regions
を指すキャレットを表示して、各領域の実行数を表示します。
領域が始まる文字。

-show-line-counts-or-regions
行にリージョンが XNUMX つしかない場合、各行の実行数を表示します。
ただし、行上に複数の領域がある場合は、個々の領域を表示します。

-使用色[=VALUE]
カラー出力を有効または無効にします。 デフォルトでは、これは自動検出されます。

-アーチ=
対象のバイナリがユニバーサル バイナリの場合は、使用するアーキテクチャを選択します。 それは
ユニバーサル バイナリに含まれていないアーキテクチャを指定するエラー、または
非ユニバーサルバイナリと一致しないアーキテクチャを使用すること。

-名前=
指定された名前の関数のコード カバレッジのみを表示します。

-name-regex=
指定された正規表現に一致する関数のコード カバレッジのみを表示します。

-line-coverage-gt=
指定された行カバレッジより大きい関数のコード カバレッジのみを表示します。
閾値。

-ラインカバレッジ-lt=
指定された行カバレッジ未満の関数のコード カバレッジのみを表示します。
閾値。

-地域カバレッジ-gt=
指定されたリージョン カバレッジより大きい関数のコード カバレッジのみを表示します
閾値。

-地域のカバレッジ-lt=
指定された領域カバレッジ未満の関数のコード カバレッジのみを表示します。
閾値。

レポート COMMAND

SYNOPSIS
llvm-cov レポート [オプション] -instr-profile プロフィール BIN [SOURCES]

DESCRIPTION
　 llvm-cov レポート コマンドはバイナリのカバレッジの概要を表示します BIN
プロフィールデータ プロフィール。 オプションでフィルタリングして、次のカバレッジのみを表示できます。
にリストされているファイル SOURCES.

ソース ファイルが指定されていない場合は、カバレッジ内のファイルごとに概要行が出力されます。
データ。 ファイルが提供されている場合は、リストされたファイル内の各機能の概要が表示されます。
を代わりにお使いください。

カバレッジ用のプログラムのコンパイルとプロファイル データの生成については、を参照してください。 SHOW
COMMAND.

OPTIONS
-使用色[=VALUE]
カラー出力を有効または無効にします。 デフォルトでは、これは自動検出されます。

-アーチ=
対象のバイナリがユニバーサル バイナリの場合は、使用するアーキテクチャを選択します。 それは
ユニバーサル バイナリに含まれていないアーキテクチャを指定するエラー、または
非ユニバーサルバイナリと一致しないアーキテクチャを使用すること。

onworks.net サービスを使用してオンラインで llvm-cov-3.7 を使用する