デバッグするアプリケーションまたはライブラリーに割り当てられた GDB を起動します。GDB は不足しているデバッグ情報を自動的に認識し、実行するコマンドを提案します。

$ gdb -q /bin/ls
Reading symbols from /usr/bin/ls...Reading symbols from /usr/bin/ls...(no debugging symbols found)...done.
(no debugging symbols found)...done.
Missing separate debuginfos, use: debuginfo-install coreutils-8.22-21.el7.x86_64
(gdb)

これ以上先に進まずに GDB を終了します。 q を入力して、Enter を押します。

(gdb) q

GDB が提案するコマンドを実行して、必要な debuginfo パッケージをインストールします。

# debuginfo-install coreutils-8.22-21.el7.x86_64

アプリケーションまたはライブラリーの debuginfo パッケージをインストールすると、すべての依存関係の debuginfo パッケージもインストールされます。

アプリケーションまたはライブラリーの実行可能ファイルを検索します。

ファイルパスを使用して、対象のファイルを提供するパッケージを検索します。

# yum provides /usr/lib64/libz.so.1.2.7
Loaded plugins: product-id, search-disabled-repos, subscription-manager
zlib-1.2.7-17.el7.x86_64 : The compression and decompression library
Repo        : @anaconda/7.4
Matched from:
Filename    : /usr/lib64/libz.so.1.2.7

この出力では、 name-version.distribution.platform 形式でパッケージの一覧が表示されます。yum の出力で表示されるバージョンは実際にインストールされているバージョンでない場合があるので、この手順では、パッケージの name のみが重要です。

rpm の低レベルのパッケージ管理ツールを使用して、どのパッケージバージョンがシステムにインストールされているかを確認します。パッケージ名を引数として使用します。

$ rpm -q zlib
zlib-1.2.7-17.el7.x86_64

この出力では、インストールされているパッケージの詳細が name-version.distribution.platform 形式で表示されます。

debuginfo-install ユーティリティーを使用して debuginfo パッケージをインストールします。このコマンドで、直前の手順で確認したパッケージ名およびその他の詳細情報を使用します。

# debuginfo-install zlib-1.2.7-17.el7.x86_64

アプリケーションまたはライブラリーの debuginfo パッケージをインストールすると、すべての依存関係の debuginfo パッケージもインストールされます。

ps コマンドで、プロセス id (pid) を検索します。

$ ps -C program -o pid h
 pid

program は、ファイル名またはプログラムへのパスに置き換えます。

このプロセスに GDB を割り当てます。

$ gdb -p pid

pid は、ps の出力にある実際のプロセス ID 番号に置き換えます。

GDB コマンド shell を使用して ps コマンドを実行し、プログラムのプロセス ID (pid) を検索します。

(gdb) shell ps -C program -o pid h
 pid

program は、ファイル名またはプログラムへのパスに置き換えます。

attach コマンドを使用して、GDB をプログラムに割り当てます。

(gdb) attach pid

pid は、ps の出力にある実際のプロセス ID の番号に置き換えます。

監視するプログラムが実行していない場合は、strace を起動して、プログラム を指定します。

$ strace -fvttTyy -s 256 -e trace=call program

call を、表示するシステム呼び出しに置き換えます。-e trace=call オプションは複数回使用できます。何も指定しない場合には、strace はすべてのシステム呼び出しタイプを表示します。詳しい情報は、strace(1) の man ページを参照してください。

プログラムがすでに実行中の場合は、プロセス id (pid) を検索して、その id に strace を割り当てます。

$ ps -C program
(...)
$ strace -fvttTyy -s 256 -e trace=call -ppid

フォークしたプロセスまたはスレッドを追跡しない場合には、-f オプションは指定しないでください。

strace は、アプリケーションで作成したシステム呼び出しとその詳細を表示します。

ほとんどの場合、システム呼び出しのフィルターが設定されていないと、アプリケーションとそのライブラリーは多数の呼び出しを行い、strace 出力がすぐに表示されます。

strace は、プログラムが終了すると終了します。

追跡しているプログラムの終了前に監視を中断するには、ctrl+C を押します。

アプリケーションが実行したシステム呼び出しの一覧を分析します。

監視するプログラムが実行されていない場合には、ltrace を起動して、プログラム を指定します。

$ ltrace -f -l library -e function program

-e と -l のオプションを使用して出力をフィルタリングします。

詳細情報は、man ページの ltrace(1) を参照してください。

プログラムがすでに実行中の場合は、プロセス id (pid) を検索して、その id に ltrace を割り当てます。

$ ps -C program
(...)
$ ltrace ... -ppid

フォークしたプロセスまたはスレッドを追跡しない場合には、-f オプションは指定しないでください。

ltrace はアプリケーションのライブラリー呼び出しを表示します。

多くの場合、アプリケーションは大量の呼び出しを作成し、フィルターが設定されていない場合には、ltrace の出力がすぐに表示されます。

ltrace は、プログラムが終了すると終了します。

追跡しているプログラムの終了前に監視を中断するには、ctrl+C を押します。

アプリケーションが実行したライブラリー呼び出しの一覧を分析します。

以下の内容で my_script.stp ファイルを作成します。

probe begin
{
  printf("waiting for syscalls of process %d \n", target())
}

probe syscall.*
{
  if (pid() == target())
    printf("%s(%s)\n", name, argstr)
}

probe process.end
{
  if (pid() == target())
    exit()
}

監視するプロセスのプロセス ID (pid) を検索します。

$ ps -aux

スクリプトで SystemTap を実行します。

# stap my_script.stp -x pid

pid の値は、プロセス ID です。

スクリプトはカーネルモジュールにコンパイルされ、それが読み込まれます。これにより、コマンドの入力から出力の取得までにわずかな遅延が生じます。

キャッチポイントを設定します。

(gdb) catch syscall syscall-name

catch syscall コマンドは、プログラムがシステム呼び出しが行われた時に実行を停止する特別なタイプのブレークポイントを設定します。

syscall-name オプションは、呼び出しの名前を指定します。様々なシステム呼び出しに対して複数のキャッチポイントを指定することができます。syscall-name オプションに何も指定しない場合には、システム呼び出しがあると GDB が停止してしまいます。

プログラムが実行を開始していない場合は、これを開始します。

(gdb) r

プログラムの実行が一時停止しているだけの場合は、これを再開します。

(gdb) c

キャッチポイントを設定します。

(gdb) catch signal signal-type

catch signal コマンドは、プログラムがシステム呼び出しを受信する際に実行を停止する特殊なタイプのブレークポイントを設定します。signal-type オプションは、シグナルのタイプを指定します。すべてのシグナルを取得するには、特別な値 'all' を使用します。

プログラムが実行を開始していない場合は、これを開始します。

(gdb) r

プログラムの実行が一時停止しているだけの場合は、これを再開します。

(gdb) c