ziglang/zig

Fork 273

Code Issues 154 Pull requests 83 Activity Actions 7

Tracking Issue: Tier System #30003

New issue

Open

opened 2025年11月27日 02:24:40 +01:00 by alexrp · 0 comments

alexrp commented

2025年11月27日 02:24:40 +01:00

Owner

Copy link

This issue serves as an overview of the current status of Zig's target support. Each target is categorized based on its current tier.

Tier 1

Criteria

All non-experimental language features are known to work correctly.
The compiler can generate machine code for this target without relying on LLVM.
The CI machines automatically run the module tests for this target on every push.

Targets

Linux

x86_64-linux - https://github.com/ziglang/zig/issues/23079

Tier 2

Criteria

The standard library's cross-platform abstractions have implementations for this target.
This target has debug info capabilities and therefore produces stack traces on failed assertions and crashes.
libc is available for this target even when cross-compiling.
The CI machines automatically build the module tests for this target on every push.

Targets

Tier 3

Criteria

The compiler can generate machine code for this target by relying on an external backend such as LLVM.
The linker can produce object files, libraries, and executables for this target.

Targets

Darwin

aarch64-ios - https://github.com/ziglang/zig/issues/23782
aarch64-tvos - https://github.com/ziglang/zig/issues/23784
aarch64-visionos - https://github.com/ziglang/zig/issues/23786
aarch64-watchos - https://github.com/ziglang/zig/issues/23788
aarch64-watchos-ilp32 - https://github.com/ziglang/zig/issues/25732

DragonFly BSD

x86_64-dragonfly - https://github.com/ziglang/zig/issues/7149

FreeBSD

loongarch64-freebsd - https://github.com/ziglang/zig/issues/24877

Fuchsia

aarch64-fuchsia - https://github.com/ziglang/zig/issues/23682
riscv64-fuchsia - https://github.com/ziglang/zig/issues/23683
x86_64-fuchsia - https://github.com/ziglang/zig/issues/7150

GNU/Hurd

aarch64-hurd - https://github.com/ziglang/zig/issues/25483
x86-hurd - https://github.com/ziglang/zig/issues/25484
x86_64-hurd - https://github.com/ziglang/zig/issues/25482

Haiku

aarch64-haiku - https://github.com/ziglang/zig/issues/23755
arm-haiku - https://github.com/ziglang/zig/issues/23756
powerpc-haiku - https://github.com/ziglang/zig/issues/23758
riscv64-haiku - https://github.com/ziglang/zig/issues/23759
x86-haiku - https://github.com/ziglang/zig/issues/23761
x86_64-haiku - https://github.com/ziglang/zig/issues/7691

illumos

x86-illumos - https://github.com/ziglang/zig/issues/23689
x86_64-illumos - https://github.com/ziglang/zig/issues/7152

Linux

loongarch32-linux - https://github.com/ziglang/zig/issues/23696
mips64(el)-linux-(gnu,musl)abin32 - https://github.com/ziglang/zig/issues/21712
x86_64-linux-(gnu,musl)x32 - https://github.com/ziglang/zig/issues/21711

NetBSD

mips64(el)-netbsd - https://github.com/ziglang/zig/issues/23765
riscv32-netbsd - https://github.com/ziglang/zig/issues/23768
riscv64-netbsd - https://github.com/ziglang/zig/issues/23769

OpenBSD

loongarch64-openbsd - https://github.com/ziglang/zig/issues/24678

SerenityOS

aarch64-serenity - https://github.com/ziglang/zig/issues/23686
riscv64-serenity - https://github.com/ziglang/zig/issues/23687
x86_64-serenity - https://github.com/ziglang/zig/issues/23688

WASI

wasm64-wasi - https://github.com/ziglang/zig/issues/23092

Windows

thumb-windows - https://github.com/ziglang/zig/issues/24017

Tier 4

Criteria

The compiler can generate assembly or C source code for this target.

Targets

Haiku

m68k-haiku - https://github.com/ziglang/zig/issues/23757
sparc64-haiku - https://github.com/ziglang/zig/issues/23760

Linux

alpha-linux - https://github.com/ziglang/zig/issues/25671
arc(eb)-linux - https://github.com/ziglang/zig/issues/23086
csky-linux - https://github.com/ziglang/zig/issues/23087
hppa-linux - https://github.com/ziglang/zig/issues/25672
kvx-linux - https://github.com/ziglang/zig/issues/25884
kvx-linux-(musl)ilp32 - https://github.com/ziglang/zig/issues/25885
m68k-linux - https://github.com/ziglang/zig/issues/23089
microblaze(el)-linux - https://github.com/ziglang/zig/issues/25670
sh(eb)-linux - https://github.com/ziglang/zig/issues/25669
sparc-linux - https://github.com/ziglang/zig/issues/23081
sparc64-linux - https://github.com/ziglang/zig/issues/4931
xtensa(eb)-linux - https://github.com/ziglang/zig/issues/23088

NetBSD

alpha-netbsd - https://github.com/ziglang/zig/issues/25673
hppa-netbsd - https://github.com/ziglang/zig/issues/25674
m68k-netbsd - https://github.com/ziglang/zig/issues/23090
sh(eb)-netbsd - https://github.com/ziglang/zig/issues/25675
sparc-netbsd - https://github.com/ziglang/zig/issues/23770
sparc64-netbsd - https://github.com/ziglang/zig/issues/23771

OpenBSD

alpha-openbsd - https://github.com/ziglang/zig/issues/25676
hppa-openbsd - https://github.com/ziglang/zig/issues/25677
sh-openbsd - https://github.com/ziglang/zig/issues/25678
sparc64-openbsd - https://github.com/ziglang/zig/issues/23779

Plan 9

x86_64-plan9 - https://github.com/ziglang/zig/issues/7153

Unsupported

Criteria

These are targets that Zig has either chosen to never add support for, or has dropped existing support for.

Targets

AIX

powerpc-aix - https://github.com/ziglang/zig/issues/23694
powerpc64-aix - https://github.com/ziglang/zig/issues/23695

Darwin

aarch64-bridgeos - https://github.com/ziglang/zig/issues/23684
arm-watchos - https://github.com/ziglang/zig/issues/23671
x86-macos - https://github.com/ziglang/zig/issues/1930
x86_64-ios - https://github.com/ziglang/zig/issues/23783
x86_64-tvos - https://github.com/ziglang/zig/issues/23785
x86_64-visionos - https://github.com/ziglang/zig/issues/23787
x86_64-watchos - https://github.com/ziglang/zig/issues/23789

FreeBSD

mips(64)(el)-freebsd - https://github.com/ziglang/zig/issues/23680
powerpc-freebsd - https://github.com/ziglang/zig/issues/23681
thumb-freebsd - https://github.com/ziglang/zig/issues/23697
x86-freebsd - https://github.com/ziglang/zig/issues/23677

GNU/kFreeBSD

x86-kfreebsd - https://github.com/ziglang/zig/issues/23669
x86_64-kfreebsd - https://github.com/ziglang/zig/issues/23670

NetBSD

powerpc64-netbsd - https://github.com/ziglang/zig/issues/23767

Solaris

sparc64-solaris - https://github.com/ziglang/zig/issues/23093
x86_64-solaris - https://github.com/ziglang/zig/issues/7151

z/OS

s390x-zos - https://github.com/ziglang/zig/issues/23693

Zig's level of support for various targets is broadly categorized into four tiers with Tier 1 being the highest. The goal is for Tier 1 targets to have zero disabled tests - this will become a requirement for post-1.0.0 Zig releases. This issue serves as an overview of the current status of Zig's target support. Each target is categorized based on its current tier. ## Tier 1 ### Criteria * All non-experimental language features are known to work correctly. * The compiler can generate machine code for this target without relying on LLVM. * The CI machines automatically run the module tests for this target on every push. ### Targets #### Linux * `x86_64-linux` - https://github.com/ziglang/zig/issues/23079 ## Tier 2 ### Criteria * The standard library's cross-platform abstractions have implementations for this target. * This target has debug info capabilities and therefore produces stack traces on failed assertions and crashes. * libc is available for this target even when cross-compiling. * The CI machines automatically build the module tests for this target on every push. ### Targets #### Darwin * `aarch64-maccatalyst` - https://github.com/ziglang/zig/issues/25932 * `aarch64-macos` - https://github.com/ziglang/zig/issues/23078 * `x86_64-maccatalyst` - https://github.com/ziglang/zig/issues/25933 * `x86_64-macos` - https://github.com/ziglang/zig/issues/4897 #### FreeBSD * `aarch64-freebsd` - https://github.com/ziglang/zig/issues/3939 * `arm-freebsd` - https://github.com/ziglang/zig/issues/23675 * `powerpc64(le)-freebsd` - https://github.com/ziglang/zig/issues/23678 * `riscv64-freebsd` - https://github.com/ziglang/zig/issues/23676 * `x86_64-freebsd` - https://github.com/ziglang/zig/issues/1759 #### Linux * `aarch64(_be)-linux` - https://github.com/ziglang/zig/issues/2443 * `arm(eb)-linux` - https://github.com/ziglang/zig/issues/3174 * `hexagon-linux` - https://github.com/ziglang/zig/issues/21652 * `loongarch64-linux` - https://github.com/ziglang/zig/issues/21646 * `mips(el)-linux` - https://github.com/ziglang/zig/issues/3345 * `mips64(el)-linux` - https://github.com/ziglang/zig/issues/21647 * `powerpc-linux` - https://github.com/ziglang/zig/issues/21649 * `powerpc64(le)-linux` - https://github.com/ziglang/zig/issues/21651 * `riscv32-linux` - https://github.com/ziglang/zig/issues/21648 * `riscv64-linux` - https://github.com/ziglang/zig/issues/4456 * `s390x-linux` - https://github.com/ziglang/zig/issues/21402 * `thumb(eb)-linux` - https://github.com/ziglang/zig/issues/23672 * `x86-linux` - https://github.com/ziglang/zig/issues/1929 #### NetBSD * `aarch64(_be)-netbsd` - https://github.com/ziglang/zig/issues/23084 * `arm(eb)-netbsd` - https://github.com/ziglang/zig/issues/23763 * `mips(el)-netbsd` - https://github.com/ziglang/zig/issues/23764 * `powerpc-netbsd` - https://github.com/ziglang/zig/issues/23766 * `x86-netbsd` - https://github.com/ziglang/zig/issues/23772 * `x86_64-netbsd` - https://github.com/ziglang/zig/issues/23082 #### OpenBSD * `aarch64-openbsd` - https://github.com/ziglang/zig/issues/23085 * `arm-openbsd` - https://github.com/ziglang/zig/issues/23773 * `mips64(el)-openbsd` - https://github.com/ziglang/zig/issues/23774 * `powerpc-openbsd` - https://github.com/ziglang/zig/issues/23775 * `powerpc64-openbsd` - https://github.com/ziglang/zig/issues/23776 * `riscv64-openbsd` - https://github.com/ziglang/zig/issues/23777 * `x86-openbsd` - https://github.com/ziglang/zig/issues/23778 * `x86_64-openbsd` - https://github.com/ziglang/zig/issues/2016 #### WASI * `wasm32-wasi` - https://github.com/ziglang/zig/issues/23091 #### Windows * `aarch64-windows` - https://github.com/ziglang/zig/issues/16665 * `x86-windows` - https://github.com/ziglang/zig/issues/537 * `x86_64-windows` - https://github.com/ziglang/zig/issues/23080 ## Tier 3 ### Criteria * The compiler can generate machine code for this target by relying on an external backend such as LLVM. * The linker can produce object files, libraries, and executables for this target. ### Targets #### Darwin * `aarch64-ios` - https://github.com/ziglang/zig/issues/23782 * `aarch64-tvos` - https://github.com/ziglang/zig/issues/23784 * `aarch64-visionos` - https://github.com/ziglang/zig/issues/23786 * `aarch64-watchos` - https://github.com/ziglang/zig/issues/23788 * `aarch64-watchos-ilp32` - https://github.com/ziglang/zig/issues/25732 #### DragonFly BSD * `x86_64-dragonfly` - https://github.com/ziglang/zig/issues/7149 #### FreeBSD * `loongarch64-freebsd` - https://github.com/ziglang/zig/issues/24877 #### Fuchsia * `aarch64-fuchsia` - https://github.com/ziglang/zig/issues/23682 * `riscv64-fuchsia` - https://github.com/ziglang/zig/issues/23683 * `x86_64-fuchsia` - https://github.com/ziglang/zig/issues/7150 #### GNU/Hurd * `aarch64-hurd` - https://github.com/ziglang/zig/issues/25483 * `x86-hurd` - https://github.com/ziglang/zig/issues/25484 * `x86_64-hurd` - https://github.com/ziglang/zig/issues/25482 #### Haiku * `aarch64-haiku` - https://github.com/ziglang/zig/issues/23755 * `arm-haiku` - https://github.com/ziglang/zig/issues/23756 * `powerpc-haiku` - https://github.com/ziglang/zig/issues/23758 * `riscv64-haiku` - https://github.com/ziglang/zig/issues/23759 * `x86-haiku` - https://github.com/ziglang/zig/issues/23761 * `x86_64-haiku` - https://github.com/ziglang/zig/issues/7691 #### illumos * `x86-illumos` - https://github.com/ziglang/zig/issues/23689 * `x86_64-illumos` - https://github.com/ziglang/zig/issues/7152 #### Linux * `loongarch32-linux` - https://github.com/ziglang/zig/issues/23696 * `mips64(el)-linux-(gnu,musl)abin32` - https://github.com/ziglang/zig/issues/21712 * `x86_64-linux-(gnu,musl)x32` - https://github.com/ziglang/zig/issues/21711 #### NetBSD * `mips64(el)-netbsd` - https://github.com/ziglang/zig/issues/23765 * `riscv32-netbsd` - https://github.com/ziglang/zig/issues/23768 * `riscv64-netbsd` - https://github.com/ziglang/zig/issues/23769 #### OpenBSD * `loongarch64-openbsd` - https://github.com/ziglang/zig/issues/24678 #### SerenityOS * `aarch64-serenity` - https://github.com/ziglang/zig/issues/23686 * `riscv64-serenity` - https://github.com/ziglang/zig/issues/23687 * `x86_64-serenity` - https://github.com/ziglang/zig/issues/23688 #### WASI * `wasm64-wasi` - https://github.com/ziglang/zig/issues/23092 #### Windows * `thumb-windows` - https://github.com/ziglang/zig/issues/24017 ## Tier 4 ### Criteria * The compiler can generate assembly or C source code for this target. ### Targets #### Haiku * `m68k-haiku` - https://github.com/ziglang/zig/issues/23757 * `sparc64-haiku` - https://github.com/ziglang/zig/issues/23760 #### Linux * `alpha-linux` - https://github.com/ziglang/zig/issues/25671 * `arc(eb)-linux` - https://github.com/ziglang/zig/issues/23086 * `csky-linux` - https://github.com/ziglang/zig/issues/23087 * `hppa-linux` - https://github.com/ziglang/zig/issues/25672 * `kvx-linux` - https://github.com/ziglang/zig/issues/25884 * `kvx-linux-(musl)ilp32` - https://github.com/ziglang/zig/issues/25885 * `m68k-linux` - https://github.com/ziglang/zig/issues/23089 * `microblaze(el)-linux` - https://github.com/ziglang/zig/issues/25670 * `sh(eb)-linux` - https://github.com/ziglang/zig/issues/25669 * `sparc-linux` - https://github.com/ziglang/zig/issues/23081 * `sparc64-linux` - https://github.com/ziglang/zig/issues/4931 * `xtensa(eb)-linux` - https://github.com/ziglang/zig/issues/23088 #### NetBSD * `alpha-netbsd` - https://github.com/ziglang/zig/issues/25673 * `hppa-netbsd` - https://github.com/ziglang/zig/issues/25674 * `m68k-netbsd` - https://github.com/ziglang/zig/issues/23090 * `sh(eb)-netbsd` - https://github.com/ziglang/zig/issues/25675 * `sparc-netbsd` - https://github.com/ziglang/zig/issues/23770 * `sparc64-netbsd` - https://github.com/ziglang/zig/issues/23771 #### OpenBSD * `alpha-openbsd` - https://github.com/ziglang/zig/issues/25676 * `hppa-openbsd` - https://github.com/ziglang/zig/issues/25677 * `sh-openbsd` - https://github.com/ziglang/zig/issues/25678 * `sparc64-openbsd` - https://github.com/ziglang/zig/issues/23779 #### Plan 9 * `x86_64-plan9` - https://github.com/ziglang/zig/issues/7153 ## Unsupported ### Criteria * These are targets that Zig has either chosen to never add support for, or has dropped existing support for. ### Targets #### AIX * `powerpc-aix` - https://github.com/ziglang/zig/issues/23694 * `powerpc64-aix` - https://github.com/ziglang/zig/issues/23695 #### Darwin * `aarch64-bridgeos` - https://github.com/ziglang/zig/issues/23684 * `arm-watchos` - https://github.com/ziglang/zig/issues/23671 * `x86-macos` - https://github.com/ziglang/zig/issues/1930 * `x86_64-ios` - https://github.com/ziglang/zig/issues/23783 * `x86_64-tvos` - https://github.com/ziglang/zig/issues/23785 * `x86_64-visionos` - https://github.com/ziglang/zig/issues/23787 * `x86_64-watchos` - https://github.com/ziglang/zig/issues/23789 #### FreeBSD * `mips(64)(el)-freebsd` - https://github.com/ziglang/zig/issues/23680 * `powerpc-freebsd` - https://github.com/ziglang/zig/issues/23681 * `thumb-freebsd` - https://github.com/ziglang/zig/issues/23697 * `x86-freebsd` - https://github.com/ziglang/zig/issues/23677 #### GNU/kFreeBSD * `x86-kfreebsd` - https://github.com/ziglang/zig/issues/23669 * `x86_64-kfreebsd` - https://github.com/ziglang/zig/issues/23670 #### NetBSD * `powerpc64-netbsd` - https://github.com/ziglang/zig/issues/23767 #### Solaris * `sparc64-solaris` - https://github.com/ziglang/zig/issues/23093 * `x86_64-solaris` - https://github.com/ziglang/zig/issues/7151 #### z/OS * `s390x-zos` - https://github.com/ziglang/zig/issues/23693

👍 4 👀 3

alexrp added the

tier system

label

2025年11月27日 02:24:40 +01:00

alexrp pinned this

2025年11月27日 02:24:48 +01:00

alexrp locked and limited conversation to collaborators

2025年11月27日 03:07:30 +01:00

alexrp removed the

tier system

label

2025年11月28日 16:01:08 +01:00

This discussion has been locked. Commenting is limited to contributors.

No Branch/Tag specified

Branches Tags

master

mmap

riscv-ci-2

riscv-ci

test-no-bin

poll

io-uring-update

llvm22

poll-ring

debug-file-leaks-differently

debug-file-leaks

hate-letter-to-std.os

i-am-a-foolish-fool

ProcessPrng

elfv2-dyn

jobserver

threadtheft

io-threaded-no-queue

0.15.x

Io.net

comptime-allocator

restricted-function-pointers

cli

wasm-linker-writer

wrangle-writer-buffering

sha1-stream

async-await-demo

fixes

0.14.x

ast-node-methods

spork8

macos-debug-info

make-vs-configure

fuzz-macos

main

sans-aro

ArrayList-reserve

incr-bug

llvm-ir-nosanitize-metadata

ci-tarballs

ci-scripts

threadpool

0.12.x

new-pkg-hash

json-diagnostics

more-doctests

rework-comptime-mutation

0.11.x

ci-perf-comment

stage2-async

0.10.x

autofix

0.9.x

aro

hcs

0.8.x

0.7.x

Labels

Clear labels

This proposal is planned.

The web application for interactive documentation and generation of its assets.

backend/c

The C backend outputs C source code.

backend/llvm

The LLVM backend outputs an LLVM bitcode module.

backend/self-hosted

The self-hosted backends produce machine code directly.

binutils

Zig's included binary utilities: zig ar, zig dlltool, zig lib, zig ranlib, zig objcopy, and zig rc.

breaking

Implementing this issue could cause existing code to no longer compile or have different behavior.

build system

The Zig build system - zig build, std.Build, the build runner, and package management.

debug info

docs

An issue with documentation, e.g. the language reference or standard library doc comments.

error message

This issue points out an error message that is unhelpful and should be improved.

frontend

Tokenization, parsing, AstGen, ZonGen, Sema, Legalize, and Liveness.

fuzzing

incremental

Reuse of internal compiler state for faster compilation.

lib/c

This issue relates to Zig's libc implementation and/or vendored libcs.

lib/compiler-rt

This issue relates to Zig's compiler-rt library.

lib/cxx

This issue relates to Zig's vendored libc++ and/or libc++abi.

lib/std

This issue relates to Zig's standard library.

lib/tsan

This issue relates to Zig's vendored libtsan.

lib/ubsan-rt

This issue relates to Zig's ubsan-rt library.

lib/unwind

This issue relates to Zig's vendored libunwind.

linking

Zig's integrated object file and incremental linker.

miscompilation

The compiler reports success but produces semantically incorrect code.

This issue suggests modifications. If it also has the "accepted" label then it is planned.

release notes

This issue or pull request should be mentioned in the release notes.

testing

This issue is related to testing the compiler, standard library, or other parts of Zig.

tier system

This issue tracks the support tier for a target.

zig cc

Zig as a drop-in C-family compiler.

zig fmt

The Zig source code formatter.

bounty

https://ziglang.org/news/announcing-donor-bounties

bug

Observed behavior contradicts documented or intended behavior.

contributor-friendly

This issue is limited in scope and/or knowledge of project internals.

downstream

An issue with a third-party project that uses this project.

enhancement

Solving this issue will likely involve adding new logic or components to the codebase.

infra

optimization

A task to improve performance and/or resource usage.

question

No questions on the issue tracker; use a community space instead.

regression

A bug that did not occur in a previous version.

upstream

An issue with a third-party project that this project uses.

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

ziglang/zig#30003

No description provided.

Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?