From patchwork Wed Aug 4 18:48:16 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jason Ekstrand X-Patchwork-Id: 12419655 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=-16.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT 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 27F38C4338F for ; Wed, 4 Aug 2021 18:48:24 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id C61AF60F58 for ; Wed, 4 Aug 2021 18:48:23 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org C61AF60F58 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=jlekstrand.net Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 0E8636E11F; Wed, 4 Aug 2021 18:48:23 +0000 (UTC) Received: from mail-pj1-x102d.google.com (mail-pj1-x102d.google.com [IPv6:2607:f8b0:4864:20::102d]) by gabe.freedesktop.org (Postfix) with ESMTPS id 3F1DD6E11F for ; Wed, 4 Aug 2021 18:48:21 +0000 (UTC) Received: by mail-pj1-x102d.google.com with SMTP id j18-20020a17090aeb12b029017737e6c349so6480903pjz.0 for ; Wed, 04 Aug 2021 11:48:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jlekstrand-net.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=CzG2FRpQq4GQGHqHEFpqswVyF/E6iIZT1I4e0pVCjrs=; b=z1V1AlsXLpzTdRc8PHs4TyChd/8FJo1XFk/J2zB1DdxzoGe2weHUR7mKLtY0a+vDFG EyeH8XRGCdkxmHI5tHr0edh0fUHr5HVhQzPvoeqX+wo5/F3Qo4iaDmdFsooGd9ruKPYy 2JjGcQtengX4nD8apulzOwhlx19zbo4vS320dfJgM7JjS/djQWNLugNNPRyDMAD1XmQZ lYw4aDvm24VMzQEDmFUoxagDNb1d5hSZ8lBGdZFlYByb+dw1QOuYIhuN12pXD74xGz1v z2tXXkdiJv7rOeSXjkMptDzvYlSu4ViIITwPpqBHbH+lJOr0aHGu4QizFEH1zFqjadW3 CVlg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=CzG2FRpQq4GQGHqHEFpqswVyF/E6iIZT1I4e0pVCjrs=; b=JmEXVs0FlRCU93CHIzmImxn+m7M1gK74K6DsAA5JD9Te8bl0bSHBIWUf7smKQLElS4 v6IJttaeUVTxNoqcxLPss3tlFRzog59N0BvVwazjJZSHCP4avC/mGpLhfyz9aQqh5UTo eUmirYDZAJL1RLY9q/AnMcQkFNW1XZIsG4uC+T7Sw9Go+Si3w8aZTiOCic1WD9IHfKhP pbmzPOiFwsEemrH5TH76Cq2w207Q+onnB63dVtclsp5h7t0Vm639WB7o5jmb8fWtrrJh 6Wyy3rF+rWjVndl1nzqbZObtbaS5tW/Vnh1wbGYx3p5RupGfTBLaFuWw/cPkUa0OOW4b Jycw== X-Gm-Message-State: AOAM5326v0xkF83dGMqSjEhROZkF4wCU03kZfZS4GnL55ofmuzTADPnF 7IY3gbePmE7cEKAXzSEVZB1Iw+np3Ldu2VSc X-Google-Smtp-Source: ABdhPJxcqa7wdIBOqnzmHkXV2lApX+tDbn3/yS7HsXZZ54THd7GgBR5wRkM+waRxxNAL5mDhrM1RgQ== X-Received: by 2002:a62:1609:0:b029:3ab:afdb:acf3 with SMTP id 9-20020a6216090000b02903abafdbacf3mr1074565pfw.43.1628102900434; Wed, 04 Aug 2021 11:48:20 -0700 (PDT) Received: from omlet.lan ([134.134.139.85]) by smtp.gmail.com with ESMTPSA id h5sm3693004pfv.145.2021.08.04.11.48.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 Aug 2021 11:48:20 -0700 (PDT) From: Jason Ekstrand To: dri-devel@lists.freedesktop.org Cc: Jason Ekstrand , Daniel Vetter , Dave Airlie Subject: [PATCH] docs/drm: Add a new bullet to the uAPI requirements Date: Wed, 4 Aug 2021 13:48:16 -0500 Message-Id: <20210804184816.623950-1-jason@jlekstrand.net> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" While tracking down various bits of i915 uAPI, it's been difficult to find the userspace much of the time because no one bothers to mention it in commit messages. Require the kernel patch to be a one-stop shop for finding the various bits which were used to justify the new uAPI. Signed-off-by: Jason Ekstrand Cc: Daniel Vetter Cc: Dave Airlie Acked-by: Daniel Vetter --- Documentation/gpu/drm-uapi.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/gpu/drm-uapi.rst b/Documentation/gpu/drm-uapi.rst index 199afb503ab1..82f780bc3fce 100644 --- a/Documentation/gpu/drm-uapi.rst +++ b/Documentation/gpu/drm-uapi.rst @@ -109,6 +109,11 @@ leads to a few additional requirements: userspace patches land. uAPI always flows from the kernel, doing things the other way round risks divergence of the uAPI definitions and header files. +- The kernel patch which adds the new uAPI **must** reference the patch series + or merge requests in the userspaces project which use the new uAPI and + against which the review was done so that future developers can find all of + the pieces which tie together. + These are fairly steep requirements, but have grown out from years of shared pain and experience with uAPI added hastily, and almost always regretted about just as fast. GFX devices change really fast, requiring a paradigm shift and