'\" te .\" Copyright (c) 2007, 2014, Oracle and/or its affiliates.All rights reserved. .TH lari 1 "2014 年 4 月 23 日" "SunOS 5.11" "ユーザーコマンド" .SH 名前 lari \- 実行時インタフェースのリンク分析 .SH 形式 .LP .nf \fBlari\fR [\fB-bCDsVv\fR] [\fB-a\fR | \fB-i\fR | \fB-o\fR] \fIfile\fR | \fIdirectory\fR... .fi .LP .nf \fBlari\fR [\fB-CDosv\fR] [\fB-m\fR [\fB-d\fR \fImapdir\fR]] \fIfile\fR .fi .SH 機能説明 .sp .LP \fBlari\fR ユーティリティーは、動的 \fBELF\fR オブジェクトのインタフェース要件を分析します。2 つの基本操作モードを利用できます。最初のモードでは、実行時インタフェース情報を表示します。2 番目のモードでは、インタフェース定義を生成します。 .sp .LP 動的オブジェクトは、外部コンシューマに提供するインタフェースを表すシンボル定義を提供します。実行時に、あるオブジェクトのシンボル参照から、別のオブジェクトのシンボル定義への結合が確立されます。\fBlari\fR は、指定されたオブジェクトのインタフェース定義と実行時結合の両方を分析します。 .sp .LP 実行時インタフェース情報を表示するときに、\fBlari\fR は、ファイルまたはディレクトリの数を分析できます。\fBlari\fR は、コマンド行で指定したそれぞれの \fIfile\fR を分析します。\fBlari\fR は、コマンド行で指定したそれぞれの \fIdirectory\fR の下位に再帰的に移動して、見つかったそれぞれのファイルを処理します。 .sp .LP インタフェース定義を生成するときに、\fBlari\fR は、コマンド行で指定した単一の \fIfile\fR だけを処理できます。 .sp .LP \fB-D\fR オプションを指定しない場合、\fBlari\fR は、\fBldd\fR(1) を使用することによって、動的 \fBELF\fR オブジェクトとしてファイルを処理します。この処理では次のオプションを使用します。 .sp .in +2 .nf \fB-r\fR and \fB-e\fR \fBLD_DEBUG=files,bindings,detail\fR .fi .in -2 .sp .sp .LP これらのオプションは、オブジェクトを読み込む過程で確立されたすべての結合に関する情報を提示します。\fBldd\fR を使用することによって、指定されたオブジェクトが実行されず、したがって、たとえば \fBdlopen\fR(3C) による、オブジェクトのユーザー制御の読み込みが行われないことに注意してください。実行プロセスからすべての結合情報を取得するために、次の環境変数を直接実行時リンカー \fBld.so.1\fR(1) に渡すことができます。 .sp .in +2 .nf \fBLD_DEBUG=files,bindings,detail LD_DEBUG_OUTPUT=lari.dbg \e LD_BIND_NOW=yes\fR .fi .in -2 .sp .sp .LP 結果として得られるデバッグ出力 \fBlari.dbg.\fIpid\fR\fR は、\fBlari\fR で \fB-D\fR オプションを使用して処理できます。\fB注:\fR \fBlari\fR は、デバッグ出力で定義されたパス名を使用して処理された各オブジェクトを分析しようとします。したがって、完全な正確な分析を行うために、各オブジェクトには \fBlari\fR からアクセスできる必要があります。デバッグ出力ファイルは、\fBC\fR ロケールで生成する必要があります。 .sp .LP \fBlari\fR は、インタフェース情報を表示するときに、処理された動的オブジェクトのインタフェースを分析し、デフォルトで、関心を引く情報を表示します。「拡張機能説明」の「関心を引く情報」を参照してください。\fB\fR表示される情報は、ほかのツールへのパイピングにも適しています。この機能は、開発者がプロセス結合を分析したり、複雑な結合シナリオをデバッグしたりするときに役立ちます。 .sp .LP \fBlari\fR を使ってインタフェース定義を生成すると、処理対象の動的オブジェクトのインタフェース要件をより正確に定義できるようになります。動的オブジェクトを作成するときに、明示的にバージョン定義されたインタフェースを定義するようにしてください。この定義は、外部ユーザーが利用できるシンボル定義を制御します。また、この定義によって、実行時のオブジェクトの実行コスト全体を削減できることがよくあります。インタフェース定義は、リンカーで \fB-M\fR オプションおよび関連付けられた \fImapfile\fR ディレクティブを使用することによって、作成時にオブジェクトに割り当てることができます。\fI『Oracle Solaris 11.3 Linkers and Libraries Guide』\fROracle Solaris 11.3 Linkers and Libraries Guide \fI\fRを参照してください。これらの \fImapfile\fR の初期バージョンは、\fBlari\fR で作成できます。 .SH オプション .sp .LP 以下のオプションがサポートされています。 .sp .ne 2 .mk .na \fB\fB-a\fR\fR .ad .RS 13n .rt 分析対象のオブジェクトに関するすべてのインタフェース情報を表示します。\fB注:\fR このオプションからの出力は大量になることがありますが、多くの場合、ほかの分析ツールへのパイピングに役立ちます。 .RE .sp .ne 2 .mk .na \fB\fB-b\fR\fR .ad .RS 13n .rt インタフェース情報を、明示的に結合されているシンボルに制限します。\fB注:\fR protected と定義したシンボルは、定義用オブジェクト内から結合されている可能性があります。この結合はリンク編集時に満たされるので、実行時環境では表示されません。protected シンボルは、このオプションで表示されます。 .RE .sp .ne 2 .mk .na \fB\fB-C\fR\fR .ad .RS 13n .rt DemanglesC++ シンボル名を復号化します。このオプションは、実行時インタフェース情報を拡張するときに役立ちます。インタフェース定義の生成時に、demangled 名がコメントとして \fImapfile\fR に追加されます。 .RE .sp .ne 2 .mk .na \fB\fB-d\fR \fImapdir\fR\fR .ad .RS 13n .rt \fImapfile\fR が作成されるディレクトリ (\fImapdir\fR) を定義します。デフォルトでは、現在の作業ディレクトリが使用されます。 .RE .sp .ne 2 .mk .na \fB\fB-D\fR\fR .ad .RS 13n .rt 動的オブジェクトではなくデバッグ情報として入力ファイルを解釈します。\fI\fR .RE .sp .ne 2 .mk .na \fB\fB-i\fR\fR .ad .RS 13n .rt 関心を引くインタフェース結合情報を表示します。ほかの出力制御オプションが指定されていない場合、このモードがデフォルトです。「拡張機能説明」の「関心を引く情報」を参照してください。\fB\fR .RE .sp .ne 2 .mk .na \fB\fB-m\fR\fR .ad .RS 13n .rt 処理される動的オブジェクトごとに \fImapfile\fR を作成します。これらの \fImapfile\fR には、処理されている入力ファイルで必要になる各オブジェクトのインタフェース要件が反映されます。 .RE .sp .ne 2 .mk .na \fB\fB-o\fR\fR .ad .RS 13n .rt インタフェース情報を、オーバーヘッドとみなされているシンボルに制限します。\fImapfile\fR の作成時、オーバーヘッドシンボルがローカルシンボルとして項目化されます。「拡張機能説明」の「オーバーヘッド情報」を参照してください。\fB\fR .RE .sp .ne 2 .mk .na \fB\fB-s\fR\fR .ad .RS 13n .rt さらに分析するために、\fBldd\fR(1) からの結合情報を保存します。「ファイル」を参照してください。 .RE .sp .ne 2 .mk .na \fB\fB-V\fR \fR .ad .RS 13n .rt 関心を引くシンボル可視設定を追加します。\fBsingleton\fR または \fBprotected\fR と定義されたシンボルは、このオプションで識別されます。 .RE .sp .ne 2 .mk .na \fB\fB-v\fR\fR .ad .RS 13n .rt すでにバージョン定義されているオブジェクトを無視します。バージョン定義されているオブジェクトのインタフェースはすでに定義されていますが、表示されるインタフェース情報にはその情報が含まれています。たとえば、バージョン定義されている共有オブジェクトであれば、特定のプロセスのオーバーヘッドシンボルが表示される場合があります。共有オブジェクトは多くの場合、複数のプロセスで使用できるように設計されているので、これらのオブジェクトで用意されているインタフェースは、単一のプロセスの要件を超えるときがあります。したがって \fB-v\fR オプションを使用すると、インタフェース情報を表示するときにノイズを軽減できます。 .RE .sp .LP \fBlari\fR から生成される実行時インタフェース情報は、次の形式になります。 .sp .in +2 .nf [information]: \fIsymbol-name\fR [demangled-name]: \fIobject-name\fR .fi .in -2 .sp .sp .LP 各行には、インタフェースシンボル (\fBsymbol-name\fR) と、シンボルが定義されるオブジェクト (\fBobject-name\fR) が記述されます。シンボルが関数を表す場合、シンボル名のあとに \fB()\fR が続きます。シンボルがデータオブジェクトを表す場合、シンボル名のあとに \fB[]\fR で囲まれたシンボルサイズが続きます。\fB-C\fR オプションが使用された場合、シンボル名は、シンボルの復号化された名前 (\fBdemangled-name\fR) とともに表示されます。情報フィールドには、シンボルの使用について記述した次のトークンの 1 つまたは複数が表示されます。 .sp .ne 2 .mk .na \fB\fIcnt\fR:\fIbnd\fR\fR .ad .RS 11n .rt 2 つの 10 進数値は、シンボル数 (\fBcnt\fR) と、このオブジェクトへの結合の数 (\fBbnd\fR) を示します。シンボル数は、分析対象のオブジェクトで見つかったこのシンボル定義の出現数です。\fB1\fR より大きな数は、シンボル定義が複数回出現したことを示しています。結合の数は、実行時リンカーによってこのシンボル定義に結合されたオブジェクトの数を示しています。 .RE .sp .ne 2 .mk .na \fB\fBE\fR\fR .ad .RS 11n .rt このシンボル定義は、外部オブジェクトから結合されています。 .RE .sp .ne 2 .mk .na \fB\fBS\fR\fR .ad .RS 11n .rt このシンボル定義は、同じオブジェクトから結合されています。 .RE .sp .ne 2 .mk .na \fB\fBD\fR\fR .ad .RS 11n .rt このシンボル定義は、直接結合されています。 .RE .sp .ne 2 .mk .na \fB\fBI\fR\fR .ad .RS 11n .rt このシンボル定義は割り込みシンボルを規定します。明示的に割り込みオブジェクトであることを示すオブジェクトは、すべてのグローバルシンボルを割り込みシンボルとして定義します。\fBld\fR(1) の \fB-z\fR \fBinterpose\fR オプションおよび \fBld.so.1\fR(1) の \fBLD_PRELOAD\fR 変数を参照してください。動的実行可能ファイル内の個々のシンボルは、\fBINTERPOSE\fR \fBmapfile\fR 指令を使用することによって、割り込みシンボルとして定義できます。 .RE .sp .ne 2 .mk .na \fB\fBC\fR\fR .ad .RS 11n .rt このシンボル定義は、コピー再配置の参照データです。 .RE .sp .ne 2 .mk .na \fB\fBF\fR\fR .ad .RS 11n .rt このシンボル定義は filtee にあります。 .RE .sp .ne 2 .mk .na \fB\fBP\fR\fR .ad .RS 11n .rt このシンボルは protected と定義されています。このシンボルには、シンボルが宣言されたオブジェクトからの内部結合が存在する可能性があります。この属性を持つ内部結合には、別のシンボル定義が割り込むことはできません。 .RE .sp .ne 2 .mk .na \fB\fBA\fR\fR .ad .RS 11n .rt このシンボル定義は、動的実行可能ファイル内でのプロシージャリンケージテーブルエントリのアドレスです。 .RE .sp .ne 2 .mk .na \fB\fBU\fR\fR .ad .RS 11n .rt このシンボル参照は \fBdlsym\fR(3C) などのユーザー要求に起因します。 .RE .sp .ne 2 .mk .na \fB\fBR\fR\fR .ad .RS 11n .rt このシンボル定義はフィルタとして機能し、フィルタ対象へのリダイレクションを規定します。 .RE .sp .ne 2 .mk .na \fB\fBr\fR\fR .ad .RS 11n .rt このシンボルへの結合は、シンボル検索中のある時点で拒否されました。直接結合要求が、直接結合を防止するタグが付けられているシンボルを見つけると、結合が拒否されます。このシナリオでは、シンボル検索は、デフォルトの検索モデルを使用して繰り返されます。結合はまだ、元の拒否されたシンボルに解決できます。デフォルト以外のシンボル検索が、\fBsingleton\fR として識別されたシンボルを見つけたときにも、結合は拒否されます。この場合も、シンボル検索は、デフォルトの検索モデルを使用して繰り返されます。 .RE .sp .ne 2 .mk .na \fB\fBN\fR\fR .ad .RS 11n .rt このシンボル定義は、定義に直接結合することを明示的に禁止します。 .RE .sp .LP これらのシンボル分類の詳細は、\fI『Oracle Solaris 11.3 Linkers and Libraries Guide』\fRを参照してください。 .SH 拡張機能説明 .SS "関心を引く情報" .sp .LP デフォルトで、または \fB-i\fR オプションを明示的に使用すると、\fBlari\fR は、実行時インタフェース情報をフィルタ処理して、関心を引くイベントを示します。このフィルタ処理は主に、大きなアプリケーションから生成される情報量を減らすときに実行します。また、この情報を使用すると、複雑な結合シナリオをデバッグするときに注目すべき箇所がわかります。多くの場合で、問題領域を強調します。ただし、特定のアプリケーション用に意味のある情報を正確に分類することは困難です。\fB-a\fR オプションを使用すると、調査対象のアプリケーションに固有のイベントの結合情報を自由に検索できます。 .sp .LP 関心を引くシンボル定義が検出された場合、同じシンボルのほかのすべての定義が出力されます。 .sp .LP 関心を引くインタフェース情報がフォーカスしているのは、シンボルの複数の定義の存在です。この場合、通常、1 つのシンボルがほかの 1 つまたは複数のシンボル定義に割り込みます。ある定義の結合数 (\fBbnd\fR) が 0 でなく、ほかのすべての定義の結合数が 0 である場合に、この割り込みが発生しています。コンパイル環境 (つまりリンク環境) に起因する割り込みは、関心を引くものとは判断されません。これらの割り込みの出現例としては、コピー再配置 (\fB[C]\fR) や、プロシージャリンケージアドレスへの結合 (\fB[A]\fR) などがあります。 .sp .LP 多くの場合、割り込みは望ましいものです。その目的は、共有オブジェクトからのシンボル定義を多重定義する、つまり置き換えることです。\fBld\fR(1) の \fB-z interpose\fR オプションを使用すると、割り込むオブジェクトに明示的にタグ (\fB[I]\fR) を付けることができます。これらのオブジェクトは、プロセスでオブジェクトを読み込む順番とは無関係に、安全にシンボルに割り込むことができます。ただし、明示的でない割り込みが使用される場合には注意してください。この割り込みは、プロセスを構成するオブジェクトの読み込み順序に起因するためです。 .sp .LP ユーザーが作成した多重定義シンボルは、関心を引く情報として \fBlari\fR から出力されます。この例では、\fBinterpose1()\fR の 2 つの定義が存在しますが、\fBmain\fR の定義だけが参照されます。 .sp .in +2 .nf [2:1E]: interpose1(): ./main [2:0]: interpose1(): ./libA.so .fi .in -2 .sp .sp .LP 割り込みは、予期しないシンボル名の衝突によって生じた、想定外の好ましくないイベントである場合もあります。このような割り込みの症状としては、関数への参照が存在することがわかっているのに、その関数が呼び出されない場合などがあります。このシナリオは、前の例で説明したように、多重定義シンボルとして識別できます。しかし、オブジェクトが特定のシンボルを定義および参照する場合に、より意外なシナリオが多く発生します。 .sp .LP このシナリオの例は、2 つの動的オブジェクトが同じ関数 \fBinterpose2()\fR を定義し参照する場合です。このシンボルへの参照はすべて、プロセスで読み込まれる最初の動的オブジェクトに結合します。この場合、オブジェクト \fBlibA.so\fR の \fBinterpose2()\fR の定義は、オブジェクト \fBlibB.so\fR の \fBinterpose2()\fR の定義に割り込み、これを隠ぺいします。\fBlari\fR からの出力は次のようになります。 .sp .in +2 .nf [2:2ES]: interpose2(): ./libA.so [2:0]: interpose2(): ./libB.so .fi .in -2 .sp .sp .LP 多重定義シンボルに個別に結合する場合もあります。直接結合が有効になっている場合や (\fB[D]\fR)、シンボルの可視性が protected の場合は (\fB[P]\fR)、個別に結合されます。個別の結合は明示的に確立できますが、予期しない想定外の結合が存在する場合もあります。直接結合されたシンボルと、可視性が protected のシンボルは、関心を引く情報として出力されます。 .SS "オーバーヘッド情報" .sp .LP \fB-o\fR オプションを使用した場合、\fBlari\fR は、オーバーヘッドとみなされるシンボル定義を表示します。 .sp .LP 参照されないグローバルシンボルはオーバーヘッドとみなされます。オブジェクト内で提供されるシンボル情報によって、オブジェクトのテキストセグメントのサイズが必要以上に増加します。さらに、シンボル情報によって、実行時にオブジェクト内でほかのシンボル参照を検索するために必要な処理が増える場合があります。 .sp .LP 同じオブジェクトからしか参照されないグローバルシンボルは、同じ特性を持っています。シンボル参照の実行時検索は、結果として、参照を行なった同じオブジェクトへの結合になり、追加のオーバーヘッドになります。 .sp .LP これらの両方のシンボル定義は、オブジェクトのインタフェースを定義することによってローカルスコープに降格できます。インタフェース定義は、リンカーで、\fB-M\fR オプションおよび関連付けられた \fImapfile\fR 指令を使用することによって、作成時にファイルに割り当てることができます。\fI『Oracle Solaris 11.3 Linkers and Libraries Guide』\fROracle Solaris 11.3 Linkers and Libraries Guide \fI\fRを参照してください。\fB-m\fR オプションを付けて \fBlari\fR を使用して、これらの \fImapfile\fR の初期バージョンを作成します。 .sp .LP \fBlari\fR を使用して \fImapfile\fR を生成すると、バージョン定義された共有オブジェクトには、オーバーヘッドシンボルをローカルに降格すべきであることを示す \fImapfile\fR が作成されます。このモデルでは、\fBlari\fR は、既存のインタフェース定義と比較するための \fImapfile\fR を生成できます。\fB-v\fR オプションを使用して、\fImapfile\fR を作成するときに、バージョン定義された共有オブジェクトを無視します。 .sp .LP コピー再配置はオーバーヘッドともみなされるため、通常は回避すべきです。コピーされたデータのサイズは、そのインタフェースの定義です。この定義は、データが定義されている共有オブジェクトのより新しいバージョンでのデータサイズを変更する機能を制限します。この制限、およびコピー再配置を処理するコストは、関数インタフェースを使用してデータを参照することによって回避できます。コピー再配置の \fBlari\fR からの出力は次のようになります。 .sp .in +2 .nf [2:1EC]: __iob[0x140]: ./main [2:0]: __iob[0x140]: ./libA.so.1 .fi .in -2 .sp .sp .LP 前の例で使用された \fB__iob\fR など、いくつかの小さなコピー再配置が存在することに注意してください。これは、システムライブラリのプログラミング操作のために歴史的な理由により存在しています。 .sp .LP オーバーヘッド情報の別の例は、動的実行可能ファイルのプロシージャリンケージテーブルエントリに、動的オブジェクトを結合する場合です。動的実行可能ファイルが外部関数を参照する場合、プロシージャリンケージテーブルエントリが作成されます。この構造では、関数呼び出しが実際に行われるまで、参照結合を延期できます。動的オブジェクトがこの参照された同じ関数のアドレスを取得した場合、動的オブジェクトは、動的実行可能ファイルのプロシージャリンケージテーブルエントリに結合します。このタイプのイベントの例は、次の点を明らかにします。 .sp .in +2 .nf [2:1EA]: foo(): ./main [2:1E]: foo(): ./libA.so .fi .in -2 .sp .sp .LP このタイプの少数の結合は、通常は心配する必要はありません。ただし、ジャンプテーブルプログラミング技法などによって、これらの結合が多数発生する場合は、オーバーヘッドを起こす一因となることが考えられます。このタイプのアドレス再配置結合では、直接関数を呼び出したときに使用される遅延再配置処理ではなく、アプリケーション起動時の再配置処理が必要になります。このアドレスを使用するために、実行時に間接参照も必要になります。 .SH 使用例 .LP \fB例 1 \fR複数の結合がある場合の分析 .sp .LP 次の例では、複数のシンボル定義が存在するプロセスの分析を示します。共有オブジェクト \fBlibX.so\fR と \fBlibY.so\fR は関数 \fBinterpose()\fR を呼び出します。この関数は、アプリケーション \fBmain\fR と、共有オブジェクト \fBlibA.so\fR の両方に存在します。割り込みのため、両方の参照は \fBmain\fR の \fBinterpose()\fR の定義に結合します。 .sp .LP 共有オブジェクト \fBlibX.so\fR と \fBlibY.so\fR は関数 \fBfoo()\fR も呼び出します。この関数は、アプリケーション \fBmain\fR と、共有オブジェクト \fBlibA.so\fR、\fBlibX.so\fR、および \fBlibY.so\fR に存在します。\fBlibX.so\fR と \fBlibY.so\fR の両方は直接結合を有効にして構築されているので、各オブジェクトはそれぞれ独自の定義に結合します。 .sp .in +2 .nf example% \fBlari ./main\fR [3:0]: foo(): ./libA.so [3:1SD]: foo(): ./libX.so [3:1SD]: foo(): ./libY.so [2:0]: interpose(): ./libA.so [2:2EP]: interpose(): ./main .fi .in -2 .sp .sp .LP 結合情報をさらに分析するために、結合データをその後の検査用に保存できます。たとえば、前の出力は、関数 \fBinterpose()\fR が、\fBmain\fR の外部にある 2 つのオブジェクトから呼び出されたことを示しています。結合の出力を検査することによって、この関数への参照が行われた場所を明らかにできます。 .sp .in +2 .nf example% \fBlari -s ./main\fR lari: ./main: bindings information saved as: \e /usr/tmp/lari.dbg.main \&..... example% \fBfgrep foo /usr/tmp/lari.dbg.main\fR binding file=./libX.so to file=./main: symbol `interpose' binding file=./libY.so to file=./main: symbol `interpose' .fi .in -2 .sp .sp .LP \fB注:\fR 結合の出力にはプロセス識別子、アドレス、その他の結合情報が伴うので、出力は通常、ここに示すよりも多くなります。 .LP \fB例 2 \fRインタフェース定義の生成 .sp .LP 次の例では、アプリケーションとその依存関係のインタフェース定義を作成しますが、バージョンが定義されたシステムライブラリは無視します。アプリケーション \fBmain\fR は、\fBfoo.so\fR のインタフェース \fBone()\fR、\fBtwo()\fR、および \fBthree()\fR を参照します。 .sp .in +2 .nf example% \fBlari -omv ./main\fR example% \fBcat mapfile-foo.so\fR # # Interface Definition mapfile for: # Dynamic Object: ./foo.so # Process: ./main # foo.so { global: one; three; two; local: _one; _three; _two; *; }; .fi .in -2 .sp .SH ファイル .sp .ne 2 .mk .na \fB\fB$TMPDIR/lari.dbg.\fIfile\fR\fR\fR .ad .RS 25n .rt \fBldd\fR(1) によって生成された結合の出力。 .RE .SH 属性 .sp .LP 属性についての詳細は、マニュアルページの \fBattributes\fR(5) を参照してください。 .sp .sp .TS tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . 属性タイプ属性値 _ 使用条件developer/base-developer-utilities _ インタフェースの安定性下記を参照。 .TE .sp .LP 人間が読める形式の出力は「不確実」です。オプションは「確実」です。 .SH 関連項目 .sp .LP \fBld\fR(1), \fBldd\fR(1), \fBld.so.1\fR(1), \fBdlopen\fR(3C), \fBdlsym\fR(3C), \fBattributes\fR(5) .sp .LP \fI『Oracle Solaris 11.3 Linkers and Libraries Guide』\fR