tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
b573c3e5b8d498b2ed7580573abdb3fa08e80315
hakorune/docs/development/runtime/ENV_VARS.md
Selfhosting Dev b573c3e5b8 feat: LLVM_SYS_180_PREFIX環境変数削除完了！llvm-harness経路でRust LLVMバインディング不要化達成 
🚀 Phase 15.5 MIR Call統一革命 - LLVM環境変数削除フェーズ完了

## ✅ 完了内容
- **条件分岐実装**: llvm-harness(デフォルト)はLLVM_SYS_180_PREFIX不要
- **後方互換性維持**: llvm-inkwell-legacy使用時はLLVM_SYS_180_PREFIX必要
- **全ツール統一**: 12個のビルドスクリプト・テストスクリプトを一括更新
- **ドキュメント更新**: ENV_VARS.mdでLLVM feature選択方法を明記

## 🛠️ 更新ファイル
- **コアビルド**: src/runner/build.rs, tools/build_llvm.sh, build_llvm.sh
- **スモークテスト**: tools/llvm_smoke.sh, tools/test/smoke/llvm/ir_phi_empty_check.sh
- **CI設定**: .github/workflows/min-gate.yml
- **Windows版**: build_llvm_wsl.sh, build_llvm_wsl_msvc.sh (cross-compilation)
- **開発ツール**: tools/build_compiler_exe.sh, tools/ny_mir_builder.sh
- **ドキュメント**: docs/development/runtime/ENV_VARS.md

## ⚡ 技術的成果
- **環境変数削減**: LLVM_SYS_180_PREFIX → 条件付き使用のみ
- **Python LLVM統合**: llvmliteハーネス経路でRust LLVM依存完全除去
- **ビルド簡略化**: デフォルトでllvm-config-18のみ必要
- **動作確認**: tools/llvm_smoke.sh成功 (1648バイト.oファイル生成)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-24 03:28:24 +09:00

3.5 KiB
Raw Blame History

Nyash Environment Variables (管理棟ガイド)

本ドキュメントは Nyash の環境変数を用途別に整理し、最小限の運用セットを提示します。nyash.toml の [env] で上書き可能（起動時に適用）。

  • 例: nyash.toml
[env]
NYASH_JIT_THRESHOLD = "1"
NYASH_CLI_VERBOSE = "1"
NYASH_DISABLE_PLUGINS = "1"

起動時に nyash は [env] の値を std::env に適用します（src/config/env.rs）。

コア運用セット（最小）

  • NYASH_CLI_VERBOSE: CLI の詳細ログ（"1" で有効）
  • NYASH_DISABLE_PLUGINS: 外部プラグインを無効化（CI/再現性向上）

JIT（共通）

  • NYASH_JIT_THRESHOLD: JIT 降下開始の閾値（整数）
  • NYASH_JIT_EXEC: JIT 実行（"1" で有効）
  • NYASH_JIT_HOSTCALL: ホストコール経路の有効化
  • NYASH_JIT_PHI_MIN: PHI(min) 合流の最適化ヒント
  • NYASH_JIT_NATIVE_F64: f64 のネイティブ ABI 利用（実験的）
  • NYASH_JIT_NATIVE_BOOL: bool のネイティブ ABI 利用（実験的）
  • NYASH_JIT_ABI_B1: B1 返り値 ABI を要求（実験的）
  • NYASH_JIT_RET_B1: bool 返り値ヒント（実験的）

JIT トレース/ダンプ

  • NYASH_JIT_DUMP: JIT IR/CFG ダンプ（"1" で有効）
  • NYASH_JIT_DOT: DOT 出力先ファイル指定でダンプ暗黙有効
  • NYASH_JIT_TRACE_BLOCKS: ブロック入場ログ
  • NYASH_JIT_TRACE_BR: 条件分岐ログ
  • NYASH_JIT_TRACE_SEL: select のログ
  • NYASH_JIT_TRACE_RET: return 経路のログ
  • NYASH_JIT_EVENTS_COMPILE: コンパイルイベント JSONL を出力
  • NYASH_JIT_EVENTS_PATH: イベント出力パス（既定: events.jsonl）

Async/Runtime

  • NYASH_AWAIT_MAX_MS: await の最大待機ミリ秒（既定 5000）
  • （今後）タスク/スケジューラ関連の変数は runtime.* 名で集約予定

LLVM/AOT

  • NYASH_LLVM_FEATURE: LLVM機能選択（"llvm"(default) または "llvm-inkwell-legacy"）
  • LLVM_SYS_180_PREFIX: LLVM 18 のパス指定（llvm-inkwell-legacy使用時のみ必要）
  • NYASH_LLVM_VINVOKE_RET_SMOKE, NYASH_LLVM_ARRAY_RET_SMOKE: CI 用スモークトグル
  • NYASH_LLVM_OBJ_OUT: LLVM経路で生成する .o の出力パス（Runner/スクリプトが尊重）
  • NYASH_AOT_OBJECT_OUT: AOT パイプラインで使用する .o 出力ディレクトリ/パス
  • NYASH_LLVM_USE_HARNESS: "1" で llvmlite ハーネス経路を有効化（MIR(JSON)→Python→.ll→llc→.o）

LLVM Feature 詳細

  • llvm (デフォルト): llvmlite Python ハーネス使用、LLVM_SYS_180_PREFIX不要
  • llvm-inkwell-legacy: Rust inkwell bindings使用、LLVM_SYS_180_PREFIX必要

管理方針（提案）

  • コード側: src/config/env.rs を単一の集約窓口に（JIT は jit::config に委譲）。
  • ドキュメント側: 本ファイルを単一索引にし、用途別に追加。
  • 設定ファイル: nyash.toml の [env] で標準化（ブランチ/CI での一括制御）。
  • 将来: nyash env print/set の CLI サブコマンドを追加し、実行前に .env/toml 反映と検証を行う。

MIR Cleanup (Phase 11.8) 用トグル（段階導入）

  • NYASH_MIR_ARRAY_BOXCALL: ArrayGet/Set → BoxCall 変換を有効化
  • NYASH_MIR_REF_BOXCALL: RefGet/Set → BoxCall 変換を有効化
  • NYASH_MIR_CORE13: Core‑13 セットの一括有効（将来拡張）
  • NYASH_MIR_CORE13_PURE: Core‑13 純化モード（"1" で有効）。最終MIRは13命令のみ許可され、Load/Store などは env.local.get/set、new は env.box.new 経由へ強制正規化。禁制命令が残存するとコンパイルエラーで早期失敗。