cb5d1a9147
jpman project specific RCS keyword (jpman %Id) is obsolete, after manual entries are stored in freefall CVS repository. This old Id is useless and more worse it confuses users and bug reporters. So, this old Id is removed. Submitted by:jpman project <man-jp@jp.FreeBSD.org>
128 lines
2.7 KiB
Groff
128 lines
2.7 KiB
Groff
.\" Copyright (c) 1997 Free Software Foundation
|
|
.\" See COPYING for conditions for redistribution
|
|
.\" $FreeBSD$
|
|
.TH addr2line 1 "27 March 1997" "Cygnus Solutions" "GNU Development Tools"
|
|
.de BP
|
|
.sp
|
|
.ti \-.2i
|
|
\(**
|
|
..
|
|
|
|
.SH 名称
|
|
addr2line \- アドレスをファイル名と行番号に変換する
|
|
|
|
.SH 書式
|
|
.hy 0
|
|
.na
|
|
.TP
|
|
.B addr2line
|
|
.RB "[\|" "\-b\ "\c
|
|
.I bfdname\c
|
|
.RB " | " "\-\-target="\c
|
|
.I bfdname\c
|
|
\&\|]
|
|
.RB "[\|" \-C | \-\-demangle "\|]"
|
|
.RB "[\|" "\-e\ "\c
|
|
.I filename\c
|
|
.RB " | " "\-\-exe="\c
|
|
.I filename\c
|
|
\&\|]
|
|
.RB "[\|" \-f | \-\-functions "\|]"
|
|
.RB "[\|" \-s | \-\-basenames "\|]"
|
|
.RB "[\|" \-H | \-\-help "\|]"
|
|
.RB "[\|" \-V | \-\-version "\|]"
|
|
.RB "[\|" addr addr ... "\|]"
|
|
.ad b
|
|
.hy 1
|
|
.SH 解説
|
|
\c
|
|
.B addr2line
|
|
はプログラムのアドレスをファイル名と行番号に変換します。
|
|
アドレスと実行ファイルが与えられると、実行ファイル中のデバッグ情報を
|
|
使って与えられたアドレスをファイル名と行番号に対応づけます。
|
|
|
|
使用される実行ファイルは
|
|
.B \-e
|
|
オプションで指定します。デフォルトは
|
|
.B a.out\c
|
|
\& です。
|
|
|
|
.B addr2line
|
|
には 2 つの動作モードがあります。
|
|
|
|
1 つ目では、16進数のアドレスをコマンドラインで指定して、
|
|
.B addr2line
|
|
が各アドレスに対応するファイル名と行番号を表示します。
|
|
|
|
2 つ目では、
|
|
.B addr2line
|
|
は 16進数のアドレスを標準入力から読み込んで、各アドレスに
|
|
対応するファイル名と行番号を標準出力に表示します。
|
|
このモードでは
|
|
.B addr2line
|
|
をパイプ中で、動的に選び出されたアドレスを変換するために利用できます。
|
|
|
|
出力の形式は「ファイル名:行番号」です。ファイル名と行番号は
|
|
各アドレス毎に改行して出力されます。
|
|
.B \-f
|
|
オプションが指定されると、「ファイル名:行番号」の行の前に
|
|
アドレスを含む関数の名前を「関数名」の行として出力します。
|
|
|
|
ファイル名または関数名が特定できない場合は、
|
|
.B addr2line
|
|
はそれらが表示されるべき場所に 2 つのクエスチョンマークを表示します。
|
|
行番号が特定できない場合は
|
|
.B addr2line
|
|
は 0 を表示します。
|
|
|
|
.SH オプション
|
|
.TP
|
|
.BI "\-b " "bfdname"\c
|
|
.TP
|
|
.BI "\-\-target=" "bfdname"
|
|
オブジェクトファイルのオブジェクト・コード形式を
|
|
\c
|
|
.I bfdname\c
|
|
\& で指定します。
|
|
|
|
.TP
|
|
.B \-C
|
|
.TP
|
|
.B \-\-demangle
|
|
シンボル名の内部表現をユーザレベルの表現にデコード (\fIdemangle\fP) します。
|
|
加えてシステムが付加した先頭のアンダースコアも取り除くので、
|
|
これによって C++ の関数名がわかりやすくなります。
|
|
|
|
.TP
|
|
.BI "\-e " "filename"\c
|
|
.TP
|
|
.BI "\-\-exe=" "filename"
|
|
アドレスを変換する対象の実行ファイル名を指定します。
|
|
デフォルトのファイル名は
|
|
.B a.out\c
|
|
\& です。
|
|
|
|
.TP
|
|
.B \-f
|
|
.TP
|
|
.B \-\-functions
|
|
ファイルと行番号情報に加えて関数名を表示します。
|
|
|
|
.TP
|
|
.B \-s
|
|
.TP
|
|
.B \-\-basenames
|
|
各ファイル名のベース (パス名を除いたファイル名部分) のみを表示します。
|
|
|
|
.SH "関連項目"
|
|
.B
|
|
info\c
|
|
\& の
|
|
.RB "`\|" binutils "\|'"
|
|
の項;
|
|
.I
|
|
The GNU Binary Utilities\c
|
|
\&, Roland H. Pesch (October 1991)
|
|
|
|
.SH 日本語訳
|
|
野首 寛高(hnokubi@yyy.or.jp): FreeBSD 用に翻訳
|