From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-vk1-f176.google.com (mail-vk1-f176.google.com [209.85.221.176]) by sourceware.org (Postfix) with ESMTPS id 0E4363857023; Fri, 13 May 2022 10:00:34 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 0E4363857023 Received: by mail-vk1-f176.google.com with SMTP id h144so3967892vkh.3; Fri, 13 May 2022 03:00:34 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=MecAf/KtHt/K4OCG/8dg7r/sGEPPaTm0SQhhKXWL2C0=; b=ohffpRp7at/QmrS6F3Vh03N7xoN1n0y2HOtPtlCyCP5J39tCQkywW5W+jo6Mh0NdPw jst8JSE5YgenRbvalISewpmlho11WgnAN93AwnAwjhVTpcDhfT4mcr+g/QR9gsUCcXIv uZt5lH52NUdLt6vW0nA8vyZdhQDK7v9owE/s2BkvIdEJVrAt5wascgoPBsvXZgMg8eM1 TyliWk4dEAxSFY4bu5s8mY6seYb1kPe7oqlRTmCy0Ohud1pyVB29EbtmeSKmhUUtbkR2 Nt+t0PMCDZPOXBUNdeCZUcNW1sIbzU7m03TKLiDbK3oZV92K3X4l35OixcWWpKTjOIw/ z3pg== X-Gm-Message-State: AOAM530RDHFdoI1Q4Ec/R20l7NDN85ObJJF022dgMeR5YinFyt/zclvO AoDox167g/ucIkXtT2WOP0kWW+yJF8mlxg== X-Google-Smtp-Source: ABdhPJz/3GfbfCSjxLUCjt9bpxNq6Dv5TUHRKOha8J35VkA03G5FkL4J4Bqi4Z8rhnDTm0u4UcESqQ== X-Received: by 2002:ac5:c0d9:0:b0:34d:76f3:7fa7 with SMTP id b25-20020ac5c0d9000000b0034d76f37fa7mr1697030vkk.41.1652436033359; Fri, 13 May 2022 03:00:33 -0700 (PDT) Received: from mail-vs1-f49.google.com (mail-vs1-f49.google.com. [209.85.217.49]) by smtp.gmail.com with ESMTPSA id q26-20020ab0671a000000b00362c5d5a021sm382858uam.32.2022.05.13.03.00.32 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 13 May 2022 03:00:33 -0700 (PDT) Received: by mail-vs1-f49.google.com with SMTP id y74so7862256vsy.7; Fri, 13 May 2022 03:00:32 -0700 (PDT) X-Received: by 2002:a67:fad7:0:b0:32c:ccf8:a370 with SMTP id g23-20020a67fad7000000b0032cccf8a370mr2046511vsq.46.1652436032666; Fri, 13 May 2022 03:00:32 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: =?UTF-8?Q?Christoph_M=C3=BCllner?= Date: Fri, 13 May 2022 12:00:21 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: Supporting RISC-V Vendor Extensions in the GNU Toolchain To: Palmer Dabbelt Cc: Binutils , GCC Patches , GNU C Library , gdb-patches@sourceware.org, Philipp Tomsich Content-Type: text/plain; charset="UTF-8" X-Spam-Status: No, score=-3.8 required=5.0 tests=BAYES_00, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FORGED_FROMDOMAIN, FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS, KAM_DMARC_STATUS, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP, T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: binutils@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 May 2022 10:00:36 -0000 On Wed, May 11, 2022 at 2:02 AM Palmer Dabbelt wrote: > > [Sorry for cross-posting to a bunch of lists, I figured it'd be best to > have all the discussions in one thread.] > > We currently only support what is defined by official RISC-V > specifications in the various GNU toolchain projects. There's certainly > some grey areas there, but in general that means not taking code that > relies on drafts or vendor defined extensions, even if that would result > in higher performance or more featured systems for users. > > The original goal of these policies were to steer RISC-V implementers > towards a common set of specifications, but over the last year or so > it's become abundantly clear that this is causing more harm that good. > All extant RISC-V systems rely on behaviors defined outside the official > specifications, and while that's technically always been the case we've > gotten to the point where trying to ignore that fact is impacting real > users on real systems. There's been consistent feedback from users that > we're not meeting their needs, which can clearly be seen in the many out > of tree patch sets in common use. > > There's been a handful of discussions about this, but we've yet to have > a proper discussion on the mailing lists. From the various discussions > I've had it seems that folks are broadly in favor of supporting vendor > extensions, but the devil's always in the details with this sort of > thing so I thought it'd be best to write something up so we can have a > concrete discussion. > > The idea is to start taking code that depends on vendor-defined behavior > into the core GNU toolchain ports, as long as it meets the following > criteria: > > * An ISA manual is available that can be redistributed/archived, defines > the behaviors in question as one or more vendor-specific extensions, > and is clearly versioned. The RISC-V foundation is setting various > guidelines around how vendor-defined extensions and instructions > should be named, we strongly suggest that vendors follow those > conventions whenever possible (this is all new, though, so exactly > what's necessary from vendor specifications will likely evolve as we > learn). > * There is a substantial user base that depends on the behavior in > question, which probably means there is hardware in the wild that > implements the extensions and users that require those extensions in > order for that hardware to be useful for common applications. This is > always going to be a grey area, but it's essentially the same spot > everyone else is in. > * There is a mechanism for testing the code in question without direct > access to hardware, which in practice means a QEMU port (or whatever > simulator is relevant in the space and that folks use for testing) or > some community commitment to long-term availability of the hardware > for testing (something like the GCC compile farm, for example). > * It is possible to produce binaries that are compatible with all > upstream vendors' implementations. That means we'll need mechanisms > to allow extensions from multiple vendors to be linked together and > then probed at runtime. That's not to say that all binaries will be > compatible, as users are always free to skip the compatibility code > and there will be conflicting definitions of instruction encodings, > but we can at least provide users with the option of compatibility. > > These are pretty loosely written on purpose, both because this is all > new and because each project has its own set of contribution > requirements so it's going to be all but impossible to have a single > concrete set of rules that applies everywhere -- that's nothing specific > to the vendor extensions (or even RISC-V), it's just life. Specifically > a major goal here is to balance the needs of users, both in the short > term (ie, getting new hardware to work) and the long term (ie, the long > term stability of their software). We're not talking about taking code > that can't be tested, hasn't been reviewed, isn't going to be supported > long-term, or doesn't have a stable ABI; just dropping the specific > requirement that a specification must be furnished by the RISC-V > foundation in order to accept code. > > Nothing is decided yet, so happy to hear any thought folks have. This > is certainly a very different development methodology than what we've > done in the past and isn't something that should be entreated into > lightly, so any comments are welcome. I'd like to add two points to this topic and raise two questions. 1) Accepting vendor extensions = avoidance of fragmentation RISC-V implementors are actively encouraged to implement their own ISA extensions. To avoid fragmentation in the SW ecosystem (every vendor maintains a fork of tools, distros and binaries) there needs to be a principle acceptance to get vendor extension support upstream. 2) Leading upstream maintainers already agreed on supporting vendor-extensions We have discussed the topic of vendor extensions in many forums last year. This topic was also part of the discussions at the Linux Plumbers conference. Further, there exists a place for documenting toolchain conventions of the RISC-V ecosystem ([1]), which everyone in the RISC-V ecosystem is aware about. As a result of the discussions last year, a PR ([2]) has been crafted to clarify the rules for upstreaming vendor extension support. These RISC-V toolchain conventions recently added a section for vendor extensions which covers important aspects like: * naming schemes * assembly mnemonic prefixes * links to the documentation and version information The PR even includes an explicit rule to clarify that maintainers decide on upstream inclusion: """ Open source toolchain maintainer has final say on accepting vendor extension, comply with this conventions isn't guarantee upstream will accept. """ A lot of people (maintainers and active developers) were notified (including you) and many also actively contributed to the PR. In the end there was an agreement of how to document vendor extensions (as a requirement for upstreaming). I believe that your set of rules is compatible with what is specified there. Note however, that you could have mentioned them during the PRs review process as you were notified when the PR was created. My questions are now the following: * Where to document the requirements? Most RISC-V upstream maintainers are accepting the riscv-toolchains-convention repository. Where if not there should we document requirements for the tool's conventions? Why not accept what has already been agreed upon? * Where to track the status? You mentioned testing requirements (e.g. QEMU support). I've created a wiki page to show the adoption status of all the RISC-V extensions ([3]) last year. As the chair of the Toolchains SIG, I'm willing to create and maintain one for vendor extensions as well. This allows users to see which projects support which extensions upstream. However, a wiki is a joint effort. So maintainers that merge changes upstream need to update the page. Will you support this? If not what is your proposal to track the status of the upstream extension support? BR Christoph [1] https://github.com/riscv-non-isa/riscv-toolchain-conventions#conventions-for-vendor-extension [2] https://github.com/riscv-non-isa/riscv-toolchain-conventions/pull/17 [3] https://wiki.riscv.org/display/HOME/RISC-V+extension+and+feature+support+in+the+Open+Source+SW+Ecosystem