From patchwork Thu Dec 29 20:48:21 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Vetter X-Patchwork-Id: 9491409 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 74BC962AB8 for ; Thu, 29 Dec 2016 20:49:00 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 61AD81FFD6 for ; Thu, 29 Dec 2016 20:49:00 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 5172222BF1; Thu, 29 Dec 2016 20:49:00 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.1 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_MED,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id B3F741FFD6 for ; Thu, 29 Dec 2016 20:48:59 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 2B27A6E15B; Thu, 29 Dec 2016 20:48:52 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-wj0-x243.google.com (mail-wj0-x243.google.com [IPv6:2a00:1450:400c:c01::243]) by gabe.freedesktop.org (Postfix) with ESMTPS id 158EB6E15A for ; Thu, 29 Dec 2016 20:48:50 +0000 (UTC) Received: by mail-wj0-x243.google.com with SMTP id j10so58871913wjb.3 for ; Thu, 29 Dec 2016 12:48:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=from:to:cc:subject:date:message-id; bh=RsVOTPof+3kEnbX1i9a5BC5L+LYPvfbF7xgw9SuEPj8=; b=hjtnJT+svSWWy7diI4DpreVe6LyitbcID86TE4x8SvsMB11HsUx1zOU2cKVtKFlvnX +kReThPeLrWLcvlqebUVMdC/0r4wNJqgJXPpvn2GNafeIWyx3EInnYNBjSdVcJKuE4YJ Hr4A7cfxJ7c7wdqh1CDgEx5YT9/cKs/zrf55o= 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; bh=RsVOTPof+3kEnbX1i9a5BC5L+LYPvfbF7xgw9SuEPj8=; b=mtWaA6+FBtdw/S1cMyJqZdA6UVH0LVNQ0w3+RTFF1ybBJidh6LQFzBHuDzROWXE3NZ nM2MRcAYwwAMIcCqxHaUsHGfn0mRvUlSY9a/OtbUYVyfSyZB5VRj8Lg7pI0lyUmKKygB cUk/aQ4u63ipJz6jOMhnbf0iWOnPJ482jitkM1tUE4kQbpAZGWTgYrIAY511FNcYOptQ psgZxdncYTK0N6d0Igfucpg9zkRzm6/cNoxhUX4Quf9lvDRNI0OXPTARBz3u3/lTbB8x kiH8vxtiAivGlJGVivrtZuRVampDWHwD2u8AXh5ci/gU6qImrCNLqqPSLZpQwwcKrO0X sHBg== X-Gm-Message-State: AIkVDXL0nIZ80pL8/UUwNnT2552IEWbx9/itWnl/HCpDTNmLxitcCbqEZyPt/xXR+R29Wg== X-Received: by 10.194.0.70 with SMTP id 6mr27154642wjc.215.1483044528269; Thu, 29 Dec 2016 12:48:48 -0800 (PST) Received: from dvetter-linux.ger.corp.intel.com ([194.230.155.242]) by smtp.gmail.com with ESMTPSA id 63sm67007754wmg.2.2016.12.29.12.48.45 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 29 Dec 2016 12:48:46 -0800 (PST) From: Daniel Vetter To: DRI Development Subject: [PATCH 01/17] drm/docs: Small cleanup in drm-uapi.rst Date: Thu, 29 Dec 2016 21:48:21 +0100 Message-Id: <1483044517-5770-1-git-send-email-daniel.vetter@ffwll.ch> X-Mailer: git-send-email 2.7.4 Cc: Jani Nikula , Daniel Vetter , Intel Graphics Development , Tomeu Vizoso , Daniel Vetter X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Virus-Scanned: ClamAV using ClamSMTP - Remove the outdated hunk about driver documentation which somehow got misplaced here in the split-up. - Collect all the testing&validation stuff together and give the CRC section a heading for prettier output. Cc: Tomeu Vizoso Cc: Jani Nikula Signed-off-by: Daniel Vetter Reviewed-by: David Herrmann Reviewed-by: Tomeu Vizoso --- Documentation/gpu/drm-uapi.rst | 25 +++++++++++-------------- 1 file changed, 11 insertions(+), 14 deletions(-) diff --git a/Documentation/gpu/drm-uapi.rst b/Documentation/gpu/drm-uapi.rst index de3ac9f90f8f..fcc228ef5bc4 100644 --- a/Documentation/gpu/drm-uapi.rst +++ b/Documentation/gpu/drm-uapi.rst @@ -156,8 +156,12 @@ other hand, a driver requires shared state between clients which is visible to user-space and accessible beyond open-file boundaries, they cannot support render nodes. + +Testing and validation +====================== + Validating changes with IGT -=========================== +--------------------------- There's a collection of tests that aims to cover the whole functionality of DRM drivers and that can be used to check that changes to DRM drivers or the @@ -193,6 +197,12 @@ run-tests.sh is a wrapper around piglit that will execute the tests matching the -t options. A report in HTML format will be available in ./results/html/index.html. Results can be compared with piglit. +Display CRC Support +------------------- + +.. kernel-doc:: drivers/gpu/drm/drm_debugfs_crc.c + :doc: CRC ABI + VBlank event handling ===================== @@ -209,16 +219,3 @@ DRM_IOCTL_MODESET_CTL mode setting, since on many devices the vertical blank counter is reset to 0 at some point during modeset. Modern drivers should not call this any more since with kernel mode setting it is a no-op. - -This second part of the GPU Driver Developer's Guide documents driver -code, implementation details and also all the driver-specific userspace -interfaces. Especially since all hardware-acceleration interfaces to -userspace are driver specific for efficiency and other reasons these -interfaces can be rather substantial. Hence every driver has its own -chapter. - -Testing and validation -====================== - -.. kernel-doc:: drivers/gpu/drm/drm_debugfs_crc.c - :doc: CRC ABI