
2026/11/17 3:34
LLDB に Fortran サポートを追加 (GSoC 2026)
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
本プロジェクトは、開発者が以前には生のラインテーブルのみを通じて基本的なブレークポイントの解析に依存していたという制限を解消するために、LLDB にネイティブの Fortran デバッグ機能を導入することを目的としています。DWARFASTParser によるデバッグ情報の符号化解釈、TypeSystem によるデータ構造の管理、Language Plugin による構文解釈を含む堅牢なアーキテクチャを実装することで、素型(INTEGER, REAL, LOGICAL, COMPLEX)、配列(カスタム境界、カラム優先レイアウト、assumed-size および allocatable 属性の処理)、ポインタ、関数/サブルーチンといった基本的な構文をサポートしています。アーキテクチャ上の重要な判断として、LLDB のコアインターフェースを変更せず、ビルドプロセス中に Flang に直接リンクすることなく動的配列やカスタムレイアウトを管理するために合成子 children プロバイダーを利用しています。実装には、ビルドボットを用いた厳格な RFC プロセスおよび当面は直接の Flang 依存性を避けることに対する合意が含まれています。式評価が将来的に Flang を活用する予定ですが、現在はスコープ外であり、代わりにフレーム変数コマンドに頼っています。テストについては、LLDB の lit インフラストラクチャに加え、C++ テストスイートおよび Python API テストを使用して実施されています。現在、コードベースは LLVM メインへのマージを待っている個人的なブランチ上に存在しています。今後の段階としては、文字列、派生型、高度な式評価のサポートが含まれます。特に、DWARF 属性を通じて Fortran の大文字小文字不敏感性を扱うような実装詳細を追加することで、マルチリンガースキューの実行ファイルとの互換性を確保しています。
本文
GSoC 2026: LLVM (LLDB) に Fortran サポートを追加する取り組み
Flang が成熟しつつある一方で、それを囲繞する開発者ツールは対応に追いついていません。特に 専用のデバッガーの欠如 が大きな課題でした。LLDB は Fortran をネイティブとしてサポートしておらず、基本ブレークポイントの解決には生々しいラインテーブルのみを頼りにしていました。
本プロジェクトでは、LLDB への Fortran サポートを追加し、フル機能の Flang 対応デバッガーを構築するための基盤を整えることを目指します。
ネイティブサポートの対象機能
この取り組みによって導入される主な機能は以下の通りです:
- 基本データ型:
,INTEGER
,REAL
,LOGICALCOMPLEX - 配列: 明示的、動的、仮定ランク配列の対応
- ポインタ: ポインターとポインテッド型の管理
- 関数/サブルーチン: シグネチャと型情報の追跡
現在の状況とコードの動作確認方法
大規模なプロジェクトにおけるアップストリーム化は進行中であり、全ての機能が LLVM メインブランチにマージされているわけではありません。しかし、テスト利用可能な実装が用意されています。
- 詳細な変更セット: GitHub の PR を参照できます。
- ローカル実行: 個人的なブランチからコードをクローンし、コンパイルして動作を確認可能です。
- 最新情報の取得: プロジェクトの進行状況は常に トラッキング issue に記載されています。
高階層アーキテクチャ
LLDB に新しい言語を追加するには、コンパイルされたバイナリから値を引き出し、表現し、表示する方法を教える必要があります。これには以下の 3 つの核心コンポーネントが依存します:
- DWARFASTParser
- コンパイラによって生成された DWARF デバッグ情報を解析。
- 生データとしての型メタデータ(シンボル名、バイトサイズ、レイアウト)を引き出します。
- TypeSystem
- LLDB 内部の言語固有の型モデルを表現します。
- DWARF から解析されたメタデータを受け取り、ネイティブな LLDB の型表現を構築します。
- 言語プラグイン
- Fortran を LLDB に登録します。
- 言語固有のプリントパー(pretty-printers)、値フォーマッター、シンセティックキッドプロバイダー(synthetic children providers)を供給します。
詳細は 公式ドキュメント をご参照ください。
RFC プロセス
LLVM への重大な変更を提案するには、RFC (Request for Comments) プロセスを経る必要があります。
- プロセス概要: 変更の概要、動機、アーキテクチャ変更点、未解決事項を含む提案書を作成し、フィードバックを受け付けた上で合意(コンセンサス)を得ます。
- 私の経験: 合意に達するまで約 2 か月かかりました。アイデアの伝え方や開発者との接し方を学ぶことができました。
RFC での重要決定事項:
- テスト戦略: ビルドボット (
/x86_64
) を活用し、ビットロートを防ぐため、テストの実行場所と方法を厳密に定義しました。AArch64 - 式の評価: Flang を用いた式評価は将来的にサポートされますが、プロジェクトのライフサイクル後半であり、GSoC のスコープ外です。
- 直接リンキング: Flang のビルド要件が高いため、現在は LLDB が Flang と直接リンクせず、テスト実行時には Fortran コンパイラのみが必要です。
- 侵入的変更の回避: LLDB コアへの侵入を避けるため、配列サポートは**合成キッド(synthetic children)**を使用しました。
- 言語固有の詳細: Fortran の大文字小文字不感症などは、LLDB コアを汚さず、DWARF 属性 (
) を介してプラグイン内で処理します。DW_AT_identifier_case
テストとアップストリーム化
GSoC 期間中はコミュニティによる RFC 合意待ちの間に個人フォークで開発を行いました。合意後、作業はレビューしやすく小規模なプルリクエストへの分割へと焦点をシフトしました。
レグレッション防止のため、LLDB の lit ベーステストインフラストラクチャ を 2 レベル活用しています:
1. ユニットテスト (C++)
:TypeSystemFortranTests
が型を正しくインスタンス化・構築・照会できるか検証。TypeSystemFortran
: 生 DWARF デバッグ情報が内部型へ正確にパースされるかテスト。DWARFASTParserFortranTests
: プラグイン登録および合成キッドプロバイダーフックの有効性確認。FortranLanguageTests
2. API テスト (Python / SB API)
- LLDB の Scripting Bridge API を用いたエンドツーエンド統合テスト。
- サンプル Fortran プログラムのコンパイル、デバッグセッション開始を行い、プラグインや型システムが適切に通信して変数を検査・表示できるか検証。
追加された機能の詳細
1. 基盤の整備
LLDB は API テスト時にサンプルプログラムをコンパイルするため、テストランナーを更新し、インストールされた Fortran コンパイラの自動検出およびテストスイートの有効化を実装しました (PR #208298)。
機能追加前の大量のボイラープレート(スチュブ)を、レビューしやすく分割した 3 つの最小限の PR に分けます:
- 言語プラグイン登録: Fortran の LLDB 内登録 (PR #218014)。
- TypeSystem スチュブ (
): クラススケルトンとインターフェースオーバーライド追加 (PR #218016)。TypeSystemFortran - DWARF パーサー スチュブ (
): DWARF 型解析のためのパーサースケルトン追加 (PR #218024)。DWARFASTParserFortran
2. 基本データ型
Fortran の
INTEGER, REAL, LOGICAL, COMPLEX は全て DW_TAG_base_type タグで記述されます。
TypeSystem 実装 (TypeSystemFortran
)
TypeSystemFortran- メモリ管理及び重複排除: リーク防止のため、型はベクタ内のユニークポインタとして格納し、LLVM FoldingSet を用いて重複を回避・再利用します。
- 基本データ型の表現: 以下の 3 プロパティを追跡。
- 型名
- バイトサイズ
- 型の種類 (type kind)
DWARFASTParser 実装 (DWARFASTParserFortran
)
DWARFASTParserFortran- タグ認識:
パースによる情報収集。DW_TAG_base_type - スコープの抽出: 型のコンテキスト計算。
- 型の構築: 抽出情報を
にフォワードしてインスタンス化・キャッシュ。TypeSystemFortran
出力例
(lldb) frame variable num_real (REAL) num_real = 2.71828175 (lldb) frame variable num_int (INTEGER) num_int = 152 (lldb) frame variable num_logical (LOGICAL) num_logical = true (lldb) frame variable z1 (COMPLEX(KIND=8)) z1 = (3, 4)
3. 関数とサブルーチン
TypeSystem 実装 (TypeSystemFortran
)
TypeSystemFortran- パラメータ: 名前と型を格納し、シグネチャ構築・引数検査を可能にします。
- 名前: 完全な Fortran シグネチャ(例:
)をフォーマット。INTEGER sample(INTEGER arg1) - 戻り値の型: 関数の戻り値またはサブルーチンの非有無を追跡。
DWARFASTParser 実装 (DWARFASTParserFortran
)
DWARFASTParserFortran- サブプログラム情報のパース:
を特定し、シンボル名、パラメータ、戻り値型を抽出・インスタンス化。DW_TAG_subprogram - フレーム境界の計算: スタックフレームアンワインディングに必要な開始/終了メモリアドレス(低 PC / 高 PC)決定。
4. 変数の出力表示
DumpTypeValue を実装し、フレーム変数が予測可能な方法で表示されるようになりました。
(lldb) frame variable num_real (REAL) num_real = 2.71828175 (lldb) frame variable z1 (COMPLEX(KIND=8)) z1 = (3, 4)
※複素数は (実部, 虚部) でフォーマットされます。
5. ポインタ
ポインタ型は C ライク言語と同様に取り扱い、ポイアンテッド型の情報だけで処理可能です。
TypeSystem 実装
- ポイアンテッド型からポインタ型を作成し、逆変換も可能にします。
DWARFASTParser 実装
の子供要素(ポイアンテッド型参照)を再帰的にパースし、DW_TAG_pointer_type
にフォワードします。TypeSystem
出力例
(lldb) frame variable int_ptr (INTEGER *) _QFEint_ptr = 0x000055555563d1e8 (lldb) frame variable func_ptr (INTEGER <unnamed function>(INTEGER * ) *) _QFEfunc_ptr = 0x0000555555556740
※変数名はマングリングされたまま表示されます。LLDB が Flang のデマングレーにアクセスできないためです。
6. 明示的な配列
Fortran の配列はカスタム境界や列優先ストレージ順序を持ちます。これに対応するため、新しいサブアリー型を作成し、外側のディメンションを stripping するとともに、バイトストライドを適切にスケーリングします。
TypeSystem 内の表現構造
+-----------------------------------------------------------+ | ArrayType | | - Element Type : CompilerType (e.g., INTEGER) | | - Metadata : Flags, Rank | | - Dimensions : vector<ArrayShape> | +-----------------------------------------------------------+ | v +-----------------------------------------------------------+ | ArrayShape | | - Byte Stride : 要素間のメモリステップ | | - Element Count : このディメンションの範囲 (Extent) | | - Lower Bound : ArrayBound | | - Upper Bound : ArrayBound | +-----------------------------------------------------------+
出力例
(lldb) frame variable a (INTEGER(2, 2)) a = { [1] = ([1] = 1, [2] = 3), [2] = ([1] = 2, [2] = 4) } (lldb) frame variable a[1] (INTEGER(2)) a[1] = ([1] = 1, [2] = 3) (lldb) frame variable a[1][2] (INTEGER) a[1][2] = 3
7. 動的配列
Fortran の動的配列は、実行時に変化可能な境界やストライドを保持します。LLDB コアが静的構造を前提としているため、合成キッドプロバイダーを使用して実行時メタデータを具体的な型に変換し、
TypeSystem を隔離するアプローチを採用しました。
処理対象
- 自動配列 (Automatic-arrays): 関数引数などで決定される境界を持つ配列。コンパイラが隠された変子を DWARF に出力するため解決可能。
- 仮定ランク配列 (Assumed-rank arrays):
およびDW_TAG_generic_subrange
を使用し、合成キッドプロバイダーが各ディメンションの実行時プロパティを決定。DW_AT_rank
8. 大文字小文字不感症
Fortran は大文字小文字不感です。コンパイラは
DW_AT_identifier_case 属性を出力するため、LLDB は適切なケース設定を実装しています。複数言語の実行ファイルでデフォルトは感症(区別あり)となります。
今後のステップ
配列処理が予想以上に複雑なため、スコープ変更となりました。以下の機能は将来の課題です:
- 文字列
- デリバッド型
理想的なゴールは Flang による式評価器を持つことではなく、
frame variable コマンド(言語非依存パーサー DIL を使用)で十分動作することを目指します。
最大の苦労と学び
- 最大の苦労: 大規模コミュニティの中で自分の声を鳴らし、効果的にコミュニケーションする方法を学ぶことでした。メンターの方々が大きな助けとなりました。
- 学び: 大規模コードベースのナビゲーション効率化、そして明確なコミュニケーションと支援的なコミュニティの重要性を実感しました。
謝辞
このプロジェクトに多大な助言をいただいたメンターである Shivam Gupta と Tarun Prabhu に感謝します。また、LLVM コミュニティおよび LLDB チームの皆様に RFC フィードバックと道案内を提供いただいたことに深く感謝申し上げます。