From 2d95dde8615f9ed8a911873f8eb72a8582af577a Mon Sep 17 00:00:00 2001 From: Tianon Gravi Date: Tue, 27 Feb 2024 15:31:36 -0800 Subject: [PATCH] Reformat "Platform Variants", especially to add amd64, ppc64le, riscv64 This changes the table to be a line per ISA instead of per variant; adds x86-64, POWER8+, and RISC-V; and notes the appropriate "Go analog" in each case (because these values mirror Go's choices, like our use of `GOOS` and `GOARCH`). Of particular note, `GOARM64` and `GORISCV64` are not fully implemented or released in Go yet, but they are accepted proposals with in-progress implementations or already merged to main: - `GOARM64`: https://golang.org/issue/60905 - `GORISCV64`: https://golang.org/issue/61476#issuecomment-1791156741 Signed-off-by: Tianon Gravi --- image-index.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/image-index.md b/image-index.md index 1cf16f64..7cd44ea2 100644 --- a/image-index.md +++ b/image-index.md @@ -105,13 +105,15 @@ For the media type(s) that this document is compatible with, see the [matrix][ma ## Platform Variants When the variant of the CPU is not listed in the table, values are implementation-defined and SHOULD be submitted to this specification for standardization. - -| ISA/ABI | `architecture` | `variant` | -|-----------------|----------------|-------------| -| ARM 32-bit, v6 | `arm` | `v6` | -| ARM 32-bit, v7 | `arm` | `v7` | -| ARM 32-bit, v8 | `arm` | `v8` | -| ARM 64-bit, v8 | `arm64` | `v8` | +These values SHOULD match (or be similar to) their analog listed in [the Go Language document][go-environment2]. + +| ISA/ABI | `architecture` | `variant` | Go analog | +|------------|----------------|-----------------------|-------------| +| ARM 32-bit | `arm` | `v6`, `v7`, `v8` | `GOARM` | +| ARM 64-bit | `arm64` | `v8`, `v8.1`, … | `GOARM64` | +| POWER8+ | `ppc64le` | `power8`, `power9`, … | `GOPPC64` | +| RISC-V | `riscv64` | `rva20u64`, … | `GORISCV64` | +| x86-64 | `amd64` | `v1`, `v2`, `v3`, … | `GOAMD64` | ## Example Image Index