Go (Golang) GOOS and GOARCH

September 15, 2021 · View on GitHub

All of the following information is based on go version go1.17.1 darwin/amd64.

GOOS Values

GOOSOut of the Box
aix✅
android✅
darwin✅
dragonfly✅
freebsd✅
hurd
illumos✅
ios✅
js✅
linux✅
nacl
netbsd✅
openbsd✅
plan9✅
solaris✅
windows✅
zos

All GOOS values:

"aix", "android", "darwin", "dragonfly", "freebsd", "hurd", "illumos", "ios", "js", "linux", "nacl", "netbsd", "openbsd", "plan9", "solaris", "windows", "zos"

"Out of the box" GOOS values:

"aix", "android", "darwin", "dragonfly", "freebsd", "illumos", "ios", "js", "linux", "netbsd", "openbsd", "plan9", "solaris", "windows"

NOTE

"Out of the box" means the GOOS is supported out of the box, i.e. the stocked go command can build the source code without the help of a C compiler, etc.

NOTE

The full list is based on https://github.com/golang/go/blob/master/src/go/build/syslist.go. The "out of the box" information is based on the result of 2-make1.sh below.

GOARCH Values

GOARCHOut of the Box32-bit64-bit
386✅✅
amd64✅✅
amd64p32✅
arm✅✅
arm64✅✅
arm64be✅
armbe✅
loong64✅
mips✅✅
mips64✅✅
mips64le✅✅
mips64p32✅
mips64p32le✅
mipsle✅✅
ppc✅
ppc64✅✅
ppc64le✅✅
riscv✅
riscv64✅✅
s390✅
s390x✅✅
sparc✅
sparc64✅
wasm✅✅

All GOARCH values:

"386", "amd64", "amd64p32", "arm", "arm64", "arm64be", "armbe", "loong64", "mips", "mips64", "mips64le", "mips64p32", "mips64p32le", "mipsle", "ppc", "ppc64", "ppc64le", "riscv", "riscv64", "s390", "s390x", "sparc", "sparc64", "wasm"

All 32-bit GOARCH values:

"386", "amd64p32", "arm", "armbe", "mips", "mips64p32", "mips64p32le", "mipsle", "ppc", "riscv", "s390", "sparc"

All 64-bit GOARCH values:

"amd64", "arm64", "arm64be", "loong64", "mips64", "mips64le", "ppc64", "ppc64le", "riscv64", "s390x", "sparc64", "wasm"

"Out of the box" GOARCH values:

"386", "amd64", "arm", "arm64", "mips", "mips64", "mips64le", "mipsle", "ppc64", "ppc64le", "riscv64", "s390x", "wasm"

"Out of the box" 32-bit GOARCH values:

"386", "arm", "mips", "mipsle"

"Out of the box" 64-bit GOARCH values:

"amd64", "arm64", "mips64", "mips64le", "ppc64", "ppc64le", "riscv64", "s390x", "wasm"

NOTE

"Out of the box" means the GOARCH is supported out of the box, i.e. the stocked go command can build the source code without the help of a C compiler, etc.

NOTE

The full list is based on https://github.com/golang/go/blob/master/src/go/build/syslist.go. The "out of the box" information is based on the result of 2-make1.sh below. The "32-bit/64-bit" information is based on the result of 4-make2.sh below and https://golang.org/doc/install/source.

Platform Values

PlatformOut of the Box32-bit64-bit
aix/ppc64✅✅
android/386✅
android/amd64✅
android/arm✅
android/arm64✅✅
darwin/amd64✅✅
darwin/arm64✅✅
dragonfly/amd64✅✅
freebsd/386✅✅
freebsd/amd64✅✅
freebsd/arm✅✅
freebsd/arm64✅✅
illumos/amd64✅✅
ios/amd64✅✅
ios/arm64✅
js/wasm✅✅
linux/386✅✅
linux/amd64✅✅
linux/arm✅✅
linux/arm64✅✅
linux/mips✅✅
linux/mips64✅✅
linux/mips64le✅✅
linux/mipsle✅✅
linux/ppc64✅✅
linux/ppc64le✅✅
linux/riscv64✅✅
linux/s390x✅✅
netbsd/386✅✅
netbsd/amd64✅✅
netbsd/arm✅✅
netbsd/arm64✅✅
openbsd/386✅✅
openbsd/amd64✅✅
openbsd/arm✅✅
openbsd/arm64✅✅
openbsd/mips64✅✅
plan9/386✅✅
plan9/amd64✅✅
plan9/arm✅✅
solaris/amd64✅✅
windows/386✅✅
windows/amd64✅✅
windows/arm✅✅
windows/arm64✅✅

All Platform values:

"aix/ppc64", "android/386", "android/amd64", "android/arm", "android/arm64", "darwin/amd64", "darwin/arm64", "dragonfly/amd64", "freebsd/386", "freebsd/amd64", "freebsd/arm", "freebsd/arm64", "illumos/amd64", "ios/amd64", "ios/arm64", "js/wasm", "linux/386", "linux/amd64", "linux/arm", "linux/arm64", "linux/mips", "linux/mips64", "linux/mips64le", "linux/mipsle", "linux/ppc64", "linux/ppc64le", "linux/riscv64", "linux/s390x", "netbsd/386", "netbsd/amd64", "netbsd/arm", "netbsd/arm64", "openbsd/386", "openbsd/amd64", "openbsd/arm", "openbsd/arm64", "openbsd/mips64", "plan9/386", "plan9/amd64", "plan9/arm", "solaris/amd64", "windows/386", "windows/amd64", "windows/arm", "windows/arm64"

All 32-bit Platform values:

"android/386", "android/arm", "freebsd/386", "freebsd/arm", "linux/386", "linux/arm", "linux/mips", "linux/mipsle", "netbsd/386", "netbsd/arm", "openbsd/386", "openbsd/arm", "plan9/386", "plan9/arm", "windows/386", "windows/arm"

All 64-bit Platform values:

"aix/ppc64", "android/amd64", "android/arm64", "darwin/amd64", "darwin/arm64", "dragonfly/amd64", "freebsd/amd64", "freebsd/arm64", "illumos/amd64", "ios/amd64", "ios/arm64", "js/wasm", "linux/amd64", "linux/arm64", "linux/mips64", "linux/mips64le", "linux/ppc64", "linux/ppc64le", "linux/riscv64", "linux/s390x", "netbsd/amd64", "netbsd/arm64", "openbsd/amd64", "openbsd/arm64", "openbsd/mips64", "plan9/amd64", "solaris/amd64", "windows/amd64", "windows/arm64"

"Out of the box" Platform values:

"aix/ppc64", "android/arm64", "darwin/amd64", "darwin/arm64", "dragonfly/amd64", "freebsd/386", "freebsd/amd64", "freebsd/arm", "freebsd/arm64", "illumos/amd64", "ios/amd64", "js/wasm", "linux/386", "linux/amd64", "linux/arm", "linux/arm64", "linux/mips", "linux/mips64", "linux/mips64le", "linux/mipsle", "linux/ppc64", "linux/ppc64le", "linux/riscv64", "linux/s390x", "netbsd/386", "netbsd/amd64", "netbsd/arm", "netbsd/arm64", "openbsd/386", "openbsd/amd64", "openbsd/arm", "openbsd/arm64", "openbsd/mips64", "plan9/386", "plan9/amd64", "plan9/arm", "solaris/amd64", "windows/386", "windows/amd64", "windows/arm", "windows/arm64"

"Out of the box" 32-bit Platform values:

"freebsd/386", "freebsd/arm", "linux/386", "linux/arm", "linux/mips", "linux/mipsle", "netbsd/386", "netbsd/arm", "openbsd/386", "openbsd/arm", "plan9/386", "plan9/arm", "windows/386", "windows/arm"

"Out of the box" 64-bit Platform values:

"aix/ppc64", "android/arm64", "darwin/amd64", "darwin/arm64", "dragonfly/amd64", "freebsd/amd64", "freebsd/arm64", "illumos/amd64", "ios/amd64", "js/wasm", "linux/amd64", "linux/arm64", "linux/mips64", "linux/mips64le", "linux/ppc64", "linux/ppc64le", "linux/riscv64", "linux/s390x", "netbsd/amd64", "netbsd/arm64", "openbsd/amd64", "openbsd/arm64", "openbsd/mips64", "plan9/amd64", "solaris/amd64", "windows/amd64", "windows/arm64"

NOTE

"Out of the box" means the platform is supported out of the box, i.e. the stocked go command can build the source code without the help of a C compiler, etc.

NOTE

The full list is based on the result of the command go tool dist list. The "out of the box" information is based on the result of 2-make1.sh below. The "32-bit/64-bit" information is based on the result of 4-make2.sh below and https://golang.org/doc/install/source.

Support Grid 1

androiddarwiniosjslinuxwindows
386☑️ (α1)✅✅386
amd64☑️ (α2)✅✅✅✅amd64
amd64p32amd64p32
arm☑️ (α2)✅✅arm
arm64✅✅☑️ (β)✅✅arm64
arm64bearm64be
armbearmbe
loong64loong64
mips✅mips
mips64✅mips64
mips64le✅mips64le
mips64p32mips64p32
mips64p32lemips64p32le
mipsle✅mipsle
ppcppc
ppc64✅ppc64
ppc64le✅ppc64le
riscvriscv
riscv64✅riscv64
s390s390
s390x✅s390x
sparcsparc
sparc64(γ)sparc64
wasm✅wasm
androiddarwiniosjslinuxwindows

Support Grid 2

adfhimnopsz
386✅✅✅✅386
amd64✅✅✅✅✅✅✅amd64
amd64p32amd64p32
arm✅✅✅✅arm
arm64✅✅✅arm64
arm64bearm64be
armbearmbe
loong64loong64
mipsmips
mips64✅mips64
mips64lemips64le
mips64p32mips64p32
mips64p32lemips64p32le
mipslemipsle
ppcppc
ppc64✅ppc64
ppc64leppc64le
riscvriscv
riscv64riscv64
s390s390
s390xs390x
sparcsparc
sparc64sparc64
wasmwasm
adfhimnopsz

Key

a = aix, d = dragonfly, f = freebsd, h = hurd, i = illumos, m = nacl, n = netbsd, o = openbsd, p = plan9, s = solaris, z = zos

✅: Supported (out of the box)

☑️: Supported (with the help of a C compiler, etc.)

(blank): Unsupported

α1:

# command-line-arguments
loadinternal: cannot find runtime/cgo
/usr/local/go/pkg/tool/darwin_amd64/link: running clang failed: exit status 1
clang: warning: argument unused during compilation: '-pie' [-Wunused-command-line-argument]
ld: unknown option: -z
clang: error: linker command failed with exit code 1 (use -v to see invocation)

α2:

# command-line-arguments
loadinternal: cannot find runtime/cgo
/usr/local/go/pkg/tool/darwin_amd64/link: running clang failed: exit status 1
ld: unknown option: -z
clang: error: linker command failed with exit code 1 (use -v to see invocation)

β:

# command-line-arguments
loadinternal: cannot find runtime/cgo
/usr/local/go/pkg/tool/darwin_amd64/link: running clang failed: exit status 1
ld: warning: ignoring file /var/folders/dd/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/T/go-link-xxxxxxxxxx/go.o, building for macOS-x86_64 but attempting to link with file built for unknown-arm64
Undefined symbols for architecture x86_64:
  "_main", referenced from:
     implicit entry/start for main executable
ld: symbol(s) not found for architecture x86_64
clang: error: linker command failed with exit code 1 (use -v to see invocation)

γ:

go tool compile: exit status 2
compile: unknown architecture "sparc64"

NOTE

The nacl GOOS was dropped since go version 1.14

The amd64p32 GOARCH, which is related to the nacl GOOS, was also dropped since go version 1.14 (I believe that mips64p32 and mips64p32le are also related, but I could not find any reference)

Reference: https://golang.org/doc/go1.14#nacl

NOTE

The darwin/386 port was dropped since go version 1.15

Reference: https://golang.org/doc/go1.15#darwin

NOTE

On before go version 1.16:

  • darwin/amd64 means macOS
  • darwin/arm64 means iOS

With the introduction of Apple Silicon (a.k.a. the M1 chip), on go version 1.16 or later:

  • darwin/amd64 means macOS with Intel CPU
  • darwin/arm64 updates to mean macOS with Apple Silicon CPU
  • ios/amd64 is the new port for iOS Simulator on macOS with Intel CPU
  • ios/arm64 is the new port for iOS

Reference: https://golang.org/doc/go1.16#darwin