From patchwork Tue Oct 28 15:03:54 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Wood X-Patchwork-Id: 5177971 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 1530BC11AD for ; Tue, 28 Oct 2014 15:04:12 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 0ACE420179 for ; Tue, 28 Oct 2014 15:04:10 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.kernel.org (Postfix) with ESMTP id 8946C2022D for ; Tue, 28 Oct 2014 15:04:05 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id EAFE86E3F5; Tue, 28 Oct 2014 08:04:04 -0700 (PDT) X-Original-To: intel-gfx@lists.freedesktop.org Delivered-To: intel-gfx@lists.freedesktop.org Received: from mail-wg0-f41.google.com (mail-wg0-f41.google.com [74.125.82.41]) by gabe.freedesktop.org (Postfix) with ESMTP id 8CAFF6E3F5 for ; Tue, 28 Oct 2014 08:04:02 -0700 (PDT) Received: by mail-wg0-f41.google.com with SMTP id k14so1084235wgh.12 for ; Tue, 28 Oct 2014 08:04:01 -0700 (PDT) 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=l61MwPCIltRP7fc5jTIRNO7+Tj2hqV0fF1gJrKlCUGQ=; b=YL4Nz8VUTa09vpEe76QSAb8ihyi/gSVGFV8CkrGrGcGdu+TwHpbTL6pS15rYxyMuxN FE8afqGzd7rE/JOgn1kKjVhVduqv0OsmvqBAL+6EoLAhjmef5Jm9tLG0iXqP99s3s3cc J3rQNgYy0KLZRd9gkvfjggAyr4pV/bcIyOYrskORaxlK8S0DlfI2ABQz1HZDYu0asvV5 2B637gIHvqdTyprGPjMppODpOog2257iyPgSIHHyg8tc6hMNMxNXeheu55mfJMTGpV5v IFHDheFPrBWGcy+DJ7ONx4CDgbi1xYNfV1BQPV8XmsmCqRwDXQFy7d+nNu3DYfRRD0P4 NGJw== X-Gm-Message-State: ALoCoQmLOX1lrIyOkxW2UFmvIKO5IkAG/LJO4NAFCsA63U4Jq6qmMKqx68omCEKZ3375TUeLl9nc X-Received: by 10.194.250.68 with SMTP id za4mr4812764wjc.83.1414508641376; Tue, 28 Oct 2014 08:04:01 -0700 (PDT) Received: from pistachio.icx.intel.com ([83.217.123.106]) by mx.google.com with ESMTPSA id ic4sm15688465wid.19.2014.10.28.08.04.00 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Oct 2014 08:04:00 -0700 (PDT) From: Thomas Wood To: intel-gfx@lists.freedesktop.org Date: Tue, 28 Oct 2014 15:03:54 +0000 Message-Id: <1414508636-13543-2-git-send-email-thomas.wood@intel.com> X-Mailer: git-send-email 2.1.0 In-Reply-To: <1414508636-13543-1-git-send-email-thomas.wood@intel.com> References: <1414508636-13543-1-git-send-email-thomas.wood@intel.com> Subject: [Intel-gfx] [PATCH i-g-t 2/4] docs: add some test descriptions 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.8 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, 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 Signed-off-by: Thomas Wood --- tests/core_getclient.c | 5 ++--- tests/core_getstats.c | 3 +++ tests/core_getversion.c | 6 +++--- tests/kms_3d.c | 2 ++ tests/kms_cursor_crc.c | 8 ++++++++ tests/kms_fbc_crc.c | 5 +++++ tests/kms_fence_pin_leak.c | 2 ++ tests/kms_flip_event_leak.c | 12 ++++++------ 8 files changed, 31 insertions(+), 12 deletions(-) diff --git a/tests/core_getclient.c b/tests/core_getclient.c index ed46e51..92bf3e7 100644 --- a/tests/core_getclient.c +++ b/tests/core_getclient.c @@ -32,9 +32,8 @@ #include "drmtest.h" -/** - * Checks DRM_IOCTL_GET_CLIENT. - */ +IGT_TEST_DESCRIPTION("Tests the DRM_IOCTL_GET_CLIENT ioctl.") + igt_simple_main { int fd, ret; diff --git a/tests/core_getstats.c b/tests/core_getstats.c index 1e2c565..52a2d20 100644 --- a/tests/core_getstats.c +++ b/tests/core_getstats.c @@ -40,6 +40,9 @@ * I don't care too much about the actual contents, just that the kernel * doesn't crash. */ + +IGT_TEST_DESCRIPTION("Tests the DRM_IOCTL_GET_STATS ioctl."); + igt_simple_main { int fd, ret; diff --git a/tests/core_getversion.c b/tests/core_getversion.c index 7058c89..30132e4 100644 --- a/tests/core_getversion.c +++ b/tests/core_getversion.c @@ -29,9 +29,9 @@ #include #include "drmtest.h" -/** - * Checks DRM_IOCTL_GET_VERSION and libdrm's drmGetVersion() interface to it. - */ +IGT_TEST_DESCRIPTION("Tests the DRM_IOCTL_GET_VERSION ioctl and libdrm's " + "drmGetVersion() interface to it."); + igt_simple_main { int fd; diff --git a/tests/kms_3d.c b/tests/kms_3d.c index 4ecb90d..6c8ab33 100644 --- a/tests/kms_3d.c +++ b/tests/kms_3d.c @@ -27,6 +27,8 @@ #include "drmtest.h" #include "igt_edid.h" +IGT_TEST_DESCRIPTION("Tests 3D mode setting.") + igt_simple_main { int drm_fd; diff --git a/tests/kms_cursor_crc.c b/tests/kms_cursor_crc.c index 87b4f64..5772ed4 100644 --- a/tests/kms_cursor_crc.c +++ b/tests/kms_cursor_crc.c @@ -34,6 +34,14 @@ #include "intel_chipset.h" #include "igt_aux.h" +IGT_TEST_DESCRIPTION( + "Use the display CRC support to validate cursor plane functionality. " + "The test will position the cursor plane either fully onscreen, " + "partially onscreen, or fully offscreen, using either a fully opaque " + "or fully transparent surface. In each case it then reads the PF CRC " + "and compares it with the CRC value obtained when the cursor plane " + "was disabled."); + #ifndef DRM_CAP_CURSOR_WIDTH #define DRM_CAP_CURSOR_WIDTH 0x8 #endif diff --git a/tests/kms_fbc_crc.c b/tests/kms_fbc_crc.c index e1e8e97..43e68bd 100644 --- a/tests/kms_fbc_crc.c +++ b/tests/kms_fbc_crc.c @@ -34,6 +34,11 @@ #include "intel_batchbuffer.h" #include "ioctl_wrappers.h" +IGT_TEST_DESCRIPTION( + "Performs various write operations to the scanout buffer while FBC is " + "enabled. CRC checks will be used to make sure the modifications to scanout " + "buffer are detected."); + enum test_mode { TEST_PAGE_FLIP, TEST_MMAP_CPU, diff --git a/tests/kms_fence_pin_leak.c b/tests/kms_fence_pin_leak.c index 5610ad8..6b032b0 100644 --- a/tests/kms_fence_pin_leak.c +++ b/tests/kms_fence_pin_leak.c @@ -35,6 +35,8 @@ #include "intel_chipset.h" #include "igt_aux.h" +IGT_TEST_DESCRIPTION("Exercises full ppgtt fence pin_count leak in the kernel.") + typedef struct { int drm_fd; uint32_t devid; diff --git a/tests/kms_flip_event_leak.c b/tests/kms_flip_event_leak.c index 0b45471..d30874d 100644 --- a/tests/kms_flip_event_leak.c +++ b/tests/kms_flip_event_leak.c @@ -39,12 +39,12 @@ typedef struct { igt_display_t display; } data_t; -/* - * This test tries to provoke the kernel to leak a pending page flip event - * when the fd is closed before the flip has completed. The test itself won't - * fail even if the kernel leaks the event, but the resulting dmesg WARN - * will cause piglit to report a failure. - */ +IGT_TEST_DESCRIPTION( + "This test tries to provoke the kernel into leaking a pending page flip " + "event when the fd is closed before the flip has completed. The test " + "itself won't fail even if the kernel leaks the event, but the resulting " + "dmesg WARN will indicate a failure.") + static bool test(data_t *data, enum pipe pipe, igt_output_t *output) { igt_plane_t *primary;