名前 | 形式 | 使用条件 | 機能説明 | オプション | 使用例 | 環境 | 関連項目
SUNWvts
vts_cmd(1M) は、1 つのコマンドを SunVTS カーネル (vtsk) へ送信する UNIX シェルアプリケーションです。テスト対象のシステムの SunVTS カーネルは、標準出力に応答を送ります。
SunVTS アプリケーションプログラミングインタフェース (API) は、文字ベースで設計されています。つまり、( コマンドの) 文字列を SunVTS カーネルに送信できるということです。このとき SunVTS カーネルも文字列の形式で応答します。
vts_cmd では UNIX のコマンド行で、コマンドの発信や応答の受信を行うことができます。
vts_cmd は、以下にリストしたコマンドを使用します。いずれの場合でも vts_cmd に続けてコマンド (コマンドによっては引き数が必要) を指定します。使用方法については、「使用例」を参照してください。
以下にリストしたコマンド記述の一部は、テストノードについて言及しています。SunVTS API には、システムを頂点として、各テストグループがその下に位置し、底辺には個々のテストがあるという、テストノードの階層があります。以下のコマンドの説明では、システムについては、スラッシュ("/") で表記します。テストグループは以下の名称のいずれかになります。それぞれ、Processor(s)、Memory、Network、SCSI-Devices(esp0)、Comm.Ports、Graphics、OtherDevices、その他のユーザーの指定したグループです。個々のテストは具体的なデバイス名やテスト名 (例: sound0(audio)) で表記します。
指定した testnode 以下にあるすべてのテストノードの表示。
testnode で指定したテストノードの構成情報の表示。
システムのテスト状態情報の表示。testnode が指定されている場合は、そのテストノードの状態情報が表示されます。-r オプションを指定すると、すべてのテストノードの状態情報が再帰的に表示されます。
いずれも、指定したテストノードに関連しているすべてのオプションを表示します。または、指定したオプションをテストノード中に設定します。
テストノードのオプションを表示するには、テストノードに続いてオプションを指定し、以下のカテゴリの 1 つを入力してください。
Threshold
Notify category
Scheduling category
Test execution category
Advanced category
vts_cmd は全オプション、さらには各オプションの設定を出力します。-l オプションを指定すると、オプションの内容を省略全設定の説明付きで表示されます。
このオプションは、指定されたテストのインスタンスへの現在のオプション設定を、同じグループにあるすべての別のグループにあるものには適用されません)。
このオプションは、指定されたテストのインスタンスへの現在のオプション設定を、(-g オプションのようにグループに対してではなく) そのシステムにある同じテストすべてに対応する全インスタンスに適用します。
このオプションは、指定されたテストのインスタンスへの現在のオプション設定を、そのテストに属するすべてのインスタンスに適用します。
このオプションは、指定されたテストのインスタンスへの現在のオプション設定を、ある特定のグループに属するすべての同じテストの全インスタンスに適用します。
このオプションは、指定されたテストのインスタンスへの現在のオプション設定を、全システムのすべての同じテストの全インスタンスに適用します。
オプションを設定するには、testnode のすぐあとに option と setting を指定する必要があります。以下のような書式で使用します。
vts_cmd option testnode[option:setting]
オプションの変更が成功すると、vts_cmd によって "DONE" と表示されます。
テストノードを選択します。テストノードが選択されると、そのテストノードに関連付けられている全てのテストが実行可能になり、テスト開始時に実行されます。
たとえば、Graphics テストノードを選択した場合、すべてのグラフィックス関連テストが実行可能になります。"fpu(fputest)" テストを選択した場合は、このテストだけ実行可能になります。
テストノードを選択解除します。テストノードが選択解除されると、そのテストノードに関連付けられている全てのテストが実行不可能になり、テスト時に実行されなくなります。
たとえば、OtherDevices テストノードを選択解除した場合、OtherDevices に該当するすべてのテストが実行不可能になります。"cgsix0(cg6)" テストを選択した場合は、このテストだけ実行可能になります。
実行可能な (選択された) すべての SunVTS テストを開始します。
実行中のすべての SunVTS テストを停止します。
実行中のすべての SunVTS テストを中断 (または一時停止) します。テストを再開したい場合は、"resume" と入力してください。
中断中のテストを再開します。
すべての SunVTS テストをリセットし、エラー回数をゼロにします。
テスト中のシステム上の全デバイスを調べ、SunVTS カーネルのデバイスリストを更新します。
もしリスト上のデバイスが、この検査で確認できない場合、そのデバイスはリストから削除されます。反対に、リストにないデバイスが検査中に発見された場合、そのデバイスはリストに追加されます。
オプションファイルを読み込みます。ファイルが読み込まれるとシステムやオプションの設定は、そのオプションファイルの設定に変更されます。
オプションファイルは、/var/opt/SUNWvts/options ディレクトリに保存されます。
システム情報とテストオプションがリストされたオプションファイルを作成します。作成されたファイルは、/var/opt/SUNWvts/options ディレクトリに保存されます。
SunVTS カーネル (vtsk) を終了します。
テスト手順スケジューラを起動します。
テスト手順スケジューラを終了します。
シーケンスファイルを読み込みます。ファイルが読み込まれると、テスト手順スケジューラユーザーインタフェースに、シーケンスファイルに記録されたタスクが反映されます。
すべてのタスクがリストされたシーケンスファイルを作成して、/var/opt/SUNWvts/sequences ディレクトリに保存します。
現在実行中のシーケンスの状態情報を含む文字列を返します。この文字列はコンマ (",") で区切られた 4 つのフィールドから構成されます。それぞれ、SunVTS の現在の状態、現在のシーケンスのループ回数、シーケンスの全ループ回数、現在実行中のタスクの位置です。
テスト手順スケジューラのタスク実行を開始します。
シーケンスファイル中の現在実行中のタスクを停止します。再開時には、停止した時点のタスクから再実行されます。
シーケンスファイルの実行を再開します。シーケンスがリセットされていない限り、再開時には、停止した時点のタスクから再実行されます。シーケンスがリセットされた場合は、シーケンスファイルの先頭から実行が開始されます。
シーケンスファイルの実行開始ポイントを先頭に設定します。またテストパスやエラー回数もリセットされます。
シーケンスファイル中の現在実行中のタスクを中断します。
/var/opt/SUNWvts/sequences ディレクトリにあるシーケンスファイルのリストから、sequence_file で指定したファイルを削除します。
現在読み込まれているシーケンスファイル中のタスクのリストを表示します。
task_name で指定したタスクを、シーケンスファイルの i 番目の位置に追加します。指定した位置に達していない場合、タスクはリストの末尾に追加されます。
選択したシーケンスの指定した位置にあるタスクを削除します。
タスクファイルを読み込みます。ファイルが読み込まれると、システムやオプションの設定は、そのタスクファイルの設定リストに従って変更されます。
現在実行中のシーケンスのループ回数を count に設定します。
SunVTS カーネルの現在のモード情報を取得します。
sample% vts_cmd config / /[Hostname:sample,Model:SPARCstation-10,SunVTS version:1.0]:idle |
sample% ls /var/adm/sunvtslog/options CPU_options sample options sbus_standard sample% vts_cmd load sbus_standard DONE |
sample% vts_cmd option Comm.Ports -l | lp request id is printer-213 (standard input) |
SunVTS カーネル (vtsk) が実行されているテスト中のシステムのホスト名です。この環境変数が設定されていない場合、vts_cmd はローカルシステムの SunVTS カーネルへのコマンドの送信を試みます。
『SunVTS ユーザーマニュアル』