src/doc/rustc/src/platform-support.md

   1 # Platform Support
   2
   3 <style type="text/css">
   4     td code {
   5         white-space: nowrap;
   6     }
   7 </style>
   8
   9 Support for different platforms are organized into three tiers, each with a
  10 different set of guarantees.
  11
  12 Platforms are identified by their "target triple" which is the string to
  13 inform the compiler what kind of output should be produced. The columns in the
  14 tables below have the following meanings:
  15
  16 * std:
  17     * ✓ indicates the full standard library is available.
  18     * \* indicates the target only supports [`no_std`] development.
  19     * ? indicates the standard library support is unknown or a work-in-progress.
  20 * host: A ✓ indicates that `rustc` and `cargo` can run on the host platform.
  21
  22 [`no_std`]: https://rust-embedded.github.io/book/intro/no-std.html
  23
  24 ## Tier 1
  25
  26 Tier 1 platforms can be thought of as "guaranteed to work".
  27 Specifically they will each satisfy the following requirements:
  28
  29 * Official binary releases are provided for the platform.
  30 * Automated testing is set up to run tests for the platform.
  31 * Landing changes to the `rust-lang/rust` repository's master branch is gated
  32   on tests passing.
  33 * Documentation for how to use and how to build the platform is available.
  34
  35 target | std | host | notes
  36 -------|-----|------|-------
  37 `aarch64-unknown-linux-gnu` | ✓ | ✓ | ARM64 Linux (kernel 4.2, glibc 2.17+) [^missing-stack-probes]
  38 `i686-pc-windows-gnu` | ✓ | ✓ | 32-bit MinGW (Windows 7+)
  39 `i686-pc-windows-msvc` | ✓ | ✓ | 32-bit MSVC (Windows 7+)
  40 `i686-unknown-linux-gnu` | ✓ | ✓ | 32-bit Linux (kernel 2.6.32+, glibc 2.11+)
  41 `x86_64-apple-darwin` | ✓ | ✓ | 64-bit macOS (10.7+, Lion+)
  42 `x86_64-pc-windows-gnu` | ✓ | ✓ | 64-bit MinGW (Windows 7+)
  43 `x86_64-pc-windows-msvc` | ✓ | ✓ | 64-bit MSVC (Windows 7+)
  44 `x86_64-unknown-linux-gnu` | ✓ | ✓ | 64-bit Linux (kernel 2.6.32+, glibc 2.11+)
  45
  46 [^missing-stack-probes]: Stack probes support is missing on
  47   `aarch64-unknown-linux-gnu`, but it's planned to be implemented in the near
  48   future. The implementation is tracked on [issue #77071][77071].
  49
  50 [77071]: https://github.com/rust-lang/rust/issues/77071
  51
  52 ## Tier 2
  53
  54 Tier 2 platforms can be thought of as "guaranteed to build". Automated tests
  55 are not run so it's not guaranteed to produce a working build, but platforms
  56 often work to quite a good degree and patches are always welcome!
  57 Specifically, these platforms are required to have each of the following:
  58
  59 * Official binary releases are provided for the platform.
  60 * Automated building is set up, but may not be running tests.
  61 * Landing changes to the `rust-lang/rust` repository's master branch is gated on
  62     platforms **building**. For some platforms only the standard library is
  63     compiled, but for others `rustc` and `cargo` are too.
  64
  65 target | std | host | notes
  66 -------|-----|------|-------
  67 `aarch64-apple-darwin` | ✓ | ✓ | ARM64 macOS (11.0+, Big Sur+)
  68 `aarch64-apple-ios` | ✓ |  | ARM64 iOS
  69 `aarch64-fuchsia` | ✓ |  | ARM64 Fuchsia
  70 `aarch64-linux-android` | ✓ |  | ARM64 Android
  71 `aarch64-pc-windows-msvc` | ✓ | ✓ | ARM64 Windows MSVC
  72 `aarch64-unknown-linux-musl` | ✓ | ✓ | ARM64 Linux with MUSL
  73 `aarch64-unknown-none` | * |  | Bare ARM64, hardfloat
  74 `aarch64-unknown-none-softfloat` | * |  | Bare ARM64, softfloat
  75 `arm-linux-androideabi` | ✓ |  | ARMv7 Android
  76 `arm-unknown-linux-gnueabi` | ✓ | ✓ | ARMv6 Linux (kernel 3.2, glibc 2.17)
  77 `arm-unknown-linux-gnueabihf` | ✓ | ✓ | ARMv6 Linux, hardfloat (kernel 3.2, glibc 2.17)
  78 `arm-unknown-linux-musleabi` | ✓ |  | ARMv6 Linux with MUSL
  79 `arm-unknown-linux-musleabihf` | ✓ |  | ARMv6 Linux with MUSL, hardfloat
  80 `armebv7r-none-eabi` | * |  | Bare ARMv7-R, Big Endian
  81 `armebv7r-none-eabihf` | * |  | Bare ARMv7-R, Big Endian, hardfloat
  82 `armv5te-unknown-linux-gnueabi` | ✓ |  | ARMv5TE Linux (kernel 4.4, glibc 2.23)
  83 `armv5te-unknown-linux-musleabi` | ✓ |  | ARMv5TE Linux with MUSL
  84 `armv7-linux-androideabi` | ✓ |  | ARMv7a Android
  85 `armv7a-none-eabi` | * |  | Bare ARMv7-A
  86 `armv7r-none-eabi` | * |  | Bare ARMv7-R
  87 `armv7r-none-eabihf` | * |  | Bare ARMv7-R, hardfloat
  88 `armv7-unknown-linux-gnueabi` | ✓ |   | ARMv7 Linux (kernel 4.15, glibc 2.27)
  89 `armv7-unknown-linux-gnueabihf` | ✓ | ✓ | ARMv7 Linux, hardfloat (kernel 3.2, glibc 2.17)
  90 `armv7-unknown-linux-musleabi` | ✓ |   | ARMv7 Linux, MUSL
  91 `armv7-unknown-linux-musleabihf` | ✓ |  | ARMv7 Linux with MUSL
  92 `asmjs-unknown-emscripten` | ✓ |  | asm.js via Emscripten
  93 `i586-pc-windows-msvc` | ✓ |  | 32-bit Windows w/o SSE
  94 `i586-unknown-linux-gnu` | ✓ |  | 32-bit Linux w/o SSE (kernel 4.4, glibc 2.23)
  95 `i586-unknown-linux-musl` | ✓ |  | 32-bit Linux w/o SSE, MUSL
  96 `i686-linux-android` | ✓ |  | 32-bit x86 Android
  97 `i686-unknown-freebsd` | ✓ |  | 32-bit FreeBSD
  98 `i686-unknown-linux-musl` | ✓ |  | 32-bit Linux with MUSL
  99 `mips-unknown-linux-gnu` | ✓ | ✓ | MIPS Linux (kernel 4.4, glibc 2.23)
 100 `mips-unknown-linux-musl` | ✓ |  | MIPS Linux with MUSL
 101 `mips64-unknown-linux-gnuabi64` | ✓ | ✓ | MIPS64 Linux, n64 ABI (kernel 4.4, glibc 2.23)
 102 `mips64-unknown-linux-muslabi64` | ✓ |  | MIPS64 Linux, n64 ABI, MUSL
 103 `mips64el-unknown-linux-gnuabi64` | ✓ | ✓ | MIPS64 (LE) Linux, n64 ABI (kernel 4.4, glibc 2.23)
 104 `mips64el-unknown-linux-muslabi64` | ✓ |  | MIPS64 (LE) Linux, n64 ABI, MUSL
 105 `mipsel-unknown-linux-gnu` | ✓ | ✓ | MIPS (LE) Linux (kernel 4.4, glibc 2.23)
 106 `mipsel-unknown-linux-musl` | ✓ |  | MIPS (LE) Linux with MUSL
 107 `nvptx64-nvidia-cuda` | ✓ |  | --emit=asm generates PTX code that [runs on NVIDIA GPUs]
 108 `powerpc-unknown-linux-gnu` | ✓ | ✓ | PowerPC Linux (kernel 2.6.32, glibc 2.11)
 109 `powerpc64-unknown-linux-gnu` | ✓ | ✓ | PPC64 Linux (kernel 2.6.32, glibc 2.11)
 110 `powerpc64le-unknown-linux-gnu` | ✓ | ✓ | PPC64LE Linux (kernel 3.10, glibc 2.17)
 111 `riscv32i-unknown-none-elf` | * |  | Bare RISC-V (RV32I ISA)
 112 `riscv32imac-unknown-none-elf` | * |  | Bare RISC-V (RV32IMAC ISA)
 113 `riscv32imc-unknown-none-elf` | * |  | Bare RISC-V (RV32IMC ISA)
 114 `riscv64gc-unknown-linux-gnu` | ✓ | ✓ | RISC-V Linux (kernel 4.20, glibc 2.29)
 115 `riscv64gc-unknown-none-elf` | * |  | Bare RISC-V (RV64IMAFDC ISA)
 116 `riscv64imac-unknown-none-elf` | * |  | Bare RISC-V (RV64IMAC ISA)
 117 `s390x-unknown-linux-gnu` | ✓ | ✓ | S390x Linux (kernel 2.6.32, glibc 2.11)
 118 `sparc64-unknown-linux-gnu` | ✓ |  | SPARC Linux (kernel 4.4, glibc 2.23)
 119 `sparcv9-sun-solaris` | ✓ |  | SPARC Solaris 10/11, illumos
 120 `thumbv6m-none-eabi` | * |  | Bare Cortex-M0, M0+, M1
 121 `thumbv7em-none-eabi` | * |  | Bare Cortex-M4, M7
 122 `thumbv7em-none-eabihf` | * |  | Bare Cortex-M4F, M7F, FPU, hardfloat
 123 `thumbv7m-none-eabi` | * |  | Bare Cortex-M3
 124 `thumbv7neon-linux-androideabi` | ✓ |  | Thumb2-mode ARMv7a Android with NEON
 125 `thumbv7neon-unknown-linux-gnueabihf` | ✓ |  | Thumb2-mode ARMv7a Linux with NEON (kernel 4.4, glibc 2.23)
 126 `thumbv8m.base-none-eabi` | * |  | ARMv8-M Baseline
 127 `thumbv8m.main-none-eabi` | * |  | ARMv8-M Mainline
 128 `thumbv8m.main-none-eabihf` | * |  | ARMv8-M Mainline, hardfloat
 129 `wasm32-unknown-emscripten` | ✓ |  | WebAssembly via Emscripten
 130 `wasm32-unknown-unknown` | ✓ |  | WebAssembly
 131 `wasm32-wasi` | ✓ |  | WebAssembly with WASI
 132 `x86_64-apple-ios` | ✓ |  | 64-bit x86 iOS
 133 `x86_64-fortanix-unknown-sgx` | ✓ |  | [Fortanix ABI] for 64-bit Intel SGX
 134 `x86_64-fuchsia` | ✓ |  | 64-bit Fuchsia
 135 `x86_64-linux-android` | ✓ |  | 64-bit x86 Android
 136 `x86_64-sun-solaris` | ✓ |  | 64-bit Solaris 10/11, illumos
 137 `x86_64-unknown-freebsd` | ✓ | ✓ | 64-bit FreeBSD
 138 `x86_64-unknown-illumos` | ✓ | ✓ | illumos
 139 `x86_64-unknown-linux-gnux32` | ✓ |  | 64-bit Linux (x32 ABI) (kernel 4.15, glibc 2.27)
 140 `x86_64-unknown-linux-musl` | ✓ | ✓ | 64-bit Linux with MUSL
 141 `x86_64-unknown-netbsd` | ✓ | ✓ | NetBSD/amd64
 142 `x86_64-unknown-redox` | ✓ |  | Redox OS
 143
 144 [Fortanix ABI]: https://edp.fortanix.com/
 145
 146 ## Tier 3
 147
 148 Tier 3 platforms are those which the Rust codebase has support for, but which
 149 are not built or tested automatically, and may not work. Official builds are
 150 not available.
 151
 152 target | std | host | notes
 153 -------|-----|------|-------
 154 `aarch64-apple-ios-macabi` | ? |  | Apple Catalyst on ARM64
 155 `aarch64-apple-ios-sim` | ? |  | Apple iOS Simulator on ARM64
 156 `aarch64-apple-tvos` | * |  | ARM64 tvOS
 157 `aarch64-unknown-freebsd` | ✓ | ✓ | ARM64 FreeBSD
 158 `aarch64-unknown-hermit` | ? |  |
 159 `aarch64-unknown-linux-gnu_ilp32` | ✓ | ✓ | ARM64 Linux (ILP32 ABI)
 160 `aarch64-unknown-netbsd` | ✓ | ✓ |
 161 `aarch64-unknown-openbsd` | ✓ | ✓ | ARM64 OpenBSD
 162 `aarch64-unknown-redox` | ? |  | ARM64 Redox OS
 163 `aarch64-uwp-windows-msvc` | ? |  |
 164 `aarch64-wrs-vxworks` | ? |  |
 165 `aarch64_be-unknown-linux-gnu` | ✓ | ✓ | ARM64 Linux (big-endian)
 166 `aarch64_be-unknown-linux-gnu_ilp32` | ✓ | ✓ | ARM64 Linux (big-endian, ILP32 ABI)
 167 `armv4t-unknown-linux-gnueabi` | ? |  |
 168 `armv5te-unknown-linux-uclibceabi` | ? |  | ARMv5TE Linux with uClibc
 169 `armv6-unknown-freebsd` | ✓ | ✓ | ARMv6 FreeBSD
 170 `armv6-unknown-netbsd-eabihf` | ? |  |
 171 `armv7-apple-ios` | ✓ |  | ARMv7 iOS, Cortex-a8
 172 `armv7-unknown-freebsd` | ✓ | ✓ | ARMv7 FreeBSD
 173 `armv7-unknown-netbsd-eabihf` | ✓ | ✓ |
 174 `armv7-wrs-vxworks-eabihf` | ? |  |
 175 `armv7a-none-eabihf` | * | | ARM Cortex-A, hardfloat
 176 `armv7s-apple-ios` | ✓ |  |
 177 `avr-unknown-gnu-atmega328` | ✗ |  | AVR. Requires `-Z build-std=core`
 178 `hexagon-unknown-linux-musl` | ? |  |
 179 `i386-apple-ios` | ✓ |  | 32-bit x86 iOS
 180 `i686-apple-darwin` | ✓ | ✓ | 32-bit macOS (10.7+, Lion+)
 181 `i686-pc-windows-msvc` | ✓ |  | 32-bit Windows XP support
 182 `i686-unknown-uefi` | ? |  | 32-bit UEFI
 183 `i686-unknown-haiku` | ✓ | ✓ | 32-bit Haiku
 184 `i686-unknown-netbsd` | ✓ | ✓ | NetBSD/i386 with SSE2
 185 `i686-unknown-openbsd` | ✓ | ✓ | 32-bit OpenBSD
 186 `i686-uwp-windows-gnu` | ? |  |
 187 `i686-uwp-windows-msvc` | ? |  |
 188 `i686-wrs-vxworks` | ? |  |
 189 `mips-unknown-linux-uclibc` | ✓ |  | MIPS Linux with uClibc
 190 `mipsel-unknown-linux-uclibc` | ✓ |  | MIPS (LE) Linux with uClibc
 191 `mipsel-unknown-none` | * |  | Bare MIPS (LE) softfloat
 192 `mipsel-sony-psp` | * |  | MIPS (LE) Sony PlayStation Portable (PSP)
 193 `mipsisa32r6-unknown-linux-gnu` | ? |  |
 194 `mipsisa32r6el-unknown-linux-gnu` | ? |  |
 195 `mipsisa64r6-unknown-linux-gnuabi64` | ? |  |
 196 `mipsisa64r6el-unknown-linux-gnuabi64` | ? |  |
 197 `msp430-none-elf` | * |  | 16-bit MSP430 microcontrollers
 198 `powerpc-unknown-linux-gnuspe` | ✓ |  | PowerPC SPE Linux
 199 `powerpc-unknown-linux-musl` | ? |  |
 200 `powerpc-unknown-netbsd` | ✓ | ✓ |
 201 `powerpc-wrs-vxworks` | ? |  |
 202 `powerpc-wrs-vxworks-spe` | ? |  |
 203 `powerpc64-unknown-freebsd` | ✓ | ✓ | PPC64 FreeBSD (ELFv1 and ELFv2)
 204 `powerpc64-unknown-linux-musl` | ? |  |
 205 `powerpc64-wrs-vxworks` | ? |  |
 206 `powerpc64le-unknown-linux-musl` | ? |  |
 207 `riscv64gc-unknown-linux-musl` |   |   | RISC-V Linux (kernel 4.20, musl 1.2.0)
 208 `riscv32gc-unknown-linux-gnu` |   |   | RISC-V Linux (kernel 5.4, glibc 2.33)
 209 `riscv32gc-unknown-linux-musl` |   |   | RISC-V Linux (kernel 5.4, musl + RISCV32 support patches)
 210 `s390x-unknown-linux-musl` |  |  | S390x Linux (kernel 2.6.32, MUSL)
 211 `sparc-unknown-linux-gnu` | ✓ |  | 32-bit SPARC Linux
 212 `sparc64-unknown-netbsd` | ✓ | ✓ | NetBSD/sparc64
 213 `sparc64-unknown-openbsd` | ? |  |
 214 `thumbv7a-pc-windows-msvc` | ? |  |
 215 `thumbv7a-uwp-windows-msvc` | ✓ |  |
 216 `thumbv7neon-unknown-linux-musleabihf` | ? |  | Thumb2-mode ARMv7a Linux with NEON, MUSL
 217 `thumbv4t-none-eabi` | * |  | ARMv4T T32
 218 `x86_64-apple-ios-macabi` | ✓ |  | Apple Catalyst on x86_64
 219 `x86_64-apple-tvos` | * | | x86 64-bit tvOS
 220 `x86_64-linux-kernel` | * |  | Linux kernel modules
 221 `x86_64-pc-solaris` | ? |  |
 222 `x86_64-pc-windows-msvc` | ✓ |  | 64-bit Windows XP support
 223 `x86_64-unknown-dragonfly` | ✓ | ✓ | 64-bit DragonFlyBSD
 224 `x86_64-unknown-haiku` | ✓ | ✓ | 64-bit Haiku
 225 `x86_64-unknown-hermit` | ? |  |
 226 `x86_64-unknown-hermit-kernel` | ? |  | HermitCore kernel
 227 `x86_64-unknown-l4re-uclibc` | ? |  |
 228 `x86_64-unknown-openbsd` | ✓ | ✓ | 64-bit OpenBSD
 229 `x86_64-unknown-uefi` | ? |  |
 230 `x86_64-uwp-windows-gnu` | ✓ |  |
 231 `x86_64-uwp-windows-msvc` | ✓ |  |
 232 `x86_64-wrs-vxworks` | ? |  |
 233
 234 [runs on NVIDIA GPUs]: https://github.com/japaric-archived/nvptx#targets