mdb [ -fkmuwyAFMS ] [ +o option ] [ -p pid ] [ -s distance] [ -I path ] [ -L path ] [ -P prompt ] [ -R root ] [ -V dis-version ] [ object [ core ] | core | suffix ] |
次のオプションがサポートされています。
mdb モジュールの自動読み込みを無効にします。デフォルトでは、mdb は、ユーザープロセスまたはコアファイルのアクティブな共用ライブラリに対応しているデバッガモジュール、または稼働中のオペレーティングシステムかオペレーティングシステムのクラッシュダンプにある読み込み済みのカーネルモジュールに対応しているデバッガモジュールを読み込もうとします。
必要に応じて、指定されたユーザープロセスに強制的に接続します。デフォルトでは、mdb は、すでに truss(1) など別のデバッグ用ツールの制御下にあるユーザープロセスへの接続を拒否します。-F オプションを指定すると、mdb はこれらのプロセスに接続します。これによって、mdb とプロセスを制御しようとしているほかのツールとの間で予期しない相互作用が発生する可能性があります。
強制的に raw ファイルデバッギングモードに入ります。デフォルトでは、mdb は、オブジェクトとコアファイルのオペランドがユーザーの実行可能ファイルとコアダンプを参照しているのか、または 1 組のオペレーティングシステムのクラッシュダンプファイルを参照しているのかを判断しようとします。ファイルのタイプを推測できない場合、デバッガはデフォルトでそのファイルをプレーンなバイナリデータとして調査します。-f オプションを使用すると、mdb は引数を調査すべき raw ファイルセットとして解釈します。
マクロファイルを検出するためのデフォルトのパスを設定します。マクロファイルは、 $< または $<< dcmd を使用して読み取ります。このときのパスは、一連のディレクトリ名をコロン (:) 文字で区切ったものです。-I include パスと -L library パス (以降を参照) には、次のトークンを含めることができます。
現在の命令セットアーキテクチャー (ISA) の名前に展開されます。sparc、sparcv9、i386、または amd64 です。
変更対象のパスの古い値まで展開されます。これは、既存のパスの前または後ろにディレクトリを追加するときに有用です。
現在のプラットフォーム文字列 (uname -i またはプロセスのコアファイルあるいはクラッシュダンプに格納されているプラットフォーム文字列) に展開されます。
ルートディレクトリのパス名まで展開されます。-R オプションを使用すると、代替ルートディレクトリを指定できます。-R オプションを指定しないと、ルートディレクトリは mdb 実行可能ファイル自体へのパスから動的に決定されます。たとえば、/bin/mdb を実行した場合、ルートディレクトリは / です。/net/hostname/bin/mdb 実行した場合、ルートディレクトリは /net/hostname となります。
現在のターゲット名まで展開されます。これはリテラル文字列「proc」(ユーザープロセスまたはユーザープロセスのコアファイル)、あるいは「kvm」(カーネルクラッシュダンプまたは稼働中のオペレーティングシステム) のどちらかです。
32 ビットの mdb に対するデフォルトのインクルードパスは、次のとおりです。%r/usr/platform/%p/lib/adb:%r/usr/lib/adb
64 ビットの mdb に対するデフォルトのインクルードパスは、次のとおりです。%r/usr/platform/%p/lib/adb/%i:%r/usr/lib/adb/%i
強制的にカーネルデバッギングモードにします。デフォルトでは、mdb は、オブジェクトとコアファイルのオペランドがユーザーの実行可能ファイルとコアダンプを参照しているのか、または 1 組のオペレーティングシステムのクラッシュダンプファイルを参照しているのかを判断しようとします。-k オプションを指定すると、mdb は、これらのファイルがオペレーティングシステムのクラッシュダンプファイルであるとみなします。オブジェクトまたはコアオペランドを指定せずに -k オプションを指定すると、mdb は、オブジェクトファイルを /dev/ksyms に、コアファイルを /dev/kmem にデフォルト設定します。/dev/kmem にアクセスできるのはグループ sys だけです。
kmdb を読み込み、実行中のオペレーティングシステムカーネルを停止して、kmdb デバッガプロンプトを表示します。このオプションは、システムコンソールでしか使用してはなりません。それに続く kmdb プロンプトがシステムコンソールに表示されます。
デバッガモジュールを検索するためのデフォルトのパスを設定します。モジュールは起動時に自動的に読み込まれるか、または ::load dcmd を使用して読み込まれます。このときのパスは一連のディレクトリ名をコロン (:) 文字で区切ったものです。-L ライブラリパスには、上記の -I オプションで示したトークンも含めることができます。
カーネルモジュールシンボルのデマンドローディングを無効にします。デフォルトでは、mdb は読み込まれたカーネルモジュールのリストを処理し、モジュールごとにシンボルテーブルのデマンドローディングを実行します。-m オプションを指定すると、mdb はカーネルモジュールのリストを処理したり、モジュールごとにシンボルテーブルを提供したりしなくなります。したがって、アクティブなカーネルモジュールに対応する mdb モジュールは起動時に読み込まれません。
すべてのカーネルモジュールシンボルを事前に読み込みます。デフォルトでは、mdb はカーネルモジュールシンボルのデマンドローディングを実行します。アドレスがそのモジュールのテキストであるとき、またはデータセクションが参照されているとき、モジュールのシンボルテーブルが完全に読み取られます。-M オプションを指定すると、mdb は起動時にすべてのカーネルモジュールのシンボルテーブルを完全に読み込みます。
指定したデバッガオプションを有効にします。+o 形式のオプションを使用した場合は、指定したオプションが無効になります。次に掲載しているものを除いて、各オプションともデフォルトでは無効になっています。mdb は次のオプション引数を認識します。
より厳密な adb(1) との互換性を有効にする。プロンプトは空の文字列に設定され、出力ページャーなどの多数の mdb 機能が無効になる
::print が表示する配列のメンバー数に対してデフォルトの制限を設定する。limit が特別なトークン none である場合、デフォルトで配列のすべてのメンバーが表示される
::print が char 型の配列を出力するときに ASCII 文字列として表示する文字数に対してデフォルトの制限を設定する。limit が特別なトークン none である場合、デフォルトで char 配列全体が string として表示される
exec(2) システムコールに従って動作するようにデバッガを設定する。mode は次の名前付き定数の 1 つである必要がある
ask |
stdout が端末デバイスである場合、デバッガは exec(2) システムコールが返ったあとに停止して、exec または stop のどちらに従うかをユーザーに尋ねる。stdout が端末デバイスではない場合、ask モードはデフォルトで stop になる |
follow |
デバッガは自動的にターゲットプロセスを継続し、新しい実行可能ファイルに基づいて、ターゲットプロセスのマッピングとシンボルテーブルをすべてリセットし、exec に従うfollow の動作の詳細については、「exec との対話」を参照 |
stop |
exec システムコールから戻ったあと、デバッガは exec システムコールに従うことを停止する。stop の動作の詳細については、「exec との対話」を参照 |
fork(2)、fork1(2)、または vfork(2) システムコールの動作に従って動作するようにデバッガを設定する。mode は次の名前付き定数の 1 つである必要がある
ask |
stdout が端末デバイスである場合、デバッガは fork システムコールが返ったあとに停止して、親プロセスまたは子プロセスのどちらに従うかをユーザーに尋ねる。stdout が端末デバイスではない場合、ask モードはデフォルトで親プロセスになる |
parent |
デバッガは親プロセスに従って、子プロセスを切り離し、「動作中 (running)」に設定する |
child |
デバッガは子プロセスに従って、親プロセスを切り離し、「動作中 (running)」に設定する |
端末に EOF
シーケンス (^D) が入力されても、デバッガは終了しない。終了するには ::quit dcmd を使用する必要がある
-p オプションを指定したか、::attach または :A dcmd を適用した場合、ユーザープロセスと接続しているときには、そのユーザープロセスを停止しない。nostop の動作の詳細については、「プロセスの接続と解放」を参照
出力ページャーが有効になる (デフォルト設定)
復帰改行文字がコマンドとして端末に入力された場合、mdb は前のコマンドを現在のドットの値で繰り返す。-o adb を指定した場合、このオプションも自動的に指定されている
MDB は LM_ID_BASE と LM_ID_LDSO 以外のリンクマップを使用するユーザーアプリケーションでシンボルの命名と識別をサポートする (「シンボルの名前解決」を参照)。LM_ID_BASE または LM_ID_LDSO 以外のリンクマップ上のシンボルは LMlmid`library`symbol のように表示される (このとき、lmid はデフォルトの出力基数 (16 進数) のリンクマップ ID)。showlmid オプションを有効にすると、すべてのシンボルとオブジェクト (LM_ID_BASE と LM_ID_LDSO に関連するものも含む) のリンクマップ ID 有効範囲を表示するように MDB を構成できる。オブジェクトファイル名を扱う組み込み dcmd (::nm、::mappings、$m、::objects など) は、上記 showlmid の値に従ってリンクマップ ID を表示する
指定されたプロセス ID に接続し、そのプロセスを停止します。mdb は、/proc/pid/object/a.out ファイルを実行可能ファイルのパス名として使用します。
コマンドプロンプトを設定します。デフォルトのプロンプトは、「>」です。
パス名を拡張するためのルートディレクトリを設定します。デフォルトでは、ルートディレクトリは mdb 実行可能ファイル自体のパス名から導かれます。ルートディレクトリは、パス名の展開の際に %r トークンと置き換えられます。
アドレスからシンボル名への変換用のシンボルマッチングディスタンスを、指定した distance に設定します。デフォルトでは、mdb はこの距離をゼロに設定し、スマートマッチングモードを有効にします。ELF シンボルテーブルのエントリには値 V とサイズ S が含まれ、関数またはデータオブジェクトのサイズがバイト単位で示されます。スマートモードでは、mdb は、A が [ V, V + S ) の範囲にある場合、アドレス A と与えられたシンボルとを一致させます。ゼロ以外の距離を指定した場合も同じアルゴリズムが使用されますが、式に S を指定した場合、常に絶対距離が指定され、シンボルのサイズは無視されます。
ユーザーの ~/.mdbrc ファイルの処理を抑制します。デフォルトでは、mdb は、$HOME で定義されているユーザーのホームディレクトリにマクロファイル .mdbrc があれば、それを読み取って処理します。-S オプションを指定すると、このファイルは読み取られません。
強制的にユーザーデバッギングモードにします。デフォルトでは、mdb は、オブジェクトとコアファイルのオペランドがユーザーの実行可能ファイルとコアダンプを参照しているのか、または 1 組のオペレーティングシステムのクラッシュダンプファイルを参照しているのかを判断しようとします。-u オプションを使用すると、mdb は、これらのファイルがオペレーティングシステムのクラッシュダンプファイルではないとみなします。
kmdb が読み込まれた場合は、それを読み込み解除します。kmdb が使用中でない場合は、それを読み込み解除し、カーネルデバッガで使用されたメモリーを解放してオペレーティングシステムが利用できるようにします。
逆アセンブラのバージョンを設定します。デフォルトでは、mdb は、デバッグターゲットに対する適切な逆アセンブラのバージョンを判断しようとします。-V オプションを使用すると、逆アセンブラを明示的に設定できます。::disasms dcmd によって、使用可能な逆アセンブラのバージョンが一覧表示されます。
指定したオブジェクトとコアファイルを書き込み用に開きます。
tty モードに対する明示的な端末初期化シーケンスを送信します。端末には、tty モードに切り換えるために明示的な初期化シーケンスを必要とするものがあります。この初期化シーケンスがないと、mdb からスタンドアウトモードなどの端末機能を使用できない場合があります。