er_print(1)

名前
er_print - 1 つまたは複数のパフォーマンス実験ファイルから、ASCII レポートを出力します。

形式
er_print [ - | -script script | -command | -V ] experiment-list

機能説明

er_print は、パフォーマンスアナライザがサポートするさまざまな表示をプレーンテキストのバージョンで出力するユーティリティです。出力は、標準出力で表示されます。実験ファイルは、collect コマンドまたは dbx collector コマンドを使用して生成されます。experiment-list には、実験の名前または実験グループの名前を含めることができます。実験グループは、グループ中の実験の名前を含むファイルによって定義されます。子孫のプロセスの実験ファイルは、明示的に参照するか、collect(1) マニュアルページで説明する方法で子孫のプロセスの実験グループを構築して読み取ることができます。

注: パフォーマンスアナライザを使用するにはライセンスが必要です。

収集されたデータに基づいて、関数、呼び出し元と呼び出し先、ソースファイル、および逆アセンブルリストについて、さまざまなパフォーマンスのメトリックが計算されます。収集されるデータおよび生成されるメトリックについては、collect(1) マニュアルページを参照してください。グラフィカルな表示については、analyzer(1) マニュアルページを参照してください。

オプション

オプション
    意味

-   コマンド行から er_print コマンドを読み取る対話型モードに移行。

-script script
    1 行につき 1 つのコマンドを含むファイル script から er_print コマンドを読み取ります。

-command
    指定されたコマンドを処理します。

-V  バージョン情報を表示して終了します。

オプションは表示された順に処理されます。オプションは反復できます。スクリプト、- 引数、および明示的なコマンドは、任意の順序で混合できます。コマンド引数とスクリプト引数が指定されない場合、er_print は対話型モードに入り、コマンド行からコマンドの読み取りを行います。コマンド行からの入力は、quit コマンドにより終了します。 SH コマンド er_print が受け付けるコマンドを以下に示します。コマンドは、コマンド名を特定できる範囲で省略可能です。

  関数リストを制御するコマンド

functions
    現在のメトリックのセットで、関数リストを出力します。関数リストには、object_select コマンドによって非表示になっているロードオブジェクトも含まれます。

metrics metric_spec
    関数リストのメトリックを設定します。metric_spec には、メトリックのキーワードをコロンで区切って指定します。各キーワードの形式は、<type><visibility><metric-name> です。メトリック 'name' はリストにない場合、リストに追加されます。

    <type> は、包括的を表す "i" または 排他的を表す "e" を指定できます。"ie" や "ei" などの組み合わせは、拡張されます。たとえば、"ie<visibility><metric-name>" は "i<visibility><metric-name>:e<visibility><metric-name>" に拡張されます。

    <visibility> は "." (メトリックを時間として表示)、"%" (割合として表示) および "+" (数として表示) と組み合わせることができます。メトリックが時間または数のみとして表示される場合、"." と "+" は同義です。カウンタが周期的にカウントされるハードウェアカウンタプロファイル実験の場合、メトリックは通常、時間 (".") として表示されます。これは、<visibility> フィールドで "+" を使用してカウントとして表示できます。時間、割合、数の出現する順序は固定されています。これは、<visibility> 設定の文字の順序により影響されません。

    たとえば、次の行は、包括的ユーザー時間および割合、排他的ユーザー時間および割合を、この順序で指定します。

    metrics i.%user:e.%user

    ロードされた実験から使用可能なすべての <metric-name> 値のリストは、metric_list コマンドを使用して取得できます。メトリックの詳細については、collect(1) マニュアルページを参照してください。

    デフォルトのメトリックは、.rc ファイルから設定します。詳細については、デフォルト設定コマンドの項で説明します。metrics コマンドで明示的に metric_spec を default に設定すると、記録されたデータに適切なデフォルト設定が復元されます。

    metric_spec が省略されると、現在のメトリックの設定が出力されます。

    metrics コマンドにエラーが発生した場合、警告が出力されますがエラーは無視され、それまでの設定は有効です。

sort metric_spec
    指定されたメトリックで関数リストをソートします。metric_spec については metrics コマンドの説明を参照してください。たとえば、次の行は、包括的ユーザー時間でソートを行うことを意味します。

    sort i.user

    メトリック名の <visibility> は、ソート順序に影響しません。

    metric_spec に複数のメトリックを指定した場合、最初に指定したメトリックが使用されます。

    metric_spec が省略されると、現在のソートメトリックが出力されます。

fsummary
    関数リスト内のそれぞれの関数について、現在のソートメトリックで指定される順序で概要メトリックパネルを記述します。 object_select コマンドで非表示になっている関数を持つ すべてのロードオブジェクトを含まれます。

fsingle function_name [N]
    指定された関数について概要メトリックパネルを出力します。関数名があいまいな場合には、任意指定のパラメータ N が必要です。詳細については、source コマンドの説明を参照してください。コマンド行に指令が含まれる場合、N の指定が必要です。必要でない場合は、N は無視されます。

  呼び出し元と呼び出し先のリストを制御するコマンド

callers-callees
    最新の cmetrics 指定を使用して、関数リストソートメトリック (sort) で指定される順序で、それぞれの関数について callers-callees パネルを記述します。

cmetrics metric_spec
    呼び出し元と呼び出し先の (callers-callees) メトリックを設定します。metric_spec は metrics セクションで定義されていますが、属性として <type> "a" が追加されます。

    デフォルトで、呼び出し元と呼び出し先のメトリックは、呼び出し元と呼び出し先コマンドが処理されたときに関数リストメトリックと一致するように設定され、属性メトリックは、関数リストで表示できるすべてのメトリックに付加されます。

    metric_spec が省略されると、現在の呼び出し元と呼び出し先のメトリック設定が出力されます。

csingle
    function_name [N] 指定された関数について呼び出し元と呼び出し先のメトリックパネルを出力します。関数名があいまいな場合には、任意指定のパラメータ N が必要です。詳細については、source コマンドの説明を参照してください。コマンド行に指令が含まれる場合、N の指定が必要です。必要でない場合は、N は無視されます。

csort metric_spec
    各関数に関する callers-callees レポート内で、指定のメトリックにより、呼び出し元と呼び出し先をソートします。csort メトリックは、属性メトリック、アドレスまたは名前でなければなりません。デフォルトでは、これは callers-callees コマンドが処理されるときの関数リストソートメトリックに対応する属性メトリックです。

    metric-spec が省略されると、現在の呼び出し元と呼び出し先のソートメトリック設定が出力されます。

  リークリストと割り当てリストを制御するコマンド

leaks
    サイズによりソートされるリークのリストをそれぞれの呼び出しスタックとともに出力します。リークリスト内のエントリは、共通呼び出しスタックにより収集されます。

allocs
    サイズによりソートされる割り当てのリストをそれぞれの呼び出しスタックとともに出力します。割り当てリスト内のエントリは、共通呼び出しスタックにより収集されます。

  ソースと逆アセンブリリストを制御するコマンド

pcs PC (Program Counter) とそのメトリックのリストを、現在のソートメトリックで指定される順序で出力します。 リストには、object_select コマンドによって関数が非表示になっているロードオブジェクトのメトリックを表示する行も含まれます。

psummary
    PC リスト内のそれぞれの PC について、現在のソートメトリックで指定される順序で概要メトリックパネルを記述します。

lines
    ソース行とそのメトリックのリストを、現在のソートメトリックで指定される順序で出力します。 ソース行とそのメトリックのリストを、現在のソートメトリックで指定される順序で出力します。リストには、行番号情報を持たない関数やソースファイルが不明な関数のメトリックを表示する行、object_select コマンドによって関数が非表示になっているロードオブジェクトのメトリックを表示する行も含まれます。

lsummary
    ソース行リスト内のそれぞれの行について、現在のソートメトリックで指定される順序で概要メトリックパネルを記述します。

source { filename | function_name } [N]
    指定されたオブジェクトファイル、または指定された関数を含む オブジェクトファイルの注釈付きソースを記述します。 任意指定のパラメータ N は、ファイル名または関数名があいまいである場合に必要となります。そのような場合には、N 番目の選択肢が使用されます (番号付けは 1 から始まります)。あいまいな名前が数値指示子 N なしで指定されている場合、注釈付きソースの代わりに選択肢リストが出力されます。各リスト項目には、N に使用可能な数字、関数またはファイルを参照するオブジェクトモジュールの名前、ならびに関数名があいまいな場合にはその関数名が含まれます。 可能性のある数字が複数あり、N に指定された数字がその範囲内にない場合は、エラーが報告されます。つまり、可能性のある数字が 1 つだけの場合は、エラーは無視されます。 コマンド行で -source が使用された場合、パラメータ N は任意指定ではなく必須指定です。必要のない場合は無視されます。

    どの関数でも、デフォルトのソースコンテキストは、 その関数の最初の命令を含むものがソースファイルとして定義されます。 通常、これは、その関数を含むオブジェクト モジュールを生成するためにコンパイルされたソースファイルになります。 代替のソースコンテキストは、関数内に含まれる命令を持つ他の ファイルから構成されます。このコンテキストには、インクルード ファイルから取り込まれた命令や、指定された関数にインライン化 された関数から取り込まれた命令などが含まれます。

    関数名は、function`file` としても指定できます。この
     file は、関数の代替ソースコンテキストの指定に使用されます。

    コンパイラのコメントが選択されている場合、コメントはソースリストの ソース行に挿入されます。ユーザーが注意すべき行を見つけ 易いよう、メトリックがその最大値に対するしきい値 (百分率) に等しい か、しきい値を超えている行の先頭に、文字列 "##" を付加できます。 表示するしきい値およびコメントのクラスは、ソースしきい 値オプションの sthresh と、ソースのコンパイラのコメントに対 する設定のオプションの scc を使って制御します。

    setpath コマンドで指定されるパスを使ってファイルを検索します。 さらに見つからない場合は、実行可能ファイルに記録された絶対パス名で検索します。 ソースを移動したか、実験ファイルが異なるファイルシステムに記録された場合は、現在のディレクトリから実際のソースのある場所へシンボリックリンクを設定して、注釈付きのソースを参照するか、ソースコードをコピーしてオブジェクトを実験ファイルにロードすることができます。

src { filename | function_name } [N]
    source と同じです。

disasm { filename | function_name } [N]
    特定のオブジェクトファイル、または特定の関数を含むオブジェクトファイルの注釈付き逆アセンブリを出力します。あいまいな表現は、source コマンドと同じ方法で解決されます。

    逆アセンブリのリストには、使用可能な場合には、ソースと、挿入された 選択済みコンパイラコメントが含まれます。ユーザーが注意すべき行を見 つけ易いよう、行のメトリック値がその最大値に対するしきい値 (百分率) に等しいか、しきい値を超えている場合は、その行の先頭に、文字列 "##" を付加できます。しきい値は dthresh コマンドによって設定されま す。表示されるコメントのクラスは、dcc コマンドにより設定され ます。

    source コマンドの説明で述べたように、指定された逆アセンブリのソースファイルを検索し、逆アセンブリでソースをインタリーブします。ソースファイルが存在しない場合は、逆アセンブリは、ソースやコンパイラのコメントなしで表示されます。

scc com_spec
    注釈付きソースでどのコンパイラのコメントのクラスが表示できるかを指定します。class_list はコロンで区切ったクラスのリストです。各クラスは、特定のメッセージの型を参照します。 使用できるクラスは、以下のとおりです。
    b[asic] — すべてのクラスから基本メッセージを表示します
    v[ersion] — バージョンメッセージを表示します
    w[arn] — 警告メッセージを表示します
    pa[rallel] — 並列化メッセージを表示します
    q[uery] — コンパイラからの質問を表示します
    l[oop] — ループの変形メッセージを表示します
    pi[pe] — パイプライン化メッセージを表示します
    i[nline] — インライン化メッセージを表示します
    m[emops] — メモリー操作についてのメッセージを表示します
    f[e] — フロントエンドのメッセージを表示します
    c[g] — コードジェネレータのメッセージを表示します
    all — すべてのメッセージを表示します
    none — メッセージを表示しません
    "all" および "none" のクラスは、他のクラスとの併用はできません。

    互換性のために、重要な行にフラグが付けられるしきい値を、"all" と "none" も含め任意のクラスを使用して、リストに含めることができます。
    t[hreshold]=nn
    メトリックの値が、ファイル中のいずれかの行にあるそのメトリックの最大値の nn パーセントより大きい場合は、その行を重要とみなしてフラグを付けます。nn のデフォルト値は、75 です。

    たとえば、

    scc l:pi:t=50

    は、ループの変形メッセージおよびパイプライン化メッセージの表示を意味し、しきい値を 50% に設定します。

    scc コマンドが指定されなかった場合、デフォルトの設定は以下のようになります。

    scc all

    com_spec が指定されなかった場合、コンパイラのコメントは出力されません。scc コマンドは、通常は .er.rc ファイルのみに使用されます。

sthresh value
    ソース内の重要な行にフラグが付けられるしきい値を設定します。 行のメトリックの値が、ファイル中のいずれかの行にあるそのメトリックの最大値の value パーセントより大きい場合は、その行その行を重要とみなしてフラグを付けます。value のデフォルト値は、75 です。

dcc com_spec
    注釈付き逆アセンブリでどのコンパイラのコメントのクラスが表示されるか指定します。このコマンドで指定する com_spec には、いずれかの scc クラスと以下の追加クラスを含めることができます。
    h[ex] — 各命令の 16 進数表現を表示します
    noh[ex] — 各命令の 16 進数表現を表示しません
    s[rc] — ソースを逆アセンブリでインタリーブします (デフォルト)
    as[rc] — 注釈付きソースをソース行メトリックによって逆アセンブリでインタリーブします
    nos[rc] — ソースを逆アセンブリでインタリーブしません

    dcc コマンドが指定されなかった場合、デフォルトの設定は以下のようになります。

    dcc all:src

    このコマンドは通常は .er.rc ファイルのみに使用されます。

cc com_spec
    ソースおよび逆アセンブリ両方に対するコンパイラのコメントを指定します

dthresh value
    逆アセンブリで重要な行にフラグが付けられるしきい値を設定します。 行のメトリックの値が、ファイル中のいずれかの行にあるそのメトリックの最大値の value パーセントより大きい場合は、その行その行を重要とみなしてフラグを付けます。value のデフォルト値 は、75 です。

setpath path_list
    ソースファイル、オブジェクトファイル、etc. ファイルの検索に使用するパスを設定します。path_list には、ディレクトリをコロンで区切って指定します。コロンを含むディレクトリを指定する場合は、ディレクトリ中のコロンにバックスラッシュを付ける必要があります。特別なディレクトリ名である $expts を指定すると、現在の実験をロードされた順番に指定したことになります。$expts は、$ 1 文字で省略指定することができます。

    デフォルトの設定は、$expts:. です。検索を行なってもファイルが見つからない場合は、編集済みのフルパス名が現在のパス設定として使用されます。

    引数なしの setpath は、現在のパスを表示します。

addpath path_list
    現在の setpath の設定に path_list を追加します。

  データ領域リストを制御するコマンド

data_objects
    データオブジェクトとそのメトリックのリストを表示します。アグレッシブなバックトラックが指定されているハードウェアカウンタ実験と -xhwcprof (SPARC 上で C でのみ使用可能) を使用してコンパイルしたファイル内のオブジェクトに対してのみ適用できます。詳細については、C コンパイラのマニュアルを参照してください。

data_osingle name [N]
指定されたデータオブジェクトについて概要メトリックパネルを出力します。オブジェクト名があいまいな場合には、任意指定のパラメータ N が必要です。コマンド行に指令が含まれる場合、N の指定が必要です。必要でない場合は、N は無視されます。アグレッシブなバックトラックが指定されているハードウェアカウンタ実験と -xhwcprof (SPARC 上で C でのみ使用可能) を使用してコンパイルしたファイル内のオブジェクトに対してのみ適用できます。詳細については、C コンパイラのマニュアルを参照してください。

data_olayout
    データ派生メトリックデータを持つすべてのプログラムデータオブジェクト用に 、実験のロードオブジェクト内で定義されている順番で、 注釈付きのデータオブジェクトを作成します。 各集合体のデータオブジェクトが、合計メトリック属性がそのすべての要素の後に オフセット順で表示され、それぞれが所有するメトリックとそのサイズ、32 バイトブロック への相対パスも表示されます。

  実験、標本、スレッド、および LWP をリストするコマンド

exp_list
    ロードされた実験のリストを表示します。各実験はインデックス付きでリストされ、インデックスは標本、スレッド、または LWP の選択に使用できます。

sample_list
    実験中に処理された標本のリストを表示します。

lwp_list
    実験中に処理された LWP のリストを表示します。

thread_list
    実験中に処理されたスレッドのリストを表示します。

cpu_list
    実験中に使用された CPU のリストを表示します。

  実験、標本、スレッド、LWP の選択を制御するコマンド

以下のコマンドは、データが表示される実験、標本、スレッド、および LWP を選択します。

sample_select sample_spec
    sample_spec は、以下で説明する標本のリストです。

lwp_select lwp_spec
    lwp_spec は、以下で説明する LWP のリストです。

thread_select thread_spec
    thread_spec は、以下で説明するスレッドのリストです。

cpu_select cpu_spec
    cpu_spec は、以下で説明する CPU のリストです。

上記の各リストは、1 つの番号、番号の範囲 (n - m)、番号や範囲を コンマで区切ったリスト、または明示的な文字列 "all" で指定します。 各リストの前に任意で、同じフォーマットをもつ、コロン (:) で区切ら れた実験リストを設定できます。複数のリストは、+ 記号で区切って連 結できます。また、空白を含んではなりません。実験リストが含まれて いない場合、リストはすべての実験に対して適用されます。

4 つある選択対象 (スレッド、LWP、CPU、標本) に対応した select コマンドによって、実験の選択を行います。選択したスレッド、LWP、 CPU、もしくは標本が存在する実験を、実験リストに指定してください。 実験が指定されていない場合には、すべての実験が選択されます。 実験リストに無い実験を対照した選択は無効になります。

例:

thread_select 1
    すべての実験の中から、スレッド 1 を選択します。

thread_select all:1
    すべての実験の中から、スレッド 1 を選択します。

thread_select all:1,3,5
    すべての実験の中から、スレッド 1、3、5 を選択します。

thread_select 1,2:all
    exp_list にリストされているように、実験 1 と実験 2 から、すべてのスレッドを選択します。

thread_select 1:1+2:2
    実験 1 の中からスレッド 1を、実験 2 の中からスレッド 2 を選択します。

  ロードオブジェクトの選択を制御するコマンド

object_list
    有効なロードオブジェクトの選択状態と名前を 2 つの欄 からなる一覧の形式で表示します。 最初の欄に選択状態、2 つ目の欄に名前を表示します。 ロードオブジェクトの関数が関数リストにある場合は yes 、関数が関数リストにない場合は、 no がそれぞれ表示されます。

object_select object1,object2,...
    有効なロードオブジェクトのリストを設定します。オブジェクトの名前は、 フルパス名またはベース名です。その名前がコンマを含む場合には、二重 引用符で囲む必要があります。 ロードオブジェクトが選択されている場合は、関数リスト内の、 メトリック値がゼロ以外のそのすべての関数を表示します。 ロードオブジェクトが選択されていない場合は、 その個々の関数ではなく、ロードオブジェクト全体のメトリックを 1 行で 表示します。

    デフォルトでは、すべてのロードオブジェクトが選択されます。

  メトリックをリストするコマンド

metric_list
    現在選択した関数リストメトリックと、それらを他のコマンド中でも参照可能な sort などのメトリックやキーワード名のリストを表示します。メトリックキーワードの書式については、metrics についての項で説明しています。使用可能なメトリックは、収集されたデータにより異なります。collect(1) のマニュアルページを参照してください。

cmetric_list
    現在選択されている callers-callees メトリックと、callers-callees レポートに関するメトリックとキーワード名のリストを表示します。 metric_list の出力と同じ方法でリストを表示しますが、 さらに属性メトリックが含まれています。

  出力を制御するコマンド

outfile filename
    開かれている出力ファイルをすべて閉じて、 これ以降の出力用に filename を開きます。filename にマイナス記号 (-) が指定された場合、出力は stdout に書き込まれます。

limit n
    レポートの最初の n 個のエントリに出力を制限します。ここで、n は符号なしの整数です。

name { long | short }
    C++ 関数名の long または short 形式を使用します。

javamode {on|expert|off}
    Java 実験のモードを on (Java モデルを表示する)、expert (Java モデルを表示するが、HotSpot を使用してコンパイルしたメソッドは別に、解釈されたメソッドから表示する)、または off (マシンモデルを表示する) に設定します。

  その他の表示を出力するコマンド

header [ exp_id ]
    指定された実験に関する記述情報を出力します。 exp_id は、experiment_list コマンドでリストされる実験の数値識別子です。 exp_id が all か、または省略された場合は、すべての実験のヘッダーが記述されます。それぞれのヘッダーに準じて、エラーまたは警告が出力されます。各実験のヘッダーは、ハイフンで区切られます。

    実験ディレクトリに notes という名前のファイルが含まれている場合は、 そのファイルの内容がヘッダー情報の先頭に付加されます。

    exp_id は、スクリプトや対話モードではなく、 コマンド行から入力する必要があります。

objects
    パフォーマンス解析にロードオブジェクトを使用した結果出力されるエラーメッセージや警告メッセージに、ロードオブジェクトを一覧表示します。

overview [ exp_id ]
    指定した実験の、各標本のデータも含めた、標本リストを出力します。experiment-id は、experiment_list コマンドでリストされる実験の数値識別子です。 exp_id が all か、または省略された場合は、すべての実験の概要が記述されます。

    exp_id は、スクリプトや対話モードではなく、 コマンド行から入力する必要があります。

statistics [ exp_id ]
    指定した実験の、実行統計データを出力します。データは現在の標本セットで収集されたものです。 exp_id は、experiment_list コマンドでリストされる実験の数値識別子です。 exp_id が省略された場合は、その標本による選択に従って、 すべての実験全体の集計値が書き込まれます。 exp_id が all の場合は、各実験で選択された 標本の集計値と統計が書き込まれます。

    exp_id は、スクリプトや対話モードではなく、 コマンド行から入力する必要があります。

  デフォルト設定コマンド

er_print で生成されるレポートおよびアナライザでの表示の多くは、デフォルトとして .er.rc リソースファイルに設定できます。er_print とパフォーマンスアナライザは、システム規模の .er.rc ファイルを処理し、次にユーザーのホームディレクトリの .er.rc ファイルが存在すればそれを処理し、次に現在のディレクトリの .er.rc ファイルが存在すればそれを処理します。各ファイルから読み取られた指令は、以前に読み取られた指令よりも優先されます。

これらのファイルには、上述のとおり scc、sthresh、dcc、dthresh、setpath、addpath、name および javamode コマンドを含めることができます。以下のコマンドを含めることもできますが、これらのコマンドは、コマンド行またはスクリプトには使用できない場合があります。

dmetrics metric_spec
    メトリックのデフォルトの順番や可視設定を指定します。複数の dmetrics コマンドが er.rc に指定され、連結されます。さまざまなファイルからの dmetrics は、現在ディレクトリ、ユーザーのホームディレクトリ、システムの順番に連結されます。

    metric_spec については、上述の metrics コマンドの項で説明していますが、以下が追加されます。

    <visibility> は、メトリックのバージョンが不可視であることを意味する "!" に設定できます。これにより、ユーザーは、デフォルトでバージョンを可視に設定しなくても、メトリックの順番を指定することができます。

    2 つの汎用メトリック名を指定できます。"hwc" はすべてのハードウェアカウンタメトリックを意味し、"any" はすべてのメトリックを意味します。

    ロードされた実験から計算されたすべてのメトリックについて、すべての dmetrics の連結リストが一致するかどうかが走査されます。最初の一致したエントリにより、関数リストおよび呼び出し元と呼び出し先のリスト内のメトリックの可視設定と順番が決定されます。

dsort metric_spec
    デフォルトで、関数リストをソートするために使用されるメトリックを指定します。ソートメトリックの決定には、実験ファイルのメトリックに一致する dsort 指定の最初のメトリックが、次の条件で使用されます。dsort metric_spec のエントリの <visibility> が "!" の場合、名前が一致した最初のメトリックが、見えるか見えないかに関わらず、使用されます。<visibility> のその他の設定が使用された場合、名前が一致した最初の可視メトリックが使用されます。dmetrics と同様に、さまざまな .er.rc ファイルからの dsort 指定が、現在ディレクトリ、ユーザーのホームディレクトリ、システムの順番に連結されます。

gdemangle library.so
    gdemangle コマンドは廃止されており、無視されます。 (er_printには、GNU 復号化プログラムを独自に実装したものが 含まれています。)

  パフォーマンスアナライザにのみ影響を与えるデフォルト設定コマンド

tlmode tl_mode
    「タイムライン」タブの表示モードオプションを設定します。tl_mode には、以下に示すオプションをコロンで区切って指定します。

    値   意味

    lw[p]
        LWP のイベントを表示します

    t[hread]
        スレッドのイベントを表示します

    c[pu]
        CPU のイベントを表示します

    r[oot]
        呼び出しスタックをルートに配置します

    le[af]
        呼び出しスタックをリーフに配置します

    d[epth]=nn
        表示可能な呼び出しスタックの最大の深さを設定します

lwp、thread、cpu のうちの 2 つを同時に指定することはできません。また、root と leaf を同時に指定することはできません。同時に指定すると、最後に指定したオプションが使用されます。

tldata tl_data
    「タイムライン」タブに表示されるデフォルトのデータの種類を設定します。tl_data には、以下に示す種類をコロンで区切って指定します。

    値   意味

    sa[mple]
        標本データを表示します

    c[lock]
        時間プロファイルデータを表示します

    hw[c]
        ハードウェアカウンタプロファイルデータを表示します

    sy[nctrace]
        スレッド同期トレースデータを表示します

    mp[itrace]
        MPI トレースデータを表示します

    he[aptrace]
        ヒープトレースデータを表示します

datamode {on|off}
    データ領域関係の画面の表示モードを on (タブを表示する) または off (タブを表示しない) に設定します。

  その他のコマンド

mapfile load-object mapfilename
    指定されたロードオブジェクトのマップファイルを mapfilename に書き込みます。mapfilename にダッシュ (-) を指定すると、マップファイルを .B stdout に書き込みます。 関数リストをソートするように現在設定されているメトリックを使って マップファイルを順序付けます。

script script
    指定されたスクリプト内のコマンドを処理します。

version
    er_print の現在のリリースバージョンを表示します。

quit
    対話型モードを終了します。このコマンドをスクリプト内で使用すると、スクリプト内のコマンドがそれ以上処理されなくなります。

help
    ヘルプ情報を表示します。

# ...
    スクリプトまたは .er.rc ファイルで使用されるコメント行

互換性

er_print は、以前のバージョンのツールで記録された実験には使用できません。このような実験に er_print を実行すると、エラーメッセーが出力されます。実験の記録されたリリースの er_print バージョンを使用してください。

関連項目
analyzer(1)、 collect(1)、 collector(1)、 dbx(1)、 er_archive(1)、 er_cp(1)、 er_export(1)、 er_mv(1)、 er_rm(1)、 er_src(1)、 libcollector(3)、 および
『プログラムのパフォーマンス解析』マニュアル