ggcov-webdb - クラウド上のオンライン

プログラム：

NAME

ggcov-webdb - ggcov Web インターフェイス用の中間データベースを生成します

SYNOPSIS

ggcov-webdb [[-r] ディレクトリにジョブを開始します。|file]..。

DESCRIPTION

Ggcov-webdb 開発ファイルから中間データベースとソース ファイルのツリーを生成します。
tarball 形式のディレクトリ。 この tarball 内のファイルは、後で
ggcov WWW ブラウザにテスト カバレッジ データを表示するための PHP ページ。

テスト カバレッジ データは、次のようにコンパイルされた C および C++ プログラムによって生成されます。 gccの -fprofile-arcs
-ftest-カバレッジ。 したがって、次の組み合わせは、 ggcov-webdb と ggcov PHP ページは基本的に
WWW の代替品 gcov 付属のプログラム gccの.

中間データベースのアプローチは、開発が行われる一般的なケースを処理するために使用されます。
マシンと Web サーバー マシンは別個です。 データベースにはカバレッジ データが含まれています。
インデックス付き、プラットフォームに依存しない、PHP に優しいフォーム。 データベースの形式が
プラットフォームに依存しないため、PHP ページは別の Web サーバーにデプロイできます。
アーキテクチャから開発マシンまで。 実際、 ggcov Web ページはあらゆる Web をサポートします
次の基準を満たすサーバー:

· PHP バージョン 4.3 以降をサポートし、

· を提供します DBA の拡張子 db4 プロバイダー（ ggcov を読むために使用します
中間データベース)、および

· を提供します gd 拡張子（ ggcov の棒グラフを生成するために使用します。
概要ページ）。

　 sourceforge.net プロジェクト Web サーバーは、このようなサーバーの例です。

Ggcov-webdb 中間データベース自体を含む gzip 圧縮された tarball を生成し、
データベースに記載されているすべてのソース ファイルのコピー。 これですべてです
という情報 ggcov Web ページに必要な、コピー元の便利な XNUMX つのバンドル
開発マシンを Web サーバーに接続します。 通常、この tarball は次のファイルに抽出されます。
のサブディレクトリ /var/ggcov/tests/ Webサーバー上。

引数は、カバレッジ データ ファイルの検索方法を指定するために使用されます。 引数は次のことができます
以下の組み合わせ:

ディレクトリにジョブを開始します。
ディレクトリでソース ファイルがスキャンされ、ソース ファイルは、
コマンドラインで指定 (欠落しているカバレッジ データ ファイルはサイレントに処理されることを除く)
無視されます）。 もし -r フラグが有効な場合、サブディレクトリは再帰的にスキャンされます。
複数のディレクトリを指定でき、指定された順序でスキャンされます。

実行ファイル
実行可能ファイルは、ソース ファイルを含むデバッグ レコードをスキャンされます。
名前が付けられ、存在する各ソース ファイルは、上で指定されたかのように処理されます。
コマンド ライン (欠落しているカバレッジ データ ファイルが黙って無視される場合を除く)。
実行可能ファイルが依存する共有ライブラリもスキャンされます。 複数
実行可能ファイルを指定することができ、指定された順序でスキャンされます。 この機能は
一部のプラットフォーム (i386-linux など) でのみ利用可能です。

ソースファイル
いずれかのファイル拡張子で終わる通常のファイルですか .c, .ccに, .cxx, .cppまたは
.C。 ソース ファイルは、対応するカバレッジ データ ファイル (.gcno および
.gcda ファイル、または .bb, .bbg, 与える 古いコンパイラを使用したファイル）とオブジェクト ファイル
同じベース名と適切な拡張子のファイルを最初に検索します。
ソースファイルと同じディレクトリ、そして上で指定されたすべてのディレクトリ
コマンドライン (指定された順序)。

OPTIONS

-f テスト.tgz, -出力ファイル=テスト.tgz
ファイル名への出力を生成 テスト.tgz デフォルトの代わりに ggcov.webdb.tgzを選択します。
特別なファイル名 - 標準出力への出力を生成するために使用できます。

-o DIR, -オブジェクトディレクトリ=DIR
ディレクトリを追加します DIR オブジェクト ファイルとカバレッジ データ ファイルの検索パスに追加されます。

-r, -再帰的
コマンドラインでディレクトリを指定した場合、カバレッジデータファイルを検索します
すべての子ディレクトリで再帰的に実行されます。

-X を示すマークを追加しました, --suppress-ifdef=を示すマークを追加しました
統計や要約には、C プリプロセッサ ディレクティブ内のコードを含めないでください。
与えられたいずれかに依存します を示すマークを追加しました。 XNUMX つ以上の記号を指定できます。
カンマまたは空白で区切ります。 Ggcov-webdb 次のサブセットを理解します
C プリプロセッサ コマンド セット:

· #もし SYMBOL
· #もし 定義済み(SYMBOL)
· #ifdef SYMBOL
· #ifndef SYMBOL
· ＃その他
· #endif

たとえば、 -X DEBUG を抑制します fprintf（） このコードで呼び出します:

unsigned int
my_function(unsigned int x)
{
x += 42;
#ifdef デバッグ
fprintf(stderr, "my_function: x=%u\n", x);
#endif
x を返します。
}

このオプションは、テスト インフラストラクチャ コードの抑制、コードのデバッグ、または
カバレッジ テストの実行可能ファイルにコンパイルされるが、そのカバレッジが含まれるその他のコード
重要ではありません。

-Y 言葉, --コメント抑制=言葉
統計や要約には、
指定されたコメントのうち XNUMX つだけを含む単一行のコメント 言葉。 XNUMX つ以上のシンボル
カンマまたは空白で区切って指定できます。 たとえば、次のように指定します。 -Y
私を無視 を抑制します 主張する（） このコードでは:

unsigned int
my_function(unsigned int x)
{
x += 42;
アサート(x >= 42); /* 私を無視 */
x を返します。
}

このオプションは、テスト インフラストラクチャ コードの抑制、コードのデバッグ、または
カバレッジ テストの実行可能ファイルにコンパイルされるが、そのカバレッジが含まれるその他のコード
重要ではありません。

-Z 開始語、終了語、...

--コメント間の抑制=開始語、終了語、...
統計や要約には、
のみで構成される単一行のコメント スタートワード そして次の一行コメント
のみを含む 終わりの言葉。 XNUMX つ以上のシンボルをペアで指定できます。
カンマまたは空白。 例えば、 -Z 開始、終了 を抑制します
このコードの関数全体:

/* 開始 */
unsigned int
my_function(unsigned int x)
{
x += 42;
x を返します。
}
// エンディグノア

このオプションは、テスト インフラストラクチャ コードの抑制、コードのデバッグ、または
カバレッジ テストの実行可能ファイルにコンパイルされるが、そのカバレッジが含まれるその他のコード
重要ではありません。

例

実行可能ファイル内の利用可能なすべてのソースの中間データベースを生成します。 アウト （に
一部のプラットフォームのみ)、テストとしてインストールします foo デフォルトのテストの場所にあります。

mkdir /var/ggcov/tests/foo
ggcov-webdb -f - アウト |
（CD /var/ggcov/tests/foo ; tar -xzf - )

現在のディレクトリにあるすべての C ソースの中間データベースを生成します。

ggcov-webdb *。NS

すべての C ソースの中間データベースを XNUMX つのディレクトリに生成します。
ファイルとテスト カバレッジ データ ファイルは別のディレクトリにあります。

ggcov-webdb /foo/obj/ /foo/cov-data/ /foo/src/

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