[llvm] [llvm][Docs] Update supported hardware (PR #121743)

David Spickett via llvm-commits llvm-commits at lists.llvm.org
Mon Jan 6 07:21:24 PST 2025


https://github.com/DavidSpickett updated https://github.com/llvm/llvm-project/pull/121743

>From c5380cd0e9c8d7dd5d031094fb081b363a80d4c8 Mon Sep 17 00:00:00 2001
From: David Spickett <david.spickett at linaro.org>
Date: Mon, 6 Jan 2025 10:18:02 +0000
Subject: [PATCH 1/3] [llvm][Docs] Update supported hardware

Add a few known platforms:
* Linux AArch64
* FreeBSD AArch64
* macOS arm64 (Clang build only, there might be a GCC port but I've not used it myself)
* Windows on Arm (ARM64 as Microsoft refers to it)
  (you could say this builds with Clang too, but you need a Visual Studio install
  as well, so I don't want to compilicate things by mentioning Clang here)
---
 llvm/docs/GettingStarted.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/llvm/docs/GettingStarted.rst b/llvm/docs/GettingStarted.rst
index 7f4b62f63957b4..8f78d7af0d6ba4 100644
--- a/llvm/docs/GettingStarted.rst
+++ b/llvm/docs/GettingStarted.rst
@@ -239,6 +239,7 @@ OS                 Arch                  Compilers
 Linux              x86\ :sup:`1`         GCC, Clang
 Linux              amd64                 GCC, Clang
 Linux              ARM                   GCC, Clang
+Linux              AArch64               GCC, Clang
 Linux              Mips                  GCC, Clang
 Linux              PowerPC               GCC, Clang
 Linux              SystemZ               GCC, Clang
@@ -246,15 +247,18 @@ Solaris            V9 (Ultrasparc)       GCC
 DragonFlyBSD       amd64                 GCC, Clang
 FreeBSD            x86\ :sup:`1`         GCC, Clang
 FreeBSD            amd64                 GCC, Clang
+FreeBSD            AArch64               GCC, Clang
 NetBSD             x86\ :sup:`1`         GCC, Clang
 NetBSD             amd64                 GCC, Clang
 OpenBSD            x86\ :sup:`1`         GCC, Clang
 OpenBSD            amd64                 GCC, Clang
 macOS\ :sup:`2`    PowerPC               GCC
 macOS              x86                   GCC, Clang
+macOS              arm64                 Clang
 Cygwin/Win32       x86\ :sup:`1, 3`      GCC
 Windows            x86\ :sup:`1`         Visual Studio
 Windows x64        x86-64                Visual Studio
+Windows on Arm     ARM64                 Visual Studio
 ================== ===================== =============
 
 .. note::

>From 10bb6820237092cc1f7e131230c171116ef3f729 Mon Sep 17 00:00:00 2001
From: David Spickett <david.spickett at linaro.org>
Date: Mon, 6 Jan 2025 15:17:01 +0000
Subject: [PATCH 2/3] note Windows Clang

---
 llvm/docs/GettingStarted.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/llvm/docs/GettingStarted.rst b/llvm/docs/GettingStarted.rst
index 8f78d7af0d6ba4..26327f727d44be 100644
--- a/llvm/docs/GettingStarted.rst
+++ b/llvm/docs/GettingStarted.rst
@@ -257,8 +257,8 @@ macOS              x86                   GCC, Clang
 macOS              arm64                 Clang
 Cygwin/Win32       x86\ :sup:`1, 3`      GCC
 Windows            x86\ :sup:`1`         Visual Studio
-Windows x64        x86-64                Visual Studio
-Windows on Arm     ARM64                 Visual Studio
+Windows x64        x86-64                Visual Studio, Clang\ :sup:`4`
+Windows on Arm     ARM64                 Visual Studio, Clang\ :sup:`4`
 ================== ===================== =============
 
 .. note::
@@ -267,6 +267,8 @@ Windows on Arm     ARM64                 Visual Studio
   #. Code generation supported for 32-bit ABI only
   #. To use LLVM modules on Win32-based system, you may configure LLVM
      with ``-DBUILD_SHARED_LIBS=On``.
+  #. Visual Studio alone can compile LLVM. When using Clang, you
+     must also have Visual Studio installed.
 
 Note that Debug builds require a lot of time and disk space.  An LLVM-only build
 will need about 1-3 GB of space.  A full build of LLVM and Clang will need around

>From 54a76206ee3c6cbe31f71a3a8e11a9339d18734c Mon Sep 17 00:00:00 2001
From: David Spickett <david.spickett at linaro.org>
Date: Mon, 6 Jan 2025 15:20:56 +0000
Subject: [PATCH 3/3] More ======

---
 llvm/docs/GettingStarted.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/llvm/docs/GettingStarted.rst b/llvm/docs/GettingStarted.rst
index 26327f727d44be..7f73b61e11dd01 100644
--- a/llvm/docs/GettingStarted.rst
+++ b/llvm/docs/GettingStarted.rst
@@ -233,9 +233,9 @@ Hardware
 
 LLVM is known to work on the following host platforms:
 
-================== ===================== =============
+================== ===================== ==============================
 OS                 Arch                  Compilers
-================== ===================== =============
+================== ===================== ==============================
 Linux              x86\ :sup:`1`         GCC, Clang
 Linux              amd64                 GCC, Clang
 Linux              ARM                   GCC, Clang
@@ -259,7 +259,7 @@ Cygwin/Win32       x86\ :sup:`1, 3`      GCC
 Windows            x86\ :sup:`1`         Visual Studio
 Windows x64        x86-64                Visual Studio, Clang\ :sup:`4`
 Windows on Arm     ARM64                 Visual Studio, Clang\ :sup:`4`
-================== ===================== =============
+================== ===================== ==============================
 
 .. note::
 



More information about the llvm-commits mailing list