DSAS開発者の部屋

DWARF とは

DWARF とは今回利用するデバッグ情報を保持するためのフォーマットであり、 通常デバッグ情報は ELF ファイルの .debug_info セクションに この DWARF 形式で納められています。

gcc の -g オプションを付けてコンパイルしたオブジェクトファイルに対し readelf -S を実行すると .debug_info セクションが含まれていることが確認 できます。

DWARF の構造

DWARF 形式のデータは Die(Debugging Information Entry) というデータ構造 の集合から構成され、それぞれの Die は tag という識別子で種類を見分ける ことが出来ます。代表的な tag は以下のような物があります。

DWARF 情報全体の構造は上記のような tag で分別できる Die をノードから成る 木構造で表現できます。

.
|-- DW_TAG_compile_unit
|   |-- DW_TAG_base_type
|   |-- DW_TAG_pointer_type
|   |   ...
|
|-- DW_TAG_compile_unit
|   |-- DW_TAG_base_type
|   |   ...
|   |-- DW_TAG_pointer_type
|   |-- DW_TAG_subprogram
|   |   |-- DW_TAG_formal_parameter
|   |   |-- DW_TAG_formal_parameter
|   |   `-- DW_TAG_formal_parameter
|   |-- DW_TAG_variable
|   |   ...
|
`-- DW_TAG_compile_unit
    |-- DW_TAG_base_type
    |   ...

たとえば以下のような、関数を定義した場合

void func(int a, short b, char c)
{
}
int main()
{
    int i=0;
    func(1, 2, 3);
}

以下のような構造の DWARF情報が構成されます。

.
`-- DW_TAG_compile_unit
    |-- [1]DW_TAG_base_type(型の名前: int、サイズ: 4byte)
    |-- [2]DW_TAG_base_type(型の名前: short、サイズ: 2byte)
    |-- [3]DW_TAG_base_type(型の名前: char、サイズ: 1byte)
    |-- DW_TAG_subprogram(関数名: func)
    |   |-- DW_TAG_formal_parameter(引数名: a, 型は [1])
    |   |-- DW_TAG_formal_parameter(引数名: b, 型は [2])
    |   `-- DW_TAG_formal_parameter(引数名: c, 型は [3])
    |-- DW_TAG_variable(変数名: i, 型は[1])
    |   ...

DWARF 情報を取得する

DWARF 情報の構造について説明したところで、実際に取得する方法を簡単に紹 介します。今回、DWARF 情報を取得するために libdwarf という ライブラリを使ってみます。

困ったことにこのライブラリに関するドキュメントが見あたらなくて使用方法 がなかなか解らなかったのですが、ソースコードに付属している dwarfdump.c というコードがとても参考になりました。 以下にざっくりと、libdwarf を使用してデバッグ情報を得るための手順を示 します。

1. elf 構造の初期化と読み込み

まず実行ファイルを open() したファイルディスクリプタを elf_begin() に 渡し、elf データとしての初期化を行います。

# elf_begin() を呼ぶ前に elf_version() を呼んでおく必要があります。

2. dwarf データの初期化と読み込み
dwarf_elf_init() に elf_begin() で初期化したelf オブジェクトと Dwarf_Debug 構造体を渡し dwarf データを扱う準備をします。
3. コンパイルユニットを列挙する
dwarf_next_cu_header() を呼び出すことでルートの Die 下にある コンパイ ルユニットを列挙することが出来ます。
4. Die の tag を取得する
各 Die の tag は以下のように dwarf_tag()を呼ぶことで得ることが出来ます。

Dwarf_Half tag;
Dwarf_Error err;
dwarf_tag(die, &tag, &err);
if(tag == DW_TAG_subprogram){
    /* この die は関数 */
}

5. 子ノード(Die) を取得する
関数などの Die は更に子の Die を持ちます、この様な子 Die を取得するに はdwarf_child() を呼び出すことで得ることが出来ます。
6. Die の 詳細を取得する
以下に 型情報の Die から型名とサイズを得るコードを示します。

Dwarf_Error err;
Dwarf_Attribute attr;
char *name;
Dwarf_Unsigned size;

dwarf_attr(die, DW_AT_name, &attr, &err);
dwarf_formstring(attr, &name, &err);

dwarf_attr(die, DW_AT_byte_size, &attr, &err);
dwarf_formsdata(attr, &size, &err);
printf("型名: %s, 型サイズ: %s\n", name, size);

実行結果例

型名: int, 型サイズ: 4
型名: short, 型サイズ: 2
型名: char, 型サイズ: 1

この様に得る情報の種類によって呼び出す dwarf API が変わるので注意が必 要です。

libdwarf の非常に大雑把な使い方を書きましたが具体的なコードは ftrace の prototype.c に有りますので興味のある方はご覧ください。

ftrace 0.93

ftrace の新しいバージョンです、以下からダウンロードしておためしください

ftrace-0.93.tar.gz

1. PowerPC, AMD 64bit CPUで動作するようになりました。
上記のアーキテクチャの場合最適化を無効にするため対象のプログラムのコン パイル時に -O0 オプションを付けなくてはならないことが解りました。

次回は、ftrace の各CPU アークテクチャ毎の対応について紹介しようと思い ます。