From mboxrd@z Thu Jan 1 00:00:00 1970 From: Laurent Pinchart Subject: Re: [RFC] drm: Start documenting userspace ABI Date: Mon, 01 Dec 2014 03:32:03 +0200 Message-ID: <1710520.BouqpcZEMs@avalon> References: <1416320373-18445-1-git-send-email-thierry.reding@gmail.com> <20141118152438.GB19426@ulmo> <20141119132347.GO25711@phenom.ffwll.local> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from galahad.ideasonboard.com (galahad.ideasonboard.com [185.26.127.97]) by gabe.freedesktop.org (Postfix) with ESMTP id 27D2A6E111 for ; Sun, 30 Nov 2014 17:31:32 -0800 (PST) In-Reply-To: <20141119132347.GO25711@phenom.ffwll.local> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Daniel Vetter Cc: Daniel Vetter , Laurent Pinchart , "dri-devel@lists.freedesktop.org" List-Id: dri-devel@lists.freedesktop.org T24gV2VkbmVzZGF5IDE5IE5vdmVtYmVyIDIwMTQgMTQ6MjM6NDcgRGFuaWVsIFZldHRlciB3cm90 ZToKPiBPbiBUdWUsIE5vdiAxOCwgMjAxNCBhdCAwNDoyNDozOVBNICswMTAwLCBUaGllcnJ5IFJl ZGluZyB3cm90ZToKPiA+IE9uIFR1ZSwgTm92IDE4LCAyMDE0IGF0IDA0OjA1OjA4UE0gKzAxMDAs IERhdmlkIEhlcnJtYW5uIHdyb3RlOgo+ID4gPiBPbiBUdWUsIE5vdiAxOCwgMjAxNCBhdCAzOjQz IFBNLCBUaGllcnJ5IFJlZGluZyB3cm90ZToKPiA+ID4gPiBPbiBUdWUsIE5vdiAxOCwgMjAxNCBh dCAwMzoyNzoyN1BNICswMTAwLCBEYW5pZWwgVmV0dGVyIHdyb3RlOgo+ID4gPiA+PiBPbiBUdWUs IE5vdiAxOCwgMjAxNCBhdCAwMzoxOTozM1BNICswMTAwLCBUaGllcnJ5IFJlZGluZyB3cm90ZToK PiA+ID4gPj4gPiBGcm9tOiBUaGllcnJ5IFJlZGluZyA8dHJlZGluZ0BudmlkaWEuY29tPgo+ID4g PiA+PiA+IAo+ID4gPiA+PiA+IEFmdGVyIHNlZWluZyBob3cgdGhlIERSTV9JT0NUTF9NT0RFX0NS RUFURV9EVU1CIHdhcyBpbXBsZW1lbnRlZAo+ID4gPiA+PiA+IHdpdGggZGlmZmVyZW50IHNlbWFu dGljcyBvbiBkaWZmZXJlbnQgZHJpdmVycyBpdCBzZWVtcyBsaWtlIGEgZ29vZAo+ID4gPiA+PiA+ IGlkZWEgdG8gc3RhcnQgdG8gbW9yZSByaWdvcm91c2x5IGRvY3VtZW50IHVzZXJzcGFjZSBBQkkg dG8gYXZvaWQKPiA+ID4gPj4gPiB0aGVzZSB0aGluZ3MgaW4gdGhlIGZ1dHVyZS4KPiA+ID4gPj4g PiAKPiA+ID4gPj4gPiBUaGlzIGlzIGEgZmlyc3QgZHJhZnQgb2Ygd2hhdCBzdWNoIGRvY3VtZW50 YXRpb24gY291bGQgbG9vayBsaWtlLgo+ID4gPiA+PiA+IE5vdCBhbGwgSU9DVExzIGFyZSBkb2N1 bWVudGVkIGFuZCBzb21lIGV4cGxhbmF0aW9uIGFib3V0IHRoZSBvdGhlcgo+ID4gPiA+PiA+IHN5 c3RlbSBjYWxscyAobW1hcCgpLCBwb2xsKCksIHJlYWQoKSwgLi4uKSB3b3VsZCBiZSBnb29kIHRv by4gQnV0IEkKPiA+ID4gPj4gPiB3YW50ZWQgdG8gc2VuZCB0aGlzIG91dCBmb3IgZWFybHkgcmV2 aWV3IHRvIHNlZSBpZiB0aGUgZGlyZWN0aW9uIGlzCj4gPiA+ID4+ID4gcmVhc29uYWJsZS4gSWYg c28gbXkgcGxhbiBpcyB0byBjb250aW51ZSB0byBjaGlwIGF3YXkgYXQgdGhpcyBhcyBJCj4gPiA+ ID4+ID4gZmluZCB0aW1lLgo+ID4gPiA+PiA+IAo+ID4gPiA+PiA+IFNpZ25lZC1vZmYtYnk6IFRo aWVycnkgUmVkaW5nIDx0cmVkaW5nQG52aWRpYS5jb20+Cj4gPiA+ID4+IAo+ID4gPiA+PiBJbW8g Zm9yIGlvY3RscyB0aGUgcmlnaHQgdGhpbmcgdG8gZG8gaXMgaGF2aW5nIHByb3BlciBtYW5wYWdl cywgbm90Cj4gPiA+ID4+IGtlcm5lbGRvYyBvciBEb2NCb29rIHNlY3Rpb25zLiBtYW5wYWdlcyBy ZWFsbHkgbGVuZCB0aGVtc2VsdmVzIHdlbGwKPiA+ID4gPj4gdG8gc3BlY2lmeSBhbGwgdGhlIGRp ZmZlcmVudCBmYWNldHMgb2YgYSBzaW5nbGUgaW50ZXJmYWNlLgo+ID4gPiA+IAo+ID4gPiA+IEkg ZG9uJ3QgdGhpbmsgSSd2ZSBldmVyIHNlZW4gbWFucGFnZXMgZG9jdW1lbnQgSU9DVExzIGF0IHRo aXMgbGV2ZWwgb2YKPiA+ID4gPiBkZXRhaWwuIFRoZSBpbnRlbnRpb24gb2YgdGhpcyBpcyB0byBh ZGQgZG9jdW1lbnRhdGlvbiBhYm91dCB0aGUgSU9DVExzCj4gPiA+ID4gYXQgdGhlIGtlcm5lbC91 c2Vyc3BhY2UgdHJhbnNpdGlvbi4gS2VlcGluZyB0aGlzIGluIHRoZSBrZXJuZWwgaGFzIHRoZQo+ ID4gPiA+IGFkdmFudGFnZSB0aGF0IGl0J3MgYSB3aG9sZSBsb3QgZWFzaWVyIHRvIGtlZXAgdXBk YXRlZCwgbXVjaCBsaWtlIHdoYXQKPiA+ID4gPiB3ZSBkbyB3aXRoIHRoZSBvdGhlciBrZXJuZWxk b2MuCj4gPiA+ID4gCj4gPiA+ID4gVGhhdCBkb2Vzbid0IG1lYW4gd2Ugc2hvdWxkbid0IGhhdmUg bWFucGFnZXMsIGJ1dCBJIHRoaW5rIGJvdGggYXJlIGZvcgo+ID4gPiA+IHRoZSBtb3N0IHBhcnQg b3J0aG9nb25hbCwgZXZlbiB0aG91Z2ggdGhleSBtYXkgZGVzY3JpYmUgdmFyaW91cyBmYWNldHMK PiA+ID4gPiBvZiB0aGUgc2FtZSBpbnRlcmZhY2VzLgo+ID4gPiAKPiA+ID4gdHR5X2lvY3RsKDQp Cj4gPiA+IGNvbnNvbGVfaW9jdGwoNCkKPiA+ID4gCj4gPiA+IEkgdGhpbmsgYSBzaW1pbGFyIG1h bi1wYWdlIGFsYSBkcm1faW9jdGwoNCkgbWFrZXMgYSBsb3Qgb2Ygc2Vuc2UuCgpUaGUgRFJNIEFQ SSBpcyBtdWNoIG1vcmUgY29tcGxleCwgSSB0aGluayBpdCBkZXNlcnZlcyBvbmUgcGFnZSBwZXIg aW9jdGwuCgo+ID4gPiA+PiBBbHNvLCB3ZSBhbHJlYWR5IGhhdmUgc29tZSBza2VsZXRvbiBvZiB0 aGF0IGluIGxpYmRybSwgc28gSSB0aGluawo+ID4gPiA+PiBleHRlbmRpbmcgdGhhdCB3b3VsZCBi ZSBiZXN0Lgo+ID4gPiA+IAo+ID4gPiA+IE9uZSBvdGhlciByZWFzb24gd2h5IEkgZG9uJ3QgdGhp bmsgbGliZHJtIGlzIHRoZSBiZXN0IGZpdCBmb3IgdGhpcyBpcwo+ID4gPiA+IHRoYXQgbGliZHJt IGlzIGp1c3Qgb25lIHVzZXJzcGFjZSBpbXBsZW1lbnRhdGlvbiBhYnN0cmFjdGluZyBhd2F5IHRo ZQo+ID4gPiA+IGludGVyZmFjZXMgdGhhdCB0aGlzIGRlc2NyaWJlcy4gTm90IGV2ZXJ5b25lIHdp bGwgdXNlIGxpYmRybS4gU28gaW4gbXkKPiA+ID4gPiBvcGluaW9uIGl0cyBncmVhdCBpZiBsaWJk cm0gZG9jdW1lbnRzIHRoZSBBUEkgdGhhdCBpdCBleHBvc2VzLCBidXQgSQo+ID4gPiA+IGRvbid0 IHRoaW5rIGl0IHNob3VsZCBkb2N1bWVudCB0aGUga2VybmVsIGludGVyZmFjZXMgdGhhdCBpdCB1 c2VzLiBUaGUKPiA+ID4gPiBrZXJuZWwgZXhwb3NlcyB0aGVtLCBzbyBpdCBzaG91bGQgcHJvdmlk ZSB0aGUgZG9jdW1lbnRhdGlvbiBmb3IgaXQgYXMKPiA+ID4gPiB3ZWxsLgo+ID4gPiAKPiA+ID4g SSBkb24ndCBtaW5kIGRvY3VtZW50aW5nIHRoaXMgaW4gdGhlIGtlcm5lbC1kb2MuIEJ1dCBpZiB3 ZSBzdGFydAo+ID4gPiBzb21ldGhpbmcgbGlrZSBkcm1faW9jdGwoNCkgKEkgcHVzaGVkIHNvbWUg bW9yZSBnZW5lcmljIG1hbi1wYWdlcyB0bwo+ID4gPiBsaWJkcm0gYSBmZXcgeWVhcnMgYWdvKSwg d2UgaGF2ZSB0aGlzIGRvY3VtZW50ZWQgaW4gMiBwbGFjZXMsIHdoaWNoIGlzCj4gPiA+IGFsd2F5 cyBhbm5veWluZyBmb3IgdXBkYXRlcy4KPiA+IAo+ID4gSSB3b25kZXIgaWYgaXQgd291bGQgc29t ZWhvdyBiZSBwb3NzaWJsZSB0byBnZW5lcmF0ZSBtYW5wYWdlcyBmcm9tIHRoZQo+ID4gRG9jQm9v ayB0byBhdm9pZCB0aGlzIGR1cGxpY2F0aW9uLgoKSSdtIHByZXR0eSBzdXJlIHRoYXQgc2hvdWxk IGJlIHBvc3NpYmxlLiBEb2NCb29rIGhhcyBhcHByb3ByaWF0ZSBtYXJrdXAgdG8gCmRvY3VtZW50 IGZ1bmN0aW9ucyBpbiBhIG1hbnBhZ2UtbGlrZSBtYW5uZXIsIHNlZSAKaHR0cDovL2xpbnV4dHYu b3JnL2Rvd25sb2Fkcy92NGwtZHZiLWFwaXMvdmlkaW9jLXJlcWJ1ZnMuaHRtbCBmb3IgaW5zdGFu Y2UuCgo+ID4gT25lIG9mIHRoZSB0aGluZ3MgdGhhdCBEUk1fSU9DVExfTU9ERV9DUkVBVEVfRFVN QiBzaG93ZWQgaXMgdGhhdCBib3RoCj4gPiBkcml2ZXJzIGFuZCB1c2Vyc3BhY2UgY2FuIGludGVy cHJldCB0aGluZ3Mgd3JvbmdseSwgYW5kIEkgZmVhciB0aGF0IGlmIGFsbAo+ID4gd2UgaGF2ZSBp cyBhIG1hbnBhZ2UgdG8gZG9jdW1lbnQgdGhlIElPQ1RMcywgcGVvcGxlIHdyaXRpbmcgdGhlIGRy aXZlcnMKPiA+IG1heSBub3QgYmUgdGVtcHRlZCBlbm91Z2ggdG8gcmVhZCB0aGF0IG1hbnBhZ2Uu IFNvIEkgdGhpbmsgd2Ugd2FudAo+ID4gZG9jdW1lbnRhdGlvbiBmb3IgYm90aCBkcml2ZXIgYW5k IHVzZXJzcGFjZSBkZXZlbG9wZXJzLgo+IAo+IEltbyBkb2NzIGRvbid0IGhlbHAgd2l0aCB0aGF0 IGtpbmQgb2YgZnVtYmxlLCBvbmx5IG5hc3R5IHRlc3RjYXNlcyB3aWxsLgo+IFBlb3BsZSBvbmx5 IHJlYWQgZG9jcyB3aGVuIHRoZXkgZG9uJ3QgdW5kZXJzdGFuZCBzdHVmZiAoaS5lLiB0cnlpbmcg dG8KPiB3cml0ZSBkcml2ZXJzKS4gSW1vIG1hbnBhZ2VzIGFuIGlvY3RsIGRvY3MgYXJlIG9ubHkg cmVhbGx5IGdvb2QgZm9yCj4gZGVzaWduaW5nIHRoZSBpbnRlcmZhY2UgKHNpbmNlIGl0IGZvcmNl cyB5b3UgdG8gcmVhbGx5IHRoaW5rIHRocm91Z2ggdGhlCj4gc2VtYW50aWNzIHRvIGJlIGFibGUg dG8gZGVzY3JpYmUgdGhlbSBjb25jaXNlbHkgYW5kIHByZWNpc2VseSkuIEJ1dCBldmVuCj4gdGhl cmUgSSB0aGluayBoYXZpbmcgc29saWQgdGVzdGNhc2VzIGlzIGJldHRlciBpbnZlc3RlZCB0aW1l Lgo+IAo+IERvY3VtZW50YXRpb24gZm9yIGRldmVsb3BlcnMgaXMgaW1vIGFuIGVudGlyZWx5IGRp ZmZlcmVudCBtYXR0ZXIsIEkgdGhpbmsKPiB0aGF0IGdldHMgdXNlZCBhIGxvdCBtb3JlLiBPciBh dCBsZWFzdCBJIGZpbmQgdGhlbSBmYWlybHkgdXNlZnVsLgoKSSB0aGluayBib3RoIGFyZSB1c2Vm dWwuIEZyb20gbXkgcGVyc29uYWwgZXhwZXJpZW5jZSBwcm9wZXIgZGV0YWlsZWQgaW9jdGwgCmRv Y3VtZW50YXRpb24gaGVscHMgYSBsb3RzIHdoZW4gd3JpdGluZyBrZXJuZWwgZHJpdmVycy4gRXZl biBpbiB0aGUgY2FzZSBvZiAKdGhlIERSTSBzdWJzeXN0ZW0gd2hlcmUgdmFyaW91cyBoZWxwZXIg ZnVuY3Rpb25zIHB1c2ggdGhlIGRyaXZlciBhd2F5IGZyb20gdGhlIAppb2N0bCBBUEksIHByb3Bl ciBkb2N1bWVudGF0aW9uIG9mIHRoZSBzdHJ1Y3R1cmVzIHBhc3NlZCBieSB1c2Vyc3BhY2UgaXMg dmVyeSAKaGVscGZ1bCBmb3IgZHJpdmVyIGRldmVsb3BlcnMuICBOb3QgdG8gbWVudGlvbiBvZiBj b3Vyc2UgdGhhdCB0aGUgCmRvY3VtZW50YXRpb24gaGVscHMgZ2V0dGluZyB0aGUgaGVscGVycyBy aWdodC4KClRlc3QgY2FzZXMgYXJlIGFsc28gaW52YWx1YWJsZS4gSSd2ZSBzZWVuIGJvdGggdGVz dCBjYXNlcyBiZWluZyB1c2VkIHRvIGZpeCAKZHJpdmVycyBhbmQgZG9jdW1lbnRhdGlvbiwgY2xh cmlmeWluZyB0aGUgQVBJIGFzIHRoZXkgZ2V0IGRldmVsb3BlZC4gCkltcGxlbWVudGluZyBhIHRl c3QgY2FzZSBpcyBhIHZlcnkgZ29vZCB3YXkgdG8gdGVzdCB0aGUgbWF0dXJpdHkgb2YgYW4gQVBJ LgoKPiA+IERvY3VtZW50aW5nIHRoaXMgd2l0aGluIHRoZSBrZXJuZWwgaXMgYWxzbyBwcmV0dHkg ZWFzeS4gSSBrbm93IHRoYXQgSSdsbAo+ID4gYmUgbXVjaCBtb3JlIHRlbXB0ZWQgdG8gZG8gaXQg d2l0aGluIHRoZSBrZXJuZWwgdGhhbiBpZiBJIGhhdmUgdG8gc3dpdGNoCj4gPiB0byBzb21lIG90 aGVyIHJlcG9zaXRvcnksIGJ1aWxkIHN5c3RlbSBhbmQgd2hhdG5vdC4KCkkgYWdyZWUuIEhhdmlu ZyBjb2RlIGFuZCBkb2N1bWVudGF0aW9uIGNsb3NlIHRvIGVhY2ggb3RoZXIgd2lsbCBiZW5lZml0 IGJvdGguCgo+ID4gUGVyaGFwcyBpbiB0aGlzIGNhc2UgaGF2aW5nIHR3byBwbGFjZXMgd2hlcmUg aXQncyBkb2N1bWVudGVkIGlzbid0IGFsbAo+ID4gdGhhdCBiYWQuIEl0J3MgQUJJIGFmdGVyIGFs bCwgc28gdGhlIGRvY3VtZW50YXRpb24gbmV2ZXIgbmVlZHMgdG8KPiA+IGNoYW5nZS4gVGhlb3Jl dGljYWxseS4KPiA+IAo+ID4gPiBBbmQgZXZlbiBpZiBwZW9wbGUgZG9uJ3QgdXNlIGxpYmRybSwg SSB0aGluayBpdCdzIHRvdGFsbHkgYWNjZXB0YWJsZQo+ID4gPiB0byBzaGlwIG1hbi1wYWdlcyB3 aXRoIGxpYmRybS4gRGlzdHJpYnV0aW9ucyBhcmUgZnJlZSB0byBwcm92aWRlCj4gPiA+IGRybS1t YW4tcGFnZXMgYXMgc3RhbmQtYWxvbmUgcGFja2FnZSAod2hpY2ggaXMgX3JlYWxseV8gZWFzeSB0 bwo+ID4gPiBnZW5lcmF0ZSBmcm9tIGxpYmRybSkuCj4gPiAKPiA+IEkgZ3Vlc3Mgb25lIG90aGVy IGhvbWUgZm9yIHRoZXNlIGNvdWxkIGJlIHRoZSBtYW4tcGFnZXMgcHJvamVjdCBvbgo+ID4ga2Vy bmVsLm9yZy4gSXQncyB3aGF0IGNhcnJpZXMgbW9zdCAoYWxsPykgb2YgdGhlIExpbnV4IGtlcm5l bC1zcGVjaWZpYwo+ID4gbWFuLXBhZ2VzIChsaWtlIHRoZSB0dHlfaW9jdGwgYW5kIGNvbnNvbGVf aW9jdGwgb25lcyB0aGF0IHlvdSByZWZlcnJlZAo+ID4gdG8pLgo+IAo+IFRoZXJlIGhhcyBiZWVu IHRhbGtzIGFib3V0IG1lcmdpbmcgdGhlIGxpbnV4IG1hbnBhZ2VzIGJhY2sgaW50byB0aGUga2Vy bmVsCj4gYWN0dWFsbHkuIEJ1dCB5ZWFoIHRoYXQgc2VlbXMgbGlrZSBhIGdvb2QgaG9tZSwgZXNw ZWNpYWxseSBzaW5jZSBNaWNoZWFsCj4gS2VycmlzayBzZWVtcyBwcmV0dHkgc2hhcnAgd2l0aCBy ZXZpZXdpbmcgbWFucGFnZXMuCgotLSAKUmVnYXJkcywKCkxhdXJlbnQgUGluY2hhcnQKCl9fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBtYWls aW5nIGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwOi8vbGlzdHMuZnJl ZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vZHJpLWRldmVsCg==