From patchwork Tue Aug 25 22:25:51 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Nick Desaulniers X-Patchwork-Id: 11736969 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 6DEA813A4 for ; Tue, 25 Aug 2020 22:26:03 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 543AC2075E for ; Tue, 25 Aug 2020 22:26:03 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=google.com header.i=@google.com header.b="fOK1Krh7" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726645AbgHYW0C (ORCPT ); Tue, 25 Aug 2020 18:26:02 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51076 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726303AbgHYW0B (ORCPT ); Tue, 25 Aug 2020 18:26:01 -0400 Received: from mail-qk1-x74a.google.com (mail-qk1-x74a.google.com [IPv6:2607:f8b0:4864:20::74a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5E6DAC061574 for ; Tue, 25 Aug 2020 15:26:01 -0700 (PDT) Received: by mail-qk1-x74a.google.com with SMTP id a186so382197qke.1 for ; Tue, 25 Aug 2020 15:26:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=sender:date:message-id:mime-version:subject:from:to:cc; bh=FW2LrTzzEQgbMzq3tJHO9RKBRPjxertl4+WTZokfJYo=; b=fOK1Krh7WNbRfwoDQK+/SD0jQQyr0PSMvwUQCD6tAzCs+A3rB/iQPEEGpJBUn9yRkl avnu+n5QnU9pInub5wiqGm/9g2/+lQm4GD55/GcD211tA9+DHFmBlQAk+XTr3Lqe65Sx Juae8uK5syhRfAapQbT5aqIWxTK+7rdDCch0/70gxF1BBfCk6o3tkfpku50rWqc3PqQa F6ELQkeluiUnEBjW+X/PZSkYC2zLwK+c+GXoFCxS6LvmWPAQ7p53cJ9OLMDQvNhJtqzV 2DmrzSdWEbZbpyu9FpZ6VEE8THXZZLckNDIvcFgmSETKsbz5gDBcyD9R1Id2w3RP+dMD 3RfA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:date:message-id:mime-version:subject:from :to:cc; bh=FW2LrTzzEQgbMzq3tJHO9RKBRPjxertl4+WTZokfJYo=; b=LEUHZfLg9KLGRlOHunfljiR3wborkPMpnheIUtyUJdYXskNVY1GLOaS85pAy7+pZXk ynk7sLVuDIdlWjX/a44M+zc/V8qQkaqyqT99EoST24ZQc7ksT2cABf6Z66V4Vie3xEPf qIUDxtwNMZevRYsW1uOyj0EBoDweN+seax/rJnAfH0vIdAOLVDFZWt5zlMnCQmVzuoEJ 0S/i7lwRbGwwzSzcO022xh0w+/1cHnkIakAcFs3oiyUB7nn6e2YLLjKPpejjITdOeBgO MHbjGlJ51UcFGLcsdvAL1doDNucerwsBPTZFa97NgLkt1rbeXmS1RppFvHJSeppd2m5r KCRg== X-Gm-Message-State: AOAM5305tI7aXQH4hf4lcYny+W7iDfj2L0PTqYcHNkVesARm7MUb7L/b T54CCynNcbRX4gw/ZLOMgZLcm8lICGphtlgjzVA= X-Google-Smtp-Source: ABdhPJxjEG9J8LsOt3eGnk+oh0vR4LuJImhCl2b2a7k2KSxcCkF/a/1kJo9E1rkfUUX8pr1WRtNDi/fWecByGG+g12M= X-Received: from ndesaulniers1.mtv.corp.google.com ([2620:15c:211:202:f693:9fff:fef4:4d25]) (user=ndesaulniers job=sendgmr) by 2002:a05:6214:1086:: with SMTP id o6mr11029155qvr.41.1598394359323; Tue, 25 Aug 2020 15:25:59 -0700 (PDT) Date: Tue, 25 Aug 2020 15:25:51 -0700 Message-Id: <20200825222552.3113760-1-ndesaulniers@google.com> Mime-Version: 1.0 X-Mailer: git-send-email 2.28.0.297.g1956fa8f8d-goog Subject: [PATCH] Documentation: add minimum clang/llvm version From: Nick Desaulniers To: Masahiro Yamada Cc: Nick Desaulniers , Nathan Chancellor , Michal Marek , Jonathan Corbet , Randy Dunlap , "Theodore Ts'o" , Kees Cook , Will Deacon , Borislav Petkov , "Alexander A. Klimov" , clang-built-linux@googlegroups.com, linux-kbuild@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Sender: linux-kbuild-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kbuild@vger.kernel.org Based on a vote at the LLVM BoF at Plumbers 2020, we decided to start small, supporting just one formal upstream release of LLVM for now. We can probably widen the support window of supported versions over time. Also, note that LLVM's release process is different than GCC's. GCC tends to have 1 major release per year while releasing minor updates to the past 3 major versions. LLVM tends to support one major release and one minor release every six months. Signed-off-by: Nick Desaulniers Tested-by: Gustavo A. R. Silva Reviewed-by: Kees Cook --- Note to reviewers: working remote, I'm having trouble testing/verifying that I have the RST links wired up correctly; I would appreciate it if someone is able to `make htmldocs` and check Documentation/output/process/changes.html properly links to Documentation/output/kbuild/llvm.html. Documentation/kbuild/llvm.rst | 2 ++ Documentation/process/changes.rst | 10 ++++++++++ 2 files changed, 12 insertions(+) diff --git a/Documentation/kbuild/llvm.rst b/Documentation/kbuild/llvm.rst index 2aac50b97921..70ec6e9a183b 100644 --- a/Documentation/kbuild/llvm.rst +++ b/Documentation/kbuild/llvm.rst @@ -1,3 +1,5 @@ +.. _kbuild_llvm: + ============================== Building Linux with Clang/LLVM ============================== diff --git a/Documentation/process/changes.rst b/Documentation/process/changes.rst index ee741763a3fc..6c580ef9f2a3 100644 --- a/Documentation/process/changes.rst +++ b/Documentation/process/changes.rst @@ -30,6 +30,7 @@ you probably needn't concern yourself with pcmciautils. Program Minimal version Command to check the version ====================== =============== ======================================== GNU C 4.9 gcc --version +Clang/LLVM (optional) 10.0.1 clang --version GNU make 3.81 make --version binutils 2.23 ld -v flex 2.5.35 flex --version @@ -68,6 +69,15 @@ GCC The gcc version requirements may vary depending on the type of CPU in your computer. +Clang/LLVM (optional) +--------------------- + +The latest formal release of clang and LLVM utils (according to +`releases.llvm.org `_) are supported for building +kernels. Older releases aren't gauranteed to work, and we may drop workarounds +from the kernel that were used to support older versions. Please see additional +docs on :ref:`Building Linux with Clang/LLVM `. + Make ----