メインコンテンツへスキップ
メインコンテンツへスキップ

DWARF

InputOutputAlias
✔✗

説明​

DWARF フォーマットは、ELF ファイル（実行ファイル、ライブラリ、またはオブジェクトファイル）から DWARF デバッグシンボルをパースします。
dwarfdump に似ていますが、はるかに高速（数百 MB/s）で動作し、SQL をサポートします。
.debug_info セクション内の各 Debug Information Entry (DIE) ごとに 1 行を出力し、さらに、DWARF エンコーディングがツリー内の子リストを終端するために使用する「null」エントリも含みます。

参考文献

.debug_info は unit から構成されており、これはコンパイル単位に対応します:

  • 各 unit は DIE の木構造であり、ルートには compile_unit DIE が存在します。
  • 各 DIE は tag と attribute のリストを持ちます。
  • 各 attribute は name と value（および、その値がどのようにエンコードされているかを指定する form）を持ちます。

DIE はソースコード中のさまざまな要素を表し、その tag によって何を表しているかが分かります。例えば次のようなものがあります:

  • 関数（tag = subprogram）
  • クラス / 構造体 / enum（class_type / structure_type / enumeration_type）
  • 変数（variable）
  • 関数引数（formal_parameter）

ツリー構造は対応するソースコードを反映しています。例えば、class_type DIE は、そのクラスのメソッドを表す subprogram DIE を含むことができます。

DWARF フォーマットは次の列を出力します:

  • offset - .debug_info セクション内での DIE の位置
  • size - エンコードされた DIE のバイト数（attribute を含む）
  • tag - DIE の種類。慣例的な "DW_TAG_" プレフィックスは省略されています
  • unit_name - この DIE を含むコンパイル単位の名前
  • unit_offset - この DIE を含むコンパイル単位の .debug_info セクション内での位置
  • ancestor_tags - 現在の DIE の祖先となるタグの配列（内側から外側の順）
  • ancestor_offsets - 祖先のオフセットの配列で、ancestor_tags と並行
  • 利便性のために、attribute 配列から複製された、よく使われる attribute:
    • name
    • linkage_name - マングルされた完全修飾名。通常は関数のみに存在します（すべての関数にあるとは限りません）
    • decl_file - このエンティティが宣言されたソースコードファイル名
    • decl_line - このエンティティが宣言されたソースコード中の行番号
  • attribute を表現する並行配列:
    • attr_name - attribute の名前。慣例的な "DW_AT_" プレフィックスは省略されています
    • attr_form - attribute がどのようにエンコードおよび解釈されるか。慣例的な DW_FORM_ プレフィックスは省略されています
    • attr_int - attribute の整数値。attribute に数値がない場合は 0
    • attr_str - attribute の文字列値。attribute に文字列がない場合は空文字列

使用例​

DWARF 形式を使うと、最も多くの関数定義（テンプレートのインスタンス化や、インクルードされたヘッダーファイル内の関数を含む）を持つコンパイル単位を特定できます。

SELECT
    unit_name,
    count() AS c
FROM file('programs/clickhouse', DWARF)
WHERE tag = 'subprogram' AND NOT has(attr_name, 'declaration')
GROUP BY unit_name
ORDER BY c DESC
LIMIT 3

┌─unit_name──────────────────────────────────────────────────┬─────c─┐
│ ./src/Core/Settings.cpp                                    │ 28939 │
│ ./src/AggregateFunctions/AggregateFunctionSumMap.cpp       │ 23327 │
│ ./src/AggregateFunctions/AggregateFunctionUniqCombined.cpp │ 22649 │
└────────────────────────────────────────────────────────────┴───────┘

3行のセット。経過時間: 1.487秒。処理済み: 1億3976万行、1.12 GB (9397万行/秒、752.77 MB/秒)
ピークメモリ使用量: 271.92 MiB。

書式設定​