From patchwork Fri Nov 28 13:45:32 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Wood X-Patchwork-Id: 5403651 Return-Path: X-Original-To: patchwork-intel-gfx@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork2.web.kernel.org (Postfix) with ESMTP id A08B9BEEA8 for ; Fri, 28 Nov 2014 13:45:51 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 80B2C201BB for ; Fri, 28 Nov 2014 13:45:49 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.kernel.org (Postfix) with ESMTP id 5C76720115 for ; Fri, 28 Nov 2014 13:45:48 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id A3A6D6EE51; Fri, 28 Nov 2014 05:45:47 -0800 (PST) X-Original-To: intel-gfx@lists.freedesktop.org Delivered-To: intel-gfx@lists.freedesktop.org Received: from mail-wg0-f49.google.com (mail-wg0-f49.google.com [74.125.82.49]) by gabe.freedesktop.org (Postfix) with ESMTP id 82E876E370 for ; Fri, 28 Nov 2014 05:45:45 -0800 (PST) Received: by mail-wg0-f49.google.com with SMTP id n12so641237wgh.22 for ; Fri, 28 Nov 2014 05:45:42 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references; bh=DkYGv/8IjK5emp3gdKY189Nb4PJEeLaIvY0qrSZW4KQ=; b=ckKW1/ufu6MVP/6voSA65vJ2pwcI8Ic00JNjPbeHUfk3ziUT9bmCe6SS3/v2qgvB6Y 4lfh2YX68piArV+Njon99oIC0+6MzbGSFFgvhxEeuRluGOYKHounzaFvN0LunJPBysU4 vzC9gktoFD9osHRNNbNH3qx6iH4JSsq85hoY1+nlGmdhwyPlQ4nSZXh1JSHJvoga6+M6 EShyKX0/0FvOSTjCKmxmcIpygS/PaeRvI7govVgstIKdZx9HYJqV0SMQ2WhufnLm8eeB AjH2ICDSGDJKwPt+JGm48oNkHS8ERvElYXs0UAHCq1DnkdvB8pV6VC+Z00ECCKboNJok c9fA== X-Gm-Message-State: ALoCoQkJI9AhmDBK9Hi27IzPk6Qh3YeJKH9Y06XWVoY4lmKB0S50Td3/e54oSrYIbO/kf+sqqjSZ X-Received: by 10.180.96.103 with SMTP id dr7mr12794888wib.47.1417182342480; Fri, 28 Nov 2014 05:45:42 -0800 (PST) Received: from pistachio.icx.intel.com ([83.217.123.106]) by mx.google.com with ESMTPSA id fo12sm29621243wic.19.2014.11.28.05.45.41 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 28 Nov 2014 05:45:41 -0800 (PST) From: Thomas Wood To: intel-gfx@lists.freedesktop.org Date: Fri, 28 Nov 2014 13:45:32 +0000 Message-Id: <1417182334-20027-4-git-send-email-thomas.wood@intel.com> X-Mailer: git-send-email 2.1.0 In-Reply-To: <1417182334-20027-1-git-send-email-thomas.wood@intel.com> References: <1417182334-20027-1-git-send-email-thomas.wood@intel.com> Subject: [Intel-gfx] [PATCH i-g-t 4/6] docs: add a glossary of test name terms X-BeenThere: intel-gfx@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Intel graphics driver community testing & development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add a glossary of test name terms based on the details in tests/NAMING-CONVENTION. Signed-off-by: Thomas Wood --- docs/reference/intel-gpu-tools/Makefile.am | 10 +- .../intel-gpu-tools/igt_test_programs.xml | 106 +++++++++++++++++++++ 2 files changed, 114 insertions(+), 2 deletions(-) diff --git a/docs/reference/intel-gpu-tools/Makefile.am b/docs/reference/intel-gpu-tools/Makefile.am index d7ef4df..53a6224 100644 --- a/docs/reference/intel-gpu-tools/Makefile.am +++ b/docs/reference/intel-gpu-tools/Makefile.am @@ -1,6 +1,8 @@ ## Process this file with automake to produce Makefile.in TESTLISTS = $(top_builddir)/tests/single-tests.txt $(top_builddir)/tests/multi-tests.txt +KEYWORDS = (hang|swap|thrash|crc|tiled|tiling|normal|uncached|snoop|rte|ctx|exec|rpm) + xml/igt_test_programs_%_programs.xml: $(TESTLISTS) mkdir -p `dirname $@` echo "" > $@ @@ -32,7 +34,9 @@ xml/igt_test_programs_%_description.xml: $(TESTLISTS) echo "" >> $@ echo "Description" >> $@ for test in `cat $(TESTLISTS) | tr ' ' '\n' | grep "^$*" | sort`; do \ - echo "$$test" >> $@; \ + echo "" >> $@; \ + echo "$$test" | perl -pe 's/(?<=_)$(KEYWORDS)(?=(_|\W))/<acronym>\1<\/acronym>/g' >> $@; \ + echo "" >> $@; \ if [ -x $(top_builddir)/tests/$$test ]; then \ testprog=$(top_builddir)/tests/$$test; \ else \ @@ -44,7 +48,9 @@ xml/igt_test_programs_%_description.xml: $(TESTLISTS) echo "Subtests" >> $@; \ echo "" >> $@; \ for subtest in `./$$testprog --list-subtests`; do \ - echo "$$subtest" >> $@; \ + echo "" >> $@; \ + echo "$$subtest" | perl -pe 's/\b$(KEYWORDS)\b/\1<\/acronym>/g' >> $@; \ + echo "" >> $@; \ done; \ echo "" >> $@; \ fi; \ diff --git a/docs/reference/intel-gpu-tools/igt_test_programs.xml b/docs/reference/intel-gpu-tools/igt_test_programs.xml index 07285fe..970ecb9 100644 --- a/docs/reference/intel-gpu-tools/igt_test_programs.xml +++ b/docs/reference/intel-gpu-tools/igt_test_programs.xml @@ -187,4 +187,110 @@ + + + Gloassary + + The following terms are commonly used in test names to describe + various features of the test and can be used to filter and select + particular tests. + + + hang + + Tests that provoke gpu hangs. + + + + + swap + + Tests that force their full working sets through swap. + + + + + thrash + + Tests that tend to have really slow forward progress due to gtt/memory/.. thrashing. + + + + + crc + + Tests that use the display CRC infrastructure to check the results. + + + + + tiled + + Tests that exercise behaviour on tiled buffers. + + + + + tiling + + Tests that exercise behaviour on tiled buffers. + + + + + rte + + Runtime enviroment checks. + + + + + ctx + + Tests that exercise the hardware context support. + + + + + render + + Tests which apply to the render ring. + + + + + blt + + Tests which apply to the blt ring. + + + + + bsd + + Tests which apply to the bsd ring. + + + + + vebox + + Tests which apply to the vebox ring. + + + + + exec + + Tests that exercise the execbuf code in various ways. + + + + + rpm + + Runtime power management tests. + + +