From: Oscar Mateo Subject: [PATCH v3 22/22] drm/i915: Document the i915_workarounds file Date: Fri, 13 Oct 2017 13:54:16 -0700 Message-ID: <1507928056-6966-23-git-send-email-oscar.mateo@intel.com> References: <1507928056-6966-1-git-send-email-oscar.mateo@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by gabe.freedesktop.org (Postfix) with ESMTPS id A62946EBC8 for ; Fri, 13 Oct 2017 20:54:15 +0000 (UTC) In-Reply-To: <1507928056-6966-1-git-send-email-oscar.mateo@intel.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: intel-gfx@lists.freedesktop.org List-Id: intel-gfx@lists.freedesktop.org RG9lcyB3aGF0IGl0IHNheXMgb24gdGhlIHRpbiAocGx1cyBhIGZldyBmaXhlcyBpbiBzb21lIG9s ZCBjb21tZW50cykuCgp2MjogSW5jbHVkZSBkaXNwbGF5IFdBcyBhcyBhIHNlcGFyYXRlIGNhdGVn b3J5LgoKU2lnbmVkLW9mZi1ieTogT3NjYXIgTWF0ZW8gPG9zY2FyLm1hdGVvQGludGVsLmNvbT4K Q2M6IENocmlzIFdpbHNvbiA8Y2hyaXNAY2hyaXMtd2lsc29uLmNvLnVrPgpDYzogTWlrYSBLdW9w cGFsYSA8bWlrYS5rdW9wcGFsYUBsaW51eC5pbnRlbC5jb20+CkNjOiBWaWxsZSBTeXJqw6Rsw6Qg PHZpbGxlLnN5cmphbGFAbGludXguaW50ZWwuY29tPgotLS0KIGRyaXZlcnMvZ3B1L2RybS9pOTE1 L2ludGVsX3BtLmMgICAgICAgICAgfCAgNCArLS0KIGRyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVs X3dvcmthcm91bmRzLmMgfCA0NyArKysrKysrKysrKysrKysrKysrKysrKysrKystLS0tLQogMiBm aWxlcyBjaGFuZ2VkLCA0MSBpbnNlcnRpb25zKCspLCAxMCBkZWxldGlvbnMoLSkKCmRpZmYgLS1n aXQgYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9wbS5jIGIvZHJpdmVycy9ncHUvZHJtL2k5 MTUvaW50ZWxfcG0uYwppbmRleCA3NGNjMmZmZS4uMDZiN2JmYSAxMDA2NDQKLS0tIGEvZHJpdmVy cy9ncHUvZHJtL2k5MTUvaW50ZWxfcG0uYworKysgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRl bF9wbS5jCkBAIC04NzM2LDkgKzg3MzYsNyBAQCBzdGF0aWMgdm9pZCBub3BfaW5pdF9jbG9ja19n YXRpbmcoc3RydWN0IGRybV9pOTE1X3ByaXZhdGUgKmRldl9wcml2KQogICogQGRldl9wcml2OiBk ZXZpY2UgcHJpdmF0ZQogICoKICAqIFNldHVwIHRoZSBob29rcyB0aGF0IGNvbmZpZ3VyZSB3aGlj aCBjbG9ja3Mgb2YgYSBnaXZlbiBwbGF0Zm9ybSBjYW4gYmUKLSAqIGdhdGVkIGFuZCBhbHNvIGFw cGx5IHZhcmlvdXMgR1QgYW5kIGRpc3BsYXkgc3BlY2lmaWMgd29ya2Fyb3VuZHMgZm9yIHRoZXNl Ci0gKiBwbGF0Zm9ybXMuIE5vdGUgdGhhdCBzb21lIEdUIHNwZWNpZmljIHdvcmthcm91bmRzIGFy ZSBhcHBsaWVkIHNlcGFyYXRlbHkKLSAqIHdoZW4gR1BVIGNvbnRleHRzIG9yIGJhdGNoYnVmZmVy cyBzdGFydCB0aGVpciBleGVjdXRpb24uCisgKiBnYXRlZC4KICAqLwogdm9pZCBpbnRlbF9pbml0 X2Nsb2NrX2dhdGluZ19ob29rcyhzdHJ1Y3QgZHJtX2k5MTVfcHJpdmF0ZSAqZGV2X3ByaXYpCiB7 CmRpZmYgLS1naXQgYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF93b3JrYXJvdW5kcy5jIGIv ZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfd29ya2Fyb3VuZHMuYwppbmRleCAxMzZmNmZiLi5j N2QxNjVkIDEwMDY0NAotLS0gYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF93b3JrYXJvdW5k cy5jCisrKyBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX3dvcmthcm91bmRzLmMKQEAgLTI1 LDYgKzI1LDM4IEBACiAjaW5jbHVkZSAiaTkxNV9kcnYuaCIKICNpbmNsdWRlICJpbnRlbF93b3Jr YXJvdW5kcy5oIgogCisvKioKKyAqIERPQzogSGFyZHdhcmUgd29ya2Fyb3VuZHMKKyAqCisgKiBU aGlzIGZpbGUgaXMgYSBjZW50cmFsIHBsYWNlIHRvIGltcGxlbWVudCBtb3N0KiBvZiB0aGUgcmVx dWlyZWQgd29ya2Fyb3VuZHMKKyAqIHJlcXVpcmVkIGZvciBIVyB0byB3b3JrIGFzIG9yaWdpbmFs bHkgaW50ZW5kZWQuIFRoZXkgZmFsbCBpbiBmaXZlIGJhc2ljCisgKiBjYXRlZ29yaWVzIGRlcGVu ZGluZyBvbiBob3cvd2hlbiB0aGV5IGFyZSBhcHBsaWVkOgorICoKKyAqIC0gV29ya2Fyb3VuZHMg dGhhdCB0b3VjaCByZWdpc3RlcnMgdGhhdCBhcmUgc2F2ZWQvcmVzdG9yZWQgdG8vZnJvbSB0aGUg SFcKKyAqICAgY29udGV4dCBpbWFnZS4gVGhlIGxpc3QgaXMgZ2VuZXJhdGVkIG9uY2UgYW5kIHRo ZW4gZW1pdHRlZCAodmlhIExvYWQKKyAqICAgUmVnaXN0ZXIgSW1tZWRpYXRlIGNvbW1hbmRzKSBl dmVyeXRpbWUgYSBuZXcgY29udGV4dCBpcyBjcmVhdGVkLgorICogLSBHVCB3b3JrYXJvdW5kcy4g VGhlIGxpc3Qgb2YgdGhlc2UgV0FzIGlzIGdlbmVyYXRlZCBvbmNlIGFuZCB0aGVuIGFwcGxpZWQK KyAqICAgd2hlbmV2ZXIgdGhlc2UgcmVnaXN0ZXJzIHJldmVydCB0byBkZWZhdWx0IHZhbHVlcyAo b24gR1BVIHJlc2V0LAorICogICBzdXNwZW5kL3Jlc3VtZSoqLCBldGMuLikuCisgKiAtIERpc3Bs YXkgd29ya2Fyb3VuZHMuIFRoZSBsaXN0IGlzIGdlbmVyYXRlZCBvbmNlIChhdCB0aGUgc2FtZSB0 aW1lIGFzIHRoZSBHVAorICogICB3b3JrYXJvdW5kcykgYnV0IGFwcGxpZWQgZHVyaW5nIGRpc3Bs YXkgY2xvY2stZ2F0aW5nIGluaXRpYWxpemF0aW9uLgorICogLSBXb3JrYXJvdW5kcyB0aGF0IHdo aXRlbGlzdCBhIHByaXZpbGVnZWQgcmVnaXN0ZXIsIHNvIHRoYXQgVU1EcyBjYW4gbWFuYWdlCisg KiAgIHRoZW0gZGlyZWN0bHkuIFRoaXMgaXMganVzdCBhIHNwZWNpYWwgY2FzZSBvZiBhIE1NTUlP IHdvcmthcm91bmQgKGFzIHdlCisgKiAgIHdyaXRlIHRoZSBsaXN0IG9mIHRoZXNlIHRvL2JlLXdo aXRlbGlzdGVkIHJlZ2lzdGVycyB0byBzb21lIHNwZWNpYWwgSFcKKyAqICAgcmVnaXN0ZXJzKS4K KyAqIC0gV29ya2Fyb3VuZCBiYXRjaGJ1ZmZlcnMsIHRoYXQgZ2V0IGV4ZWN1dGVkIGF1dG9tYXRp Y2FsbHkgYnkgdGhlIGhhcmR3YXJlCisgKiAgIG9uIGV2ZXJ5IEhXIGNvbnRleHQgcmVzdG9yZS4K KyAqCisgKiAqIFBsZWFzZSBub3RpY2UgdGhhdCB0aGVyZSBhcmUgb3RoZXIgV0FzIHRoYXQsIGR1 ZSB0byB0aGVpciBuYXR1cmUsIGNhbm5vdCBiZQorICogICBhcHBsaWVkIGZyb20gYSBjZW50cmFs IHBsYWNlLiBUaG9zZSBhcmUgcGVwcGVyZWQgYXJvdW5kIHRoZSByZXN0IG9mIHRoZQorICogICBj b2RlLCBhcyBuZWVkZWQpLgorICoKKyAqICoqIFRlY2huaWNhbGx5LCBzb21lIHJlZ2lzdGVycyBh cmUgcG93ZXJjb250ZXh0IHNhdmVkICYgcmVzdG9yZWQsIHNvIHRoZXkKKyAqICAgIHN1cnZpdmUg YSBzdXNwZW5kL3Jlc3VtZS4gSW4gcHJhY3RpY2UsIHdyaXRpbmcgdGhlbSBhZ2FpbiBpcyBub3Qg dG9vCisgKiAgICBjb3N0bHkgYW5kIHNpbXBsaWZpZXMgdGhpbmdzLiBXZSBjYW4gcmV2aXNpdCB0 aGlzIGluIHRoZSBmdXR1cmUuCisgKgorICovCisKIHN0YXRpYyBpbnQgY3R4X3dhX2FkZChzdHJ1 Y3QgZHJtX2k5MTVfcHJpdmF0ZSAqZGV2X3ByaXYsCiAJCSAgICAgIGk5MTVfcmVnX3QgYWRkciwK IAkJICAgICAgY29uc3QgdTMyIG1hc2ssIGNvbnN0IHUzMiB2YWwpCkBAIC0xOTAsOSArMjIyLDkg QEAgc3RhdGljIGludCBnZW45X2N0eF93b3JrYXJvdW5kc19pbml0KHN0cnVjdCBkcm1faTkxNV9w cml2YXRlICpkZXZfcHJpdikKIAkJQ1RYX1dBX1NFVF9CSVRfTUFTS0VEKEdFTjdfQ09NTU9OX1NM SUNFX0NISUNLRU4xLAogCQkJCSAgICAgIEdFTjlfUkhXT19PUFRJTUlaQVRJT05fRElTQUJMRSk7 CiAJCS8qCi0JCSAqIFdBIGFsc28gcmVxdWlyZXMgR0VOOV9TTElDRV9DT01NT05fRUNPX0NISUNL RU4wWzE0OjE0XSB0byBiZSBzZXQKLQkJICogYnV0IHdlIGRvIHRoYXQgaW4gcGVyIGN0eCBiYXRj aGJ1ZmZlciBhcyB0aGVyZSBpcyBhbiBpc3N1ZQotCQkgKiB3aXRoIHRoaXMgcmVnaXN0ZXIgbm90 IGdldHRpbmcgcmVzdG9yZWQgb24gY3R4IHJlc3RvcmUKKwkJICogV0EgYWxzbyByZXF1aXJlcyBH RU45X1NMSUNFX0NPTU1PTl9FQ09fQ0hJQ0tFTjBbMTQ6MTRdIHRvIGJlCisJCSAqIHNldCBidXQg d2UgZG8gdGhhdCBpbiBwZXIgY3R4IGJhdGNoYnVmZmVyIGFzIHRoZXJlIGlzIGFuCisJCSAqIGlz c3VlIHdpdGggdGhpcyByZWdpc3RlciBub3QgZ2V0dGluZyByZXN0b3JlZCBvbiBjdHggcmVzdG9y ZS4KIAkJICovCiAJfQogCkBAIC0xMzIxLDEwICsxMzUzLDExIEBAIHZvaWQgaW50ZWxfd2hpdGVs aXN0X3dvcmthcm91bmRzX2FwcGx5KHN0cnVjdCBpbnRlbF9lbmdpbmVfY3MgKmVuZ2luZSkKICAq IGJ1dCB0aGVyZSBpcyBhIHNsaWdodCBjb21wbGljYXRpb24gYXMgdGhpcyBpcyBhcHBsaWVkIGlu IFdBIGJhdGNoIHdoZXJlIHRoZQogICogdmFsdWVzIGFyZSBvbmx5IGluaXRpYWxpemVkIG9uY2Ug c28gd2UgY2Fubm90IHRha2UgcmVnaXN0ZXIgdmFsdWUgYXQgdGhlCiAgKiBiZWdpbm5pbmcgYW5k IHJldXNlIGl0IGZ1cnRoZXI7IGhlbmNlIHdlIHNhdmUgaXRzIHZhbHVlIHRvIG1lbW9yeSwgdXBs b2FkIGEKLSAqIGNvbnN0YW50IHZhbHVlIHdpdGggYml0MjEgc2V0IGFuZCB0aGVuIHdlIHJlc3Rv cmUgaXQgYmFjayB3aXRoIHRoZSBzYXZlZCB2YWx1ZS4KKyAqIGNvbnN0YW50IHZhbHVlIHdpdGgg Yml0MjEgc2V0IGFuZCB0aGVuIHdlIHJlc3RvcmUgaXQgYmFjayB3aXRoIHRoZSBzYXZlZAorICog dmFsdWUuCiAgKiBUbyBzaW1wbGlmeSB0aGUgV0EsIGEgY29uc3RhbnQgdmFsdWUgaXMgZm9ybWVk IGJ5IHVzaW5nIHRoZSBkZWZhdWx0IHZhbHVlCiAgKiBvZiB0aGlzIHJlZ2lzdGVyLiBUaGlzIHNo b3VsZG4ndCBiZSBhIHByb2JsZW0gYmVjYXVzZSB3ZSBhcmUgb25seSBtb2RpZnlpbmcKLSAqIGl0 IGZvciBhIHNob3J0IHBlcmlvZCBhbmQgdGhpcyBiYXRjaCBpbiBub24tcHJlbXB0aWJsZS4gV2Ug Y2FuIG9mY291cnNlCisgKiBpdCBmb3IgYSBzaG9ydCBwZXJpb2QgYW5kIHRoaXMgYmF0Y2ggaW4g bm9uLXByZW1wdGlibGUuIFdlIGNhbiBvZiBjb3Vyc2UKICAqIHVzZSBhZGRpdGlvbmFsIGluc3Ry dWN0aW9ucyB0aGF0IHJlYWQgdGhlIGFjdHVhbCB2YWx1ZSBvZiB0aGUgcmVnaXN0ZXIKICAqIGF0 IHRoYXQgdGltZSBhbmQgc2V0IG91ciBiaXQgb2YgaW50ZXJlc3QgYnV0IGl0IG1ha2VzIHRoZSBX QSBjb21wbGljYXRlZC4KICAqCkBAIC0xMzYwLDggKzEzOTMsOCBAQCB2b2lkIGludGVsX3doaXRl bGlzdF93b3JrYXJvdW5kc19hcHBseShzdHJ1Y3QgaW50ZWxfZW5naW5lX2NzICplbmdpbmUpCiAg KiBUeXBpY2FsbHkgd2Ugb25seSBoYXZlIG9uZSBpbmRpcmVjdF9jdHggYW5kIHBlcl9jdHggYmF0 Y2ggYnVmZmVyIHdoaWNoIGFyZQogICogaW5pdGlhbGl6ZWQgYXQgdGhlIGJlZ2lubmluZyBhbmQg c2hhcmVkIGFjcm9zcyBhbGwgY29udGV4dHMgYnV0IHRoaXMgZmllbGQKICAqIGhlbHBzIHVzIHRv IGhhdmUgbXVsdGlwbGUgYmF0Y2hlcyBhdCBkaWZmZXJlbnQgb2Zmc2V0cyBhbmQgc2VsZWN0IHRo ZW0gYmFzZWQKLSAqIG9uIGEgY3JpdGVyaWEuIEF0IHRoZSBtb21lbnQgdGhpcyBiYXRjaCBhbHdh eXMgc3RhcnQgYXQgdGhlIGJlZ2lubmluZyBvZiB0aGUgcGFnZQotICogYW5kIGF0IHRoaXMgcG9p bnQgd2UgZG9uJ3QgaGF2ZSBtdWx0aXBsZSB3YV9jdHggYmF0Y2ggYnVmZmVycy4KKyAqIG9uIGEg Y3JpdGVyaWEuIEF0IHRoZSBtb21lbnQgdGhpcyBiYXRjaCBhbHdheXMgc3RhcnQgYXQgdGhlIGJl Z2lubmluZyBvZiB0aGUKKyAqIHBhZ2UgYW5kIGF0IHRoaXMgcG9pbnQgd2UgZG9uJ3QgaGF2ZSBt dWx0aXBsZSB3YV9jdHggYmF0Y2ggYnVmZmVycy4KICAqCiAgKiBUaGUgbnVtYmVyIG9mIFdBIGFw cGxpZWQgYXJlIG5vdCBrbm93biBhdCB0aGUgYmVnaW5uaW5nOyB3ZSB1c2UgdGhpcyBmaWVsZAog ICogdG8gcmV0dXJuIHRoZSBubyBvZiBEV09SRFMgd3JpdHRlbi4KLS0gCjEuOS4xCgpfX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpJbnRlbC1nZnggbWFpbGlu ZyBsaXN0CkludGVsLWdmeEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVl ZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9pbnRlbC1nZngK