Re: [PATCH v2] drm/doc: Add a few words on validation with IGT

From: Daniel Vetter
Date: Thu Sep 01 2016 - 04:45:36 EST


On Thu, Sep 01, 2016 at 09:41:35AM +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>

Applied to drm-misc, thanks.
-Daniel

> ---
> 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 12b47c30fe2e..1ba301cebe16 100644
> --- a/Documentation/gpu/drm-uapi.rst
> +++ b/Documentation/gpu/drm-uapi.rst
> @@ -156,6 +156,43 @@ 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.
>
> +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
> +core don't regress existing functionality. This test suite is called IGT and
> +its code can be found in https://cgit.freedesktop.org/drm/igt-gpu-tools/.
> +
> +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/drm/igt-gpu-tools
> +
> +Configure the build system and start the build::
> +
> + $ cd igt-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.
> +
> VBlank event handling
> =====================
>
> --
> 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