gdb(1) FreeBSD 一般コマンドマニュアル

gdb

前のページ 上に戻る 次のページ

gdb



書式

       gdb    [-help] [-nx] [-q] [-batch] [-cd=dir] [-f] [-k]
              [-wcore] [-b bps] [-tty=dev] [-s symfile] [-e prog]
              [-se prog] [-c core] [-x cmds] [-d dir]
              [prog[core|procID]]


解説

       GDB をはじめとするデバッガは、プログラムが実行中もしくはク
       ラッシュした時にそのプログラムの ``内部'' で何が行なわれて
       いるか/行われていたかを調べるのに使用されます。

       GDB は、4 つの機能 (加えてこれらをサポートする機能) によっ
       て実行中にバグを見つけることを手助けします。


          o   プ ログラムの動作を詳細に指定してプログラムを実行さ
              せる。


          o   指定した条件でプログラムを停止させる。


          o   プログラムが止まった時に、何が起こったか調べる。


          o   バグによる副作用を修正し、別のバグを調べるためプ ロ
              グラムの状態を変更する。


       GDB では C, C++, Modula-2 などで書かれたプログラムのデバッ
       グが行なえます。 GNU Fortran コンパイラが完成すれ ば  For-
       tran もサポートされます。

       GDB   は シェルコマンドgdbで起動されます。いったん起動する
       と、GDB コマンドquitを実行して終了するまで、端末からコマン
       ドを読み続けます。 gdbのオンラインヘルプは(gdbの中で) help
       コマンドを実行すれば表示されます。

       gdb は引数やオプション無しで起動できますが、たいてい、1 つ
       か  2 つの引数を付けて起動します。実行プログラムを引数にす
       る場合は以下のようになります:

       gdb program


       また実行プログラムと core ファイルの両方を指定することもで
       きます:

       gdb program core


       も し 実行中のプロセスのデバッグを行ないたい場合には、第 2

       run [arglist]
              プログラムの実行を開始します(もしあれば arglistを引
              数として)。

       bt     バックトレース: プログラムのスタックを表示します。

       print expr
               式の値を表示します。

       c      プログラムの実行を再開します。(たとえばブレークポイ
              ントで実行を中断した後で)

       next   次のプログラム行を実行します 。その行内の全ての関数
              は 1 ステップで実行されます。

       step    次のプログラム行を実行します。もしその行に関数が含
              まれていれば、その関数内をステップ実行して い き ま
              す。

       help [name]
              GDB  コマンド nameについての情報や、 GDB を使う上で
              の一般的な情報を表示します。

       quit   GDB を終了します。

       GDB の詳細についてはUsing GDB: A Guide to the GNU  Source-
       Level  Debugger,  by  Richard  M.  Stallman  and Roland H.
       Pesch. を参照して下さい。同じテキストは、 info プログラ ム
       内の gdb エントリからオンラインで参照できます。


オプション

       オプション以外の引数は、実行ファイルと core ファイル (もし
       くはプロセス ID) を表します。つまりオプションフラグでも オ
       プ ションフラグの引数でもない最初の引数は `-se' オプション
       で指定するファイルと同じになり、(もしあれば)次の 2 番目 の
       引数は `-c' オプションで指定するファイルと同じになります。

       オプションの多くは、長い表記法と短い表記法の両方で指定する
       こ と ができますが、ここではその両方を示します。長い表記法
       は、どのオプションであるのかが明確であれば、短く切り詰めて
       も構いません。 (好みにより `-' の代わりに `+' が使用できま
       すが、ここではよく用いられる表記で記します。)

       全てのオプションとコマンドライン引数は指定した順番に処理さ
       れます。 `-x' オプションが使用されると、この順番は変わって
       きます。


       -help

       -h     短い説明つきで、全てのオプションを表示します。


       -se=file
               ファイル file からシンボルテーブルを読み、同時にそ
              れを実行可能ファイルとして利用します。


       -core=file

       -c file
               ファイル file を core dump として利用します。


       -command=file

       -x file
               ファイル fileから GDB のコマンドを読み込み、実行し
              ます。


       -directory=directory

       -d directory
               ソースファイルを探すサーチパスに directory を追 加
              します。



       -nx

       -n      初期化ファイル `.gdbinit' からコマンドを読み込みま
              せん。通常は、全てのコマンドオプションと引数が処 理
              さ れた後で、初期化ファイル内のコマンドが実行されま
              す。


       -quiet

       -q     起動時のメッセージおよび copyright を表示しません。
              これらのメッセージはバッチモードでも抑制されます。


       -batch  バッチモードで動作します。`-x' で指定したファイル(
              および、-nx か -n  で 抑 制 さ れ て い な け れ ば
              `.gdbinit')  内の全てのコマンドを処理した後、戻り値
              として 0 を返して終了します。コマンドファイル 内 の
              GDB コマンドの実行中にエラーが生じた場合は、 0 以外
              の値で終了します。

              バッチモードは GDB をフィルタとして実行する場合、た
              と えばプログラムをダウンロードして別のコンピュータ
              上で実行したりする場合に便利です。以下のメッセージ

       -f     Emacs が GDB をサブプロセスとして実行する際にこのオ
              プションを付加します。このとき GDB は、スタックフレ
              ームが表示される度(プログラムが中断する度を含 み ま
              す)に、完全なファイル名と行番号を標準的な認識しやす
              い形式で表示します。この表示書式は 2 つの ` 32'  文
              字、 ファ イ ル名、コロンで区切られた行番号と文字位
              置、改行の順になっています。これは Emacs→GDB イ ン
              タ フェースプログラムにおいて、フレームに対応するソ
              ースコードを表示するために 2 つの ` 32' 文字を使 う
              ことになっているからです。


       -kernel

       -k     gdb  をカーネルデバッグモードで使用します。プロンプ
              トは ``(kgdb)'' になります。


       -wcore このオプションはカーネルデバッグモードで 「動 作 中
              の」 カ ー ネルをデバッグしている時のみ使用可能であ
              り、コアファイル (/dev/mem) を書き込み可能 に し ま
              す。


       -b bps   リモートデバッグ用に GDB が利用するシリアルインタ
              フェースの転送速度を (ボーレートまたはビット/秒 で)
              セットします。


       -tty=device
               プログラムの標準入出力に device を利用します。




関連項目

       info 内 の  `gdb' エントリ ; Using GDB: A Guide to the GNU
       Source-Level Debugger, Richard M. Stallman and  Roland  H.
       Pesch, July 1991.


COPYING

       Copyright (c) 1991 Free Software Foundation, Inc.

       Permission  is  granted  to  make  and distribute verbatim
       copies of this manual provided the  copyright  notice  and
       this permission notice are preserved on all copies.

       Permission is granted to copy and distribute modified ver-
       sions of this manual under  the  conditions  for  verbatim
       copying,  provided  that the entire resulting derived work
       is distributed under the  terms  of  a  permission  notice
       identical to this one.

ABELNET VPSサービス