名称

addr2line -アドレスをファイル名と行番号に変換する

書式

addr2line [ -b bfdname| --target= bfdname]
[ -C| --demangle[= style]]
[ -e filename| --exe= filename]
[ -f| --functions] [ -s| --basename]
[ -i| --inlines]
[ -j| --section= name]
[ -H| --help] [ -V| --version]
[addr addr ...]

解説

addr2line は、アドレスをファイル名と行番号に変換します。リロケータブルオブジェクトのセクションの実行形式のアドレスまたはオフセットを与えて、ファイル名と行番号が、それに関連しているかを解読するためにデバッグ情報を使用します。

使用する実行形式またはリロケータブルオブジェクトは、 -e オプションで指定されます。デフォルトは、ファイル a.out です。使用するリロケータブルオブジェクトのセクションは、 -j オプションで指定されます。

addr2line には、2 つの動作モードがあります。

最初に、16 進アドレスが、コマンド行で指定され、 addr2line は、各アドレスに対してファイル名と行番号を表示します。

2 番目に、 addr2line は、標準入力から 16 進アドレスを読み込み、各アドレスに対してファイル名と行番号を標準出力に印刷 (表示) します。このモードで、 addr2line は、動的に選択されれたアドレスを変換するためにパイプで使用されます。

出力の形式は、 FILENAME:LINENO です。各アドレスに対するファイル名と行番号は、別々の行に印刷されます。 -f オプションが使用されるなら、各 FILENAME:LINENO 行は、アドレスを含む関数の名前である FUNCTIONNAME 行に先行します。

ファイル名または関数名が決定できないなら、 addr2line は、それらの場所の 2 つの疑問符を印刷します。行番号が決定できないなら、 addr2line は、0 を印刷します。

オプション

代替の方法としてここに示されたオプションの長い形式と短い形式は、同等です。

-b bfdname

--target= bfdname

オブジェクトファイルのオブジェクトコードの形式が、 bfdname であると指定します。

-C

--demangle[= style ]

低レベルのシンボル名をユーザレベルの名前にデコード ( demangle) します。さらに、システムによって先頭に追加された下線を取り除くことによって、 C++ の関数名を読みやすくします。別のコンパイラには、別の台無し (mangle) にするスタイルがあります。利用者のコンパイラのための適切な demangle スタイルを選択するために、オプションの demangle スタイル引数を使用することができます。

-e filename

--exe= filename

アドレスが変換されるべきである実行形式の名前を指定します。デフォルトのファイルは、 a.out です。

-f

--functions

ファイルと行番号情報と同様に関数名を表示します。

-s

--basenames

各ファイル名のベース (パス名を除いたファイル名) のみを表示します。

-i

--inlines

アドレスがインライン化された関数に属しているなら、最初のインラインでない関数に戻るすべて囲まれたスコープのためのソース情報も印刷されます。例えば、"main"が "callee2"をインラインとする "callee1"をインラインとし、アドレスが "callee2"からであるなら、 "callee1"と "main"のためのソース情報も印刷されます。

-j

--section

絶対アドレスの代わりに指定されたセクションに相対的なオフセットを読み込みます。

@ file

file からコマンドラインのオプションを読み込みます。読み込まれたオプションは、オリジナルの @ file オプションの場所に代わって挿入されます。 file が存在しないか、または読み込むことができないなら、オプションは、文字通りに扱われ、取り除かれません。

 

file 中のオプションは、空白類によって分離されます。空白類の文字は、シングルクォートまたはダブルクォートのいずれかで全体のオプションを囲むことによって、オプションに含めることができます。 (バックスラッシュを含む) 任意の文字は、バックスラッシュを文字を前に置くことによって、含めることができます。 file は、それ自体に、追加の @ file オプションを含むことができます。そのようなオプションは、再帰的に処理されます。

関連項目

binutils の Info エントリ。

COPYRIGHT

Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".