TOP <<<<
|
BACKWARD <<
|
|
>> FORWARD
|
>>>> END
※ 左右のカーソルキーでもページ繰りができます
<div class="title" >ユーザプログラムでの DTrace<br/> 〜 導入編</div> <div class="author"> 藤原 克則 <foozy@lares.dti.ne.jp> </div> ----@ <div class="section">更新履歴</div> <dl> <dt>2010/03/26</dt> <dd>初版公開</dd> </dl> ----@ <div class="section">参照先</div> <dl> <dt><a href="http://docs.sun.com/app/docs/doc/819-0395/preface?l=ja&a=browse" >Solaris 動的トレースガイド</a></dt> <dd>SUN の公式ドキュメント。<br/> 一括参照には <a href="http://dlc.sun.com/pdf/819-0395/819-0395.pdf" >PDF 版</a>が便利です。</dd> <dt><a href="http://gihyo.jp/dev/serial/01/dtrace4cpg/" >C/C++ プログラマのための DTrace 入門</a></dt> <dd>手前味噌で恐縮ですが、 本資料で割愛した詳細に関しても解説していますので、 DTrace に興味を覚えた方は是非ご一読ください。 </dd> </dl> ----@ <ul> <li><span class="hilite" >開始前準備</span> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> </ul> ----@ <a name="preparation"></a> <div class="section">開始前準備</div> <p>DTrace の使用 (＝ <code>dtrace</code> コマンドの実行)には、 root 権限が必要です。</p> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><span class="hilite" >関数フローのログ</span> <ul> <li><a href="JavaScript:showSlideByName('flow.whole')" >コマンド実行全体のフロー</a> <li><a href="JavaScript:showSlideByName('flow.dtracecommand')" >dtrace コマンド起動の基本</a> <li><a href="JavaScript:showSlideByName('flow.dscriptdetail')" >D スクリプトの詳細</a> <li><a href="JavaScript:showSlideByName('flow.dscriptsyntax')" >D スクリプトの基本文法</a> <li><a href="JavaScript:showSlideByName('flow.attach')" >起動済みコマンドのフロー</a> <li><a href="JavaScript:showSlideByName('flow.inconsistency')" >フローの不整合</a> </ul> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> </ul> ----@ <a name="flow"> <div class="section">関数フローのログ</div> <p>ユーザプロセスの関数呼び出しフローを採取しましょう</p> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <ul> <li><span class="hilite" >コマンド実行全体のフロー</span> <li><a href="JavaScript:showSlideByName('flow.dtracecommand')" >dtrace コマンド起動の基本</a> <li><a href="JavaScript:showSlideByName('flow.dscriptdetail')" >D スクリプトの詳細</a> <li><a href="JavaScript:showSlideByName('flow.dscriptsyntax')" >D スクリプトの基本文法</a> <li><a href="JavaScript:showSlideByName('flow.attach')" >起動済みコマンドのフロー</a> <li><a href="JavaScript:showSlideByName('flow.inconsistency')" >フローの不整合</a> </ul> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> </ul> ----@ <a name="flow.whole"></a> <div class="section">関数フローのログ</div> <div class="subsection">コマンド実行全体のフロー</div> <p><a href="./src/intro/show_flow.c" ><code>show_flow.c</code></a> から生成した <code>show_flow</code> コマンドの関数フローを、 <a href="./src/intro/watch_flow_whole.d" ><code>watch_flow_whole.d</code></a> を使用して採取してみましょう。</p> <pre> $ <b >dtrace -s ./watch_flow_whole.d \ -F \ -c ./show_flow \ show_flow</b> </pre> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <ul> <li><a href="JavaScript:showSlideByName('flow.whole')" >コマンド実行全体のフロー</a> <li><span class="hilite" >dtrace コマンド起動の基本</span> <li><a href="JavaScript:showSlideByName('flow.dscriptdetail')" >D スクリプトの詳細</a> <li><a href="JavaScript:showSlideByName('flow.dscriptsyntax')" >D スクリプトの基本文法</a> <li><a href="JavaScript:showSlideByName('flow.attach')" >起動済みコマンドのフロー</a> <li><a href="JavaScript:showSlideByName('flow.inconsistency')" >フローの不整合</a> </ul> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> </ul> ----@ <a name="flow.dtracecommand"></a> <div class="section">関数フローのログ</div> <div class="subsection">dtrace コマンド起動の基本</div> <p><code>dtrace</code> コマンドの起動における各要素について説明します。</p> <pre> $ <b >dtrace -s ./watch_flow_whole.d \ -F \ -c ./show_flow \ show_flow</b> </pre> ----@ <div class="section">関数フローのログ</div> <div class="subsection">dtrace コマンド起動の基本</div> <p><code>dtrace</code> コマンドの起動における各要素について説明します。</p> <pre> $ <b >dtrace <span class="hilite">-s ./watch_flow_whole.d</span> \ -F \ -c ./show_flow \ show_flow</b> </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>-s ./watch_flow_whole.d</code></th> <td>指定ファイルからのスクリプト読み込みを指示するオプション。<br/> コマンド行で直接スクリプトを記述する場合は、 "<code>-n <i>script</i></code>" のように記述する。 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">dtrace コマンド起動の基本</div> <p><code>dtrace</code> コマンドの起動における各要素について説明します。</p> <pre> $ <b >dtrace -s ./watch_flow_whole.d \ <span class="hilite">-F</span> \ -c ./show_flow \ show_flow</b> </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>-s ./watch_flow_whole.d</code></th> <td>指定ファイルからのスクリプト読み込みを指示するオプション。<br/> コマンド行で直接スクリプトを記述する場合は、 "<code>-n <i>script</i></code>" のように記述する。 </td> </tr> <tr> <th><code>-F</code></th> <td>フロー表示を指示するオプション。<br/> 関数呼び出し階層に応じた字下げ等が行われる。 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">dtrace コマンド起動の基本</div> <p><code>dtrace</code> コマンドの起動における各要素について説明します。</p> <pre> $ <b >dtrace -s ./watch_flow_whole.d \ -F \ <span class="hilite">-c ./show_flow</span> \ show_flow</b> </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>-s ./watch_flow_whole.d</code></th> <td>指定ファイルからのスクリプト読み込みを指示するオプション。<br/> コマンド行で直接スクリプトを記述する場合は、 "<code>-n <i>script</i></code>" のように記述する。 </td> </tr> <tr> <th><code>-F</code></th> <td>フロー表示を指示するオプション。<br/> 関数呼び出し階層に応じた字下げ等が行われる。 </td> </tr> <tr> <th><code>-c ./show_flow</code></th> <td>指定コマンド実行プロセスをトレース対象とする旨を指示するオプション。<br/> 引数が必要なコマンドの場合はクォーテーション等で囲み、 "-c" オプションの引数としては1つにする必要あり (例: "<code>-c './show_flow 1 2 3'</code>")。 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">dtrace コマンド起動の基本</div> <p><code>dtrace</code> コマンドの起動における各要素について説明します。</p> <pre> $ <b >dtrace -s ./watch_flow_whole.d \ -F \ -c ./show_flow \ <span class="hilite">show_flow</span></b> </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>-s ./watch_flow_whole.d</code></th> <td>指定ファイルからのスクリプト読み込みを指示するオプション。<br/> コマンド行で直接スクリプトを記述する場合は、 "<code>-n <i>script</i></code>" のように記述する。 </td> </tr> <tr> <th><code>-F</code></th> <td>フロー表示を指示するオプション。<br/> 関数呼び出し階層に応じた字下げ等が行われる。 </td> </tr> <tr> <th><code>-c ./show_flow</code></th> <td>指定コマンド実行プロセスをトレース対象とする旨を指示するオプション。<br/> 引数が必要なコマンドの場合はクォーテーション等で囲み、 "-c" オプションの引数としては1つにする必要あり (例: "<code>-c './show_flow 1 2 3'</code>")。 </td> </tr> <tr> <th><code>show_flow</code></th> <td>これ以後は、実行されるスクリプトに対する引数とみなされる。<br/> スクリプト中からは、順に $1, $2, $3, .... として参照可能。 </td> </tr> </table> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <ul> <li><a href="JavaScript:showSlideByName('flow.whole')" >コマンド実行全体のフロー</a> <li><a href="JavaScript:showSlideByName('flow.dtracecommand')" >dtrace コマンド起動の基本</a> <li><span class="hilite" >D スクリプトの詳細</span> <li><a href="JavaScript:showSlideByName('flow.dscriptsyntax')" >D スクリプトの基本文法</a> <li><a href="JavaScript:showSlideByName('flow.attach')" >起動済みコマンドのフロー</a> <li><a href="JavaScript:showSlideByName('flow.inconsistency')" >フローの不整合</a> </ul> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> </ul> ----@ <a name="flow.dscriptdetail"></a> <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの詳細</div> <p>D スクリプト(<a href="./src/intro/watch_flow_whole.d" ><code>watch_flow_whole.d</code></a> ファイル) の各要素について説明します。</p> <pre> pid$target:$1::entry, pid$target:$1::return { } </pre> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの詳細</div> <p>D スクリプト(<a href="./src/intro/watch_flow_whole.d" ><code>watch_flow_whole.d</code></a> ファイル) の各要素について説明します。</p> <pre> <span class="hilite">pid</span>$target:$1::entry, <span class="hilite">pid</span>$target:$1::return { } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>pid</code></th> <td>ユーザプロセスにおける関数・命令実行のトレースを行う機能である <a href="http://docs.sun.com/app/docs/doc/819-0395/chp-pid?l=ja&a=view" >pid</a> プロバイダ(provider)の使用を宣言。 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの詳細</div> <p>D スクリプト(<a href="./src/intro/watch_flow_whole.d" ><code>watch_flow_whole.d</code></a> ファイル) の各要素について説明します。</p> <pre> pid<span class="hilite">$target</span>:$1::entry, pid<span class="hilite">$target</span>:$1::return { } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>pid</code></th> <td>ユーザプロセスにおける関数・命令実行のトレースを行う機能である <a href="http://docs.sun.com/app/docs/doc/819-0395/chp-pid?l=ja&a=view" >pid</a> プロバイダ(provider)の使用を宣言。 </td> </tr> <tr> <th><code>$target</code></th> <td><code>dtrace</code> コマンドの "<code>-c</code>" オプションで指定されたコマンドを実行することで生成されたプロセスの、 プロセスIDと置換される。 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの詳細</div> <p>D スクリプト(<a href="./src/intro/watch_flow_whole.d" ><code>watch_flow_whole.d</code></a> ファイル) の各要素について説明します。</p> <pre> pid$target:<span class="hilite">$1</span>::entry, pid$target:<span class="hilite">$1</span>::return { } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>pid</code></th> <td>ユーザプロセスにおける関数・命令実行のトレースを行う機能である <a href="http://docs.sun.com/app/docs/doc/819-0395/chp-pid?l=ja&a=view" >pid</a> プロバイダ(provider)の使用を宣言。 </td> </tr> <tr> <th><code>$target</code></th> <td><code>dtrace</code> コマンドの "<code>-c</code>" オプションで指定されたコマンドを実行することで生成されたプロセスの、 プロセスIDと置換される。 </td> </tr> <tr> <th><code>$1</code></th> <td><code>dtrace</code> コマンドの(オプション指定等を除いた後の) 第1引数の値で置換。<br/> 先の実行例の場合は "<code>show_flow</code>" </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの詳細</div> <p>D スクリプト(<a href="./src/intro/watch_flow_whole.d" ><code>watch_flow_whole.d</code></a> ファイル) の各要素について説明します。</p> <pre> pid$target:$1::<span class="hilite">entry</span>, pid$target:$1::return { } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>pid</code></th> <td>ユーザプロセスにおける関数・命令実行のトレースを行う機能である <a href="http://docs.sun.com/app/docs/doc/819-0395/chp-pid?l=ja&a=view" >pid</a> プロバイダ(provider)の使用を宣言。 </td> </tr> <tr> <th><code>$target</code></th> <td><code>dtrace</code> コマンドの "<code>-c</code>" オプションで指定されたコマンドを実行することで生成されたプロセスの、 プロセスIDと置換される。 </td> </tr> <tr> <th><code>$1</code></th> <td><code>dtrace</code> コマンドの(オプション指定等を除いた後の) 第1引数の値で置換。<br/> 先の実行例の場合は "<code>show_flow</code>" </td> </tr> <tr> <th><code>entry</code></th> <td>採取対象として「関数の呼び出し」を指定 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの詳細</div> <p>D スクリプト(<a href="./src/intro/watch_flow_whole.d" ><code>watch_flow_whole.d</code></a> ファイル) の各要素について説明します。</p> <pre> pid$target:$1::entry, pid$target:$1::<span class="hilite">return</span> { } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>pid</code></th> <td>ユーザプロセスにおける関数・命令実行のトレースを行う機能である <a href="http://docs.sun.com/app/docs/doc/819-0395/chp-pid?l=ja&a=view" >pid</a> プロバイダ(provider)の使用を宣言。 </td> </tr> <tr> <th><code>$target</code></th> <td><code>dtrace</code> コマンドの "<code>-c</code>" オプションで指定されたコマンドを実行することで生成されたプロセスの、 プロセスIDと置換される。 </td> </tr> <tr> <th><code>$1</code></th> <td><code>dtrace</code> コマンドの(オプション指定等を除いた後の) 第1引数の値で置換。<br/> 先の実行例の場合は "<code>show_flow</code>" </td> </tr> <tr> <th><code>entry</code></th> <td>採取対象として「関数の呼び出し」を指定 </td> </tr> <tr> <th><code>exit</code></th> <td>採取対象として「関数からの復帰」を指定 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの詳細</div> <p>D スクリプト(<a href="./src/intro/watch_flow_whole.d" ><code>watch_flow_whole.d</code></a> ファイル) の各要素について説明します。</p> <pre> pid$target:$1::entry, pid$target:$1::return <span class="hilite">{ }</span> </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>pid</code></th> <td>ユーザプロセスにおける関数・命令実行のトレースを行う機能である <a href="http://docs.sun.com/app/docs/doc/819-0395/chp-pid?l=ja&a=view" >pid</a> プロバイダ(provider)の使用を宣言。 </td> </tr> <tr> <th><code>$target</code></th> <td><code>dtrace</code> コマンドの "<code>-c</code>" オプションで指定されたコマンドを実行することで生成されたプロセスの、 プロセスIDと置換される。 </td> </tr> <tr> <th><code>$1</code></th> <td><code>dtrace</code> コマンドの(オプション指定等を除いた後の) 第1引数の値で置換。<br/> 先の実行例の場合は "<code>show_flow</code>" </td> </tr> <tr> <th><code>entry</code></th> <td>採取対象として「関数の呼び出し」を指定 </td> </tr> <tr> <th><code>exit</code></th> <td>採取対象として「関数からの復帰」を指定 </td> </tr> <tr> <th><code>{ }</code></th> <td>採取対象となるイベント(この場合は関数の呼び出し・復帰) が発生した際に実行される処理。 </td> </tr> </table> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <ul> <li><a href="JavaScript:showSlideByName('flow.whole')" >コマンド実行全体のフロー</a> <li><a href="JavaScript:showSlideByName('flow.dtracecommand')" >dtrace コマンド起動の基本</a> <li><a href="JavaScript:showSlideByName('flow.dscriptdetail')" >D スクリプトの詳細</a> <li><span class="hilite" >D スクリプトの基本文法</span> <li><a href="JavaScript:showSlideByName('flow.attach')" >起動済みコマンドのフロー</a> <li><a href="JavaScript:showSlideByName('flow.inconsistency')" >フローの不整合</a> </ul> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> </ul> ----@ <a name="flow.dscriptsyntax"></a> <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの基本文法</div> <p>基本的な D スクリプトは、 以下の構成を持っています。</p> <pre> <i>probe-description</i> [, .....] { <i>action-statements</i> } </pre> <p>上記を「<b>節</b>」(clause) と呼びます。</p> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの基本文法</div> <p>基本的な D スクリプトは、 以下の構成を持っています。</p> <pre> <i>probe-description</i> [, .....] { <i>action-statements</i> } </pre> <p>上記を「<b>節</b>」(clause) と呼びます。</p> <p><code><i>probe-description</i></code> は、 以下の要素から構成されています。</p> <pre> <i>probeprov</i> : <i>probemod</i> : <i>probefunc</i> : <i>probename</i> </pre> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの基本文法</div> <p>基本的な D スクリプトは、 以下の構成を持っています。</p> <pre> <i>probe-description</i> [, .....] { <i>action-statements</i> } </pre> <p>上記を「<b>節</b>」(clause) と呼びます。</p> <p><code><i>probe-description</i></code> は、 以下の要素から構成されています。</p> <pre> <i class="hilite">probeprov</i> : <i>probemod</i> : <i>probefunc</i> : <i>probename</i> </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>probeprov</code></th> <td>プロバイダ(provider)指定。<br/> 情報採取機能の種類を指定。 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの基本文法</div> <p>基本的な D スクリプトは、 以下の構成を持っています。</p> <pre> <i>probe-description</i> [, .....] { <i>action-statements</i> } </pre> <p>上記を「<b>節</b>」(clause) と呼びます。</p> <p><code><i>probe-description</i></code> は、 以下の要素から構成されています。</p> <pre> <i>probeprov</i> : <i class="hilite">probemod</i> : <i>probefunc</i> : <i>probename</i> </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>probeprov</code></th> <td>プロバイダ(provider)指定。<br/> 情報採取機能の種類を指定。 </td> </tr> <tr> <th><code>probemod</code></th> <td>モジュール(module)指定。<br/> 採取対象バイナリファイルを指定。 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの基本文法</div> <p>基本的な D スクリプトは、 以下の構成を持っています。</p> <pre> <i>probe-description</i> [, .....] { <i>action-statements</i> } </pre> <p>上記を「<b>節</b>」(clause) と呼びます。</p> <p><code><i>probe-description</i></code> は、 以下の要素から構成されています。</p> <pre> <i>probeprov</i> : <i>probemod</i> : <i class="hilite">probefunc</i> : <i>probename</i> </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>probeprov</code></th> <td>プロバイダ(provider)指定。<br/> 情報採取機能の種類を指定。 </td> </tr> <tr> <th><code>probemod</code></th> <td>モジュール(module)指定。<br/> 採取対象バイナリファイルを指定。 </td> </tr> <tr> <th><code>probefunc</code></th> <td>関数(function)指定<br/> 情報採取対象となる関数名を指定。 </td> </tr> </table> ----@ <div class="section">関数フローのログ</div> <div class="subsection">D スクリプトの基本文法</div> <p>基本的な D スクリプトは、 以下の構成を持っています。</p> <pre> <i>probe-description</i> [, .....] { <i>action-statements</i> } </pre> <p>上記を「<b>節</b>」(clause) と呼びます。</p> <p><code><i>probe-description</i></code> は、 以下の要素から構成されています。</p> <pre> <i>probeprov</i> : <i>probemod</i> : <i>probefunc</i> : <i class="hilite">probename</i> </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>probeprov</code></th> <td>プロバイダ(provider)指定。<br/> 情報採取機能の種類を指定。 </td> </tr> <tr> <th><code>probemod</code></th> <td>モジュール(module)指定。<br/> 採取対象バイナリファイルを指定。 </td> </tr> <tr> <th><code>probefunc</code></th> <td>関数(function)指定<br/> 情報採取対象となる関数名を指定。 </td> </tr> <tr> <th><code>probename</code></th> <td>プローブ(probe)指定<br/> 採取契機を指定。 </td> </tr> </table> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <ul> <li><a href="JavaScript:showSlideByName('flow.whole')" >コマンド実行全体のフロー</a> <li><a href="JavaScript:showSlideByName('flow.dtracecommand')" >dtrace コマンド起動の基本</a> <li><a href="JavaScript:showSlideByName('flow.dscriptdetail')" >D スクリプトの詳細</a> <li><a href="JavaScript:showSlideByName('flow.dscriptsyntax')" >D スクリプトの基本文法</a> <li><span class="hilite" >起動済みコマンドのフロー</span> <li><a href="JavaScript:showSlideByName('flow.inconsistency')" >フローの不整合</a> </ul> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> </ul> ----@ <a name="flow.attach"></a> <div class="section">関数フローのログ</div> <div class="subsection">起動済みコマンドのフロー</div> <p>"<code>-p</code>" でのプロセスID指定が、 "<code>-c</code>" によるコマンド指定の代替として機能します。 </p> <pre> $ <b >dtrace -s ./watch_flow_whole.d \ -F \</b> <b>-p <i class="hilite">PID</i> \</b> <i>※ $target を置換</i> <b>show_flow</b> </pre> ----@ <div class="section">関数フローのログ</div> <div class="subsection">起動済みコマンドのフロー</div> <p>"<code>-p</code>" でのプロセスID指定が、 "<code>-c</code>" によるコマンド指定の代替として機能します。 </p> <pre> $ <b >dtrace -s ./watch_flow_whole.d \ -F \</b> <b>-p <i class="hilite">PID</i> \</b> <i>※ $target を置換</i> <b>show_flow</b> </pre> <p><code>-p</code> による対象指定を行う場合、 デバッガ等の制御下にある(例: ブレークポイント等での停止状態) プロセスを対象とすることはできません。</p> ----@ <div class="section">関数フローのログ</div> <div class="subsection">起動済みコマンドのフロー</div> <p>デバッガ等と併用する場合には、<a href="./src/intro/watch_flow_attach.d" ><code>watch_flow_attach.d</code></a> のような D スクリプトを使用します:</p> <pre> pid$1:$2::entry, pid$1:$2::return { } </pre> ----@ <div class="section">関数フローのログ</div> <div class="subsection">起動済みコマンドのフロー</div> <p>デバッガ等と併用する場合には、<a href="./src/intro/watch_flow_attach.d" ><code>watch_flow_attach.d</code></a> のような D スクリプトを使用します:</p> <pre> pid$1:$2::entry, pid$1:$2::return { } </pre> <p>以下の要領で使用します。</p> <pre> $ <b >dtrace -s ./watch_flow_attach.d \ -F \ </b> <b><i class="hilite">PID</i> \</b> <i>※ $1 を置換</i> <b>show_flow</b> <i>※ $2 を置換</i> </pre> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <ul> <li><a href="JavaScript:showSlideByName('flow.whole')" >コマンド実行全体のフロー</a> <li><a href="JavaScript:showSlideByName('flow.dtracecommand')" >dtrace コマンド起動の基本</a> <li><a href="JavaScript:showSlideByName('flow.dscriptdetail')" >D スクリプトの詳細</a> <li><a href="JavaScript:showSlideByName('flow.dscriptsyntax')" >D スクリプトの基本文法</a> <li><a href="JavaScript:showSlideByName('flow.attach')" >起動済みコマンドのフロー</a> <li><span class="hilite" >フローの不整合</span> </ul> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> </ul> ----@ <a name="flow.inconsistency"></a> <div class="section">関数フローのログ</div> <div class="subsection">フローの不整合</div> <p>採取された関数フローに以下の様な不整合が見られる場合があります。</p> <ul> <li>ソースコードの記述とは異なるフロー出力 <li>entry/return の対応付けが崩れたフロー <li>フローが採取されない関数呼び出し </ul> ----@ <div class="section">関数フローのログ</div> <div class="subsection">フローの不整合</div> <p>採取された関数フローに以下の様な不整合が見られる場合があります。</p> <ul> <li>ソースコードの記述とは異なるフロー出力 <li>entry/return の対応付けが崩れたフロー <li>フローが採取されない関数呼び出し </ul> <p>一般には最適化の影響によるものです。</p> <ul> <li>末尾呼び出し最適化 <li>インライン展開 <li>leaf procedure 最適化(SPARC プロセッサ固有) </ul> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <li><span class="hilite" >より詳細な情報の取得</span> <ul> <li><a href="JavaScript:showSlideByName('detail.argval')" >引数値の取得</a> <li><a href="JavaScript:showSlideByName('detail.argstr')" >引数文字列の取得</a> <li><a href="JavaScript:showSlideByName('detail.argmem')" >メモリ内容の取得</a> <li><a href="JavaScript:showSlideByName('detail.retval')" >戻り値の取得</a> <li><a href="JavaScript:showSlideByName('detail.ustack')" >呼び出しスタック</a> </ul> </ul> ----@ <a name="detail"></a> <div class="section">より詳細な情報の取得</div> <p>関数フロー以外の詳細情報を採取してみましょう。</p> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> <ul> <li><span class="hilite" >引数値の取得</span> <li><a href="JavaScript:showSlideByName('detail.argstr')" >引数文字列の取得</a> <li><a href="JavaScript:showSlideByName('detail.argmem')" >メモリ内容の取得</a> <li><a href="JavaScript:showSlideByName('detail.retval')" >戻り値の取得</a> <li><a href="JavaScript:showSlideByName('detail.ustack')" >呼び出しスタック</a> </ul> </ul> ----@ <a name="detail.argval"></a> <div class="section">より詳細な情報の取得</div> <div class="subsection">引数値の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>multiply()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_val.d" ><code>watch_args_val.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:multiply:entry { printf("%s(%d, %d)", probefunc, arg0, arg1); } </pre> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数値の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>multiply()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_val.d" ><code>watch_args_val.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:multiply:entry { <span class="hilite">printf</span>("%s(%d, %d)", probefunc, arg0, arg1); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>printf</code></th> <td>C/C++ プログラマには説明不要な出力整形処理。<br/> 標準 C ライブラリで既定されているフォーマットは概ね使用可能。 </td> </tr> </table> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数値の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>multiply()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_val.d" ><code>watch_args_val.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:multiply:entry { printf("%s(%d, %d)", <span class="hilite">probefunc</span>, arg0, arg1); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>printf</code></th> <td>C/C++ プログラマには説明不要な出力整形処理。<br/> 標準 C ライブラリで既定されているフォーマットは概ね使用可能。 </td> </tr> <tr> <th><code>probefunc</code></th> <td>トレース対象関数名を参照するための組み込み変数(文字列型)。<br/> 複数の関数に同じ処理を実施する場合に便利。 </td> </tr> </table> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数値の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>multiply()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_val.d" ><code>watch_args_val.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:multiply:entry { printf("%s(%d, %d)", probefunc, <span class="hilite">arg0, arg1</span>); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>printf</code></th> <td>C/C++ プログラマには説明不要な出力整形処理。<br/> 標準 C ライブラリで既定されているフォーマットは概ね使用可能。 </td> </tr> <tr> <th><code>probefunc</code></th> <td>トレース対象関数名を参照するための組み込み変数(文字列型)。<br/> 複数の関数に同じ処理を実施する場合に便利。 </td> </tr> <tr> <th><code>arg0</code>, ....</th> <td><code>pid</code> プロバイダで <code>entry</code> プローブを使用する場合、 関数の引数が <code>arg0</code> から順に関連付けられる。<br/> <code>args[n]</code> 配列形式で扱うことも可能。 </td> </tr> </table> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> <ul> <li><a href="JavaScript:showSlideByName('detail.argval')" >引数値の取得</a> <li><span class="hilite" >引数文字列の取得</span> <li><a href="JavaScript:showSlideByName('detail.argmem')" >メモリ内容の取得</a> <li><a href="JavaScript:showSlideByName('detail.retval')" >戻り値の取得</a> <li><a href="JavaScript:showSlideByName('detail.ustack')" >呼び出しスタック</a> </ul> </ul> ----@ <a name="detail.argstr"></a> <div class="section">より詳細な情報の取得</div> <div class="subsection">引数文字列の取得</div> <p>先の例と同じ要領で、引数文字列を表示してみましょう。</p> <pre> pid$target:show_args:showname:entry { printf("%s(%s)", probefunc, arg0); } </pre> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数文字列の取得</div> <p>先の例と同じ要領で、引数文字列を表示してみましょう。</p> <pre> pid$target:show_args:showname:entry { <s>printf("%s(%s)", probefunc, arg0);</s> } </pre> <p>このままでは上手く機能しません。</p> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数文字列の取得</div> <p>先の例と同じ要領で、引数文字列を表示してみましょう。</p> <pre> pid$target:show_args:showname:entry { <s>printf("%s(%s)", probefunc, arg0);</s> } </pre> <p>このままでは上手く機能しません。</p> <p><a href="http://docs.sun.com/app/docs/doc/819-0395/chp-intro-3?l=ja&a=view" >D スクリプトはカーネル内部で動作する</a>ため、 ユーザープログラムのメモリ内容を参照するには以下の手順が必要です:</p> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数文字列の取得</div> <p>先の例と同じ要領で、引数文字列を表示してみましょう。</p> <pre> pid$target:show_args:showname:entry { <s>printf("%s(%s)", probefunc, arg0);</s> } </pre> <p>このままでは上手く機能しません。</p> <p><a href="http://docs.sun.com/app/docs/doc/819-0395/chp-intro-3?l=ja&a=view" >D スクリプトはカーネル内部で動作する</a>ため、 ユーザープログラムのメモリ内容を参照するには以下の手順が必要です:</p> <ol> <li>カーネル内部に一時的なメモリ領域＝バッファを確保して </ol> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数文字列の取得</div> <p>先の例と同じ要領で、引数文字列を表示してみましょう。</p> <pre> pid$target:show_args:showname:entry { <s>printf("%s(%s)", probefunc, arg0);</s> } </pre> <p>このままでは上手く機能しません。</p> <p><a href="http://docs.sun.com/app/docs/doc/819-0395/chp-intro-3?l=ja&a=view" >D スクリプトはカーネル内部で動作する</a>ため、 ユーザープログラムのメモリ内容を参照するには以下の手順が必要です:</p> <ol> <li>カーネル内部に一時的なメモリ領域＝バッファを確保して <li>ユーザプログラムの仮想記憶領域からバッファにデータを転送し </ol> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数文字列の取得</div> <p>先の例と同じ要領で、引数文字列を表示してみましょう。</p> <pre> pid$target:show_args:showname:entry { <s>printf("%s(%s)", probefunc, arg0);</s> } </pre> <p>このままでは上手く機能しません。</p> <p><a href="http://docs.sun.com/app/docs/doc/819-0395/chp-intro-3?l=ja&a=view" >D スクリプトはカーネル内部で動作する</a>ため、 ユーザープログラムのメモリ内容を参照するには以下の手順が必要です:</p> <ol> <li>カーネル内部に一時的なメモリ領域＝バッファを確保して <li>ユーザプログラムの仮想記憶領域からバッファにデータを転送し <li>転送されたバッファの内容を参照 </ol> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数文字列の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>showname()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_str.d" ><code>watch_args_str.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:showname:entry { printf("%s(%s)", probefunc, <span class="hilite">copyinstr(arg0)</span>); } </pre> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数文字列の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>showname()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_str.d" ><code>watch_args_str.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:showname:entry { printf("%s(%s)", probefunc, <span class="hilite">copyinstr(arg0)</span>); } </pre> <p>ユーザプロセスの文字列を扱う場合、 以下の機能を使用する必要があります。</p> <dl> <dt><code>copyin</code></dt> <dd>ユーザ空間からカーネル空間へのデータのコピー </dd> <dt><code>stringof</code></dt> <dd>指定データ領域の内容を元に、 DTrace 固有の <code>string</code> 型オブジェクトを生成。 </dd> <dt><code>copyinstr</code></dt> <dd><code>stringof(copyin(addr))</code> と等価</dd> </dl> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">引数文字列の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>showname()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_str.d" ><code>watch_args_str.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:showname:entry { printf("%s(%s)", probefunc, <span class="hilite">copyinstr(arg0)</span>); } </pre> <p>ユーザプロセスの文字列を扱う場合、 以下の機能を使用する必要があります。</p> <dl> <dt><code>copyin</code></dt> <dd>ユーザ空間からカーネル空間へのデータのコピー </dd> <dt><code>stringof</code></dt> <dd>指定データ領域の内容を元に、 DTrace 固有の <code>string</code> 型オブジェクトを生成。 </dd> <dt><code>copyinstr</code></dt> <dd><code>stringof(copyin(addr))</code> と等価</dd> </dl> <p><code>printf</code> の <code>%s</code> フォーマットは、 <code>string</code> 変換されたものしか受け付けません。</p> <p>文字列を扱う DTrace の組み込み変数は <code>string</code> を返却するものが殆どであり、 ついつい忘れてしまうので注意が必要です！ </p> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> <ul> <li><a href="JavaScript:showSlideByName('detail.argval')" >引数値の取得</a> <li><a href="JavaScript:showSlideByName('detail.argstr')" >引数文字列の取得</a> <li><span class="hilite" >メモリ内容の取得</span> <li><a href="JavaScript:showSlideByName('detail.retval')" >戻り値の取得</a> <li><a href="JavaScript:showSlideByName('detail.ustack')" >呼び出しスタック</a> </ul> </ul> ----@ <a name="detail.argmem"></a> <div class="section">より詳細な情報の取得</div> <div class="subsection">メモリ内容の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>checksum()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_mem.d" ><code>watch_args_mem.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:checksum:entry { this->iobuf = alloca(32); copyinto(arg0, 32, this->iobuf); tracemem(this->iobuf, 32); } </pre> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">メモリ内容の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>checksum()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_mem.d" ><code>watch_args_mem.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:checksum:entry { <span class="hilite">this->iobuf</span> = alloca(32); copyinto(arg0, 32, this->iobuf); tracemem(this->iobuf, 32); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>this->iobuf</code></th> <td><b>節固有変数</b>(clause local variable)(※1)として、 <code>iobuf</code> を参照 </td> </tr> </table> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">メモリ内容の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>checksum()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_mem.d" ><code>watch_args_mem.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:checksum:entry { this->iobuf = <span class="hilite">alloca(32)</span>; copyinto(arg0, 32, this->iobuf); tracemem(this->iobuf, 32); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>this->iobuf</code></th> <td><b>節固有変数</b>(clause local variable)(※1)として、 <code>iobuf</code> を参照 </td> </tr> <tr> <th><code>alloca(size)</code></th> <td>指定サイズのバッファをカーネル空間に確保 </td> </tr> </table> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">メモリ内容の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>checksum()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_mem.d" ><code>watch_args_mem.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:checksum:entry { this->iobuf = alloca(32); <span class="hilite">copyinto(arg0, 32, this->iobuf)</span>; tracemem(this->iobuf, 32); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>this->iobuf</code></th> <td><b>節固有変数</b>(clause local variable)(※1)として、 <code>iobuf</code> を参照 </td> </tr> <tr> <th><code>alloca(size)</code></th> <td>指定サイズのバッファをカーネル空間に確保 </td> </tr> <tr> <th><code>copyinto(from, size, to)</code></th> <td>ユーザ空間のアドレス <code>from</code> から、 <code>size</code> バイト分だけ、 カーネル空間のアドレス <code>to</code> にコピー </td> </tr> </table> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">メモリ内容の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>checksum()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_mem.d" ><code>watch_args_mem.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:checksum:entry { this->iobuf = alloca(32); copyinto(arg0, 32, this->iobuf); <span class="hilite">tracemem(this->iobuf, 32)</span>; } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>this->iobuf</code></th> <td><b>節固有変数</b>(clause local variable)(※1)として、 <code>iobuf</code> を参照 </td> </tr> <tr> <th><code>alloca(size)</code></th> <td>指定サイズのバッファをカーネル空間に確保 </td> </tr> <tr> <th><code>copyinto(from, size, to)</code></th> <td>ユーザ空間のアドレス <code>from</code> から、 <code>size</code> バイト分だけ、 カーネル空間のアドレス <code>to</code> にコピー </td> </tr> <tr> <th><code>tracemem(addr, size)</code></th> <td>カーネル空間のアドレス <code>addr</code> から <code>size</code> バイトの領域の内容を表示。<br/> <code>size</code> は固定値のみ指定可能(※2) </td> </tr> </table> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">メモリ内容の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 <code>checksum()</code> 関数呼び出しにおける引数は、 以下の D スクリプト <a href="./src/intro/watch_args_mem.d" ><code>watch_args_mem.d</code></a> で採取することができます。</p> <pre> pid$target:show_args:checksum:entry { this->iobuf = alloca(32); copyinto(arg0, 32, this->iobuf); tracemem(this->iobuf, 32); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>this->iobuf</code></th> <td><b>節固有変数</b>(clause local variable)(※1)として、 <code>iobuf</code> を参照 </td> </tr> <tr> <th><code>alloca(size)</code></th> <td>指定サイズのバッファをカーネル空間に確保 </td> </tr> <tr> <th><code>copyinto(from, size, to)</code></th> <td>ユーザ空間のアドレス <code>from</code> から、 <code>size</code> バイト分だけ、 カーネル空間のアドレス <code>to</code> にコピー </td> </tr> <tr> <th><code>tracemem(addr, size)</code></th> <td>カーネル空間のアドレス <code>addr</code> から <code>size</code> バイトの領域の内容を表示。<br/> <code>size</code> は固定値のみ指定可能(※2) </td> </tr> </table> <p>※1: とりあえずは、C/C++ の局所変数相当と考えてください。</p> <p>※2: 可変長メモリ領域の内容取得に関しては、<a href="./advanced.ja.html" >応用編</a>で説明します。</p> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> <ul> <li><a href="JavaScript:showSlideByName('detail.argval')" >引数値の取得</a> <li><a href="JavaScript:showSlideByName('detail.argstr')" >引数文字列の取得</a> <li><a href="JavaScript:showSlideByName('detail.argmem')" >メモリ内容の取得</a> <li><span class="hilite" >戻り値の取得</span> <li><a href="JavaScript:showSlideByName('detail.ustack')" >呼び出しスタック</a> </ul> </ul> ----@ <a name="detail.retval"></a> <div class="section">より詳細な情報の取得</div> <div class="subsection">戻り値の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 各関数呼び出しにおける戻り値は、 以下の D スクリプト <a href="./src/intro/watch_retval.d" ><code>watch_retval.d</code></a> で採取することができます。</p> <pre> pid$target:show_args::return { printf("%s()=0x%p", probefunc, arg1); } </pre> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">戻り値の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 各関数呼び出しにおける戻り値は、 以下の D スクリプト <a href="./src/intro/watch_retval.d" ><code>watch_retval.d</code></a> で採取することができます。</p> <pre> pid$target:show_args::return { printf("%s()=0x%p", probefunc, <span class="hilite">arg1</span>); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>arg1</code></th> <td><code>pid</code> プロバイダの <code>return</code> プローブ使用時における <code>arg1</code> は関数の戻り値 </td> </tr> </table> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">戻り値の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 各関数呼び出しにおける戻り値は、 以下の D スクリプト <a href="./src/intro/watch_retval.d" ><code>watch_retval.d</code></a> で採取することができます。</p> <pre> pid$target:show_args::return { printf("%s()=0x%p", probefunc, arg1); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>arg1</code></th> <td><code>pid</code> プロバイダの <code>return</code> プローブ使用時における <code>arg1</code> は関数の戻り値 </td> </tr> </table> <p>戻り値無し(void)や、構造体返しの関数の場合、 <code>arg1</code> 値は不定となるので注意が必要です。</p> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">戻り値の取得</div> <p><a href="./src/intro/show_args.c" ><code>show_args.c</code></a> から生成されたコマンド <code>show_args</code> 中の、 各関数呼び出しにおける戻り値は、 以下の D スクリプト <a href="./src/intro/watch_retval.d" ><code>watch_retval.d</code></a> で採取することができます。</p> <pre> pid$target:show_args::return { printf("%s()=0x%p", probefunc, arg1); } </pre> <table style="width: 100%;"> <tr> <th style="width: 30%;" ><code>arg1</code></th> <td><code>pid</code> プロバイダの <code>return</code> プローブ使用時における <code>arg1</code> は関数の戻り値 </td> </tr> </table> <p>戻り値無し(void)や、構造体返しの関数の場合、 <code>arg1</code> 値は不定となるので注意が必要です。</p> <p><code>pid</code> プロバイダの <code>return</code> プローブ使用時における <code>arg0</code> は関数の戻り先アドレスを保持します。</p> ----@ <ul> <li><a href="JavaScript:showSlideByName('preparation')" >開始前準備</a> <li><a href="JavaScript:showSlideByName('flow')" >関数フローのログ</a> <li><a href="JavaScript:showSlideByName('detail')" >より詳細な情報の取得</a> <ul> <li><a href="JavaScript:showSlideByName('detail.argval')" >引数値の取得</a> <li><a href="JavaScript:showSlideByName('detail.argstr')" >引数文字列の取得</a> <li><a href="JavaScript:showSlideByName('detail.argmem')" >メモリ内容の取得</a> <li><a href="JavaScript:showSlideByName('detail.retval')" >戻り値の取得</a> <li><span class="hilite" >呼び出しスタック</span> </ul> </ul> ----@ <a name="detail.ustack"></a> <div class="section">より詳細な情報の取得</div> <div class="subsection">呼び出しスタック</div> <p>必ずしも「完全なフロー」の採取が必要なケースばかりではありません。</p> <p>「どこから呼び出されたか？」という情報のみで十分なケースもあります。</p> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">呼び出しスタック</div> <p><a href="./src/intro/show_flow.c" ><code>show_flow.c</code></a> から生成した <code>show_flow</code> コマンドにおける関数 <code>f1()</code> が、 どのような契機で呼び出されているのかを、 <a href="./src/intro/watch_ustack.d" ><code>watch_ustack.d</code></a> を使用して採取してみましょう。</p> <pre> $ <b >dtrace -s ./watch_ustack.d \ -c ./show_flow \</b> <b>show_flow \</b> <i>※ $1 を置換</i> <b>f1</b> <i>※ $2 を置換</i> </pre> ----@ <div class="section">より詳細な情報の取得</div> <div class="subsection">呼び出しスタック</div> <p>D スクリプト <a href="./src/intro/watch_ustack.d" ><code>watch_ustack.d</code></a> では、 <code>ustack()</code> アクションを使用して、 特定の関数が呼び出された際の呼び出しスタックを表示します。</p> <pre> pid$target:$1:$2:entry { <span class="hilite">ustack()</span>; } </pre> ----@ <div class="title" >ユーザプログラムでの DTrace<br> 〜 導入編</div> <div class="author"> 藤原 克則 <foozy@lares.dti.ne.jp> </div> <div class="center" style="font-size: 200%;">〜 END 〜</div>