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 <tomeu.vizoso@xxxxxxxxxxxxx> > Cc: Daniel Vetter <daniel.vetter@xxxxxxxxx> > --- > 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@xxxxxxxxxxxxxxxxxxxxx > https://lists.freedesktop.org/mailman/listinfo/dri-devel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch _______________________________________________ dri-devel mailing list dri-devel@xxxxxxxxxxxxxxxxxxxxx https://lists.freedesktop.org/mailman/listinfo/dri-devel
