リンクsysroot手動除去 (-C link-sysroot)

この文書は、wavecでリンクユニットsysrootを明示的に除去する方法を説明します。

核心原則:

• --sysroot=<path>: コンパイル単位(clang -c) sysroot
• -C link-sysroot=<path>: リンク単位(linker) sysroot

つまり、コンパイルとリンクのsysrootを分離します。

---

1. なぜ必要か

クロスリンクで-C linker=<path>を使うと、リンクドライバ（例：aarch64-linux-gnu-gcc）が参照するランタイムパス(crt1.o, libc, libm)を別途指定しなければならない場合が多いです。

この場合、リンクsysrootは自動推論されず、CLIで明示的に伝達されるよう設定します。

---

2. オプション定義

2.1 -C link-sysroot=<path>

リンク単位に--sysroot=<path>を入力します。

wavec -C link-sysroot=/path/to/sysroot ...

内部的には-C link-arg=--sysroot=<path>と同じ意味です。

2.2 -C link-arg=--sysroot=<path>

既存のrawリンク引数方式も継続サポートします。

wavec -C link-arg=--sysroot=/path/to/sysroot ...

---

3. 検証規則

リンク単位が必要なビルドで次の条件が同時に成立するとusage errorで終了します。

1. -C linker=... 使用
2. --sysroot=<path> 使用
3. リンクsysroot(-C link-sysrootまたは-C link-arg=--sysroot=...) 未指定

エラーメッセージ例:

when using -C linker=..., --sysroot=<path> is compile-stage only; pass linker sysroot explicitly with -C link-sysroot=<path> (or -C link-arg=--sysroot=<path>)

---

4. 使用例示

4.1 AArch64 Linux クロスリンク

wavec \
  -C linker=aarch64-linux-gnu-gcc \
  --sysroot=/usr/aarch64-redhat-linux/sys-root/fc43 \
  -C link-sysroot=/usr/aarch64-redhat-linux/sys-root/fc43 \
  build test/test93.wave \
  --target aarch64-unknown-linux-gnu \
  --emit=bin \
  -o /tmp/test93-aarch64.bin

4.2 raw リンク引数方式

wavec \
  -C linker=aarch64-linux-gnu-gcc \
  --sysroot=/usr/aarch64-redhat-linux/sys-root/fc43 \
  -C link-arg=--sysroot=/usr/aarch64-redhat-linux/sys-root/fc43 \
  build test/test93.wave \
  --target aarch64-unknown-linux-gnu \
  --emit=bin

4.3 リンクがないビルド (--emit=obj)

リンク単位がなければリンクsysrootは必要ありません。

wavec --sysroot=/path/to/sysroot build main.wave --emit=obj

---

5. 整理

• --sysrootはコンパイル単位除去
• -C link-sysrootはリンク単位除去
• 自動推論より明示的除去を優先