GCov の

Gcovはソースコードカバレッジ分析およびステートメントごとのプロファイリングツールです。Gcov はプログラム内の各ステートメントの実行回数を正確にカウントし、ソースコードに注釈を付けてインストルメンテーションを追加します。Gcov はGNU コンパイラコレクション(GCC) スイートの標準ユーティリティとして提供されています。 ^[1]

gcov ユーティリティは、プログラムがコードセグメントを実行する頻度に関する情報を提供します。^[2]これは、実行頻度の注釈が付いたソースファイルのコピーを生成します。gcov ユーティリティは時間ベースのデータを生成せず、GCC スイートでコンパイルされたコードでのみ機能します。マニュアルには、他のプロファイリングやテストカバレッジメカニズムとは互換性がないと記載されていますが、^[3] llvmで生成されたファイルでも機能します。 ^[4]

gcov は、特別にインストルメントされたプログラムのテスト カバレッジ分析を生成します。-fprofile-arcs -ftest-coverageカバレッジ分析用にプログラムをコンパイルするには、オプションを使用する必要があります (最初のオプションは分岐統計を記録し、2 番目は行実行カウントを保存します)。-fprofile-arcsまた、プログラムをリンクするためにも使用する必要があります。^[2]このようなプログラムを実行すると、gcov で分析できる拡張子 (サフィックス) を持ついくつかのファイルが作成されます。ソース ファイルをコマンド ライン引数として受け取り、注釈付きのソース リストを生成します。ソース コードの各行には、実行回数がプレフィックスとして付けられます。実行されていない行には、プレフィックスとして "#####" が付けられます。^[2]

gcov は、ソース ファイルsourcefile.cの各行が何回実行されたかを示す、sourcefile.gcovというログ ファイルを作成します。この注釈付きソース ファイルは、別のプロファイリング ツールであるgprofで使用して、プログラムのタイミング情報を抽出できます。

Cで書かれた次のプログラムは、1 から 9 までの整数を ループし、係数 (%) 演算子を使用してそれらの割り切れるかどうかをテストします。

#include <stdio.h> 

int 
main ( void ) { int i ; 

   

  for ( i = 1 ; i < 10 ; i ++ ) { if ( i % 3 == 0 ) printf ( "%d は 3 で割り切れます\n " , i ); if ( i % 11 == 0 ) printf ( "%d は 11 で割り切れます\n " , i ); }       
  
         
        
         
        
  

  0 を返す; } 

カバレッジ テストを有効にするには、プログラムを次のオプションでコンパイルする必要があります。

gcc  -Wall  -fprofile-arcs  -ftest-coverage  cov.c を
実行します。

ここで、cov.c はプログラム ファイルの名前です。これにより、プログラムの各行が実行された回数を記録する追加の命令を含むインストルメントされた実行可能ファイルが作成されます。オプション-ftest-coverage は、個々の行が実行された回数をカウントする命令を追加し、-fprofile-arcs はプログラムの各ブランチのインストルメンテーション コードを組み込みます。ブランチ インストルメンテーションは、'if' ステートメントやその他の条件文を通じて異なるパスが実行される頻度を記録します。

その後、実行可能ファイルを実行してコードを分析してカバレッジ データを作成できます。

$ ./a.out

実行からのデータは、現在のディレクトリ内のそれぞれ拡張子が「.bb」、「.bbg」、「.da」の複数のカバレッジ データ ファイルに書き込まれます。

プログラムの実行が入力パラメータまたはデータに基づいて異なる場合は、複数回実行することができ、その結果は全体的な分析のためにカバレッジ データ ファイルに蓄積されます。

このデータは、gcov コマンドとソース ファイルの名前を使用して分析できます。

$ gcov  cov.cファイル cov.c の 9 行のソース行のうち 88.89% が実行されましたcov.c.gcov を作成しています 

gcovコマンドは、各行が実行された回数のカウントを含む、ファイル拡張子 '.gcov' を持つ 元のソース ファイルの注釈付きバージョンを生成します。

        #include <stdio.h> 

        int 
main ( void ) { 1 int i ;         
        
          

    10 for ( i = 1 ; i < 10 ; i ++ ) { 9 if ( i % 3 == 0 ) 3 printf ( "%d は 3 で割り切れます\n " , i ); 9 if ( i % 11 == 0 ) ###### printf ("%d は 11 で割り切れます\n", i); 9 }           
          
                
               
                

         

     1 0を返す; 1 }     
       

行数は出力の最初の列に表示されます。実行されなかった行にはハッシュ「######」が付きます。

Gcovコマンドラインユーティリティは、プロファイルデータから注釈付きファイルを生成する際に以下のオプションをサポートしています: ^{[5] [6]}

• -h ( --help ): gcov の使用に関するヘルプを (標準出力に) 表示し、それ以上の処理を行わずに終了します。
• -v ( --version ): gcov のバージョン番号を (標準出力に) 表示し、それ以上の処理を行わずに終了します。
• -a ( --all-blocks ): すべての基本ブロックの個別の実行回数を書き込みます。通常、gcov は行のメイン ブロックの実行回数のみを出力します。このオプションを使用すると、1 行内のブロックが実行されていないかどうかを判断できます。
• -b ( --branch-probabilities ): 分岐頻度を出力ファイルに書き込み、分岐概要情報を標準出力に書き込みます。このオプションを使用すると、プログラム内の各分岐がどのくらいの頻度で行われたかを確認できます。-u オプションが指定されていない限り、無条件分岐は表示されません。
• -c ( --branch-counts ): 分岐の頻度を、分岐の割合ではなく、分岐の数として書き込みます。
• -n ( --no-output ): gcov 出力ファイルを作成しません。
• -l ( --long-file-names ): インクルードされたソース ファイルの長いファイル名を作成します。たとえば、ヘッダー ファイル xh にコードが含まれており、それがファイル ac にインクルードされている場合、ファイル ac に対して gcov を実行すると、xhgcov ではなく ac##xhgcov という出力ファイルが生成されます。これは、xh が複数のソース ファイルにインクルードされており、個々の貢献を確認したい場合に便利です。`-p' オプションを使用すると、インクルードするファイル名とインクルードされるファイル名の両方が完全なパス名になります。
• -p ( --preserve-paths ): 生成された .gcov ファイルの名前に完全なパス情報を保存します。このオプションを指定しないと、ファイル名コンポーネントのみが使用されます。このオプションを指定すると、すべてのディレクトリが使用され、`/' 文字が `#' 文字に変換され、. ディレクトリ コンポーネントが削除され、削除できない .. コンポーネントの名前が `^' に変更されます。これは、ソース ファイルが複数の異なるディレクトリにある場合に便利です。
• -r ( --relative-only ): 相対パス名 (ソース プレフィックスの省略後) を持つソース ファイルに関する情報のみを出力します。絶対パスは通常、システム ヘッダー ファイルであり、そこに含まれるインライン関数のカバレッジは通常は重要ではありません。
• -f ( --function-summaries ): ファイルレベルの概要に加えて、各関数の概要を出力します。
• -o directory|file ( --object-directory directoryまたは--object-file file ): gcov データ ファイルを含むディレクトリまたはオブジェクト パス名を指定します。このオプションを使用して、.gcno および .gcda データ ファイルを検索します。ディレクトリが指定されている場合、データ ファイルはそのディレクトリにあり、入力ファイル名に基づいて拡張子なしで名前が付けられます。ここでファイルが指定されている場合、データ ファイルはそのファイル名に基づいて拡張子なしで名前が付けられます。
• -s ディレクトリ( --source-prefix ディレクトリ): 出力カバレッジ ファイルを生成するときに削除するソース ファイル名のプレフィックス。このオプションは、別のディレクトリにビルドする場合に役立ち、出力ファイル名を決定するときにソース ディレクトリへのパス名は必要ありません。このプレフィックス検出は、ソース ファイルが絶対であるかどうかを判断する前に適用されることに注意してください。
• -u ( --unconditional-branches ): 分岐確率が指定されている場合は、無条件分岐の分岐確率も含めます。無条件分岐は通常は重要ではありません。
• -d ( --display-progress ): 標準出力に進行状況を表示します。

Lcov はgcov のグラフィカル フロントエンドです。複数のソース ファイルの gcov データを収集し、カバレッジ情報で注釈を付けたソース コードを含むHTMLページを作成します。また、ファイル構造内でのナビゲーションを容易にするために概要ページも追加します。Lcov はステートメント、関数、および分岐のカバレッジ測定をサポートしています。^[7] Windows バージョンもあります。

Gcovr は、 gcov の使用を管理し、要約されたコード カバレッジ結果を生成するためのユーティリティを提供します。このコマンドは、Python で同様のユーティリティを提供する Python coverage.py パッケージにヒントを得ています。Gcovr は、コンパクトな人間が読める要約レポート、機械が読める XML レポート、またはグラフィカルな HTML 要約を生成します。gcovr によって生成された XML レポートは、Jenkinsでグラフィカルなコード カバレッジ要約を提供するために使用できます。Gcovr は、ステートメントおよび分岐カバレッジ測定をサポートしています^[8]

SCovは、 gcov（gcov -iを使用）によって生成された中間テキスト形式を処理して、コードカバレッジに関するレポートを生成するユーティリティです。これらのレポートは、単純なテキストレポート、またはより詳細なレポートを含むHTMLページになることができます。^[9]

• Tcov – Sun Studio スイートで提供される Solaris 用コード カバレッジ ツール
• Trucov - 機械可読な出力で Gcov を改良することを目的としている