From mboxrd@z Thu Jan  1 00:00:00 1970
From: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Subject: Re: [PATCH 4/5] drm/atomic: document how to handle
	driver private objects
Date: Tue, 19 Dec 2017 15:33:57 +0200
Message-ID: <5672659.FuCFnFTodp@avalon>
References: <20171214203054.20141-1-daniel.vetter@ffwll.ch>
 <27523743.fP04iXrJ1A@avalon> <20171219100355.GA26573@phenom.ffwll.local>
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Return-path: <intel-gfx-bounces@lists.freedesktop.org>
In-Reply-To: <20171219100355.GA26573@phenom.ffwll.local>
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: Daniel Vetter <daniel@ffwll.ch>
Cc: Daniel Vetter <daniel.vetter@ffwll.ch>, Intel Graphics Development <intel-gfx@lists.freedesktop.org>, DRI Development <dri-devel@lists.freedesktop.org>, Dhinakaran Pandiyan <dhinakaran.pandiyan@intel.com>, Alex Deucher <alexander.deucher@amd.com>, Daniel Vetter <daniel.vetter@intel.com>, Harry Wentland <harry.wentland@amd.com>, Ben Skeggs <bskeggs@redhat.com>
List-Id: dri-devel@lists.freedesktop.org

SGkgRGFuaWVsLAoKT24gVHVlc2RheSwgMTkgRGVjZW1iZXIgMjAxNyAxMjowMzo1NSBFRVQgRGFu
aWVsIFZldHRlciB3cm90ZToKPiBPbiBNb24sIERlYyAxOCwgMjAxNyBhdCAwNjoxMzo0NlBNICsw
MjAwLCBMYXVyZW50IFBpbmNoYXJ0IHdyb3RlOgo+ID4gT24gVGh1cnNkYXksIDE0IERlY2VtYmVy
IDIwMTcgMjI6MzA6NTMgRUVUIERhbmllbCBWZXR0ZXIgd3JvdGU6Cj4gPj4gREsgcHV0IHNvbWUg
bmljZSBkb2NzIGludG8gdGhlIGNvbW1pdCBpbnRyb2R1Y2luZyBkcml2ZXIgcHJpdmF0ZQo+ID4+
IHN0YXRlLCBidXQgaW4gdGhlIGdpdCBoaXN0b3J5IGFsb25lIGl0J2xsIGJlIGxvc3QuCj4gPiAK
PiA+IFlvdSBtaWdodCB3YW50IHRvIHNwZWxsIERLJ3MgbmFtZSBmdWxseS4KPiA+IAo+ID4+IEFs
c28sIHNpbmNlIFZpbGxlIHJlbW92ZSB0aGUgdm9pZCogdXNhZ2UgaXQncyBhIGdvb2Qgb3Bwb3J0
dW5pdHkgdG8KPiA+PiBnaXZlIHRoZSBkcml2ZXIgcHJpdmF0ZSBzdHVmZiBzb21lIHRsYyBvbiB0
aGUgZG9jIGZyb250Lgo+ID4+IAo+ID4+IEZpbmFsbHkgdHJ5IHRvIGV4cGxhaW4gd2h5IHRoZSAi
bGV0J3MganVzdCBzdWJjbGFzcyBkcm1fYXRvbWljX3N0YXRlIgo+ID4+IGFwcHJvYWNoIHdhc24n
dCB0aGUgZ3JlYXRlc3QsIGFuZCBhbm5vdGF0ZSBhbGwgdGhvc2UgZnVuY3Rpb25zIGFzCj4gPj4g
ZGVwcmVjYXRlZCBpbiBmYXZvdXIgb2YgbW9yZSBzdGFuZGFyZGl6ZWQgZHJpdmVyIHByaXZhdGUg
c3RhdGVzLiBBbHNvCj4gPj4gbm90ZSB3aGVyZSB3ZSBjb3VsZC9zaG91bGQgZXh0ZW5kIGRyaXZl
ciBwcml2YXRlIHN0YXRlcyBnb2luZyBmb3J3YXJkCj4gPj4gKGF0bSBuZWl0aGVyIGxvY2tpbmcg
bm9yIHN5bmNocm9uaXphdGlvbiBpcyBoYW5kbGVkIGluIGNvcmUvaGVscGVycywKPiA+PiB3aGlj
aCBpc24ndCByZWFsbHkgYWxsIHRoYXQgZ3JlYXQpLgo+ID4+IAo+ID4+IENjOiBIYXJyeSBXZW50
bGFuZCA8aGFycnkud2VudGxhbmRAYW1kLmNvbT4KPiA+PiBDYzogRGhpbmFrYXJhbiBQYW5kaXlh
biA8ZGhpbmFrYXJhbi5wYW5kaXlhbkBpbnRlbC5jb20+Cj4gPj4gQ2M6IE1hYXJ0ZW4gTGFua2hv
cnN0IDxtYWFydGVuLmxhbmtob3JzdEBsaW51eC5pbnRlbC5jb20+Cj4gPj4gQ2M6IFZpbGxlIFN5
cmrDpGzDpCA8dmlsbGUuc3lyamFsYUBsaW51eC5pbnRlbC5jb20+Cj4gPj4gQ2M6IExhdXJlbnQg
UGluY2hhcnQgPGxhdXJlbnQucGluY2hhcnRAaWRlYXNvbmJvYXJkLmNvbT4KPiA+PiBDYzogUm9i
IENsYXJrIDxyb2JkY2xhcmtAZ21haWwuY29tPgo+ID4+IENjOiBBbGV4IERldWNoZXIgPGFsZXhh
bmRlci5kZXVjaGVyQGFtZC5jb20+Cj4gPj4gQ2M6IEJlbiBTa2VnZ3MgPGJza2VnZ3NAcmVkaGF0
LmNvbT4KPiA+PiBTaWduZWQtb2ZmLWJ5OiBEYW5pZWwgVmV0dGVyIDxkYW5pZWwudmV0dGVyQGlu
dGVsLmNvbT4KPiA+PiAtLS0KPiA+PiAKPiA+PiAgRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy5y
c3QgfCAgNiArKysrKysKPiA+PiAgZHJpdmVycy9ncHUvZHJtL2RybV9hdG9taWMuYyAgfCA0NSAr
KysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrLS0tCj4gPj4gIGluY2x1ZGUvZHJtL2Ry
bV9hdG9taWMuaCAgICAgIHwgMjggKysrKysrKysrKysrKysrKysrKysrKysrKysrCj4gPj4gIGlu
Y2x1ZGUvZHJtL2RybV9tb2RlX2NvbmZpZy5oIHwgIDkgKysrKysrKysrCj4gPj4gIDQgZmlsZXMg
Y2hhbmdlZCwgODUgaW5zZXJ0aW9ucygrKSwgMyBkZWxldGlvbnMoLSkKCltzbmlwXQoKPiA+PiBk
aWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUvZHJtL2RybV9hdG9taWMuYyBiL2RyaXZlcnMvZ3B1L2Ry
bS9kcm1fYXRvbWljLmMKPiA+PiBpbmRleCAzNzQ0NWQ1MDgxNmEuLjE1ZTFhMzVjNzRhOCAxMDA2
NDQKPiA+PiAtLS0gYS9kcml2ZXJzL2dwdS9kcm0vZHJtX2F0b21pYy5jCj4gPiA+ICsrKyBiL2Ry
aXZlcnMvZ3B1L2RybS9kcm1fYXRvbWljLmMKCltzbmlwXQoKPiA+PiArLyoqCj4gPj4gKyAqIERP
QzogaGFuZGxpbmcgZHJpdmVyIHByaXZhdGUgc3RhdGUKPiA+PiArICoKPiA+PiArICogVmVyeSBv
ZnRlbiB0aGUgRFJNIG9iamVjdHMgZXhwb3NlZCB0byB1c2Vyc3BhY2UgaW4gdGhlIGF0b21pYwo+
ID4+IG1vZGVzZXQgYXBpCj4gPiAKPiA+IHMvYXBpL0FQSS8KPiA+IAo+ID4+ICsgKiAoJmRybV9j
b25uZWN0b3IsICZkcm1fY3J0YyBhbmQgJmRybV9wbGFuZSkgZG8gbm90IG1hcCBuZWF0bHkgdG8g
dGhlCj4gPj4gKyAqIHVuZGVybHlpbmcgaGFyZHdhcmUuIEVzcGVjaWFsbHkgZm9yIGFueSBraW5k
IG9mIHNoYXJlZCByZXNvdXJjZXMKPiA+PiAoZS5nLiBzaGFyZWQKPiA+PiArICogY2xvY2tzLCBz
Y2FsZXIgdW5pdHMsIGJhbmR3aWR0aCBhbmQgZmlmbyBsaW1pdHMgc2hhcmVkIGFtb25nIGEgZ3Jv
dXAKPiA+PiBvZgo+ID4+ICsgKiBwbGFuZXMgb3IgQ1JUQ3MsIGFuZCBzbyBvbikgaXQgbWFrZXMg
c2Vuc2UgdG8gbW9kZWwgdGhlc2UgYXMKPiA+PiBpbmRlcGVuZGVudAo+ID4+ICsgKiBvYmplY3Rz
LiBEcml2ZXJzIHRoZW4gbmVlZCB0byBzaW1pbGFyIHN0YXRlIHRyYWNraW5nIGFuZCBjb21taXQK
PiA+PiBvcmRlcmluZyBmb3IKPiA+PiArICogc3VjaCBwcml2YXRlIChzaW5jZSBub3QgZXhwb3Nl
ZCB0byB1c2VycGFjZSkgb2JqZWN0cyBhcyB0aGUgYXRvbWljCj4gPj4gY29yZSBhbmQKPiA+PiAr
ICogaGVscGVycyBhbHJlYWR5IHByb3ZpZGUgZm9yIGNvbm5lY3RvcnMsIHBsYW5lcyBhbmQgQ1JU
Q3MuCj4gPj4gCj4gPj4gKyAqIFRvIG1ha2UgdGhpcyBlYXNpZXIgb24gZHJpdmVycyB0aGUgYXRv
bWljIGNvcmUgcHJvdmlkZXMgc29tZSBzdXBwb3J0Cj4gPj4gdG8gdHJhY2sKPiA+PiArICogZHJp
dmVyIHByaXZhdGUgc3RhdGUgb2JqZWN0cyB1c2luZyBzdHJ1Y3QgJmRybV9wcml2YXRlX29iaiwg
d2l0aCB0aGUKPiA+PiArICogYXNzb2NpYXRlZCBzdGF0ZSBzdHJ1Y3QgJmRybV9wcml2YXRlX3N0
YXRlLgo+ID4+ICsgKgo+ID4+ICsgKiBTaW1pbGFyIHRvIHVzZXJzcGFjZS1leHBvc2VkIG9iamVj
dHMsIHN0YXRlIHN0cnVjdHVyZXMgY2FuIGJlCj4gPj4gYWNxdWlyZWQgYnkKPiA+PiArICogY2Fs
bGluZyBkcm1fYXRvbWljX2dldF9wcml2YXRlX29ial9zdGF0ZSgpLiBTaW5jZSB0aGlzIGZ1bmN0
aW9uIGRvZXMKPiA+PiBub3QgdGFrZQo+ID4+ICsgKiBjYXJlIG9mIGxvY2tpbmcsIGRyaXZlcnMg
c2hvdWxkIHdyYXAgaXQgZm9yIGVhY2ggdHlwZSBvZiBwcml2YXRlCj4gPj4gc3RhdGUgb2JqZWN0
Cj4gPj4gKyAqIHRoZXkgaGF2ZSB3aXRoIHRoZSByZXF1aXJlZCBjYWxsIHRvIGRybV9tb2Rlc2V0
X2xvY2soKSBmb3IgdGhlCj4gPj4gY29ycmVzcG9uZGluZwo+ID4+ICsgKiAmZHJtX21vZGVzZXRf
bG9jay4KPiA+IAo+ID4gVGhpcyBwYXJhZ3JhcGggY291bGQgYmVuZWZpdCBmcm9tIGFuIGV4cGxh
bmF0aW9uIG9mIHdoYXQgdGhlIGNvcnJlc3BvbmRpbmcKPiA+IGRybV9tb2Rlc2V0X2xvY2sgaXMu
IFRoZSByZXN0IG9mIHRoZSBkb2N1bWVudCBpcyBwcmV0dHkgY2xlYXIuCj4gCj4gSG0geWVhaCAu
Li4gVGhpcyBpcyBhbHNvIG9uZSBvZiB0aG9zZSB0aGluZ3MgSSdkIGxpa2UgdG8gaW1wcm92ZSBp
biB0aGUKPiBwcml2YXRlIHN0YXRlIHN0dWZmOiBJZiB3ZSBhZGQgYSBmaWxlZCBmb3IgdGhlIGxv
Y2sgKGEgcG9pbnRlciwgbm90IHRoZQo+IGxvY2sgaXRzZWxmKSB3ZSBjb3VsZCBzaW1wbGlmeSB0
aGlzIHN0dWZmIGEgbG90LgoKV2UgZG9uJ3QgaGF2ZSB0byBmaXggZXZlcnl0aGluZyBpbiBvbmUg
Z28gb2YgY291cnNlLCBidXQgYSBzbWFsbCBleHBsYW5hdGlvbiAKb2Ygd2hhdCBkcml2ZXJzIGFy
ZSBzdXBwb3NlZCB0byBkbyB3b3VsZCBiZSBoZWxwZnVsLgoKPiA+PiArICogQWxsIHByaXZhdGUg
c3RhdGUgc3RydWN0dXJlcyBjb250YWluZWQgaW4gYSAmZHJtX2F0b21pY19zdGF0ZSB1cGRhdGUK
PiA+PiBjYW4gYmUKPiA+PiArICogaXRlcmF0ZWQgdXNpbmcgZm9yX2VhY2hfb2xkbmV3X3ByaXZh
dGVfb2JqX2luX3N0YXRlKCksCj4gPj4gKyAqIGZvcl9lYWNoX29sZF9wcml2YXRlX29ial9pbl9z
dGF0ZSgpIGFuZAo+ID4+IGZvcl9lYWNoX29sZF9wcml2YXRlX29ial9pbl9zdGF0ZSgpLgo+ID4g
Cj4gPiBJIHRoaW5rIG9uZSBvZiB0aG9zZSB0d28gd2FzIG1lYW50IHRvIGJlCj4gPiBmb3JfZWFj
aF9uZXdfcHJpdmF0ZV9vYmpfaW5fc3RhdGUoKS4KPiAKPiBGaXhlZC4KPiAKPiA+PiArICogRHJp
dmVycyBhcmUgcmVjb21tZW5kIHRvIHdyYXAgdGhlc2UgZm9yIGVhY2ggdHlwZSBvZiBkcml2ZXIg
cHJpdmF0ZQo+ID4+IHN0YXRlCj4gPj4gKyAqIG9iamVjdCB0aGV5IGhhdmUsIGZpbHRlcmluZyBv
biAmZHJtX3ByaXZhdGVfb2JqLmZ1bmNzIHVzaW5nCj4gPj4gZm9yX2VhY2hfaWYoKSwgYXQKPiA+
PiArICogbGVhc3QgaWYgdGhleSB3YW50IHRvIGl0ZXJhdGUgb3ZlciBhbGwgb2JqZWN0cyBvZiBh
IGdpdmVuIHR5cGUuCj4gPj4gKyAqCj4gPj4gKyAqIEFuIGVhcmxpZXIgd2F5IHRvIGhhbmRsZSBk
cml2ZXIgcHJpdmF0ZSBzdGF0ZSB3YXMgYnkgc3ViY2xhc3NpbmcKPiA+PiBzdHJ1Y3QKPiA+PiAr
ICogJmRybV9hdG9taWNfc3RhdGUuIEJ1dCBzaW5jZSB0aGF0IGVuY291cmFnZXMgbm9uLXN0YW5k
YXJkIHdheXMgdG8KPiA+PiBpbXBsZW1lbnQKPiA+PiArICogdGhlIGNoZWNrL2NvbW1pdCBzcGxp
dCBhdG9taWMgcmVxdWlyZXMgKGJ5IHVzaW5nIGUuZy4gImNoZWNrIGFuZAo+ID4+IHJvbGxiYWNr
IG9yCj4gPj4gKyAqIGNvbW1pdCBpbnN0ZWFkIiBvZiAiZHVwbGljYXRlIHN0YXRlLCBjaGVjaywg
dGhlbiBlaXRoZXIgY29tbWl0IG9yCj4gPj4gcmVsZWFzZQo+ID4+ICsgKiBkdXBsaWNhdGVkIHN0
YXRlKSBpdCBpcyBkZXByZWNhdGVkIGluIGZhdm91ciBvZiB1c2luZwo+ID4+ICZkcm1fcHJpdmF0
ZV9zdGF0ZS4KPiA+IAo+ID4gVGhpcyBJIHN0aWxsIGRvbid0IGFncmVlIHdpdGguIEkgdGhpbmsg
aXQgc3RpbGwgbWFrZXMgc2Vuc2UgdG8gc3ViY2xhc3MKPiA+IHRoZSBnbG9iYWwgc3RhdGUgb2Jq
ZWN0IHdoZW4geW91IGhhdmUgdHJ1ZSBnbG9iYWwgc3RhdGUgZGF0YS4gSG93IGFib3V0Cj4gPiBz
dGFydGluZyBieSBtYWtpbmcgaXQgYSByZWNvbW1lbmRhdGlvbiBpbnN0ZWFkLCBtb3Zpbmcgc3Rh
dGUgZGF0YSByZWxhdGVkCj4gPiB0byBkcml2ZXItIHNwZWNpZmljIG9iamVjdHMgdG8gdGhlIG5l
dyBmcmFtZXdvcmssIGFuZCBrZWVwaW5nIGdsb2JhbCBkYXRhCj4gPiBpbiB0aGUgZHJtX2F0b21p
Y19zdGF0ZSBzdWJjbGFzcyA/Cj4gCj4gQ29udmVydGluZyBhbGwgdGhlIGV4aXN0aW5nIGRyaXZl
cnMgb3ZlciBpcyBzb21ld2hlcmUgb24gbXkgdG9kby4gSSdtIGFsc28KPiBub3QgcmVhbGx5IGNs
ZWFyIHdoYXQgeW91IG1lYW4gd2l0aCBnbG9iYWwgZGF0YSBjb21wYXJlZCB0bwo+IGRyaXZlci1z
cGVjaWZpYyBvYmplY3RzIC4uLgoKSSdsbCB0YWtlIGFuIGV4YW1wbGUgcmVsYXRlZCB0byB0aGUg
cmNhci1kdSBkcml2ZXIuIFRoZSBoYXJkd2FyZSBncm91cHMgQ1JUQ3MgCmJ5IHR3byBhbmQgc2hh
cmUgcmVzb3VyY2VzIChzdWNoIGFzIHBsYW5lcykgYmV0d2VlbiBDUlRDcyBpbiBhIGdyb3VwLiBU
aGlzIGlzIApzb21ldGhpbmcgSSBjdXJyZW50bHkgaW1wbGVtZW50IGluIGEgY29udm9sdXRlZCB3
YXksIGFuZCB1c2luZyBwcml2YXRlIG9iamVjdHMgCnRvIGhhbmRsZSBncm91cHMgKEkgYWxyZWFk
eSBoYXZlIGEgZ3JvdXAgb2JqZWN0IGluIG15IGRyaXZlcikgd2lsbCBsaWtlbHkgaGVscCAKdG8g
bW9kZWwgdGhlIGdyb3VwIHN0YXRlLgoKT24gdGhlIG90aGVyIGhhbmQsIGlmIHRoZSBoYXJkd2Fy
ZSBkaWRuJ3QgaGF2ZSBncm91cHMgYnV0IHNoYXJlZCBwbGFuZXMgCmJldHdlZW4gYWxsIENSVENz
LCB0aGUgc2hhcmVkIHJlc291cmNlcyB3b3VsZCBiZSBnbG9iYWwsIGFuZCBpdCB3b3VsZCBtYWtl
IApzZW5zZSB0byBzdG9yZSB0aGVtIGluIHRoZSBnbG9iYWwgc3RhdGUuCgo+IEFuZCBzZWUgdGhl
IGV2b2x1dGlvbiBvZiB0aGUgaTkxNSBzdGF0ZSBzdHVmZiwKPiBpbW8gaXQncyBhIGJpdCB0b28g
ZWFzeSB0byBnZXQgdGhlIGRybV9hdG9taWNfc3RhdGUgc3ViY2xhc3Npbmcgd3JvbmcuCgotLSAK
UmVnYXJkcywKCkxhdXJlbnQgUGluY2hhcnQKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19f
X19fX19fX19fX19fX19fX19fCkludGVsLWdmeCBtYWlsaW5nIGxpc3QKSW50ZWwtZ2Z4QGxpc3Rz
LmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xp
c3RpbmZvL2ludGVsLWdmeAo=