インライン化された関数のデバッグ情報
Debugging Information for Inlined Functions (lwn.net)
要約
BPFプログラムは、カーネル内の関数と連携するためにBTF(BPF Type Format)デバッグ情報を使用しますが、インライン化された関数は単一のアドレスを持たないため、現在トレースできません。LSFMM+BPFカンファレンスでは、インライン化された関数に関する情報をBTFに追加し、それらをトレース可能にするための提案が議論されました。この変更により、カーネルのデバッグ能力が向上し、インライン化された関数の呼び出しをより正確に追跡できるようになります。
全文翻訳
インライン化された関数のデバッグ情報
BPFプログラムは、カーネル内の関数とどのように連携するかを判断するために、BPF Type Format(BTF)デバッグ情報を使用しています。具体的には、カーネル関数をトレースするには、カーネルのBTFセクションでそのアドレスを見つける必要があります。しかし、これはインライン化された関数、つまり単一の特定のアドレスを持たない関数には適用できません。Alan Maguire氏は、インライン化された関数をトレースできるように、BTFにインライン化関数に関する情報を追加したいと考えており、2026年のLinux Storage, Filesystem, Memory-Management, and BPF Summitでそのトピックに関するセッションを主導しました。
Maguire氏によると、カーネルには10万を超えるインライン化された関数があり、それらは5倍の数の場所に分散しています。さらに悪いことに、一部の関数は部分的にインライン化されており、場所によっては通常通り呼び出され、別の場所ではインライン化されています。これにより、今日では関数が正常にトレースされたように見えても、一部の呼び出しが見落とされるというケースが発生する可能性があります。
良いニュースは、インライン化された関数をトレースするための残りのインフラストラクチャは、任意の場所にアタッチできるkprobesを有効にするためにすでに整っていることです。Maguire氏は、「ストーリーは実際にはかなり完成しています」と述べ、問題は、関数がどこにインライン化されたかに関するデータを、使用可能な形式で取得することだけだと述べています。
では、この情報をBTFに格納するために何が必要でしょうか?DWARFデバッグフォーマットは、インライン化情報を示す方法をすでに持っていますが、DWARFも扱いが難しく、一般的なケースを単純に表現する方法がありません。Maguire氏によると、BTFのソリューションはコンパクトで、重複排除を可能にし、メモリオーバーヘッドを低く保つ必要があります。理想的には、インライン化情報はカーネルバイナリの別のセクションに格納されるか、必要になるまでロードされないように、別のカーネルモジュールとして配布されるべきです。
具体的には、Maguire氏はBTFに3つの新しい情報が追加されることを提案しました。最初のものは、各コールサイトでどの関数がインライン化されたか、そしてインライン化されなかった場合にどのように呼び出されたかを示す、インラインサイト固有の情報であり、「ロケーションセクション」と呼ばれます。このデータは、特定のコールサイトに固有であるため、簡単に重複排除することはできません。そのため、可能な限り、情報は重複排除可能なデータへのポインタで構成されるべきです。
彼が追加したい2番目と3番目の情報は、参照されるデータ、すなわち「ロケーションプロトタイプ」と「ロケーションパラメータ」です。ロケーションプロトタイプは、インライン化された関数の引数がコールサイトでどのように表現されるかを指定します。これは、ロケーションパラメータへのポインタのリストとして表され、各ロケーションパラメータは単一の関数引数へのアクセス方法を格納します。理論的には、コンパイラは、インライン化された各コールサイト(538,090個存在)に対して、関数の引数を異なる場所に格納する可能性があります。しかし実際には、コンパイラが変換する引数の方法は限られており、多くの関数は互換性のあるシグネチャを持っており、コンパイラは同じ選択をします。現在のカーネルでは、ロケーションプロトタイプを重複排除すると、わずか57,141個の異なるエントリになり、参照されるロケーションパラメータエントリは合計で17,535個にすぎません。
これは、ロケーションセクションが追加データの大部分を占めることを意味します。全体として、Maguire氏が提案するBTFへの追加は、約11MBの追加データ、つまりインライン化されたコールサイトあたり約21バイトになります。これを別のカーネルモジュールに分離して圧縮すると、データ総量は3.5MBに減少します。
Maguire氏は、特定の関数に関する情報がどのように格納されるかの例を挙げました。この関数を考えてみましょう。
int foo(int a, void *b, bool c);
コンパイラが、aを未使用として削除し、bをレジスタで渡すように昇格させ、cが定数であると判断するようにfoo()をインライン化することを選択した場合、BTF表現は、foo()のBTF型ID、カーネルのベースアドレスからのコールサイトのオフセット、およびロケーションプロトタイプエントリへのポインタを格納する単一のロケーションセクションエントリになります。そのエントリは、ロケーションパラメータエントリへの参照の長さタグ付き配列になります。最初の項目はnullで、aを回復できないことを示します。2番目の項目は、値がレジスタに含まれていることを示すフラグを持つロケーションパラメータエントリを参照し、次にbの特定のレジスタ番号を示します。最後のロケーションパラメータエントリは、定数であることを示す別のフラグを持ち、次に定数の値を示します。
Alexei Starovoitov氏は、カーネルがトレース設定時に正しいエントリを見つけるために検索する必要があるため、ロケーションセクションエントリはどのような順序で格納されるかを尋ねました。当初、Maguire氏はコールサイトのアドレスでソートするのが最善だと考えていましたが、データの使用方法を見た後、代わりにエントリを関数名でソートすることにしました。これにより、特定の関数の情報を探しているトレースツールは、バイナリ検索で素早く見つけることができます。
Maguire氏がカバーした、BTFにインライン化情報を追加する際の2つの前提問題がありました。まず、ロケーションセクションエントリの数が、コンテナ構造の長さフィールドのサイズを24ビットに増やす必要がありました。より深刻なのは、BTFを処理する既存のツールのいくつかが、読み方がわからない新しいタグの存在にうまく対応できなかったことです。これは、BTFが新しい種類の情報で拡張されるたびに発生する問題であり、DWARFが非常に壊れやすくなった一因です。これに対処するため、Maguire氏はBTF自体にBTFを解析する方法に関する情報(メタ情報)を追加しました。これにより、このメタ情報を読み取ることができるツールは、理解できない新しいタグを正しくスキップできます。
Maguire氏はまた、新しい種類のBTFタグを正しくソートできるように、poke-a-hole (pahole) ユーティリティを更新する必要がありました。これは少し複雑になりましたが、通常のカーネルビルドでは機能するはずです。Andrii Nakryiko氏は、アウトオブツリーモジュールをどのように処理するかについて尋ねました。Maguire氏は、それらのモジュールは、実行中のカーネルにロードされたときに明示的に再配置できるレジリエントモジュールBTFを必要とするだろうと説明しました。彼の設計はそれを可能にしますが、ビルドはいくらか複雑になります。アウトオブツリーモジュールをエレガントにサポートするために必要な変更について多少のやり取りがありましたが、最終的に合意された変更はありませんでした。
この記事の執筆時点では、Maguire氏のパッチセットはマージされていません。インライン化された関数や部分的にインライン化された関数をトレースできることは明らかに有用ですが、問題は、それが複雑さとメモリオーバーヘッドに見合うかどうかです。時が経てばわかるでしょう。
この記事のインデックスエントリ
Storage, Filesystem, Memory-Management and BPF Summit/2026