crustc: rustc 全体をC言語に翻訳
crustc: entirety of `rustc`, translated to C (github.com)
要約
このプロジェクトは、Rustコンパイラであるrustcを4600万行のC言語コードに変換した「crustc」を紹介しています。これはGCCとmakeでビルド可能な、機能するRustコンパイラです。この成果は、Rustコードを任意のターゲット向けにC言語へコンパイルする新しいツールチェーン「cilly」のデモンストレーションであり、特にLLVMやGCCのサポートがない古いハードウェアや特殊な環境へのRustの移植を可能にすることを目的としています。
全文翻訳
crustc - rustc 1.98.0-nightly (c712ea946 2026-06-16) を 4600万行の C コードに変換
これは GCC & make でビルドできる、機能する Rust コンパイラです。
# LLVM(`libLLVM.so.22.1-rust-1.98.0-nightly`) へのパスを指定する必要があります
# プロジェクトにプリビルドされた LLVM を含めることもできますが、ランダムなバイナリを埋め込みたくはありません。
make -j20 LLVM_LIB_DIR=~/.rustup/toolchains/nightly-2026-06-16-aarch64-unknown-linux-gnu/lib
これは単なる C コード [1] であり、コンパイルすると機能する Rust コンパイラが得られます。
# 動作します - (libLLVM.so.22.1-rust-1.98.0-nightly を指すライブラリパス - rustc は llvm を使用します)
LD_LIBRARY_PATH=~/.rustup/toolchains/nightly-2026-06-16-aarch64-unknown-linux-gnu/lib:./rustc_driver ./rustc/rustc --version
rustc 1.98.0-nightly (c712ea946 2026-06-16)
その Rust コンパイラはコードをコンパイルできます - core, alloc, std をビルドできます - 何でもです!
これは何か?
これは私の新しい Rust から C へのコンパイラツールチェーンのデモ/ティーザーです。完全な cilly ツールチェーンは、あなたの Rust コードを 任意のターゲット 向けに C にコンパイルします。このリポジトリは、私ができる最も派手なショーケースだと信じているため、コンパイラ自身がコンパイルされる様子を示しています。
どうやってこれをやったのか?
過去 3 年間、私は Rust を C にコンパイルすることに取り組んできました。rustc_codegen_clr のようないくつかの公開された試みと、多くの非公開の試みを行いました。
私の数えでは、これが 14 回目の試みです: cilly。これは C コードを生成するための Rust ライブラリであり、Rust を C にコンパイルできる Rust コンパイラバックエンド(つまりプラグイン)です。
cilly の主な革新は、それが C コンパイラに適応する ことです。
これは、特定のコンパイラとプラットフォームが何をサポートしているかをチェックする「証拠」プログラムを生成できます。
/* これは、C コンパイラが _Thread_local をサポートしている場合にのみコンパイルされます。 */
_Thread_local int KEYWORD_TLS_SUPPORTED;
これは、cilly が C コードを生成し、あなたの特定の、奇妙な「Blorbo OS 用の Shminky C コンパイラ」を 満足させる ことを意味します。
/* これは一部の C コンパイラでパスします。 */
assert(sizeof(float) == sizeof(double));
すべての型レイアウト、サイズ、アラインメント、文字エンコーディング (ASCII)、および整数フォーマット (2 の補数) が 問い合わせ られます。
可能な場合はフォールバックを使用します。
ANSI C [2] 以外のものを仮定しないように最善を尽くしています。これには、「モダン」C 標準にある厳密なエイリアシングのようなものの回避策も含まれます。
残念ながら、これは cilly の出力がコンパイラ固有であることを意味します(つまり、Arm64 向けに生成された cilly C を riscv32 で実行することはできませんが、riscv32 向けに cilly C を生成することはできます)。
この rustc のビルド(生成された C)は、私のワークステーションの ISA であるため、ARM64 Linux を「ターゲット」にしています。
なぜこれをやったのか?
この主な目標は、LLVM/GCC のサポートがない古い/特殊なハードウェアをサポートすることです。まだ Rust をサポートしていないが C をサポートしているシステムが いくつか 存在します。
いつかプロジェクトが Rust から C に移行したり、C プロジェクトの Rust の代替が作成されたりすると、それらのターゲットのサポートは Rust の欠点として 正当に 提起されます [3]。
このプロジェクトの目標は、その問題を解消することです。
cilly は rustc と C コンパイラをラップし、実行時に Rust コードを C に変換します。ユーザーの視点からは、これは指定されたターゲットに使用する C コンパイラを定義するのと同じくらい簡単です。
"triple": [
"sdcc_z180-unknown-none"
],
"tool_def": {
"kind": "local",
"compile": {
"base": {
"executable": "/usr/bin/sdcc",
"base_args": [
"-mz180",
"--std-c89",
"-c"
],
"input_arg_template": [
"{input}"
],
// JSON は簡潔さのため省略されています。
}
}
}
ネットワーク透過性。
cilly はネットワーク透過であり、TCP を介して C コンパイラと通信できます(必要に応じて UART のようなものに拡張される可能性があります)。
これはブートストラップパラドックス / C クロスコンパイラを持たないプラットフォームの解決策です。
Blorbo OS 上で小さな C サーバーをビルドし、Linux のような通常のプラットフォームで rustc を実行し、cilly にワイヤー越しに通信させます。
私はこれを、Arm64 Linux で rustc を実行しながら、x86 Plan9 VM 向けに小さな Rust プログラムをコンパイルするために成功裏に使用しました。
term% echo `{cat /dev/sysname} osversion `{cat /dev/osversion} cputype $cputype
gnot osversion 2000 cputype 386
term% /tmp/hello_plan9
Hello, world!
term% nm /tmp/hello_plan9 | grep rust_begin_unwind
1020 T _RNvCshfEkAwg4zv6_7___rustc17rust_begin_unwind
Makefiles の生成。
cilly はオプションでオブジェクトファイル内にマーカーを埋め込み、IR をキャッシュディレクトリに保存できます。その後、これらのマーカーを読み取り、関数/グローバルを定義場所で分割し、C コンパイラと make を使用して Rust をビルドできるように、makefile を含むディレクトリを生成できます。
ABI 互換性
cilly で生成されたコードは、通常の rustc でコンパイルされたコードと ほぼ ABI 互換性があります。ほぼと言うのは、一部のプラットフォーム(Arm64 など)では rustc が C から表現できない ABI を選択するためです [4]。
再現方法
前提条件
この Rust コンパイラは以下でビルドされました:
uname -a
Linux spark-2773 6.17.0-1021-nvidia #21-Ubuntu SMP PREEMPT_DYNAMIC Wed May 27 19:14:05 UTC 2026 aarch64 aarch64 aarch64 GNU/Linux
私が使用した C コンパイラはこれです:
readelf -p .comment ./rustc/rustc
String dump of section '.comment':
[ 1] GCC: (Ubuntu 13.3.0-6ubuntu2~24.04.1) 13.3.0
[ 2e] Linker: Ubuntu LLD 18.1.3
デモをビルドするには、適切な LLVM ライブラリを提供する必要があります。最も簡単な方法は、rustc が同梱している LLVM を使用することです。
rustup install nightly-2026-06-16
ビルド
適切な GCC(より新しい GCC バージョンも動作するはずですが、未テスト)、適切な LLVM バージョン、および GNU make がインストールされている場合、以下を実行します。
# LLVM(`libLLVM.so.22.1-rust-1.98.0-nightly`) へのパスを指定する必要があります
# プロジェクトにプリビルドされた LLVM を含めることもできますが、ランダムなバイナリを埋め込みたくはありません。
make -j20 LLVM_LIB_DIR=~/.rustup/toolchains/nightly-2026-06-16-aarch64-unknown-linux-gnu/lib
# CFLAGS は動作します (注意: 一部のフラグはコンパイル時間を遅くします)
make -j20 CFLAGS=-g
そして... voilà!
コンパイル速度
最適化を有効にしないことを強くお勧めします。なぜなら、それらがバグを引き起こす可能性があり(これは単なるデモであり、... ee...エッジが粗い [5])、最適化にはこの規模では時間がかかるからです。
最適化なしでは、私のマシンではプロジェクトが数分でビルドされます。
make -j20 937.98s user 123.77s system 1352% cpu 1:18.48 total
最適化ありの場合、一部の特定の大きな Rust ファイルで詰まることが予想されます。ほとんどのコードはすぐに処理できますが、それらの巨大なファイルで立ち往生します。
ビルドのテスト
実行します。
LD_LIBRARY_PATH=~/.rustup/toolchains/nightly-2026-06-16-aarch64-unknown-linux-gnu/lib:./rustc_driver ./rustc/rustc --version
rustc のバージョンが表示されるはずです。
プログラムをビルドするには、std をビルドする必要があります。
LD_LIBRARY_PATH=~/.rustup/toolchains/nightly-2026-06-16-aarch64-unknown-linux-gnu/lib:./rustc_driver ./rustc/rustc main.rs
error[E0463]: can't find crate for `std`
|
= note: the `aarch64-unknown-linux-gnu` target may not be installed
= help: consider downloading the target with `rustup target add aarch64-unknown-linux-gnu`
= help: consider building the standard library from source with `cargo build -Zbuild-std`
error: aborting due to 1 previous error
For more information about this error, try `rustc --explain E0463`.
これについては BUILDING_STD.md を読んでください。
既知のバグ
奇妙なパス正規化の理由により、crustc はビルドされたディレクトリ(リポジトリのルート、crustc)で実行するとクラッシュすることがあります。他の場所では正常に動作します。
...
私も混乱しています。
cilly を試すことはできますか?
いいえ、まだできません。一般公開の準備はできていません。できるだけ早くリリースしますが、
- 仕事があります(ラップトップの G と C のキーが壊れている状態でコードを書く必要がなくなりました、やった!)。
- 大学があります(夏休みですが、論文は自分で書かないと終わらない)。
- 左手をミキサーに入れました。ミキサーが勝ちました。(指はすべて無事ですが、縫合痕があります)。これ以上は説明しません。
注釈
1 - まあ、C コード + いくつかの C++ LLVM ラッパーです。Rust は LLVM の一部のノブを公開するために少量の C++ を使用します。これらは LLVM のバージョン固有であり、スタンドアロンでビルドするのが面倒なため、プリコンパイルされた状態で出荷されます。
2 - まれに、「合理的な仮定」をしなければならないことがありますが、それは目標を停止させる可能性があります。例: (void*)(uintptr_t)(ptr) のラウンドトリップ。これらを文書化し、可能であればアサートを追加します (CHAR_BIT = 8)。
3 - 「Rust は Plan 9 をサポートしていない」という重みが Rust に対する議論の重みは、個人の好みに依存し、その議論の評価は読者の演習に任されます。
4 - 問題は構造体返却ポインタ (sret) です。ほとんどのプラットフォームでは、最初の引数と同じレジスタで渡されるため、最初の引数をアウトポインタにすることで、常に sret による返却(アウトポインタ)を強制できます。Arm64 ではそうではありません。そこでは、sret ポインタは異なるレジスタで渡されるため、ネイティブ C コンパイラが私たちのためだけに sret による返却を行うように 選択 する必要があります。これは(私の知る限り 16 バイト未満の)小さな構造体では行われません。迷惑です。
5 - 最適化関連のバグを追っています - これが完全な cilly ツールチェーンがまだリリースされていない理由の一部です。