TAEF の終了コード
TAEF の "Te.exe" コマンド ライン実行可能フロントエンドは、実行中にエラーが発生した場合、0 以外の終了コードを返します。 "エラー" にはさまざまな起こり方があり、プロセスの終了コードはそれを反映します。
Te.exeからのプロセス終了コードは 32 ビットの数値であり、この数値内の異なるビットは、異なるタイプのエラーを反映します。 終了コードは次のように分類されます。
- ビット 0 から 15: "テスト結果の値" - これは、合格しないテストの数値です。
- ビット 16 から 23: "TestMode 結果値" - TestMode からのエラー (まだ使用されていません)。
- ビット 24 から 30: "ハーネスの結果の値" - ハーネス自体からのエラー。
最も重要なビット (ビット 31、符号付き数値の符号ビット) は、符号付き/符号なしの混同を回避するために使用されません。 プロセス終了コードは常に正の値です。 より現実的な言い方をすれば
- 終了コードが 0xFFFF (65535) 以下の場合、これは、Te.exeが実行した不合格テスト (失敗、ブロック、実行なし、スキップ) の数です。 65535 以上のテストが合格しなかった場合、値は 65535 に制限されます。
- 終了コードが 0xFFFF/65535 より大きい場合、実行中のテスト コード以外の問題が発生しています。
次の一覧は、現在の "ハーネスの結果の値" とその解釈を示しています。
| ハーネスの結果の値 | Te.exe 終了コード | 解釈 |
|---|---|---|
| 1 | 0x01000000 (16777216) | ヘルプが要求されました ("/?" または "/!") - テストは実行されませんでした。 |
| 2 | 0x02000000 (33554432) | Wex.Logger がエラーを報告しました。 |
| 3 | 0x03000000 (50331648) | Wex.Logger を初期化できませんでした。 |
| 4 | 0x04000000 (67108864) | Wex.Logger によって無効な成功/失敗数が生成されました (通常、テストからの StartGroup/Engroup 呼び出しの不均衡) |
| 5 | 0x05000000 (83886080) | 無効なコマンド ライン (有効なテスト ファイルが指定されませんでした。"/inproc" は複数のテスト ファイルで指定されています)。 |
| 6 | 0x06000000 (100663296) | その他の例外が発生しました。 |
| 7 | 0x07000000 (117440512) | テストが実行されませんでした。 |
| 8 | 0x08000000 (134217728) | TAEF セッションがタイムアウトしました。 |
| 9 | 0x09000000 (150994944) | バージョン情報が要求されました ("/version") - テストは実行されませんでした。 |