€•cŒsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ)/translations/zh_CN/gpu/automated_testing”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ)/translations/zh_TW/gpu/automated_testing”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ)/translations/it_IT/gpu/automated_testing”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ)/translations/ja_JP/gpu/automated_testing”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ)/translations/ko_KR/gpu/automated_testing”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ)/translations/sp_SP/gpu/automated_testing”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ!SPDX-License-Identifier: GPL-2.0+”h]”hŒ!SPDX-License-Identifier: GPL-2.0+”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1h¡hhhžhhŸŒC/var/lib/git/docbuild/linux/Documentation/gpu/automated_testing.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ&Automated testing of the DRM subsystem”h]”hŒ&Automated testing of the DRM subsystem”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒ Introduction”h]”hŒ Introduction”…””}”(hhÌhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhÉhžhhŸh³h KubhŒ paragraph”“”)”}”(hX?Making sure that changes to the core or drivers don't introduce regressions can be very time-consuming when lots of different hardware configurations need to be tested. Moreover, it isn't practical for each person interested in this testing to have to acquire and maintain what can be a considerable amount of hardware.”h]”hXCMaking sure that changes to the core or drivers don’t introduce regressions can be very time-consuming when lots of different hardware configurations need to be tested. Moreover, it isn’t practical for each person interested in this testing to have to acquire and maintain what can be a considerable amount of hardware.”…””}”(hhÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K hhÉhžhubhÛ)”}”(hŒ¦Also, it is desirable for developers to check for regressions in their code by themselves, instead of relying on the maintainers to find them and then reporting back.”h]”hŒ¦Also, it is desirable for developers to check for regressions in their code by themselves, instead of relying on the maintainers to find them and then reporting back.”…””}”(hhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhÉhžhubhÛ)”}”(hXThere are facilities in gitlab.freedesktop.org to automatically test Mesa that can be used as well for testing the DRM subsystem. This document explains how people interested in testing it can use this shared infrastructure to save quite some time and effort.”h]”hXThere are facilities in gitlab.freedesktop.org to automatically test Mesa that can be used as well for testing the DRM subsystem. This document explains how people interested in testing it can use this shared infrastructure to save quite some time and effort.”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhÉhžhubeh}”(h]”Œ introduction”ah ]”h"]”Œ introduction”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒRelevant files”h]”hŒRelevant files”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjhžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒ drivers/gpu/drm/ci/gitlab-ci.yml”h]”hŒ drivers/gpu/drm/ci/gitlab-ci.yml”…””}”(hj"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjhžhhŸh³h KubhÛ)”}”(hŒèThis is the root configuration file for GitLab CI. Among other less interesting bits, it specifies the specific version of the scripts to be used. There are some variables that can be modified to change the behavior of the pipeline:”h]”hŒèThis is the root configuration file for GitLab CI. Among other less interesting bits, it specifies the specific version of the scripts to be used. There are some variables that can be modified to change the behavior of the pipeline:”…””}”(hj0hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K hjhžhubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒUDRM_CI_PROJECT_PATH Repository that contains the Mesa software infrastructure for CI ”h]”(hŒterm”“”)”}”(hŒDRM_CI_PROJECT_PATH”h]”hŒDRM_CI_PROJECT_PATH”…””}”(hjKhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jIhŸh³h K%hjEubhŒ definition”“”)”}”(hhh]”hÛ)”}”(hŒ@Repository that contains the Mesa software infrastructure for CI”h]”hŒ@Repository that contains the Mesa software infrastructure for CI”…””}”(hj^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K%hj[ubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjEubeh}”(h]”h ]”h"]”h$]”h&]”uh1jChŸh³h K%hj@ubjD)”}”(hŒDDRM_CI_COMMIT_SHA A particular revision to use from that repository ”h]”(jJ)”}”(hŒDRM_CI_COMMIT_SHA”h]”hŒDRM_CI_COMMIT_SHA”…””}”(hj|hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jIhŸh³h K(hjxubjZ)”}”(hhh]”hÛ)”}”(hŒ1A particular revision to use from that repository”h]”hŒ1A particular revision to use from that repository”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K(hjŠubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjxubeh}”(h]”h ]”h"]”h$]”h&]”uh1jChŸh³h K(hj@hžhubjD)”}”(hŒAUPSTREAM_REPO URL to git repository containing the target branch ”h]”(jJ)”}”(hŒ UPSTREAM_REPO”h]”hŒ UPSTREAM_REPO”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jIhŸh³h K+hj§ubjZ)”}”(hhh]”hÛ)”}”(hŒ2URL to git repository containing the target branch”h]”hŒ2URL to git repository containing the target branch”…””}”(hj¼hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K+hj¹ubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhj§ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jChŸh³h K+hj@hžhubjD)”}”(hŒ?TARGET_BRANCH Branch to which this branch is to be merged into ”h]”(jJ)”}”(hŒ TARGET_BRANCH”h]”hŒ TARGET_BRANCH”…””}”(hjÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jIhŸh³h K.hjÖubjZ)”}”(hhh]”hÛ)”}”(hŒ0Branch to which this branch is to be merged into”h]”hŒ0Branch to which this branch is to be merged into”…””}”(hjëhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K.hjèubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjÖubeh}”(h]”h ]”h"]”h$]”h&]”uh1jChŸh³h K.hj@hžhubjD)”}”(hŒhIGT_VERSION Revision of igt-gpu-tools being used, from https://gitlab.freedesktop.org/drm/igt-gpu-tools ”h]”(jJ)”}”(hŒ IGT_VERSION”h]”hŒ IGT_VERSION”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jIhŸh³h K2hjubjZ)”}”(hhh]”hÛ)”}”(hŒ[Revision of igt-gpu-tools being used, from https://gitlab.freedesktop.org/drm/igt-gpu-tools”h]”(hŒ+Revision of igt-gpu-tools being used, from ”…””}”(hjhžhhŸNh NubhŒ reference”“”)”}”(hŒ0https://gitlab.freedesktop.org/drm/igt-gpu-tools”h]”hŒ0https://gitlab.freedesktop.org/drm/igt-gpu-tools”…””}”(hj$hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j&uh1j"hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K1hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jChŸh³h K2hj@hžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1j>hjhžhhŸh³h Nubeh}”(h]”Œ drivers-gpu-drm-ci-gitlab-ci-yml”ah ]”h"]”Œ drivers/gpu/drm/ci/gitlab-ci.yml”ah$]”h&]”uh1h´hjhžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒdrivers/gpu/drm/ci/testlist.txt”h]”hŒdrivers/gpu/drm/ci/testlist.txt”…””}”(hjVhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjShžhhŸh³h K5ubhÛ)”}”(hŒaIGT tests to be run on all drivers (unless mentioned in a driver's \*-skips.txt file, see below).”h]”hŒcIGT tests to be run on all drivers (unless mentioned in a driver’s *-skips.txt file, see below).”…””}”(hjdhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K7hjShžhubeh}”(h]”Œdrivers-gpu-drm-ci-testlist-txt”ah ]”h"]”Œdrivers/gpu/drm/ci/testlist.txt”ah$]”h&]”uh1h´hjhžhhŸh³h K5ubhµ)”}”(hhh]”(hº)”}”(hŒ:drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-fails.txt”h]”hŒ:drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-fails.txt”…””}”(hj}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjzhžhhŸh³h K;ubhÛ)”}”(hŒLLists the known failures for a given driver on a specific hardware revision.”h]”hŒLLists the known failures for a given driver on a specific hardware revision.”…””}”(hj‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K=hjzhžhubeh}”(h]”Œ4drivers-gpu-drm-ci-driver-name-hw-revision-fails-txt”ah ]”h"]”Œ:drivers/gpu/drm/ci/${driver_name}-${hw_revision}-fails.txt”ah$]”h&]”uh1h´hjhžhhŸh³h K;ubhµ)”}”(hhh]”(hº)”}”(hŒ;drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-flakes.txt”h]”hŒ;drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-flakes.txt”…””}”(hj¤hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj¡hžhhŸh³h K@ubhÛ)”}”(hŒ¿Lists the tests that for a given driver on a specific hardware revision are known to behave unreliably. These tests won't cause a job to fail regardless of the result. They will still be run.”h]”hŒÁLists the tests that for a given driver on a specific hardware revision are known to behave unreliably. These tests won’t cause a job to fail regardless of the result. They will still be run.”…””}”(hj²hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KBhj¡hžhubhÛ)”}”(hXBEach new flake entry must be associated with a link to the email reporting the bug to the author of the affected driver or the relevant GitLab issue. The entry must also include the board name or Device Tree name, the first kernel version affected, the IGT version used for tests, and an approximation of the failure rate.”h]”hXBEach new flake entry must be associated with a link to the email reporting the bug to the author of the affected driver or the relevant GitLab issue. The entry must also include the board name or Device Tree name, the first kernel version affected, the IGT version used for tests, and an approximation of the failure rate.”…””}”(hjÀhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KFhj¡hžhubhÛ)”}”(hŒ4They should be provided under the following format::”h]”hŒ3They should be provided under the following format:”…””}”(hjÎhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KKhj¡hžhubhŒ literal_block”“”)”}”(hŒ# Bug Report: $LORE_URL_OR_GITLAB_ISSUE # Board Name: broken-board.dtb # Linux Version: 6.6-rc1 # IGT Version: 1.28-gd2af13d9f # Failure Rate: 100 flaky-test”h]”hŒ# Bug Report: $LORE_URL_OR_GITLAB_ISSUE # Board Name: broken-board.dtb # Linux Version: 6.6-rc1 # IGT Version: 1.28-gd2af13d9f # Failure Rate: 100 flaky-test”…””}”hjÞsbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jÜhŸh³h KMhj¡hžhubhÛ)”}”(hX9Use the appropriate link below to create a GitLab issue: amdgpu driver: https://gitlab.freedesktop.org/drm/amd/-/issues i915 driver: https://gitlab.freedesktop.org/drm/i915/kernel/-/issues msm driver: https://gitlab.freedesktop.org/drm/msm/-/issues xe driver: https://gitlab.freedesktop.org/drm/xe/kernel/-/issues”h]”(hŒHUse the appropriate link below to create a GitLab issue: amdgpu driver: ”…””}”(hjìhžhhŸNh Nubj#)”}”(hŒ/https://gitlab.freedesktop.org/drm/amd/-/issues”h]”hŒ/https://gitlab.freedesktop.org/drm/amd/-/issues”…””}”(hjôhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jöuh1j"hjìubhŒ i915 driver: ”…””}”(hjìhžhhŸNh Nubj#)”}”(hŒ7https://gitlab.freedesktop.org/drm/i915/kernel/-/issues”h]”hŒ7https://gitlab.freedesktop.org/drm/i915/kernel/-/issues”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j uh1j"hjìubhŒ msm driver: ”…””}”(hjìhžhhŸNh Nubj#)”}”(hŒ/https://gitlab.freedesktop.org/drm/msm/-/issues”h]”hŒ/https://gitlab.freedesktop.org/drm/msm/-/issues”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”juh1j"hjìubhŒ xe driver: ”…””}”(hjìhžhhŸNh Nubj#)”}”(hŒ5https://gitlab.freedesktop.org/drm/xe/kernel/-/issues”h]”hŒ5https://gitlab.freedesktop.org/drm/xe/kernel/-/issues”…””}”(hj-hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j/uh1j"hjìubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KThj¡hžhubeh}”(h]”Œ5drivers-gpu-drm-ci-driver-name-hw-revision-flakes-txt”ah ]”h"]”Œ;drivers/gpu/drm/ci/${driver_name}-${hw_revision}-flakes.txt”ah$]”h&]”uh1h´hjhžhhŸh³h K@ubhµ)”}”(hhh]”(hº)”}”(hŒ:drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-skips.txt”h]”hŒ:drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-skips.txt”…””}”(hjMhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjJhžhhŸh³h K[ubhÛ)”}”(hŒÝLists the tests that won't be run for a given driver on a specific hardware revision. These are usually tests that interfere with the running of the test list due to hanging the machine, causing OOM, taking too long, etc.”h]”hŒßLists the tests that won’t be run for a given driver on a specific hardware revision. These are usually tests that interfere with the running of the test list due to hanging the machine, causing OOM, taking too long, etc.”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K]hjJhžhubeh}”(h]”Œ4drivers-gpu-drm-ci-driver-name-hw-revision-skips-txt”ah ]”h"]”Œ:drivers/gpu/drm/ci/${driver_name}-${hw_revision}-skips.txt”ah$]”h&]”uh1h´hjhžhhŸh³h K[ubeh}”(h]”Œrelevant-files”ah ]”h"]”Œrelevant files”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒ,How to enable automated testing on your tree”h]”hŒ,How to enable automated testing on your tree”…””}”(hj|hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjyhžhhŸh³h KcubhÛ)”}”(hŒS1. Create a Linux tree in https://gitlab.freedesktop.org/ if you don't have one yet”h]”(hŒ1. Create a Linux tree in ”…””}”(hjŠhžhhŸNh Nubj#)”}”(hŒhttps://gitlab.freedesktop.org/”h]”hŒhttps://gitlab.freedesktop.org/”…””}”(hj’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j”uh1j"hjŠubhŒ if you don’t have one yet”…””}”(hjŠhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KehjyhžhubhÛ)”}”(hŒÈ2. In your kernel repo's configuration (eg. https://gitlab.freedesktop.org/janedoe/linux/-/settings/ci_cd), change the CI/CD configuration file from .gitlab-ci.yml to drivers/gpu/drm/ci/gitlab-ci.yml.”h]”(hŒ.2. In your kernel repo’s configuration (eg. ”…””}”(hj«hžhhŸNh Nubj#)”}”(hŒ=https://gitlab.freedesktop.org/janedoe/linux/-/settings/ci_cd”h]”hŒ=https://gitlab.freedesktop.org/janedoe/linux/-/settings/ci_cd”…””}”(hj³hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jµuh1j"hj«ubhŒ_), change the CI/CD configuration file from .gitlab-ci.yml to drivers/gpu/drm/ci/gitlab-ci.yml.”…””}”(hj«hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhjyhžhubhÛ)”}”(hŒ–3. Request to be added to the drm/ci-ok group so that your user has the necessary privileges to run the CI on https://gitlab.freedesktop.org/drm/ci-ok”h]”(hŒn3. Request to be added to the drm/ci-ok group so that your user has the necessary privileges to run the CI on ”…””}”(hjÌhžhhŸNh Nubj#)”}”(hŒ(https://gitlab.freedesktop.org/drm/ci-ok”h]”hŒ(https://gitlab.freedesktop.org/drm/ci-ok”…””}”(hjÔhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jÖuh1j"hjÌubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KmhjyhžhubhÛ)”}”(hŒ‘4. Next time you push to this repository, you will see a CI pipeline being created (eg. https://gitlab.freedesktop.org/janedoe/linux/-/pipelines)”h]”(hŒX4. Next time you push to this repository, you will see a CI pipeline being created (eg. ”…””}”(hjéhžhhŸNh Nubj#)”}”(hŒ8https://gitlab.freedesktop.org/janedoe/linux/-/pipelines”h]”hŒ8https://gitlab.freedesktop.org/janedoe/linux/-/pipelines”…””}”(hjñhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jóuh1j"hjéubhŒ)”…””}”(hjéhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KphjyhžhubhÛ)”}”(hŒ5. The various jobs will be run and when the pipeline is finished, all jobs should be green unless a regression has been found.”h]”hŒ5. The various jobs will be run and when the pipeline is finished, all jobs should be green unless a regression has been found.”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Kshjyhžhubeh}”(h]”Œ,how-to-enable-automated-testing-on-your-tree”ah ]”h"]”Œ,how to enable automated testing on your tree”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kcubhµ)”}”(hhh]”(hº)”}”(hŒHow to update test expectations”h]”hŒHow to update test expectations”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj hžhhŸh³h KxubhÛ)”}”(hŒÛIf your changes to the code fix any tests, you will have to remove one or more lines from one or more of the files in drivers/gpu/drm/ci/${DRIVER_NAME}_*_fails.txt, for each of the test platforms affected by the change.”h]”hŒÛIf your changes to the code fix any tests, you will have to remove one or more lines from one or more of the files in drivers/gpu/drm/ci/${DRIVER_NAME}_*_fails.txt, for each of the test platforms affected by the change.”…””}”(hj1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Kzhj hžhubeh}”(h]”Œhow-to-update-test-expectations”ah ]”h"]”Œhow to update test expectations”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kxubhµ)”}”(hhh]”(hº)”}”(hŒHow to expand coverage”h]”hŒHow to expand coverage”…””}”(hjJhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjGhžhhŸh³h KubhÛ)”}”(hŒÝIf your code changes make it possible to run more tests (by solving reliability issues, for example), you can remove tests from the flakes and/or skips lists, and then the expected results if there are any known failures.”h]”hŒÝIf your code changes make it possible to run more tests (by solving reliability issues, for example), you can remove tests from the flakes and/or skips lists, and then the expected results if there are any known failures.”…””}”(hjXhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KƒhjGhžhubhÛ)”}”(hŒ¬If there is a need for updating the version of IGT being used (maybe you have added more tests to it), update the IGT_VERSION variable at the top of the gitlab-ci.yml file.”h]”hŒ¬If there is a need for updating the version of IGT being used (maybe you have added more tests to it), update the IGT_VERSION variable at the top of the gitlab-ci.yml file.”…””}”(hjfhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K‡hjGhžhubeh}”(h]”Œhow-to-expand-coverage”ah ]”h"]”Œhow to expand coverage”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒ'How to test your changes to the scripts”h]”hŒ'How to test your changes to the scripts”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj|hžhhŸh³h KubhÛ)”}”(hX For testing changes to the scripts in the drm-ci repo, change the DRM_CI_PROJECT_PATH and DRM_CI_COMMIT_SHA variables in drivers/gpu/drm/ci/gitlab-ci.yml to match your fork of the project (eg. janedoe/drm-ci). This fork needs to be in https://gitlab.freedesktop.org/.”h]”(hŒëFor testing changes to the scripts in the drm-ci repo, change the DRM_CI_PROJECT_PATH and DRM_CI_COMMIT_SHA variables in drivers/gpu/drm/ci/gitlab-ci.yml to match your fork of the project (eg. janedoe/drm-ci). This fork needs to be in ”…””}”(hjhžhhŸNh Nubj#)”}”(hŒhttps://gitlab.freedesktop.org/”h]”hŒhttps://gitlab.freedesktop.org/”…””}”(hj•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j—uh1j"hjubhŒ.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Khj|hžhubeh}”(h]”Œ'how-to-test-your-changes-to-the-scripts”ah ]”h"]”Œ'how to test your changes to the scripts”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒ1How to incorporate external fixes in your testing”h]”hŒ1How to incorporate external fixes in your testing”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj¶hžhhŸh³h K–ubhÛ)”}”(hŒñOften, regressions in other trees will prevent testing changes local to the tree under test. These fixes will be automatically merged in during the build jobs from a branch in the target tree that is named as ${TARGET_BRANCH}-external-fixes.”h]”hŒñOften, regressions in other trees will prevent testing changes local to the tree under test. These fixes will be automatically merged in during the build jobs from a branch in the target tree that is named as ${TARGET_BRANCH}-external-fixes.”…””}”(hjÇhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K˜hj¶hžhubhÛ)”}”(hŒ—If the pipeline is not in a merge request and a branch with the same name exists in the local tree, commits from that branch will be merged in as well.”h]”hŒ—If the pipeline is not in a merge request and a branch with the same name exists in the local tree, commits from that branch will be merged in as well.”…””}”(hjÕhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Khj¶hžhubeh}”(h]”Œ1how-to-incorporate-external-fixes-in-your-testing”ah ]”h"]”Œ1how to incorporate external fixes in your testing”ah$]”h&]”uh1h´hh¶hžhhŸh³h K–ubhµ)”}”(hhh]”(hº)”}”(hŒ8How to deal with automated testing labs that may be down”h]”hŒ8How to deal with automated testing labs that may be down”…””}”(hjîhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjëhžhhŸh³h K¢ubhÛ)”}”(hŒúIf a hardware farm is down and thus causing pipelines to fail that would otherwise pass, one can disable all jobs that would be submitted to that farm by editing the file at https://gitlab.freedesktop.org/gfx-ci/lab-status/-/blob/main/lab-status.yml.”h]”(hŒ®If a hardware farm is down and thus causing pipelines to fail that would otherwise pass, one can disable all jobs that would be submitted to that farm by editing the file at ”…””}”(hjühžhhŸNh Nubj#)”}”(hŒKhttps://gitlab.freedesktop.org/gfx-ci/lab-status/-/blob/main/lab-status.yml”h]”hŒKhttps://gitlab.freedesktop.org/gfx-ci/lab-status/-/blob/main/lab-status.yml”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”juh1j"hjüubhŒ.”…””}”(hjühžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K¤hjëhžhubeh}”(h]”Œ8how-to-deal-with-automated-testing-labs-that-may-be-down”ah ]”h"]”Œ8how to deal with automated testing labs that may be down”ah$]”h&]”uh1h´hh¶hžhhŸh³h K¢ubeh}”(h]”Œ&automated-testing-of-the-drm-subsystem”ah ]”h"]”Œ&automated testing of the drm subsystem”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jPŒerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j*j'j jjvjsjPjMjwjtjžj›jGjDjnjkjjjDjAjyjvj³j°jèjåj"juŒ nametypes”}”(j*‰j ‰jv‰jP‰jw‰jž‰jG‰jn‰j‰jD‰jy‰j³‰jè‰j"‰uh}”(j'h¶jhÉjsjjMjjtjSj›jzjDj¡jkjJjjyjAj jvjGj°j|jåj¶jjëuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nhžhub.