From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.7 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, NICE_REPLY_A,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 34D8FC433DF for ; Tue, 25 Aug 2020 23:21:36 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id EF66820767 for ; Tue, 25 Aug 2020 23:21:35 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=embeddedor.com header.i=@embeddedor.com header.b="tko7O8ws" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726751AbgHYXVe (ORCPT ); Tue, 25 Aug 2020 19:21:34 -0400 Received: from gateway33.websitewelcome.com ([192.185.146.78]:39674 "EHLO gateway33.websitewelcome.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726904AbgHYXVc (ORCPT ); Tue, 25 Aug 2020 19:21:32 -0400 X-Greylist: delayed 1399 seconds by postgrey-1.27 at vger.kernel.org; Tue, 25 Aug 2020 19:21:30 EDT Received: from cm14.websitewelcome.com (cm14.websitewelcome.com [100.42.49.7]) by gateway33.websitewelcome.com (Postfix) with ESMTP id 3D3882835D for ; Tue, 25 Aug 2020 17:58:11 -0500 (CDT) Received: from gator4166.hostgator.com ([108.167.133.22]) by cmsmtp with SMTP id AhtLk9y0sBD8bAhtLkaVyr; Tue, 25 Aug 2020 17:58:11 -0500 X-Authority-Reason: nr=8 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=embeddedor.com; s=default; h=Content-Transfer-Encoding:Content-Type: In-Reply-To:MIME-Version:Date:Message-ID:From:References:Cc:To:Subject:Sender :Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help: List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=qbTX7+RfGTdBt/QiCAJh2phecdvKxL9tHi/iN+H8Res=; b=tko7O8wsfo714hNVhqOuUL4Zuo XgR8Pl1ivGkPYGkAV/YYkv58SH8ePWlSizxnTdWoMzkN7xyE8lwvuPswowDCfTTDDdOWXkwcRw/Ty oP4GM80xHnLw3mrfHiifaoZodjBb0XEoD4lVFxuU57RP8CUg9Vb1TVQXIvs+ICBkBwQLZi+9V2ml/ q15xAk5GxUQM5UXJJdknIZ/N9XJv+mJ7IGYsOjYg9zxzVMBuILjI3AGpxKvo0NDXNDDMsX8m6Zv77 DlmNu8dMGCJLhwMNgJharR33nH91RSvUcPAftA4NAU9YA0Ekzas52C5OVXPwcGjkEMhzOU2Vn/iKA N5cyD+rw==; Received: from 187-162-31-110.static.axtel.net ([187.162.31.110]:40606 helo=[192.168.15.8]) by gator4166.hostgator.com with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.93) (envelope-from ) id 1kAhtK-004D5n-Ja; Tue, 25 Aug 2020 17:58:10 -0500 Subject: Re: [PATCH] Documentation: add minimum clang/llvm version To: Nathan Chancellor , Nick Desaulniers Cc: Masahiro Yamada , 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 References: <20200825222552.3113760-1-ndesaulniers@google.com> <20200825225131.GA2702183@ubuntu-n2-xlarge-x86> From: "Gustavo A. R. Silva" Autocrypt: addr=gustavo@embeddedor.com; keydata= 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 AP7RWS474w== Message-ID: <8e867824-48ca-f63a-c863-d4ce9f9ebf75@embeddedor.com> Date: Tue, 25 Aug 2020 18:04:09 -0500 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 MIME-Version: 1.0 In-Reply-To: <20200825225131.GA2702183@ubuntu-n2-xlarge-x86> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - gator4166.hostgator.com X-AntiAbuse: Original Domain - vger.kernel.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - embeddedor.com X-BWhitelist: no X-Source-IP: 187.162.31.110 X-Source-L: No X-Exim-ID: 1kAhtK-004D5n-Ja X-Source: X-Source-Args: X-Source-Dir: X-Source-Sender: 187-162-31-110.static.axtel.net ([192.168.15.8]) [187.162.31.110]:40606 X-Source-Auth: gustavo@embeddedor.com X-Email-Count: 13 X-Source-Cap: Z3V6aWRpbmU7Z3V6aWRpbmU7Z2F0b3I0MTY2Lmhvc3RnYXRvci5jb20= X-Local-Domain: yes Sender: linux-kbuild-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kbuild@vger.kernel.org On 8/25/20 17:51, Nathan Chancellor wrote: > On Tue, Aug 25, 2020 at 03:25:51PM -0700, Nick Desaulniers wrote: >> 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 >> --- >> 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. > > I ran 'make O=out htmldocs' and can confirm that the link works properly > in process/changes.html, pointing to kbuild/llvm.html. > The same here. Tested-by: Gustavo A. R. Silva Thanks -- Gustavo >> 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 > > Maybe it is worth making the "(optional)" a footnote like Sphinx? Seems > to just kind of stick out to me but I do not have a strong opinion > unless others do. > >> 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 `. >> + > > Do we maybe want to add a section for LLVM/clang in the "Getting updated > software" section? Maybe just a link to the existing section that we > have in kbuild/llvm.rst? > >> Make >> ---- >> >> -- >> 2.28.0.297.g1956fa8f8d-goog >> > > Regardless of the nits above: > > Reviewed-and-tested-by: Nathan Chancellor >