memdb(1)

名前
memdb - メモリーデバッガ。実行可能ファイルに対して Sun Workshop Memory Monitor を実行します。

形式
memdb [ -d ] [ -g ] [ -b ] [ -v ] [ -w web-browser ] [ -p port ] [ -m monfilepath ] command

機能説明
メモリーデバッガ memdb は、gc デバッグライブラリ (libgc_dbg.so) に明示的にリンクしなくても、 実行可能プログラムに対して Sun WorkShop Memory Monitor を実行します。 指定したコマンド (command) を実行するほかに、 memdb は gcmonitor(1) と Web ブラウザを実行します。 Web ブラウザは自動的に実行中の gcmonitor に接続されます。 デフォルトでは、Web ブラウザは Netscape に設定されています。 gcmonitor と web-browser のパスは PATH に設定されていなければなりません。 Sun WorkShop Memory Monitor は、 command がフォークした子プロセスに対しても実行されます。 ブラウザが画面に表示されたら、 「プログラム選択」 タブをクリックして、 解析するプログラムを選択します。 プロセスを選択すると、 ほかのタブをクリックできるようになります。 「ヘルプ」 タブをクリックすると、 Sun WorkShop Memory Monitor の機能についての詳細な説明が表示されます。 プログラムと gcmonitor との間で通信するために、 このメモリーデバッガは各プロセスについてモニターファイル (gcXXXX.mon) を作成します。 デフォルトの場合、これらのファイルは、ディレクトリ ~/.gcmonfiles に作成されます。 command によって作成されたプロセスに対応するすべてのモニターファイルは、1 つの サブディレクトリに保存されます。 command と web-browser が終了すると、 このサブディレクトリとモニターファイルは削除されます。 プログラムと gcmonitor との通信は共用メモリーを使用して行われるため、 モニターファイルはローカルディスクに保存することをお勧めします。 ネットワーク上のファイルを使用すると、 システムによるプログラムの起動時間が 10 倍も遅くなる場合があります。 ~/.gcmonfiles ディレクトリがローカルディスク上にない場合は、 -m オプションを使用してください。

オプション

-d  コマンドおよび web-browser の終了後、 モニターファイルを削除しないように メモリーデバッガに指示します。

-g  gcmonitor および web-browser を自動的に実行しないように メモリーデバッガに指示します。

-b  web-browser を自動的に実行しないように メモリーデバッガに指示します。

-v  メモリーデバッガを冗長モードで実行します。

-w web-browser
    Web ブラウザとして web-browser を使用するように設定します。 web-browser には、最初の URL を 1 つ目の引数として扱える Web ブラウザを 指定する必要があります。 デフォルトでは、 web-browser は "netscape" です。

-p  port
    gcmonitor のポートを設定します。 デフォルトでは、 未使用のポートが無作為に選択されます。

-m monfilepath
    gc モニターファイルを保存するディレクトリ monfilepath を設定します。 プログラムと gcmonitor との通信のオーバーヘッドを減らすために、 このディレクトリはローカルディスクに作成することを お勧めします。

障害時の対処方法

  問題
プログラムが次のエラーを表示します。

!!! **** Could not reopen gcmonitor file.

  対策
プログラムによって作成された子プロセスがまだ実行されているときに、 web-browser を終了した可能性があります。 子プロセスの実行が確実に終了するまで、 web-browser を終了しないでください。 あるいは、 -d オプションを使用して モニターファイルが削除されないようにして、 作業が終了した後、手動でモニターファイルを削除してください。

  問題
web-browser が gcmonitor に接続できません。

  対策
gcmonitor(1) の「障害時の対処方法」の項を参照してください。

関連項目
gcmonitor(1)

『WorkShop Memory Monitor ユーザーズガイド』