Documentation/gpu/automated_testing.rst

1 .. SPDX-License-Identifier: GPL-2.0+
11 be very time-consuming when lots of different hardware configurations need to
21 can be used as well for testing the DRM subsystem. This document explains how
29 drivers/gpu/drm/ci/gitlab-ci.yml
30 --------------------------------
49     Revision of igt-gpu-tools being used, from
50     https://gitlab.freedesktop.org/drm/igt-gpu-tools
53 -------------------------------
55 IGT tests to be run on all drivers (unless mentioned in a driver's \*-skips.txt
58 drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-fails.txt
59 ----------------------------------------------------------
61 Lists the known failures for a given driver on a specific hardware revision.
63 drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-flakes.txt
64 -----------------------------------------------------------
67 known to behave unreliably. These tests won't cause a job to fail regardless of
78   # Board Name: broken-board.dtb
79   # Linux Version: 6.6-rc1
80   # IGT Version: 1.28-gd2af13d9f
82   flaky-test
84 drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-skips.txt
85 -----------------------------------------------------------
99 https://gitlab.freedesktop.org/janedoe/linux/-/settings/ci_cd), change the
100 CI/CD configuration file from .gitlab-ci.yml to
101 drivers/gpu/drm/ci/gitlab-ci.yml.
103 3. Request to be added to the drm/ci-ok group so that your user has the
104 necessary privileges to run the CI on https://gitlab.freedesktop.org/drm/ci-ok
107 created (eg. https://gitlab.freedesktop.org/janedoe/linux/-/pipelines)
127 and then the expected results if there are any known failures.
131 gitlab-ci.yml file.
137 For testing changes to the scripts in the drm-ci repo, change the
139 drivers/gpu/drm/ci/gitlab-ci.yml to match your fork of the project (eg.
140 janedoe/drm-ci). This fork needs to be in https://gitlab.freedesktop.org/.
149 ${TARGET_BRANCH}-external-fixes.
152 exists in the local tree, commits from that branch will be merged in as well.
161 https://gitlab.freedesktop.org/gfx-ci/lab-status/-/blob/main/lab-status.yml.