From mboxrd@z Thu Jan  1 00:00:00 1970
From: Jason Ekstrand <jason@jlekstrand.net>
Subject: [PATCH] i915,
	drm/fourcc: Improve the CCS modifier documentation
Date: Fri, 18 Aug 2017 11:34:40 -0700
Message-ID: <1503081280-1813-1-git-send-email-jason.ekstrand@intel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Return-path: <intel-gfx-bounces@lists.freedesktop.org>
List-Unsubscribe: <https://lists.freedesktop.org/mailman/options/intel-gfx>,
 <mailto:intel-gfx-request@lists.freedesktop.org?subject=unsubscribe>
List-Archive: <https://lists.freedesktop.org/archives/intel-gfx>
List-Post: <mailto:intel-gfx@lists.freedesktop.org>
List-Help: <mailto:intel-gfx-request@lists.freedesktop.org?subject=help>
List-Subscribe: <https://lists.freedesktop.org/mailman/listinfo/intel-gfx>,
 <mailto:intel-gfx-request@lists.freedesktop.org?subject=subscribe>
Errors-To: intel-gfx-bounces@lists.freedesktop.org
Sender: "Intel-gfx" <intel-gfx-bounces@lists.freedesktop.org>
To: dri-devel@lists.freedesktop.org, intel-gfx@lists.freedesktop.org
Cc: Jason Ekstrand <jason.ekstrand@intel.com>, Ben Widawsky <ben@bwidawsk.net>
List-Id: dri-devel@lists.freedesktop.org

VGhpcyB1cGRhdGVzIHRoZSBkb2N1bWVudGF0aW9uIG9uIHRoZSBpbnRlbCBDQ1MgbW9kaWZpZXJz
IGZvciBhIGNvdXBsZQpvZiByZWFzb25zOgoKIDEpIFRoZSBvbGQgZG9jdW1lbnRhdGlvbiByZXF1
aXJlZCB0aGF0IHRoZSBDQ1MgbW9kaWZpZXIgb25seSBiZSB1c2VkCiAgICB3aXRoIDg4ODggZm9y
bWF0cy4gIFdoaWxlIGk5MTUgY3VycmVudGx5IG9ubHkgc3VwcG9ydHMgQ0NTIHNjYW5vdXQKICAg
IHdpdGggODg4OCBmb3JtYXRzIChhbmQgYWR2ZXJ0aXNlcyBzdWNoIHRocm91Z2ggdGhlIGJsb2Ig
Zm9ybWF0KSwgQ0NTCiAgICBjYW4gYmUgdXNlZCB3aXRoIG1hbnkgb3RoZXIgZm9ybWF0cy4gIE1l
c2EsIGluIHBhcnRpY3VsYXIsIGNhbgogICAgaGFuZGxlIENDUyBvbiB0aGUgZnVsbCByYW5nZSBv
ZiBmb3JtYXRzIHN1cHBvcnRlZCBieSB0aGUgaGFyZHdhcmUuCiAgICBGb3IgaW1hZ2Ugc2hhcmlu
ZyBlbnRpcmVseSB3aXRoaW4gdXNlcnNwYWNlLCB3ZSBkb24ndCB3YW50IHRoaXMKICAgIHJlc3Ry
aWN0aW9uLgoKIDIpIFRoZSBvbGQgZG9jdW1lbnRhdGlvbiBzcGVjaWZpZWQgdGhlIHNjYWxpbmcg
ZmFjdG9yIGluIHRlcm1zIG9mCiAgICBwaXhlbHMgd2hpY2ggYnJlYWtzIGRvd24gd2hlbiB5b3Ug
c3RhcnQgdXNpbmcgZm9ybWF0cyB3aGljaCBhcmUgbm90CiAgICAzMi1iaXQuICBCeSBzcGVjaWZ5
aW5nIGl0IGluIHRlcm1zIG9mIGNhY2hlIGxpbmVzIGFuZCB0aWxlcywgd2UgY2FuCiAgICBwcm9w
ZXJseSBzcGVjaWZ5IHRoZSBzY2FsZS1kb3duIHJlbGF0aW9uc2hpcCB3aXRoIG5vIGZvcm1hdCBz
aXplCiAgICBhc3N1bXB0aW9ucy4KCiAzKSBUaGUgbmV3IGNvbW1lbnQgcHJvdmlkZXMgbW9yZSBk
ZXRhaWwgYWJvdXQgdGhlICJyZWFsIiBsYXlvdXQgb2YgQ0NTCiAgICBvbiBTa3kgTGFrZSBhbmQg
YWxzbyBwb2ludHMgb3V0IHRoYXQgdGhlIHJlYXNvbiB3aHkgWSB0aWxpbmcgaXMKICAgIGltcG9y
dGFudCBpcyBiZWNhdXNlIGl0IGFmZmVjdHMgcm93IHBpdGNoIGNhbGN1bGF0aW9ucy4KCiA0KSBX
ZSBzaG91bGRuJ3QgYmUgZG9jdW1lbnRpbmcgdGhlIFlmIENDUyBtb2RpZmllciB5ZXQuICBVc2Vy
c3BhY2UgaXMKICAgIGluY2FwYWJsZSBvZiBnZW5lcmF0aW5nIGl0IHJpZ2h0IG5vdyBhbmQgd2Ug
ZG9uJ3QgZnVsbHkga25vdyBob3cgaXQKICAgIHdvcmtzIHlldC4gIFRyeWluZyB0byBmdWxseSBk
ZXNjcmliZSBpdCBpcyBwcmVtYXR1cmUuCgpTaWduZWQtb2ZmLWJ5OiBKYXNvbiBFa3N0cmFuZCA8
amFzb25Aamxla3N0cmFuZC5uZXQ+CkNjOiBCZW4gV2lkYXdza3kgPGJlbkBid2lkYXdzay5uZXQ+
CkNjOiBWaWxsZSBTeXJqw6Rsw6QgPHZpbGxlLnN5cmphbGFAbGludXguaW50ZWwuY29tPgotLS0K
IGluY2x1ZGUvdWFwaS9kcm0vZHJtX2ZvdXJjYy5oIHwgMzUgKysrKysrKysrKysrKysrKysrKysr
Ky0tLS0tLS0tLS0tLS0KIDEgZmlsZSBjaGFuZ2VkLCAyMiBpbnNlcnRpb25zKCspLCAxMyBkZWxl
dGlvbnMoLSkKCmRpZmYgLS1naXQgYS9pbmNsdWRlL3VhcGkvZHJtL2RybV9mb3VyY2MuaCBiL2lu
Y2x1ZGUvdWFwaS9kcm0vZHJtX2ZvdXJjYy5oCmluZGV4IDNhZDgzOGQuLjk2NzBkYTQgMTAwNjQ0
Ci0tLSBhL2luY2x1ZGUvdWFwaS9kcm0vZHJtX2ZvdXJjYy5oCisrKyBiL2luY2x1ZGUvdWFwaS9k
cm0vZHJtX2ZvdXJjYy5oCkBAIC0yNjYsMjEgKzI2NiwzMCBAQCBleHRlcm4gIkMiIHsKIC8qCiAg
KiBJbnRlbCBjb2xvciBjb250cm9sIHN1cmZhY2UgKENDUykgZm9yIHJlbmRlciBjb21wcmVzc2lv
bgogICoKLSAqIFRoZSBmcmFtZWJ1ZmZlciBmb3JtYXQgbXVzdCBiZSBvbmUgb2YgdGhlIDg6ODo4
OjggUkdCIGZvcm1hdHMuCi0gKiBUaGUgbWFpbiBzdXJmYWNlIHdpbGwgYmUgcGxhbmUgaW5kZXgg
MCBhbmQgbXVzdCBiZSBZL1lmLXRpbGVkLAotICogdGhlIENDUyB3aWxsIGJlIHBsYW5lIGluZGV4
IDEuCi0gKgotICogRWFjaCBDQ1MgdGlsZSBtYXRjaGVzIGEgMTAyNHg1MTIgcGl4ZWwgYXJlYSBv
ZiB0aGUgbWFpbiBzdXJmYWNlLgotICogVG8gbWF0Y2ggY2VydGFpbiBhc3BlY3RzIG9mIHRoZSAz
RCBoYXJkd2FyZSB0aGUgQ0NTIGlzCi0gKiBjb25zaWRlcmVkIHRvIGJlIG1hZGUgdXAgb2Ygbm9y
bWFsIDEyOEJ4MzIgWSB0aWxlcywgVGh1cwotICogdGhlIENDUyBwaXRjaCBtdXN0IGJlIHNwZWNp
ZmllZCBpbiBtdWx0aXBsZXMgb2YgMTI4IGJ5dGVzLgotICoKLSAqIEluIHJlYWxpdHkgdGhlIEND
UyB0aWxlIGFwcGVhcnMgdG8gYmUgYSA2NEJ4NjQgWSB0aWxlLCBjb21wb3NlZAotICogb2YgUVdP
UkQgKDggYnl0ZXMpIGNodW5rcyBpbnN0ZWFkIG9mIE9XT1JEICgxNiBieXRlcykgY2h1bmtzLgot
ICogQnV0IHRoYXQgZmFjdCBpcyBub3QgcmVsZXZhbnQgdW5sZXNzIHRoZSBtZW1vcnkgaXMgYWNj
ZXNzZWQKLSAqIGRpcmVjdGx5LgorICogVGhlIGltYWdlIGZvcm1hdCBtdXN0IGJlIGNvbXBhdGli
bGUgd2l0aCBDQ1NfRSAobG9zc2xlc3MgcmVuZGVyCisgKiBjb21wcmVzc2lvbikgYXMgc3BlY2lm
aWVkIGluIHRoZSBQUk0gZm9yIHRoZSByZWxldmFudCBoYXJkd2FyZS4KKyAqIFRoZSBtYWluIHN1
cmZhY2Ugd2lsbCBiZSBwbGFuZSBpbmRleCAwIGFuZCBtdXN0IGJlIFktdGlsZWQsCisgKiB0aGUg
Q0NTIHdpbGwgYmUgcGxhbmUgaW5kZXggMSBhbmQgaXMgYWxzbyBZLXRpbGVkLgorICoKKyAqIEVh
Y2ggNjRCIGNhY2hlIGxpbmUgaW4gdGhlIENDUyAoYSByZWdpb24gb2YgMTZCIHggNCByb3dzIHdo
ZW4KKyAqIFktdGlsZWQpIGNvcnJlc3BvbmRzIHRvIGEgcmVnaW9uIG9mIDMyeDE2IGNhY2hlIGxp
bmVzIGluIHRoZSBtYWluCisgKiBzdXJmYWNlLiAgKEFzIGEgY29yb2xsYXJ5LCBlYWNoIENDUyB0
aWxlIGNvcnJlc3BvbmRzIHRvIGFuIGFyZWEgb2YKKyAqIDMyeDE2IHRpbGVzIGluIHRoZSBtYWlu
IHN1cmZhY2UuKSAgVGhpcyByZWxhdGlvbnNoaXAgaG9sZHMgcmVnYXJkbGVzcworICogb2YgdGhl
IHNpemUgb2YgdGhlIG51bWJlciBvZiBiaXRzIHBlciBwaXhlbCBvZiB0aGUgaW1hZ2UgZm9ybWF0
LgorICoKKyAqIEluIHJlYWxpdHksIHRoZSBjYWNoZSBsaW5lcyBpbiB0aGUgQ0NTIHRpbGUgYXJl
IHByb3BvcnRpb25lZCBpbiBhbgorICogOEIgeCA4IHJvdyBjb25maWd1cmF0aW9uIHdpdGggZWFj
aCBieXRlIGJlaW5nIDJ4MiAyLWJpdCBDQ1MgZW50cmllcy4KKyAqIEhvd2V2ZXIsIENDUyBpcyBk
b2N1bWVudGVkIGFzIFktdGlsZWQgd2l0aCB0aGUgc2NhbGluZyByZWxhdGlvbnNoaXAKKyAqIGRl
c2NyaWJlZCBpbiB0ZXJtcyBvZiBjYWNoZSBsaW5lcyBhcyBhYm92ZSBzbyB3ZSBjb25zaWRlciBp
dCB0byBiZQorICogWS10aWxlZCBmb3IgdGhlIHB1cnBvc2Ugb2Ygc3BlY2lmeWluZyB0aGlzIG1v
ZGlmaWVyLiAgVGhpcyBtZWFucyB0aGF0CisgKiB0aGUgcm93IHBpdGNoIGZvciB0aGUgQ0NTIGFz
c3VtZXMgMTI4Qi90aWxlLgogICovCiAjZGVmaW5lIEk5MTVfRk9STUFUX01PRF9ZX1RJTEVEX0ND
Uwlmb3VyY2NfbW9kX2NvZGUoSU5URUwsIDQpCisKKy8qIFJlc2VydmVkIGZvciB0aGUgWWYgdmVy
c2lvbiBvZiB0aGUgVElMRURfQ0NTIG1vZGlmaWVyLgorICoKKyAqIEV4YWN0IGRlZmluaXRpb24g
VEJELgorICovCiAjZGVmaW5lIEk5MTVfRk9STUFUX01PRF9ZZl9USUxFRF9DQ1MJZm91cmNjX21v
ZF9jb2RlKElOVEVMLCA1KQogCiAvKgotLSAKMi41LjAuNDAwLmdmZjg2ZmFmCgpfX19fX19fX19f
X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpJbnRlbC1nZnggbWFpbGluZyBs
aXN0CkludGVsLWdmeEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVlZGVz
a3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9pbnRlbC1nZngK