From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: Re: [RFC] drm: Start documenting userspace ABI Date: Wed, 19 Nov 2014 14:23:47 +0100 Message-ID: <20141119132347.GO25711@phenom.ffwll.local> References: <1416320373-18445-1-git-send-email-thierry.reding@gmail.com> <20141118142727.GD25711@phenom.ffwll.local> <20141118144006.GA18586@ulmo> <20141118152438.GB19426@ulmo> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-wi0-f176.google.com (mail-wi0-f176.google.com [209.85.212.176]) by gabe.freedesktop.org (Postfix) with ESMTP id 55A266E233 for ; Wed, 19 Nov 2014 05:23:24 -0800 (PST) Received: by mail-wi0-f176.google.com with SMTP id ex7so5297594wid.15 for ; Wed, 19 Nov 2014 05:23:23 -0800 (PST) Content-Disposition: inline In-Reply-To: <20141118152438.GB19426@ulmo> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Thierry Reding Cc: Daniel Vetter , Laurent Pinchart , "dri-devel@lists.freedesktop.org" List-Id: dri-devel@lists.freedesktop.org T24gVHVlLCBOb3YgMTgsIDIwMTQgYXQgMDQ6MjQ6MzlQTSArMDEwMCwgVGhpZXJyeSBSZWRpbmcg d3JvdGU6Cj4gT24gVHVlLCBOb3YgMTgsIDIwMTQgYXQgMDQ6MDU6MDhQTSArMDEwMCwgRGF2aWQg SGVycm1hbm4gd3JvdGU6Cj4gPiBIaQo+ID4gCj4gPiBPbiBUdWUsIE5vdiAxOCwgMjAxNCBhdCAz OjQzIFBNLCBUaGllcnJ5IFJlZGluZwo+ID4gPHRoaWVycnkucmVkaW5nQGdtYWlsLmNvbT4gd3Jv dGU6Cj4gPiA+IE9uIFR1ZSwgTm92IDE4LCAyMDE0IGF0IDAzOjI3OjI3UE0gKzAxMDAsIERhbmll bCBWZXR0ZXIgd3JvdGU6Cj4gPiA+PiBPbiBUdWUsIE5vdiAxOCwgMjAxNCBhdCAwMzoxOTozM1BN ICswMTAwLCBUaGllcnJ5IFJlZGluZyB3cm90ZToKPiA+ID4+ID4gRnJvbTogVGhpZXJyeSBSZWRp bmcgPHRyZWRpbmdAbnZpZGlhLmNvbT4KPiA+ID4+ID4KPiA+ID4+ID4gQWZ0ZXIgc2VlaW5nIGhv dyB0aGUgRFJNX0lPQ1RMX01PREVfQ1JFQVRFX0RVTUIgd2FzIGltcGxlbWVudGVkIHdpdGgKPiA+ ID4+ID4gZGlmZmVyZW50IHNlbWFudGljcyBvbiBkaWZmZXJlbnQgZHJpdmVycyBpdCBzZWVtcyBs aWtlIGEgZ29vZCBpZGVhIHRvCj4gPiA+PiA+IHN0YXJ0IHRvIG1vcmUgcmlnb3JvdXNseSBkb2N1 bWVudCB1c2Vyc3BhY2UgQUJJIHRvIGF2b2lkIHRoZXNlIHRoaW5ncwo+ID4gPj4gPiBpbiB0aGUg ZnV0dXJlLgo+ID4gPj4gPgo+ID4gPj4gPiBUaGlzIGlzIGEgZmlyc3QgZHJhZnQgb2Ygd2hhdCBz dWNoIGRvY3VtZW50YXRpb24gY291bGQgbG9vayBsaWtlLiBOb3QKPiA+ID4+ID4gYWxsIElPQ1RM cyBhcmUgZG9jdW1lbnRlZCBhbmQgc29tZSBleHBsYW5hdGlvbiBhYm91dCB0aGUgb3RoZXIgc3lz dGVtCj4gPiA+PiA+IGNhbGxzIChtbWFwKCksIHBvbGwoKSwgcmVhZCgpLCAuLi4pIHdvdWxkIGJl IGdvb2QgdG9vLiBCdXQgSSB3YW50ZWQgdG8KPiA+ID4+ID4gc2VuZCB0aGlzIG91dCBmb3IgZWFy bHkgcmV2aWV3IHRvIHNlZSBpZiB0aGUgZGlyZWN0aW9uIGlzIHJlYXNvbmFibGUuCj4gPiA+PiA+ IElmIHNvIG15IHBsYW4gaXMgdG8gY29udGludWUgdG8gY2hpcCBhd2F5IGF0IHRoaXMgYXMgSSBm aW5kIHRpbWUuCj4gPiA+PiA+Cj4gPiA+PiA+IFNpZ25lZC1vZmYtYnk6IFRoaWVycnkgUmVkaW5n IDx0cmVkaW5nQG52aWRpYS5jb20+Cj4gPiA+Pgo+ID4gPj4gSW1vIGZvciBpb2N0bHMgdGhlIHJp Z2h0IHRoaW5nIHRvIGRvIGlzIGhhdmluZyBwcm9wZXIgbWFucGFnZXMsIG5vdAo+ID4gPj4ga2Vy bmVsZG9jIG9yIERvY0Jvb2sgc2VjdGlvbnMuIG1hbnBhZ2VzIHJlYWxseSBsZW5kIHRoZW1zZWx2 ZXMgd2VsbCB0bwo+ID4gPj4gc3BlY2lmeSBhbGwgdGhlIGRpZmZlcmVudCBmYWNldHMgb2YgYSBz aW5nbGUgaW50ZXJmYWNlLgo+ID4gPgo+ID4gPiBJIGRvbid0IHRoaW5rIEkndmUgZXZlciBzZWVu IG1hbnBhZ2VzIGRvY3VtZW50IElPQ1RMcyBhdCB0aGlzIGxldmVsIG9mCj4gPiA+IGRldGFpbC4g VGhlIGludGVudGlvbiBvZiB0aGlzIGlzIHRvIGFkZCBkb2N1bWVudGF0aW9uIGFib3V0IHRoZSBJ T0NUTHMKPiA+ID4gYXQgdGhlIGtlcm5lbC91c2Vyc3BhY2UgdHJhbnNpdGlvbi4gS2VlcGluZyB0 aGlzIGluIHRoZSBrZXJuZWwgaGFzIHRoZQo+ID4gPiBhZHZhbnRhZ2UgdGhhdCBpdCdzIGEgd2hv bGUgbG90IGVhc2llciB0byBrZWVwIHVwZGF0ZWQsIG11Y2ggbGlrZSB3aGF0Cj4gPiA+IHdlIGRv IHdpdGggdGhlIG90aGVyIGtlcm5lbGRvYy4KPiA+ID4KPiA+ID4gVGhhdCBkb2Vzbid0IG1lYW4g d2Ugc2hvdWxkbid0IGhhdmUgbWFucGFnZXMsIGJ1dCBJIHRoaW5rIGJvdGggYXJlIGZvcgo+ID4g PiB0aGUgbW9zdCBwYXJ0IG9ydGhvZ29uYWwsIGV2ZW4gdGhvdWdoIHRoZXkgbWF5IGRlc2NyaWJl IHZhcmlvdXMgZmFjZXRzCj4gPiA+IG9mIHRoZSBzYW1lIGludGVyZmFjZXMuCj4gPiAKPiA+IHR0 eV9pb2N0bCg0KQo+ID4gY29uc29sZV9pb2N0bCg0KQo+ID4gCj4gPiBJIHRoaW5rIGEgc2ltaWxh ciBtYW4tcGFnZSBhbGEgZHJtX2lvY3RsKDQpIG1ha2VzIGEgbG90IG9mIHNlbnNlLgo+ID4gCj4g PiA+PiBBbHNvLCB3ZSBhbHJlYWR5IGhhdmUgc29tZSBza2VsZXRvbiBvZiB0aGF0IGluIGxpYmRy bSwgc28gSSB0aGluawo+ID4gPj4gZXh0ZW5kaW5nIHRoYXQgd291bGQgYmUgYmVzdC4KPiA+ID4K PiA+ID4gT25lIG90aGVyIHJlYXNvbiB3aHkgSSBkb24ndCB0aGluayBsaWJkcm0gaXMgdGhlIGJl c3QgZml0IGZvciB0aGlzIGlzCj4gPiA+IHRoYXQgbGliZHJtIGlzIGp1c3Qgb25lIHVzZXJzcGFj ZSBpbXBsZW1lbnRhdGlvbiBhYnN0cmFjdGluZyBhd2F5IHRoZQo+ID4gPiBpbnRlcmZhY2VzIHRo YXQgdGhpcyBkZXNjcmliZXMuIE5vdCBldmVyeW9uZSB3aWxsIHVzZSBsaWJkcm0uIFNvIGluIG15 Cj4gPiA+IG9waW5pb24gaXRzIGdyZWF0IGlmIGxpYmRybSBkb2N1bWVudHMgdGhlIEFQSSB0aGF0 IGl0IGV4cG9zZXMsIGJ1dCBJCj4gPiA+IGRvbid0IHRoaW5rIGl0IHNob3VsZCBkb2N1bWVudCB0 aGUga2VybmVsIGludGVyZmFjZXMgdGhhdCBpdCB1c2VzLiBUaGUKPiA+ID4ga2VybmVsIGV4cG9z ZXMgdGhlbSwgc28gaXQgc2hvdWxkIHByb3ZpZGUgdGhlIGRvY3VtZW50YXRpb24gZm9yIGl0IGFz Cj4gPiA+IHdlbGwuCj4gPiAKPiA+IEkgZG9uJ3QgbWluZCBkb2N1bWVudGluZyB0aGlzIGluIHRo ZSBrZXJuZWwtZG9jLiBCdXQgaWYgd2Ugc3RhcnQKPiA+IHNvbWV0aGluZyBsaWtlIGRybV9pb2N0 bCg0KSAoSSBwdXNoZWQgc29tZSBtb3JlIGdlbmVyaWMgbWFuLXBhZ2VzIHRvCj4gPiBsaWJkcm0g YSBmZXcgeWVhcnMgYWdvKSwgd2UgaGF2ZSB0aGlzIGRvY3VtZW50ZWQgaW4gMiBwbGFjZXMsIHdo aWNoIGlzCj4gPiBhbHdheXMgYW5ub3lpbmcgZm9yIHVwZGF0ZXMuCj4gCj4gSSB3b25kZXIgaWYg aXQgd291bGQgc29tZWhvdyBiZSBwb3NzaWJsZSB0byBnZW5lcmF0ZSBtYW5wYWdlcyBmcm9tIHRo ZQo+IERvY0Jvb2sgdG8gYXZvaWQgdGhpcyBkdXBsaWNhdGlvbi4gT25lIG9mIHRoZSB0aGluZ3Mg dGhhdAo+IERSTV9JT0NUTF9NT0RFX0NSRUFURV9EVU1CIHNob3dlZCBpcyB0aGF0IGJvdGggZHJp dmVycyBhbmQgdXNlcnNwYWNlIGNhbgo+IGludGVycHJldCB0aGluZ3Mgd3JvbmdseSwgYW5kIEkg ZmVhciB0aGF0IGlmIGFsbCB3ZSBoYXZlIGlzIGEgbWFucGFnZSB0bwo+IGRvY3VtZW50IHRoZSBJ T0NUTHMsIHBlb3BsZSB3cml0aW5nIHRoZSBkcml2ZXJzIG1heSBub3QgYmUgdGVtcHRlZAo+IGVu b3VnaCB0byByZWFkIHRoYXQgbWFucGFnZS4gU28gSSB0aGluayB3ZSB3YW50IGRvY3VtZW50YXRp b24gZm9yIGJvdGgKPiBkcml2ZXIgYW5kIHVzZXJzcGFjZSBkZXZlbG9wZXJzLgoKSW1vIGRvY3Mg ZG9uJ3QgaGVscCB3aXRoIHRoYXQga2luZCBvZiBmdW1ibGUsIG9ubHkgbmFzdHkgdGVzdGNhc2Vz IHdpbGwuClBlb3BsZSBvbmx5IHJlYWQgZG9jcyB3aGVuIHRoZXkgZG9uJ3QgdW5kZXJzdGFuZCBz dHVmZiAoaS5lLiB0cnlpbmcgdG8Kd3JpdGUgZHJpdmVycykuIEltbyBtYW5wYWdlcyBhbiBpb2N0 bCBkb2NzIGFyZSBvbmx5IHJlYWxseSBnb29kIGZvcgpkZXNpZ25pbmcgdGhlIGludGVyZmFjZSAo c2luY2UgaXQgZm9yY2VzIHlvdSB0byByZWFsbHkgdGhpbmsgdGhyb3VnaCB0aGUKc2VtYW50aWNz IHRvIGJlIGFibGUgdG8gZGVzY3JpYmUgdGhlbSBjb25jaXNlbHkgYW5kIHByZWNpc2VseSkuIEJ1 dCBldmVuCnRoZXJlIEkgdGhpbmsgaGF2aW5nIHNvbGlkIHRlc3RjYXNlcyBpcyBiZXR0ZXIgaW52 ZXN0ZWQgdGltZS4KCkRvY3VtZW50YXRpb24gZm9yIGRldmVsb3BlcnMgaXMgaW1vIGFuIGVudGly ZWx5IGRpZmZlcmVudCBtYXR0ZXIsIEkgdGhpbmsKdGhhdCBnZXRzIHVzZWQgYSBsb3QgbW9yZS4g T3IgYXQgbGVhc3QgSSBmaW5kIHRoZW0gZmFpcmx5IHVzZWZ1bC4KCj4gRG9jdW1lbnRpbmcgdGhp cyB3aXRoaW4gdGhlIGtlcm5lbCBpcyBhbHNvIHByZXR0eSBlYXN5LiBJIGtub3cgdGhhdCBJJ2xs Cj4gYmUgbXVjaCBtb3JlIHRlbXB0ZWQgdG8gZG8gaXQgd2l0aGluIHRoZSBrZXJuZWwgdGhhbiBp ZiBJIGhhdmUgdG8gc3dpdGNoCj4gdG8gc29tZSBvdGhlciByZXBvc2l0b3J5LCBidWlsZCBzeXN0 ZW0gYW5kIHdoYXRub3QuCj4gCj4gUGVyaGFwcyBpbiB0aGlzIGNhc2UgaGF2aW5nIHR3byBwbGFj ZXMgd2hlcmUgaXQncyBkb2N1bWVudGVkIGlzbid0IGFsbAo+IHRoYXQgYmFkLiBJdCdzIEFCSSBh ZnRlciBhbGwsIHNvIHRoZSBkb2N1bWVudGF0aW9uIG5ldmVyIG5lZWRzIHRvCj4gY2hhbmdlLiBU aGVvcmV0aWNhbGx5Lgo+IAo+ID4gQW5kIGV2ZW4gaWYgcGVvcGxlIGRvbid0IHVzZSBsaWJkcm0s IEkgdGhpbmsgaXQncyB0b3RhbGx5IGFjY2VwdGFibGUKPiA+IHRvIHNoaXAgbWFuLXBhZ2VzIHdp dGggbGliZHJtLiBEaXN0cmlidXRpb25zIGFyZSBmcmVlIHRvIHByb3ZpZGUKPiA+IGRybS1tYW4t cGFnZXMgYXMgc3RhbmQtYWxvbmUgcGFja2FnZSAod2hpY2ggaXMgX3JlYWxseV8gZWFzeSB0bwo+ ID4gZ2VuZXJhdGUgZnJvbSBsaWJkcm0pLgo+IAo+IEkgZ3Vlc3Mgb25lIG90aGVyIGhvbWUgZm9y IHRoZXNlIGNvdWxkIGJlIHRoZSBtYW4tcGFnZXMgcHJvamVjdCBvbgo+IGtlcm5lbC5vcmcuIEl0 J3Mgd2hhdCBjYXJyaWVzIG1vc3QgKGFsbD8pIG9mIHRoZSBMaW51eCBrZXJuZWwtc3BlY2lmaWMK PiBtYW4tcGFnZXMgKGxpa2UgdGhlIHR0eV9pb2N0bCBhbmQgY29uc29sZV9pb2N0bCBvbmVzIHRo YXQgeW91IHJlZmVycmVkCj4gdG8pLgoKVGhlcmUgaGFzIGJlZW4gdGFsa3MgYWJvdXQgbWVyZ2lu ZyB0aGUgbGludXggbWFucGFnZXMgYmFjayBpbnRvIHRoZSBrZXJuZWwKYWN0dWFsbHkuIEJ1dCB5 ZWFoIHRoYXQgc2VlbXMgbGlrZSBhIGdvb2QgaG9tZSwgZXNwZWNpYWxseSBzaW5jZSBNaWNoZWFs CktlcnJpc2sgc2VlbXMgcHJldHR5IHNoYXJwIHdpdGggcmV2aWV3aW5nIG1hbnBhZ2VzLgotRGFu aWVsCi0tIApEYW5pZWwgVmV0dGVyClNvZnR3YXJlIEVuZ2luZWVyLCBJbnRlbCBDb3Jwb3JhdGlv bgorNDEgKDApIDc5IDM2NSA1NyA0OCAtIGh0dHA6Ly9ibG9nLmZmd2xsLmNoCl9fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBtYWlsaW5nIGxp c3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwOi8vbGlzdHMuZnJlZWRlc2t0 b3Aub3JnL21haWxtYW4vbGlzdGluZm8vZHJpLWRldmVsCg==