Reference

テストを記述するためのAPIについてはAPIリファレンスを参照してください。

auditor

名称

auditor — コンソールサーバ

書式

autditor  [--port=ポート番号 ]

詳説

コンソールサーバを実行し、指定されたポート番号でクライアントからの接続を待ちます。

--portオプションを省略した場合、デフォルトのポート番号として30000を使用します。

funnel

名称

funnel — ファンネル

書式

funnel 共有ライブラリのパスリスト  [-s]  [-m]  [-t 秒数 ]  [-d ホスト名 [:ポート番号 ]]  テストクラスのパス  [...]

詳説

テスト対象とそのスタブである共有ライブラリをロードして、指定されたテストを実行します。

共有ライブラリのパスリスト には、テスト対象とスタブの共有ライブラリのパスをコロンで連結したものを指定します。

-sオプションを指定した場合、スタンドアロンモード（後述）で処理を開始します。そうでなければ、-dオプションが指定するコンソールサーバに接続して、コンソールサーバ経由でユーザと対話します。

-mオプションを指定した場合、メモリリークの検出を有効にします。

-tオプションはテストのタイムアウト時間を指定します。テストメソッドの呼び出しが-tオプションで指定した秒数 を経過しても戻ってこない場合、そのテストメソッドは失敗します。秒数 は正の整数でなければなりません。-tオプションを省略した場合、5秒を指定したとみなします。

-dオプションと環境変数TF_DISPLAYの値で接続するコンソールサーバを選択できます。環境変数TF_DISPLAYの値は ホスト名 [:ポート番号 ]という（-dオプションの引数と同じ）形式で指定します。

接続するコンソールサーバは次の順序で決定します。

1. -dオプションが指定された場合、その値
2. 環境変数TF_DISPLAYが定義されていた場合、その値
3. ローカルホストのデフォルトポート

ポート番号を省略した場合はデフォルトのポート番号（30000）を使用します。

共有ライブラリは環境変数LD_PRELOADを使用して起動時にファンネルとリンクされます。テストクラスはdlopen(3)でダイナミックリンクされます。

スタンドアロンモード

スタンドアロンモードでは、環境変数TF_DISPLAYや-dオプションの値を無視して、指定された順にテストクラスのテストメソッドをすべて実行します（テストクラスに含まれるテストメソッドの実行順序は不定です）。

すべてのテストに成功するとステータスコード0で終了します。そうでなれば、速やかにステータスコード1で終了します。-mオプションが指定される場合、テストに成功しても、メモリリークが検出された場合は、テストは失敗したものとしてみなされます。

制限事項

gccのコンパイルオプション-fomit-frame-pointerを指定してコンパイルした共有ライブラリは使用できません。