Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update RIDs for uniformity, remove unsupported OS #8710

Merged
merged 7 commits into from
Feb 23, 2019
105 changes: 31 additions & 74 deletions docs/core/rid-catalog.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: .NET Core Runtime IDentifier (RID) catalog
description: Learn about the Runtime IDentifier (RID) and how RIDs are used in .NET Core.
ms.date: 07/19/2018
ms.date: 02/22/2019
---
# .NET Core RID Catalog

Expand Down Expand Up @@ -29,7 +29,7 @@ RIDs that represent concrete operating systems usually follow this pattern: `[os

- `[architecture]` is the processor architecture. For example: `x86`, `x64`, `arm`, or `arm64`.

- `[additional qualifiers]` further differentiate different platforms. For example: `aot` or `corert`.
- `[additional qualifiers]` further differentiate different platforms. For example: `aot`.

## RID graph

Expand Down Expand Up @@ -76,22 +76,22 @@ There are some considerations about RIDs that you have to keep in mind when work
To be able to use RIDs, you have to know which RIDs exist. New values are added regularly to the platform.
For the latest and complete version, see the [runtime.json](https://github.com/dotnet/corefx/blob/master/pkg/Microsoft.NETCore.Platforms/runtime.json) file on CoreFX repo.

.NET Core 2.0 SDK introduces the concept of portable RIDs. They are new values added to the RID graph that aren't tied to a specific version or OS distribution. They're particularly useful when dealing with multiple Linux distros.
.NET Core 2.0 SDK introduces the concept of portable RIDs. They are new values added to the RID graph that aren't tied to a specific version or OS distribution and are the preferred choice when using .NET Core 2.0 and higher. They're particularly useful when dealing with multiple Linux distros since most distribution RIDs are mapped to the portable RIDs.

The following list shows the most common RIDs used for each OS. It doesn't cover `arm` or `corert` values.
The following list shows a small subset of the most common RIDs used for each OS.
ErikNoren marked this conversation as resolved.
Show resolved Hide resolved

## Windows RIDs

- Portable
- `win-x86`
Only common values are listed. For the latest and complete version, see the [runtime.json](https://github.com/dotnet/corefx/blob/master/pkg/Microsoft.NETCore.Platforms/runtime.json) file on CoreFX repo.

- Portable (.NET Core 2.0 or later versions)
- `win-x64`
ErikNoren marked this conversation as resolved.
Show resolved Hide resolved
- `win-x86`
- `win-arm`
- `win-arm64`
- Windows 7 / Windows Server 2008 R2
ErikNoren marked this conversation as resolved.
Show resolved Hide resolved
- `win7-x64`
- `win7-x86`
- Windows 8 / Windows Server 2012
- `win8-x64`
- `win8-x86`
- `win8-arm`
- Windows 8.1 / Windows Server 2012 R2
- `win81-x64`
- `win81-x86`
Expand All @@ -106,84 +106,41 @@ See [Prerequisites for .NET Core on Windows](windows-prerequisites.md) for more

## Linux RIDs

- Portable
- `linux-x64`
- CentOS
- `centos-x64`
- `centos.7-x64`
- Debian
- `debian-x64`
- `debian.8-x64`
- `debian.9-x64` (.NET Core 1.1 or later versions)
- Fedora
- `fedora-x64`
- `fedora.27-x64`
- `fedora.28-x64` (.NET Core 1.1 or later versions)
- Gentoo (.NET Core 2.0 or later versions)
- `gentoo-x64`
- openSUSE
- `opensuse-x64`
- `opensuse.42.3-x64`
- Oracle Linux
- `ol-x64`
- `ol.7-x64`
- `ol.7.0-x64`
- `ol.7.1-x64`
- `ol.7.2-x64`
- `ol.7.3-x64`
- `ol.7.4-x64`
Only common values are listed. For the latest and complete version, see the [runtime.json](https://github.com/dotnet/corefx/blob/master/pkg/Microsoft.NETCore.Platforms/runtime.json) file on CoreFX repo. Devices running a distribution not listed below may work with one of the Portable RIDs. For example, Raspberry Pi devices running a Linux distribution not listed can be targeted with `linux-arm`.

- Portable (.NET Core 2.0 or later versions)
- `linux-x64` (Most desktop distributions like CentOS, Debian, Fedora, Ubuntu and derivatives)
- `linux-musl-x64` (Lightweight distributions using [musl](https://wiki.musl-libc.org/projects-using-musl.html) like Alpine Linux)
- `linux-arm` (Linux distributions running on ARM like Raspberry Pi)
- Red Hat Enterprise Linux
- `rhel-x64`
- `rhel-x64` (Superseded by `linux-x64` for RHEL above version 6)
- `rhel.6-x64` (.NET Core 2.0 or later versions)
- `rhel.7-x64`
- Tizen (.NET Core 2.0 or later versions)
- `tizen`
- `tizen.4.0.0`
- `tizen.5.0.0`
- Ubuntu
- `ubuntu-x64`
- `ubuntu.14.04-x64`
- `ubuntu.16.04-x64`
- `ubuntu.17.10-x64`
- `ubuntu.18.04-x64`
- Ubuntu derivatives
- `linuxmint.17-x64`
- `linuxmint.17.1-x64`
- `linuxmint.17.2-x64`
- `linuxmint.17.3-x64`
- `linuxmint.18-x64` (.NET Core 2.0 or later versions)
- `linuxmint.18.1-x64` (.NET Core 2.0 or later versions)
- `linuxmint.18.2-x64` (.NET Core 2.0 or later versions)
- `linuxmint.18.3-x64` (.NET Core 2.0 or later versions)
- SUSE Enterprise Linux (SLES) (.NET Core 2.0 or later versions)
- `sles-x64`
- `sles.12-x64`
- `sles.12.1-x64`
- `sles.12.2-x64`
- `sles.12.3-x64`
- Alpine Linux (.NET Core 2.1 or later versions)
- `alpine-x64`
- `alpine.3.7-x64`

See [Prerequisites for .NET Core on Linux](linux-prerequisites.md) for more information.

## macOS RIDs

macOS RIDs use the older "OSX" branding.

- `osx-x64` (.NET Core 2.0 or later versions, minimum version is `osx.10.12-x64`)
- `osx.10.10-x64`
- `osx.10.11-x64`
- `osx.10.12-x64` (.NET Core 1.1 or later versions)
- `osx.10.13-x64`
macOS RIDs use the older "OSX" branding. Only common values are listed. For the latest and complete version, see the [runtime.json](https://github.com/dotnet/corefx/blob/master/pkg/Microsoft.NETCore.Platforms/runtime.json) file on CoreFX repo.

- Portable (.NET Core 2.0 or later versions)
- `osx-x64` (Minimum OS version is macOS 10.12 Sierra)
- macOS 10.10 Yosemite
- `osx.10.10-x64`
- macOS 10.11 El Capitan
- `osx.10.11-x64`
- macOS 10.12 Sierra (.NET Core 1.1 or later versions)
- `osx.10.12-x64`
- macOS 10.13 High Sierra (.NET Core 1.1 or later versions)
- `osx.10.13-x64`
- macOS 10.14 Mojave (.NET Core 1.1 or later versions)
- `osx.10.14-x64`

See [Prerequisites for .NET Core on macOS](macos-prerequisites.md) for more information.

## Android RIDs (.NET Core 2.0 or later versions)

- `android`
- `android.21`

## See also

- [Runtime IDs](https://github.com/dotnet/corefx/blob/master/pkg/Microsoft.NETCore.Platforms/readme.md)