spot [ options ] [ target target-args | -p pid ]
spot コマンドは、ターゲットアプリケーション上で一連のパフォーマンスツールを実行し、ハイパーリンクでリンクされた一連の Web ページとして出力を生成します。spot は次の 2 とおりの方法で使用できます。
spot は、実行中のプロセスにアタッチし、さまざまなプローブを使用して実行中のプロセスからデータを収集します。
アプリケーションは複数回実行され、それぞれ別々のプローブで実行されます。したがって、ユーザーが操作せずにアプリケーションを複数回実行できることが必要になります。
spot で生成される Web ページには、次の情報が記録されます (使用できる場合)。
収集された実験を行ったシステムに関する情報
アプリケーションを構築した方法に関する情報
アプリケーションの実行中、CPU によって記録されたパフォーマンスカウンタイベント。このデータは、大幅なストール時間の原因となるイベントの種類を示すために使用できます。
これは、アプリケーションで実行される命令の組み合わせを示します (SPARC のみ)。
これは、さまざまなルーチンで消費される時間を返す collect コマンドからのデータです。このデータは er_html を使用して表示されます。
collect コマンドは、最大のストール時間の一因となるパフォーマンスカウンタイベントに基づいて、アプリケーションをプロファイリングするために使用されます。生成されたプロファイルは、ストールイベントが発生しているプログラム内の箇所を示します。このデータは er_html を使用して表示されます。
このデータは、各ルーチンが呼び出される頻度のほか、ルーチン内の個々の命令が呼び出される頻度も示します (SPARC のみ)。
実行中のすべてプロセスに対するシステム全体での帯域幅の使用率に関するデータ。特定のプロセスがその時点でアクティブな唯一のプロセスでないかぎり、帯域幅の原因がそのプロセスにあるみなすことはできません。システム全体でのパフォーマンスカウンタにアクセスするための適切なアクセス権がユーザーにある場合にのみ、このデータを収集できます。(SPARC のみ)。
プログラムの実行で発生したトラップ数に関するデータ。この情報は、trapstat データにアクセスする適切なアクセス権がユーザーにある場合にのみ利用できます (SPARC のみ)。
パス上で gnuplot を使用できる場合、時間経過に伴ってさまざまなイベントを示す追加グラフを使用できます。
引数なしで呼び出された場合、使用法に関するメッセージを出力します。/bin/perl がシステムにインストールされていない場合、欠落しているのが spot ではなく perl である場合でも、「spot: コマンドが見つかりません」というメッセージで失敗します。システム上の perl のバージョンが十分新しくない場合、spot は失敗し、未定義変数に関するメッセージが表示される可能性があります。
spot で使用される Oracle Solaris Studio コンポーネントのパスを指定します。Oracle Solaris Studio と spot の両方がデフォルトの場所にインストールされている場合、spot は必要とするコンポーネントを検出します。ただし、これらのどちらかがデフォルトの場所にインストールされている場合、このオプションを使用してパスを指定できます。このオプションは、ユーザーがデフォルトのコンパイラをオーバーライドし、デフォルトの場所とは異なる場所にインストールされたコンパイラを使用する場合にも役立ちます。
出力するデバッグ情報のレベルを設定します。デフォルトは 1 です。0 の設定は spot からの出力がないことを意味し、2 の設定は完全なデバッグ情報を意味します。デバッグ出力は、完了したレポートの debug.log で利用できます。
spot による出力を、指定のディレクトリのサブディレクトリに収めます。指定されない場合、デフォルトで、データを現在のディレクトリに配置します。
ヘルプ情報を出力します。
spot による出力を、name<n> という名前の指定サブディレクトリに出力します。ここで、n は未使用の最初の名前です。名前が指定されている場合、spot が呼び出された時点でディレクトリが存在しないかぎり、どの形式でも可能です。名前が指定されていない場合、spot はデフォルトで spot_run<n> を使用します。
実行中のプロセスに spot をアタッチし、レポートを生成します。
すべての spot 出力を抑制します。(-D 0 と同等です)
このオプションは、spot が実行中のプロセスにアタッチしているときにのみ有効です。それぞれのプローブをプロセスにアタッチする秒数を設定します。デフォルトは 300 秒 (5 分) です。
現在のバージョンを出力します。それ以上の引数を検査せず、それ以上の処理も行いません。
現在のバージョンと、実行されている変換に関するさらに詳細なデバッグ情報を出力します。(-D 2 と同等です)
このオプションを指定すると、spot は、アプリケーションのパフォーマンスに関する拡張情報の収集を試みます。これは、全体的なストール時間に対する大きな要因だと ripc によって識別されているパフォーマンスカウンタを使用して、アプリケーションのハードウェアカウンタプロファイルを収集します。可能な場合、帯域幅とトラップデータも収集されます。帯域幅およびトラップデータを収集するための適切なアクセス権がユーザーにあることが必要です。
analyzer (1) , collect (1) , er_archive (1) , er_cp (1) , er_export (1) , er_html (1) , er_mv (1) , er_print (1) , er_rm (1) , er_src (1)
パフォーマンスアナライザマニュアル