ヘッドレス・モードでのコード・カバレッジの実行

ヘッドレス・モードでコード・カバレッジを実行すると、UI を開かなくてもコード・カバレッジを実行することができます。 UI ワークベンチがインストールされていない環境や、コマンド行から (あるいはスクリプトの一部として) コード・カバレッジを実行する必要が生じる可能性のある環境では、これが理想的です。

このタスクについて

コマンド行から、またはスクリプトの一部として、デバッグ可能な任意のコンパイル済み言語アプリケーションに対してコード・カバレッジを実行できます。 以下の 2 つのモードでヘッドレス・コード・カバレッジを実行することができます。

  1. 接続を listen するデーモンとして (指定したポートを使ってリモート・デバッグ・エンジンと共に使用します - 詳しくは、ヘッドレス・モードでのコード・カバレッジの実行: デーモンを参照してください)。
  2. 引数として指定され、デバッグ情報と共にコンパイルされるプログラムに対して直接操作します (One Shot モード)。
    注: One Shot モードは AIX/Linux でのみ使用可能です。zSeries では使用できません。
    $ codecov testProg
注: 結果は、ユーザーのホーム・ディレクトリーのルート (CC フォルダーの下) に日付別に保管されます。
codecov コマンドの構文図は、次のとおりです。
>>-codecov--+----------------------------------------------------------------------------------------------------------------+--><
            |                                                                                                                |
            + -stopdaemon=<PORT_NUMBER> -------------------------------------------------------------------------------------+
            |                                                                                                                |
            + <PROGRAM_NAME>  <PROGRAM_PARAMETERS>  -optionsfile=<PATH> --+                                                  |
            |                                                             |                                                  |
            |                                     .------------------.    |                                                  |
            |                                     v                  |    v                                                  |
            + -startdaemon  -optionsfile=<PATH> --+--------------------------+--------------------------------------------+--+
            |                                     |                  |       |                                            |  |
            |                                     + -singleconnect --+       + -output=<PATH> ----------------------------+  |
            |                                     |           	     |       |                                            |  |
            |                                     + -localonly ------+       + -cclevel=<"LINE" | "FUNCTION" | "LEVEL"> --+  |
            |                                                                |                                            |  |
            |                                                                + -prevresultpath=<"NONE" | "PREV" | PATH> --+  |
            |                                                                |                                            |  |
            |                                                                + -reportformat=<"HTML" | "NONE"> -----------+  |
            |                                                                |                                            |  |
            |                                                                + -savesource -------------------------------+  |
            |                                                                |                                            |  |
            |                                                                + -startupcommandlist=<PATH> ----------------+  |
            |                                                                |                                            |  |
            |                                                                + -zipresult --------------------------------+  |
            |                                                                |                                            |  |
            |                                                                + -port=<PORT_LIST> -------------------------+  |
            |                                                                                                                |  
            + -help ---------------------------------------------------------------------------------------------------------+  
                                           
オプション・リスト
形式: codecov [options] [program_name] [program_parameters]
program_name
コード・カバレッジを実行する対象となる実行可能ファイルの絶対パス。
注: One Shot モードは AIX/Linux でのみ使用可能です。zSeries では使用できません。
program_parameters
プログラム用のパラメーター。
注: One Shot モードは AIX/Linux でのみ使用可能です。zSeries では使用できません。
-startdaemon
デーモン・モードで開始し、接続を待機します。
-stopdaemon=<port>
ポートで listen しているデーモンを停止します。
-cclevel=<"LINE" | "FUNCTION" | "MODULE">
コード・カバレッジ・レベル ("LINE"、”FUNCTION"、または "MODULE" のいずれか)
-modulelist=<path>
必要に応じて、MODULE レベル・コード・カバレッジによって使用されるリスト・モジュールが入ったファイルを指定します。
-prevresultpath=<"NONE" | "PREV" | path>
前の結果ファイルのパスを指定します。
-reportformat=<"HTML" | "NONE">
レポート形式が HTML である場合に HTML レポートを生成します。
-singleconnect
1 つのデーモン接続後に終了します (-startDaemon と共に使用する必要があります)。
-localonly
デーモンはローカル・ホストからの接続のみを受け入れます。
startupcommandlist=<path>
始動時にデバッグ・エンジンに送信されるコマンドを含むファイルを指定します。
-savesource
ソースを結果と共に保存します。
-optionsfile=<path>
指定されたオプション・ファイルからコマンド引数を読み取ります。
-tag="text"
CC 結果に関連付けられるタグを指定します (例えばテスト・ケース ID)。
-zipresult
結果ディレクトリーが、結果ディレクトリーと同じ名前の zip ファイルに圧縮されます。
-port=<port_list>
デバッグ・デーモンによって使用されるポート番号、ポート・リスト (port,port) またはポート範囲 (port-port)。
-help
ヘルプ画面を表示します。

フィードバック