From: Oscar Mateo Subject: [RFC PATCH 10/11] drm/i915: Document the i915_workarounds file Date: Mon, 9 Oct 2017 13:58:25 -0700 Message-ID: <1507582707-20079-11-git-send-email-oscar.mateo@intel.com> References: <1507582707-20079-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 C966E6E3BC for ; Mon, 9 Oct 2017 20:58:26 +0000 (UTC) In-Reply-To: <1507582707-20079-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 ZCBjb21tZW50cykuCgpTaWduZWQtb2ZmLWJ5OiBPc2NhciBNYXRlbyA8b3NjYXIubWF0ZW9AaW50 ZWwuY29tPgpDYzogQ2hyaXMgV2lsc29uIDxjaHJpc0BjaHJpcy13aWxzb24uY28udWs+CkNjOiBN aWthIEt1b3BwYWxhIDxtaWthLmt1b3BwYWxhQGxpbnV4LmludGVsLmNvbT4KLS0tCiBkcml2ZXJz L2dwdS9kcm0vaTkxNS9pOTE1X3dvcmthcm91bmRzLmMgfCA0NSArKysrKysrKysrKysrKysrKysr KysrKysrKysrLS0tLS0KIDEgZmlsZSBjaGFuZ2VkLCAzOCBpbnNlcnRpb25zKCspLCA3IGRlbGV0 aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfd29ya2Fyb3Vu ZHMuYyBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfd29ya2Fyb3VuZHMuYwppbmRleCBmZjMw NTI1Li45YTMyNjAxIDEwMDY0NAotLS0gYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pOTE1X3dvcmth cm91bmRzLmMKKysrIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV93b3JrYXJvdW5kcy5jCkBA IC0yNSw2ICsyNSwzNiBAQAogI2luY2x1ZGUgImk5MTVfZHJ2LmgiCiAjaW5jbHVkZSAiaTkxNV93 b3JrYXJvdW5kcy5oIgogCisvKioKKyAqIERPQzogSGFyZHdhcmUgd29ya2Fyb3VuZHMKKyAqCisg KiBUaGlzIGZpbGUgaXMgYSBjZW50cmFsIHBsYWNlIHRvIGltcGxlbWVudCBtb3N0KiBvZiB0aGUg cmVxdWlyZWQgd29ya2Fyb3VuZHMKKyAqIHJlcXVpcmVkIGZvciBIVyB0byB3b3JrIGFzIG9yaWdp bmFsbHkgaW50ZW5kZWQuIFRoZXkgZmFsbCBpbiBmb3VyIGNhdGVnb3JpZXMKKyAqIGRlcGVuZGlu ZyBvbiBob3cvd2hlbiB0aGV5IGFyZSBhcHBsaWVkOgorICoKKyAqIC0gV29ya2Fyb3VuZHMgdGhh dCB0b3VjaCByZWdpc3RlcnMgdGhhdCBhcmUgc2F2ZWQvcmVzdG9yZWQgdG8vZnJvbSB0aGUgSFcK KyAqICAgY29udGV4dCBpbWFnZS4gVGhlIGxpc3QgaXMgZ2VuZXJhdGVkIG9uY2UgYW5kIHRoZW4g ZW1pdHRlZCAodmlhIExvYWQKKyAqICAgUmVnaXN0ZXIgSW1tZWRpYXRlIGNvbW1hbmRzKSBldmVy eXRpbWUgYSBuZXcgY29udGV4dCBpcyBjcmVhdGVkLgorICogLSBXb3JrYXJvdW5kcyB0aGF0IHRv dWNoIGdsb2JhbCBNTUlPIHJlZ2lzdGVycy4gVGhlIGxpc3Qgb2YgdGhlc2UgV0FzIGlzCisgKiAg IGdlbmVyYXRlZCBvbmNlIGFuZCB0aGVuIGFwcGxpZWQgd2hlbmV2ZXIgdGhlc2UgcmVnaXN0ZXJz IHJldmVydCB0byBkZWZhdWx0CisgKiAgIHZhbHVlcyAob24gR1BVIHJlc2V0LCBzdXNwZW5kL3Jl c3VtZSoqLCBldGMuLikuCisgKiAtIFdvcmthcm91bmRzIHRoYXQgd2hpdGVsaXN0IGEgcHJpdmls ZWdlZCByZWdpc3Rlciwgc28gdGhhdCBVTURzIGNhbiBtYW5hZ2UKKyAqICAgdGhlbSBkaXJlY3Rs eS4gVGhpcyBpcyBqdXN0IGEgc3BlY2lhbCBjYXNlIG9mIGEgTU1NSU8gd29ya2Fyb3VuZCAoYXMg d2UKKyAqICAgd3JpdGUgdGhlIGxpc3Qgb2YgdGhlc2UgdG8vYmUtd2hpdGVsaXN0ZWQgcmVnaXN0 ZXJzIHRvIHNvbWUgc3BlY2lhbCBIVworICogICByZWdpc3RlcnMpLgorICogLSBXb3JrYXJvdW5k IGJhdGNoYnVmZmVycywgdGhhdCBnZXQgZXhlY3V0ZWQgYXV0b21hdGljYWxseSBieSB0aGUgaGFy ZHdhcmUKKyAqICAgb24gZXZlcnkgSFcgY29udGV4dCByZXN0b3JlLgorICoKKyAqICogUGxlYXNl IG5vdGljZSB0aGF0IHRoZXJlIGFyZSBvdGhlciBXQXMgdGhhdCwgZHVlIHRvIHRoZWlyIG5hdHVy ZSwgY2Fubm90IGJlCisgKiAgIGFwcGxpZWQgZnJvbSBhIGNlbnRyYWwgcGxhY2UuIFRob3NlIGFy ZSBwZXBwZXJlZCBhcm91bmQgdGhlIHJlc3Qgb2YgdGhlCisgKiAgIGNvZGUsIGFzIG5lZWRlZCku CisgKgorICogKiogVGVjaG5pY2FsbHksIHNvbWUgcmVnaXN0ZXJzIGFyZSBwb3dlcmNvbnRleHQg c2F2ZWQgJiByZXN0b3JlZCwgc28gdGhleQorICogICAgc3Vydml2ZSBhIHN1c3BlbmQvcmVzdW1l LiBJbiBwcmFjdGljZSwgd3JpdGluZyB0aGVtIGFnYWluIGlzIG5vdCB0b28KKyAqICAgIGNvc3Rs eSBhbmQgc2ltcGxpZmllcyB0aGluZ3MuIFdlIGNhbiByZXZpc2l0IHRoaXMgaW4gdGhlIGZ1dHVy ZS4KKyAqCisgKi8KKwogc3RhdGljIGludCBjdHhfd2FfYWRkKHN0cnVjdCBkcm1faTkxNV9wcml2 YXRlICpkZXZfcHJpdiwKIAkJICAgICAgaTkxNV9yZWdfdCBhZGRyLAogCQkgICAgICBjb25zdCB1 MzIgbWFzaywgY29uc3QgdTMyIHZhbCkKQEAgLTE5MCw5ICsyMjAsOSBAQCBzdGF0aWMgaW50IGdl bjlfY3R4X3dvcmthcm91bmRzX2luaXQoc3RydWN0IGRybV9pOTE1X3ByaXZhdGUgKmRldl9wcml2 KQogCQlDVFhXQV9TRVRfQklUX01TSyhHRU43X0NPTU1PTl9TTElDRV9DSElDS0VOMSwKIAkJCQkg IEdFTjlfUkhXT19PUFRJTUlaQVRJT05fRElTQUJMRSk7CiAJCS8qCi0JCSAqIFdBIGFsc28gcmVx dWlyZXMgR0VOOV9TTElDRV9DT01NT05fRUNPX0NISUNLRU4wWzE0OjE0XSB0byBiZSBzZXQKLQkJ ICogYnV0IHdlIGRvIHRoYXQgaW4gcGVyIGN0eCBiYXRjaGJ1ZmZlciBhcyB0aGVyZSBpcyBhbiBp c3N1ZQotCQkgKiB3aXRoIHRoaXMgcmVnaXN0ZXIgbm90IGdldHRpbmcgcmVzdG9yZWQgb24gY3R4 IHJlc3RvcmUKKwkJICogV0EgYWxzbyByZXF1aXJlcyBHRU45X1NMSUNFX0NPTU1PTl9FQ09fQ0hJ Q0tFTjBbMTQ6MTRdIHRvIGJlCisJCSAqIHNldCBidXQgd2UgZG8gdGhhdCBpbiBwZXIgY3R4IGJh dGNoYnVmZmVyIGFzIHRoZXJlIGlzIGFuCisJCSAqIGlzc3VlIHdpdGggdGhpcyByZWdpc3RlciBu b3QgZ2V0dGluZyByZXN0b3JlZCBvbiBjdHggcmVzdG9yZS4KIAkJICovCiAJfQogCkBAIC0xMDI5 LDEwICsxMDU5LDExIEBAIHZvaWQgaTkxNV93aGl0ZWxpc3Rfd29ya2Fyb3VuZHNfYXBwbHkoc3Ry dWN0IGludGVsX2VuZ2luZV9jcyAqZW5naW5lKQogICogYnV0IHRoZXJlIGlzIGEgc2xpZ2h0IGNv bXBsaWNhdGlvbiBhcyB0aGlzIGlzIGFwcGxpZWQgaW4gV0EgYmF0Y2ggd2hlcmUgdGhlCiAgKiB2 YWx1ZXMgYXJlIG9ubHkgaW5pdGlhbGl6ZWQgb25jZSBzbyB3ZSBjYW5ub3QgdGFrZSByZWdpc3Rl ciB2YWx1ZSBhdCB0aGUKICAqIGJlZ2lubmluZyBhbmQgcmV1c2UgaXQgZnVydGhlcjsgaGVuY2Ug d2Ugc2F2ZSBpdHMgdmFsdWUgdG8gbWVtb3J5LCB1cGxvYWQgYQotICogY29uc3RhbnQgdmFsdWUg d2l0aCBiaXQyMSBzZXQgYW5kIHRoZW4gd2UgcmVzdG9yZSBpdCBiYWNrIHdpdGggdGhlIHNhdmVk IHZhbHVlLgorICogY29uc3RhbnQgdmFsdWUgd2l0aCBiaXQyMSBzZXQgYW5kIHRoZW4gd2UgcmVz dG9yZSBpdCBiYWNrIHdpdGggdGhlIHNhdmVkCisgKiB2YWx1ZS4KICAqIFRvIHNpbXBsaWZ5IHRo ZSBXQSwgYSBjb25zdGFudCB2YWx1ZSBpcyBmb3JtZWQgYnkgdXNpbmcgdGhlIGRlZmF1bHQgdmFs dWUKICAqIG9mIHRoaXMgcmVnaXN0ZXIuIFRoaXMgc2hvdWxkbid0IGJlIGEgcHJvYmxlbSBiZWNh dXNlIHdlIGFyZSBvbmx5IG1vZGlmeWluZwotICogaXQgZm9yIGEgc2hvcnQgcGVyaW9kIGFuZCB0 aGlzIGJhdGNoIGluIG5vbi1wcmVtcHRpYmxlLiBXZSBjYW4gb2Zjb3Vyc2UKKyAqIGl0IGZvciBh IHNob3J0IHBlcmlvZCBhbmQgdGhpcyBiYXRjaCBpbiBub24tcHJlbXB0aWJsZS4gV2UgY2FuIG9m IGNvdXJzZQogICogdXNlIGFkZGl0aW9uYWwgaW5zdHJ1Y3Rpb25zIHRoYXQgcmVhZCB0aGUgYWN0 dWFsIHZhbHVlIG9mIHRoZSByZWdpc3RlcgogICogYXQgdGhhdCB0aW1lIGFuZCBzZXQgb3VyIGJp dCBvZiBpbnRlcmVzdCBidXQgaXQgbWFrZXMgdGhlIFdBIGNvbXBsaWNhdGVkLgogICoKQEAgLTEw NjgsOCArMTA5OSw4IEBAIHZvaWQgaTkxNV93aGl0ZWxpc3Rfd29ya2Fyb3VuZHNfYXBwbHkoc3Ry dWN0IGludGVsX2VuZ2luZV9jcyAqZW5naW5lKQogICogVHlwaWNhbGx5IHdlIG9ubHkgaGF2ZSBv bmUgaW5kaXJlY3RfY3R4IGFuZCBwZXJfY3R4IGJhdGNoIGJ1ZmZlciB3aGljaCBhcmUKICAqIGlu aXRpYWxpemVkIGF0IHRoZSBiZWdpbm5pbmcgYW5kIHNoYXJlZCBhY3Jvc3MgYWxsIGNvbnRleHRz IGJ1dCB0aGlzIGZpZWxkCiAgKiBoZWxwcyB1cyB0byBoYXZlIG11bHRpcGxlIGJhdGNoZXMgYXQg ZGlmZmVyZW50IG9mZnNldHMgYW5kIHNlbGVjdCB0aGVtIGJhc2VkCi0gKiBvbiBhIGNyaXRlcmlh LiBBdCB0aGUgbW9tZW50IHRoaXMgYmF0Y2ggYWx3YXlzIHN0YXJ0IGF0IHRoZSBiZWdpbm5pbmcg b2YgdGhlIHBhZ2UKLSAqIGFuZCBhdCB0aGlzIHBvaW50IHdlIGRvbid0IGhhdmUgbXVsdGlwbGUg d2FfY3R4IGJhdGNoIGJ1ZmZlcnMuCisgKiBvbiBhIGNyaXRlcmlhLiBBdCB0aGUgbW9tZW50IHRo aXMgYmF0Y2ggYWx3YXlzIHN0YXJ0IGF0IHRoZSBiZWdpbm5pbmcgb2YgdGhlCisgKiBwYWdlIGFu ZCBhdCB0aGlzIHBvaW50IHdlIGRvbid0IGhhdmUgbXVsdGlwbGUgd2FfY3R4IGJhdGNoIGJ1ZmZl cnMuCiAgKgogICogVGhlIG51bWJlciBvZiBXQSBhcHBsaWVkIGFyZSBub3Qga25vd24gYXQgdGhl IGJlZ2lubmluZzsgd2UgdXNlIHRoaXMgZmllbGQKICAqIHRvIHJldHVybiB0aGUgbm8gb2YgRFdP UkRTIHdyaXR0ZW4uCi0tIAoxLjkuMQoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX18KSW50ZWwtZ2Z4IG1haWxpbmcgbGlzdApJbnRlbC1nZnhAbGlzdHMuZnJl ZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGlu Zm8vaW50ZWwtZ2Z4Cg==