From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757777AbcHWNGF (ORCPT ); Tue, 23 Aug 2016 09:06:05 -0400 Received: from mail-wm0-f67.google.com ([74.125.82.67]:34131 "EHLO mail-wm0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757413AbcHWNGC (ORCPT ); Tue, 23 Aug 2016 09:06:02 -0400 Date: Tue, 23 Aug 2016 15:05:58 +0200 From: Daniel Vetter To: Tomeu Vizoso Cc: linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, Jonathan Corbet , dri-devel@lists.freedesktop.org, Daniel Vetter Subject: Re: [PATCH] drm/doc: Add a few words on validation with IGT Message-ID: <20160823130558.GH10980@phenom.ffwll.local> Mail-Followup-To: Tomeu Vizoso , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, Jonathan Corbet , dri-devel@lists.freedesktop.org, Daniel Vetter References: <1471943731-15729-1-git-send-email-tomeu.vizoso@collabora.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1471943731-15729-1-git-send-email-tomeu.vizoso@collabora.com> X-Operating-System: Linux phenom 4.6.0-1-amd64 User-Agent: Mutt/1.6.0 (2016-04-01) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Aug 23, 2016 at 11:15:31AM +0200, Tomeu Vizoso wrote: > Also provide some pointers for building IGT as some kernel hackers might > not be that familiar with building stuff on Linux distros. > > Signed-off-by: Tomeu Vizoso > Cc: Daniel Vetter > --- > Documentation/gpu/drm-uapi.rst | 37 +++++++++++++++++++++++++++++++++++++ > 1 file changed, 37 insertions(+) > > diff --git a/Documentation/gpu/drm-uapi.rst b/Documentation/gpu/drm-uapi.rst > index 94876938aef3..5e425ab83dc1 100644 > --- a/Documentation/gpu/drm-uapi.rst > +++ b/Documentation/gpu/drm-uapi.rst > @@ -112,3 +112,40 @@ 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. > + > +Validating changes with IGT > +=========================== I think it'd be good to move this at least ahead of the vblank section. The vblank section is pure legacy stuff, so best if we leave it at the bottom. > + > +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 > +core don't regress existing functionality. This test suite is called IGT and > +its code can be found in https://cgit.freedesktop.org/xorg/app/intel-gpu-tools. Daniel Stone just did a rebranding of igt, it's now in /drm/igt-gpu-tests. Or at least should be once the updates trickle through. Please confirm with Daniel before respinning. Aside on that rebranding: I think we could do a similar rebranding in igt as IGT Gpu Tests in the igt documentation. If you feel like doing that at least. -Daniel > + > +To build IGT, start by installing its build dependencies. In Debian-based > +systems:: > + > + # apt-get build-dep intel-gpu-tools > + > +And in Fedora-based systems:: > + > + # dnf builddep intel-gpu-tools > + > +Then clone the repository:: > + > + $ git clone git://anongit.freedesktop.org/xorg/app/intel-gpu-tools > + > +Configure the build system and start the build:: > + > + $ cd intel-gpu-tools && ./autogen.sh && make -j6 > + > +Download the piglit dependency:: > + > + $ ./scripts/run-tests.sh -d > + > +And run the tests:: > + > + $ ./scripts/run-tests.sh -t kms -t core -s > + > +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. > -- > 2.7.4 > > _______________________________________________ > dri-devel mailing list > dri-devel@lists.freedesktop.org > https://lists.freedesktop.org/mailman/listinfo/dri-devel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch