Table of Contents
1 Valgrind Pluginとは
Valgrindを実行し、Jenkins上で結果を閲覧するプラグインです。
Valgrindの実行をValgrind Pluginに任せても独自に実行しても構いません。
2 valgrindのインストール
テスト実行環境にvalgrindをインストールします。Debian 8なのでapt-getでインストールします。
$ sudo apt-get install -y valgrind
3 Valgrind Pluginのインストール
Jenkinsのプラグイン制御画面からインストールします。
Jenkinsの管理 -> プラグインの管理 -> 利用可能
4 システムの設定
システムの設定のValgrind PublisherでValgrind検出箇所で表示するソースコードの行数を指定します。
Jenkinsの管理 -> システムの設定 -> Valgrind Publisher
Stacktrace, prefix lines of code Valgrind検出箇所で表示する前部分の行数 Stacktrace, suffix lines of code Valgrind検出箇所で表示する後部分の行数
5 ジョブの設定
5.1 ビルド手順の追加（Run Valgrind）
Run Valgrindでvalgrindの挙動を制御します。
主だったパラメータは以下の通りです。
Executable Include Pattern valgrindを実行するプログラム名（パターンマッチング） Executable Exclude Pattern valgrindを実行しないプログラム名（パターンマッチング） File Ending valgrind実行結果を保存するファイルのアペンディクス
Executable Include Patternに指定したパターンにマッチするプログラムに全てついてvalgrindが実行されます。
例えば、memleak1とmemleak2というプログラムがあった場合、memleak*を指定します。
Executable Exclude PatternはExecutable Include Patternの結果から除外するパターンを指定します。
例えば、memleak1とmemleak2というプログラムは実行したいが、memleak1.cとmemleak2.cを除外する場合は*.cを指定します。
File Endingに.valgrind.xmlを指定すると各プログラムに対して、以下の名前のxmlファイルにvalgrind実行結果が保存されます。
<program>.<pid>.valgrind.xml
5.2 ビルド後の処理の追加（Publish Valgrind results）
Report PatternにFile Endingで作成されたファイル名のパターンを指定します。
パターンではなく完全一致でも問題ありません。
5.3 ビルド手順の追加（独自の手順）
Run Valgrindは若干柔軟性に欠けるので（ディレクトリ変更に対応できない等）、独自にシェルスクリプトを実行してxmlファイルを出力しても良いでしょう。
以下のコマンドは/var/lib/jenkinsディレクトリ配下でJenkinsを動作させ、Run Valgrindの実行した場合と同等です。
$ valgrind –tool=memcheck –leak-check=full –show-reachable=no –undef-value-errors=no –track-origins=no –child-silent-after-fork=no –trace-children=no –gen-suppressions=no –xml=yes –xml-file=/var/lib/jenkins/jobs/a/workspace/memleak.%p.valgrind.xml /var/lib/jenkins/jobs/a/workspace/memleak
6 コンソール出力
memleakというプログラムに対して、コンソールに以下のように出力されました。
$ valgrind –version[Valgrind] detected valgrind version (valgrind): 3.10.0[Valgrind] includes files: memleak[Valgrind] working dir: /var/lib/jenkins/jobs/a/workspace[workspace] $ valgrind –tool=memcheck –leak-check=full–show-reachable=no –undef-value-errors=no –track-origins=no–child-silent-after-fork=no –trace-children=no–gen-suppressions=no –xml=yes–xml-file=/var/lib/jenkins/jobs/a/workspace/memleak.%p.valgrind.xml/var/lib/jenkins/jobs/a/workspace/memleak[Valgrind] valgrind exit code: 0[Valgrind] Files to copy:[Valgrind] memleak.16916.valgrind.xml[Valgrind] Copying memleak.16916.valgrind.xml to/var/lib/jenkins/jobs/a/builds/1/valgrind-plugin/valgrind-results/memleak.16916.valgrind.xml[Valgrind] Analysing valgrind results[Valgrind]’/mnt/valgrind-3.10.0/coregrind/m_replacemalloc/vg_replace_malloc.c’does not exist, source code won’t be available[Valgrind] copying source file’/var/lib/jenkins/jobs/a/workspace/memleak.c’ to ‘source_2.tmp’…[Valgrind] workspacePath: /var/lib/jenkins/jobs/a/workspace/[Valgrind] Ending the valgrind analysis.
7 結果
Valgrind実行結果のグラフを見ることができます。
Valgrind実行結果の詳細も見ることができます。
