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

gdbserver

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

gdbserver



書式

       gdbserver
              tty prog [args...]


解説

       GDBSERVER は、デバッグ対象のプログラムを実行しているマシン
       とは異なるマシン上で GDB を実行することを可能にするプロ グ
       ラムです。

       使用方法 (サーバ(ターゲット)側):

       まず、デバッグ対象のプログラムのコピーをターゲットシステム
       に用意します。 GDBserver は、シンボルを関知しないので、 使
       用スペースを節約するためにプログラムをストリップしても構い
       ません。全てのシンボルは、ホストシステムで実行され る  GDB
       によって考慮されます。

       サ ー バ を 使用するためには、ターゲットシステムにログイン
       し、`gdbserver' プログラムを実行します。(a) GDB との通信方
       法、(b) プログラム名、 (c) プログラムへの引数 を指定する必
       要があります。一般的な書式は以下のようになります:

            target> gdbserver COMM PROGRAM [ARGS ...]

       例えば、シリアルポートを使用する場合は、以下のようになりま
       す。

            target> gdbserver /dev/com1 emacs foo.txt

       こ の例では、emacs を引数 foo.txt を用いてデバッグすること
       を指定し、 GDB との通信に /dev/com1 を使 用 し ま す。gdb-
       server は、ホストの GDB が通信して来ることを辛抱強く待ちま
       す。

       TCP 接続を使用する場合は、以下のようになります。

            target> gdbserver host:2345 emacs foo.txt

       この例では、ホストの GDB との通信に TCP を用いる以外は、前
       の 例と同じです。引数 `host:2345' は、`host' からの TCP 接
       続が ローカルの TCP ポート 2345 に接続されるのを待つ、とい
       う 意味です。(現状では `host' 部は無視されます。) ターゲッ
       トシステムで存在する TCP ポートとの衝突が無ければ、ポー ト
       番 号 は 自由に選ぶことができます。ホストの GDB の `target
       remote' コマンドで、同じポート番号を指定する必要があ り ま
       す。 他 の サ ービスと衝突するポート番号を選んだ場合、gdb-
       server はエラーメッセージを出力して終了します。

       使用方法 (ホスト側):

       GDB がシンボルテーブルを検査したりするため、ホストシステム
       には、ターゲットプログラムのストリップされていないコピーが
            (gdb) target remote the-target:2345

       は、TCP 接続で、ホスト `the-target' の gdbserver を起動 し
       た時に指定したポートと同じポート 2345 を使用してサーバと通
       信します。TCP 接続の場合、 `target remote' コマンドを実 行
       す る前に gdbserver を実行しておく必要があります。そうしな
       いと、`Connection refused' というようなエラーになるで しょ
       う。


オプション

       デバッグの対象となるプログラムの名前と、通信に使用する tty
       を指定する必要があります。他の全てのことはリモート の  GDB
       が 行 います。その他の引数は、そのままプログラムに渡されま
       す。


関連項目

       `gdb' entry in info; Using GDB: A Guide to the GNU Source-
       Level  Debugger,  Richard M. Stallman and Roland H. Pesch,
       July 1991.


COPYING

       Copyright (c) 1993 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.

       Permission is granted to copy and distribute  translations
       of this manual into another language, under the above con-
       ditions for modified versions, except that this permission
       notice  may  be  included  in translations approved by the
       Free  Software  Foundation  instead  of  in  the  original
       English.




Cygnus Support           2 November 1993             gdbserver(1)

ABELNET VPSサービス