From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6754190139198537728 X-Received: by 2002:a25:f20e:: with SMTP id i14mr7868654ybe.477.1572582437997; Thu, 31 Oct 2019 21:27:17 -0700 (PDT) X-BeenThere: outreachy-kernel@googlegroups.com Received: by 2002:a0d:f703:: with SMTP id h3ls764810ywf.2.gmail; Thu, 31 Oct 2019 21:27:16 -0700 (PDT) X-Google-Smtp-Source: APXvYqwJU13QRxauGSkf7eRVebPHkpds/4O5NwwWjOksiy8W7XDcZpF9pMYDZL6PyfM/VK8niGmo X-Received: by 2002:a81:61c3:: with SMTP id v186mr7205582ywb.151.1572582436696; Thu, 31 Oct 2019 21:27:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1572582436; cv=none; d=google.com; s=arc-20160816; b=tpV73HXlaJaY2QWmyz3At3tsH9Z5XyF58SkiusgIzTvrihq/8P9kVdSLmWiGjWaG8v Eb+97KGYMZDo7BGYgeHbBwJkAvsfigoMmITGe4uBww9Ve0aALKgFnY1sR/966/lv/LeH kYPKYrsHM9XUoB+qWh5r65A2v3Q+iq59aIl6Mb4L/AY7b6Hzs+PgZ1YTSwRPEs2s2lt5 tr4nKdRBzRH23DUyFVtdHBRLgfkCgB6PCt8glP+8qciHZpOni1zKm5aEvgUjCGPAKvmQ HntYX9QTwIHp7xriwTP8zKi9aMJMPsAUkKEprR/dLq2hnCI7wiAKrf5xu3G5+N9hNzwF Xmcg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:dkim-signature; bh=HpS7M3wugMxRqvwJlP7zk8Xh32CVSZbs51QsUAEIzfw=; b=G7gJGM80Gju9l6QR1FqtKBen0wSJpxcIpHFOrIC7fdwPtPUmbODiqB35bYR6EkAiCz vpmU4TLhQaj4mNsVOe9qYC7wmgVjDHzlTFhgNYWLPgrxVMVca27DwG4w/H1XSGyQ7ENr tMtGkssFw8yMWdLLUJra3q3lBG/9mXL7jU/GhaYsIn4Dnn87sUPjPBfn/boEB0zJfexX k2msJMn+ULGDCdWbFJ6ZoVAIZFmLd6PxfQpA49itC2/wH4fj0x9WKQUkmGGGZpXygUG/ c741VQDoCfU92s5Zx2xTQ8himM0jH1g/i5/YJN9xs8nNHoFiQVRNOov+Ju6bIJc+hoVY vkrg== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=eYOl9Xry; spf=pass (google.com: domain of gabrielabittencourt00@gmail.com designates 2607:f8b0:4864:20::841 as permitted sender) smtp.mailfrom=gabrielabittencourt00@gmail.com; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from mail-qt1-x841.google.com (mail-qt1-x841.google.com. [2607:f8b0:4864:20::841]) by gmr-mx.google.com with ESMTPS id a1si495135ywh.3.2019.10.31.21.27.16 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 31 Oct 2019 21:27:16 -0700 (PDT) Received-SPF: pass (google.com: domain of gabrielabittencourt00@gmail.com designates 2607:f8b0:4864:20::841 as permitted sender) client-ip=2607:f8b0:4864:20::841; Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=eYOl9Xry; spf=pass (google.com: domain of gabrielabittencourt00@gmail.com designates 2607:f8b0:4864:20::841 as permitted sender) smtp.mailfrom=gabrielabittencourt00@gmail.com; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: by mail-qt1-x841.google.com with SMTP id c26so11495792qtj.10 for ; Thu, 31 Oct 2019 21:27:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=HpS7M3wugMxRqvwJlP7zk8Xh32CVSZbs51QsUAEIzfw=; b=eYOl9Xry51JB4XOdcoO0HKnLb5V3OO+fyyZXo3Gyk4O17pxoDfoSvQUCR7XNoasLmn 1JpmLWlUEimCevap83AXVIUpMM4tmRf7BrH/H9HZPBHebQwP4EUXbC7Mpu/iAUjg9bx4 K/Gnk0D2Xoe4iTxrsIsps+Z1VX4K2XAEJQe1EY4qUmWUkm2MDrHWhRSkW90OsfNKH+at djFMIo9+Ypc0/PLBXNAydL8HRDa6ovC53rdB2Yv+9dgU30Jc9nGMQ7WSDhRJ/YdLkB8p 3j//UCXEPr/yf2jxd3nXQKS5QarHMHlwIztXZJv9pIM9MK5iHpry0oPwBnaUJMvVUwNU kw+Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=HpS7M3wugMxRqvwJlP7zk8Xh32CVSZbs51QsUAEIzfw=; b=PgZTufb6HZQK7zsAHC2siM34gr3GQcsambuAzhkEVU1JvXZj0PuQ+sK61CsyhpCtkN xv/fzKRWK4YOQpAvtDlveQCUd9YMgc05EmUFXuHCtB5D1Hwgz+P0Gyao6fcNuA9QrOcl 8nF9Mc8YTiFD6N3Xz81qlStn5BUiYpAuZZdgkDddOIZ2P72ARPaqX8js0oWIrWwtjRdp Y5IaEkNbSNCgVcZQ+XaAN8OaRDbThSQXltp+HYzvDck8U3CkzW6BS8p8Dw4b0ipeEb91 TKeB69HeWjHh+k5kThaAjib/tbyhlZ2hi2pERrIXMC66CdnPP5r3aIktDeykQpo/OCbB 3xpQ== X-Gm-Message-State: APjAAAW19SNfh+DBiqew55Bf2hG31XE8XI8YVKB2uZVGLIR3qmqFt01j +w3ZZa2JO9ln2kVsagmpxHlBl0IcNJI= X-Received: by 2002:aed:24af:: with SMTP id t44mr1230263qtc.135.1572582435878; Thu, 31 Oct 2019 21:27:15 -0700 (PDT) Return-Path: Received: from localhost.localdomain ([187.106.44.83]) by smtp.gmail.com with ESMTPSA id w24sm3719838qta.44.2019.10.31.21.27.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 31 Oct 2019 21:27:15 -0700 (PDT) From: Gabriela Bittencourt To: outreachy-kernel@googlegroups.com, manasi.d.navare@intel.com, rodrigosiqueiramelo@gmail.com, maarten.lankhorst@linux.intel.com, mripard@kernel.org, sean@poorly.run, airlied@linux.ie, daniel@ffwll.ch, corbet@lwn.net, dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, lkcamp@lists.libreplanetbr.org Cc: Gabriela Bittencourt Subject: [PATCH] drm/doc: Adding VKMS module description and use to "Testing and Validation" Date: Fri, 1 Nov 2019 01:27:06 -0300 Message-Id: <20191101042706.2602-1-gabrielabittencourt00@gmail.com> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Add a description on VKMS module and the cases in which it should be used. There's a brief explanation on how to set it and use it in a VM, along with an example of running an igt-test. Signed-off-by: Gabriela Bittencourt --- Hi DRM-community, this is my first (of many, I hope) patch in this subsystem. I hope to have a lot of learning (and fun :)) working with you guys. I'm starting by documenting the VKMS driver in "Userland interfaces", if I have been inaccurate in my description or if I misunderstood some concept, please let me know. --- Documentation/gpu/drm-uapi.rst | 38 ++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/Documentation/gpu/drm-uapi.rst b/Documentation/gpu/drm-uapi.rst index 94f90521f58c..7d6c86b7af76 100644 --- a/Documentation/gpu/drm-uapi.rst +++ b/Documentation/gpu/drm-uapi.rst @@ -285,6 +285,44 @@ 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. +Using VKMS to test DRM API +-------------------------- + +VKMS is a software-only model of a KMS driver that is useful for testing +and for running compositors. VKMS aims to enable a virtual display without +the need for a hardware display capability. These characteristics made VKMS +a perfect tool for validating the DRM core behavior and also support the +compositor developer. VKMS helps us to test DRM core function in a virtual +machine, which makes it easy to test some of the core changes. + +To Validate changes in DRM API with VKMS, start setting the kernel. The +VKMS module is not enabled by defaut, so enable it in the menuconfig:: + + $ make menuconfig + +Compile the kernel with the VKMS enabled and install it in the target +machine. VKMS can be run in a Virtual Machine (QEMU, virtme or similar). +It's recommended the use of KVM with the minimum of 1GB of RAM and four +cores. + +It's possible to run the IGT-tests in a VM in two ways: +1. Use IGT inside a VM +2. Use IGT from the host machine and write the results in a shared directory. + +As follow, there is an example of using a VM with a shared directory with +the host machine to run igt-tests. As example it's used virtme:: + + $ virtme-run --rwdir /path/for/shared_dir --kdir=path/for/kernel/directory --mods=auto + +Run the igt-tests, as example it's ran the 'kms_flip' tests:: + + $ /path/for/igt-gpu-tools/scripts/run-tests.sh -p -s -t "kms_flip.*" -v + +In this example instead of build the igt_runner it's used Piglit +(-p option); it's created html summary of the tests results and it's saved +in the folder "igt-gpu-tools/results"; it's executed only the igt-tests +matching the -t option. + Display CRC Support ------------------- -- 2.20.1 From mboxrd@z Thu Jan 1 00:00:00 1970 From: Gabriela Bittencourt Subject: [PATCH] drm/doc: Adding VKMS module description and use to "Testing and Validation" Date: Fri, 1 Nov 2019 01:27:06 -0300 Message-ID: <20191101042706.2602-1-gabrielabittencourt00@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-qt1-x841.google.com (mail-qt1-x841.google.com [IPv6:2607:f8b0:4864:20::841]) by gabe.freedesktop.org (Postfix) with ESMTPS id 078AD6E172 for ; Fri, 1 Nov 2019 04:27:17 +0000 (UTC) Received: by mail-qt1-x841.google.com with SMTP id o3so11506916qtj.8 for ; Thu, 31 Oct 2019 21:27:16 -0700 (PDT) List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: outreachy-kernel@googlegroups.com, manasi.d.navare@intel.com, rodrigosiqueiramelo@gmail.com, maarten.lankhorst@linux.intel.com, mripard@kernel.org, sean@poorly.run, airlied@linux.ie, daniel@ffwll.ch, corbet@lwn.net, dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, lkcamp@lists.libreplanetbr.org Cc: Gabriela Bittencourt List-Id: dri-devel@lists.freedesktop.org QWRkIGEgZGVzY3JpcHRpb24gb24gVktNUyBtb2R1bGUgYW5kIHRoZSBjYXNlcyBpbiB3aGljaCBp dCBzaG91bGQgYmUgdXNlZC4KVGhlcmUncyBhIGJyaWVmIGV4cGxhbmF0aW9uIG9uIGhvdyB0byBz ZXQgaXQgYW5kIHVzZSBpdCBpbiBhIFZNLCBhbG9uZyB3aXRoCmFuIGV4YW1wbGUgb2YgcnVubmlu ZyBhbiBpZ3QtdGVzdC4KClNpZ25lZC1vZmYtYnk6IEdhYnJpZWxhIEJpdHRlbmNvdXJ0IDxnYWJy aWVsYWJpdHRlbmNvdXJ0MDBAZ21haWwuY29tPgoKLS0tCgpIaSBEUk0tY29tbXVuaXR5LAp0aGlz IGlzIG15IGZpcnN0IChvZiBtYW55LCBJIGhvcGUpICBwYXRjaCBpbiB0aGlzIHN1YnN5c3RlbS4g SSBob3BlIHRvIGhhdmUKYSBsb3Qgb2YgbGVhcm5pbmcgKGFuZCBmdW4gOikpIHdvcmtpbmcgd2l0 aCB5b3UgZ3V5cy4KSSdtIHN0YXJ0aW5nIGJ5IGRvY3VtZW50aW5nIHRoZSBWS01TIGRyaXZlciBp biAiVXNlcmxhbmQgaW50ZXJmYWNlcyIsIGlmIEkKaGF2ZSBiZWVuIGluYWNjdXJhdGUgaW4gbXkg ZGVzY3JpcHRpb24gb3IgaWYgSSBtaXN1bmRlcnN0b29kIHNvbWUgY29uY2VwdCwKcGxlYXNlIGxl dCBtZSBrbm93LgotLS0KIERvY3VtZW50YXRpb24vZ3B1L2RybS11YXBpLnJzdCB8IDM4ICsrKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAzOCBpbnNlcnRp b25zKCspCgpkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9ncHUvZHJtLXVhcGkucnN0IGIvRG9j dW1lbnRhdGlvbi9ncHUvZHJtLXVhcGkucnN0CmluZGV4IDk0ZjkwNTIxZjU4Yy4uN2Q2Yzg2Yjdh Zjc2IDEwMDY0NAotLS0gYS9Eb2N1bWVudGF0aW9uL2dwdS9kcm0tdWFwaS5yc3QKKysrIGIvRG9j dW1lbnRhdGlvbi9ncHUvZHJtLXVhcGkucnN0CkBAIC0yODUsNiArMjg1LDQ0IEBAIHJ1bi10ZXN0 cy5zaCBpcyBhIHdyYXBwZXIgYXJvdW5kIHBpZ2xpdCB0aGF0IHdpbGwgZXhlY3V0ZSB0aGUgdGVz dHMgbWF0Y2hpbmcKIHRoZSAtdCBvcHRpb25zLiBBIHJlcG9ydCBpbiBIVE1MIGZvcm1hdCB3aWxs IGJlIGF2YWlsYWJsZSBpbgogLi9yZXN1bHRzL2h0bWwvaW5kZXguaHRtbC4gUmVzdWx0cyBjYW4g YmUgY29tcGFyZWQgd2l0aCBwaWdsaXQuCiAKK1VzaW5nIFZLTVMgdG8gdGVzdCBEUk0gQVBJCist LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQorCitWS01TIGlzIGEgc29mdHdhcmUtb25seSBtb2Rl bCBvZiBhIEtNUyBkcml2ZXIgdGhhdCBpcyB1c2VmdWwgZm9yIHRlc3RpbmcKK2FuZCBmb3IgcnVu bmluZyBjb21wb3NpdG9ycy4gVktNUyBhaW1zIHRvIGVuYWJsZSBhIHZpcnR1YWwgZGlzcGxheSB3 aXRob3V0Cit0aGUgbmVlZCBmb3IgYSBoYXJkd2FyZSBkaXNwbGF5IGNhcGFiaWxpdHkuIFRoZXNl IGNoYXJhY3RlcmlzdGljcyBtYWRlIFZLTVMKK2EgcGVyZmVjdCB0b29sIGZvciB2YWxpZGF0aW5n IHRoZSBEUk0gY29yZSBiZWhhdmlvciBhbmQgYWxzbyBzdXBwb3J0IHRoZQorY29tcG9zaXRvciBk ZXZlbG9wZXIuIFZLTVMgaGVscHMgdXMgdG8gdGVzdCBEUk0gY29yZSBmdW5jdGlvbiBpbiBhIHZp cnR1YWwKK21hY2hpbmUsIHdoaWNoIG1ha2VzIGl0IGVhc3kgdG8gdGVzdCBzb21lIG9mIHRoZSBj b3JlIGNoYW5nZXMuCisKK1RvIFZhbGlkYXRlIGNoYW5nZXMgaW4gRFJNIEFQSSB3aXRoIFZLTVMs IHN0YXJ0IHNldHRpbmcgdGhlIGtlcm5lbC4gVGhlCitWS01TIG1vZHVsZSBpcyBub3QgZW5hYmxl ZCBieSBkZWZhdXQsIHNvIGVuYWJsZSBpdCBpbiB0aGUgbWVudWNvbmZpZzo6CisKKwkkIG1ha2Ug bWVudWNvbmZpZworCitDb21waWxlIHRoZSBrZXJuZWwgd2l0aCB0aGUgVktNUyBlbmFibGVkIGFu ZCBpbnN0YWxsIGl0IGluIHRoZSB0YXJnZXQKK21hY2hpbmUuIFZLTVMgY2FuIGJlIHJ1biBpbiBh IFZpcnR1YWwgTWFjaGluZSAoUUVNVSwgdmlydG1lIG9yIHNpbWlsYXIpLgorSXQncyByZWNvbW1l bmRlZCB0aGUgdXNlIG9mIEtWTSB3aXRoIHRoZSBtaW5pbXVtIG9mIDFHQiBvZiBSQU0gYW5kIGZv dXIKK2NvcmVzLgorCitJdCdzIHBvc3NpYmxlIHRvIHJ1biB0aGUgSUdULXRlc3RzIGluIGEgVk0g aW4gdHdvIHdheXM6CisxLiBVc2UgSUdUIGluc2lkZSBhIFZNCisyLiBVc2UgSUdUIGZyb20gdGhl IGhvc3QgbWFjaGluZSBhbmQgd3JpdGUgdGhlIHJlc3VsdHMgaW4gYSBzaGFyZWQgZGlyZWN0b3J5 LgorCitBcyBmb2xsb3csIHRoZXJlIGlzIGFuIGV4YW1wbGUgb2YgdXNpbmcgYSBWTSB3aXRoIGEg c2hhcmVkIGRpcmVjdG9yeSB3aXRoCit0aGUgaG9zdCBtYWNoaW5lIHRvIHJ1biBpZ3QtdGVzdHMu IEFzIGV4YW1wbGUgaXQncyB1c2VkIHZpcnRtZTo6CisKKwkkIHZpcnRtZS1ydW4gLS1yd2RpciAv cGF0aC9mb3Ivc2hhcmVkX2RpciAtLWtkaXI9cGF0aC9mb3Iva2VybmVsL2RpcmVjdG9yeSAtLW1v ZHM9YXV0bworCitSdW4gdGhlIGlndC10ZXN0cywgYXMgZXhhbXBsZSBpdCdzIHJhbiB0aGUgJ2tt c19mbGlwJyB0ZXN0czo6CisKKwkkIC9wYXRoL2Zvci9pZ3QtZ3B1LXRvb2xzL3NjcmlwdHMvcnVu LXRlc3RzLnNoIC1wIC1zIC10ICJrbXNfZmxpcC4qIiAtdgorCitJbiB0aGlzIGV4YW1wbGUgaW5z dGVhZCBvZiBidWlsZCB0aGUgaWd0X3J1bm5lciBpdCdzIHVzZWQgUGlnbGl0CisoLXAgb3B0aW9u KTsgaXQncyBjcmVhdGVkIGh0bWwgc3VtbWFyeSBvZiB0aGUgdGVzdHMgcmVzdWx0cyBhbmQgaXQn cyBzYXZlZAoraW4gdGhlIGZvbGRlciAiaWd0LWdwdS10b29scy9yZXN1bHRzIjsgaXQncyBleGVj dXRlZCBvbmx5IHRoZSBpZ3QtdGVzdHMKK21hdGNoaW5nIHRoZSAtdCBvcHRpb24uCisKIERpc3Bs YXkgQ1JDIFN1cHBvcnQKIC0tLS0tLS0tLS0tLS0tLS0tLS0KIAotLSAKMi4yMC4xCgpfX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpkcmktZGV2ZWwgbWFpbGlu ZyBsaXN0CmRyaS1kZXZlbEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVl ZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9kcmktZGV2ZWw=