Promote riscv64-linux-musl from planned to verified cross target

- triple.cppm: mark riscv64-linux-musl verified, pin gcc@16.1.0
- cross-build-test.yml: add riscv64-linux-musl qemu matrix row
- 103_target_vocabulary.sh: use aarch64-linux-gnu as the planned-tier example
- test_linkmodel.cpp: assert riscv64 loader names (musl + glibc)
- README/README.zh-CN: riscv64-linux-musl now verified with rv64gc/lp64d note

Requires xim riscv64-linux-musl-gcc@16.1.0 (openxlings/xim-pkgindex#585).

Author: lildengzi

.github/workflows/cross-build-test.yml

@@ -11,6 +11,7 @@ name: cross-build-test
 #   target                | toolchain                       | host→target   | run
 #   ----------------------|---------------------------------|---------------|-----
 #   aarch64-linux-musl    | aarch64-linux-musl-gcc@16.1.0   | x86_64→arm64  | qemu
+#   riscv64-linux-musl    | riscv64-linux-musl-gcc@16.1.0   | x86_64→riscv64| qemu
 #   x86_64-w64-mingw32    | mingw-cross-gcc@16.1.0 (MSVCRT)  | linux→windows | wine
 #
 # The mingw row is OS-cross (same arch, different OS/ABI: ELF→PE), so it lives
@@ -34,8 +35,6 @@ name: cross-build-test
 #                         yet inject `-target <triple>` + a cross sysroot for a
 #                         clang toolchain; cross `--target` resolves to gcc musl
 #                         only. Wire the clang cross path first, then add a row.
-#   * riscv64-linux-musl: add once xim:riscv64-linux-musl-gcc ships to
-#                         xlings-res + xim-pkgindex.
 
 on:
   push:
@@ -60,6 +59,9 @@ jobs:
           - target: aarch64-linux-musl
             file_arch: "ARM aarch64"
             qemu_bin: qemu-aarch64-static
+          - target: riscv64-linux-musl
+            file_arch: "UCB RISC-V"
+            qemu_bin: qemu-riscv64-static
     env:
       MCPP_HOME: /home/runner/.mcpp
       # Verbose every mcpp invocation for richer CI diagnostics (src/cli.cppm).

README.md

@@ -249,7 +249,7 @@ the right toolchain payload is resolved and installed automatically.
 | `x86_64-windows-gnu`  | gcc 16 MinGW-w64 — native on Windows, cross from Linux (wine-verified) | ✅ |
 | `x86_64-windows-msvc` | `msvc@system` (detected VS/BuildTools) or llvm ¹ *(Windows default)* | ✅ |
 | `aarch64-macos`       | llvm *(macOS default)* | ✅ |
-| `riscv64-linux-musl`  | — | 🔄 |
+| `riscv64-linux-musl`  | gcc 16, fully static — cross from x86_64 (qemu-verified); base `rv64gc`/`lp64d` ISA, optional extensions (`-march=rv64gcv`, Zb*) pass through | ✅ |
 | `aarch64-linux-gnu`   | — | 🔄 |
 | `x86_64-macos`        | — | 🔄 |
 

README.zh-CN.md

@@ -247,7 +247,7 @@ mcpp 的身份模型是两条正交轴:**工具链** = `family@version`(family 
 | `x86_64-windows-gnu`  | gcc 16 MinGW-w64——Windows 原生,Linux 交叉(wine 实测) | ✅ |
 | `x86_64-windows-msvc` | `msvc@system`(探测 VS/BuildTools)或 llvm ¹(*Windows 默认*) | ✅ |
 | `aarch64-macos`       | llvm(*macOS 默认*) | ✅ |
-| `riscv64-linux-musl`  | — | 🔄 |
+| `riscv64-linux-musl`  | gcc 16,全静态——x86_64 交叉(qemu 实测);基础 `rv64gc`/`lp64d` ISA,可选扩展(`-march=rv64gcv`、Zb*)自行指定 | ✅ |
 | `aarch64-linux-gnu`   | — | 🔄 |
 | `x86_64-macos`        | — | 🔄 |
 

src/toolchain/triple.cppm

@@ -106,7 +106,7 @@ inline constexpr TargetInfo kKnownTargets[] = {
     { "x86_64-windows-gnu",    "verified",  "PE",  "gcc@16.1.0", true  },
     { "x86_64-windows-msvc",   "verified",  "PE",  "",           false },
     { "aarch64-macos",         "verified",  "",    "",           false },
-    { "riscv64-linux-musl",    "planned",   "",    "",           true  },
+    { "riscv64-linux-musl",    "verified",  "",    "gcc@16.1.0", true  },
     { "aarch64-linux-gnu",     "planned",   "",    "",           false },
     { "x86_64-macos",          "planned",   "",    "",           false },
 };

tests/e2e/103_target_vocabulary.sh

@@ -26,7 +26,7 @@ grep -q "did you mean 'x86_64-linux-musl'" "$TMP/typo.log" || {
     echo "FAIL: missing did-you-mean suggestion"; cat "$TMP/typo.log"; exit 1; }
 
 # ── 2. planned tier: registered but unsupported → error, not a host build ───
-if "$MCPP" build --target riscv64-linux-musl > "$TMP/planned.log" 2>&1; then
+if "$MCPP" build --target aarch64-linux-gnu > "$TMP/planned.log" 2>&1; then
     echo "FAIL: planned-tier target built"; cat "$TMP/planned.log"; exit 1
 fi
 grep -q "not yet supported" "$TMP/planned.log" || {

tests/unit/test_linkmodel.cpp

@@ -42,6 +42,8 @@ TEST(LoaderFilename, TripleMap) {
     EXPECT_EQ(tc::loader_filename("aarch64-linux-gnu"), "ld-linux-aarch64.so.1");
     EXPECT_EQ(tc::loader_filename("x86_64-linux-musl"), "ld-musl-x86_64.so.1");
     EXPECT_EQ(tc::loader_filename("aarch64-linux-musl"), "ld-musl-aarch64.so.1");
+    EXPECT_EQ(tc::loader_filename("riscv64-linux-musl"), "ld-musl-riscv64.so.1");
+    EXPECT_EQ(tc::loader_filename("riscv64-linux-gnu"), "ld-linux-riscv64-lp64d.so.1");
     EXPECT_EQ(tc::loader_filename("wasm32-unknown-unknown"), "");
 }