Support-Tiers: clarify OCLP tiers based on CPU generation

This commit is contained in:
Patrick Linnane 2025-04-13 09:40:09 -07:00
parent cb5a375d07
commit 9754d5f79d
No known key found for this signature in database

View File

@ -4,8 +4,7 @@ last_review_date: "2025-04-12"
# Support Tiers # Support Tiers
Homebrew has three support tiers. Homebrew has three support tiers. These tiers set expectations for how well Homebrew will run on a given configuration.
These set expectations for how well Homebrew will run on a given configuration.
## Tier 1 ## Tier 1
@ -28,7 +27,7 @@ For Tier 1 support, Homebrew on macOS must be all of:
- installed in the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Intel x86_64) - installed in the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Intel x86_64)
- running on a supported architecture (i.e. Apple Silicon or Intel x86_64) - running on a supported architecture (i.e. Apple Silicon or Intel x86_64)
- not building official packages from source - not building official packages from source
- installed on your Mac's built-in hard-drive (i.e. not external/removable storage) - installed on your Mac's built-in hard drive (i.e. not external/removable storage)
- you have `sudo` access on your system - you have `sudo` access on your system
- the Xcode Command Line Tools are installed and fully up-to-date - the Xcode Command Line Tools are installed and fully up-to-date
@ -39,7 +38,7 @@ For Tier 1 support, Homebrew on Linux must be all of:
- running on Ubuntu or a Homebrew-provided Docker image - running on Ubuntu or a Homebrew-provided Docker image
- have a system `glibc` >= 2.35 - have a system `glibc` >= 2.35
- have a Linux kernel >= 3.2 - have a Linux kernel >= 3.2
- if running Ubuntu, running an Ubuntu version in "standard support": <https://ubuntu.com/about/release-cycle> - if running Ubuntu, using an Ubuntu version in "standard support": <https://ubuntu.com/about/release-cycle>
- installed in the default prefix (i.e. `/home/linuxbrew/.linuxbrew`) - installed in the default prefix (i.e. `/home/linuxbrew/.linuxbrew`)
- running on a supported architecture (i.e. Intel x86_64) - running on a supported architecture (i.e. Intel x86_64)
- not building official packages from source - not building official packages from source
@ -59,11 +58,11 @@ A Tier 2 supported configuration is one in which any of:
Tier 2 configurations include: Tier 2 configurations include:
- macOS prereleases before we state they are Tier 1 (e.g. in March 2025, macOS 16, whatever it ends up being called) - macOS prereleases before we state they are Tier 1 (e.g. in March 2025, macOS 16, whatever it ends up being called)
- Linux versions where a system `glibc` < 2.35 (but still >= 2.13), so the Homebrew `glibc` formula is automatically installed - Linux versions with a system `glibc` version < 2.35 (but >= 2.13), requiring the Homebrew `glibc` formula to be installed automatically
- using official packages that need to be built from source due to installing Homebrew outside the default prefix - using official packages that need to be built from source due to installing Homebrew outside the default prefix
(i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux) (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux)
- running on a not-yet-supported architecture (i.e. Linux ARM64/AARCH64) - running on a not-yet-supported architecture (i.e. Linux ARM64/AARCH64)
- devices using OpenCore Legacy Patcher - devices using OpenCore Legacy Patcher with a Westmere or newer Intel CPU
## Tier 3 ## Tier 3
@ -86,6 +85,7 @@ Tier 3 configurations include:
- installing Homebrew outside the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux) - installing Homebrew outside the default prefix (i.e. `/opt/homebrew` on Apple Silicon, `/usr/local` on Apple Intel x86_64, `/home/linuxbrew/.linuxbrew` for Linux)
- installing formulae using `--HEAD` - installing formulae using `--HEAD`
- installing deprecated or disabled formulae - installing deprecated or disabled formulae
- devices using OpenCore Legacy Patcher with an Intel CPU older than Westmere
## Unsupported ## Unsupported
@ -105,7 +105,7 @@ Unsupported configurations include:
## Unsupported Software ## Unsupported Software
Note that all packages installed from third-party taps outside of the Homebrew GitHub organisation are unsupported by default. All packages installed from third-party taps outside of the Homebrew GitHub organisation are unsupported by default.
We may assist the maintainers/contributors/developers of such packages to fix bugs with the Homebrew formula/cask/tap system, but we are not responsible for resolving issues when using that software. We may assist the maintainers/contributors/developers of such packages to fix bugs with the Homebrew formula/cask/tap system, but we are not responsible for resolving issues when using that software.