From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jani Nikula Subject: Re: [PATCH] drm/doc: Document uapi requirements in DRM Date: Mon, 22 Aug 2016 11:10:51 +0300 Message-ID: <87inutustw.fsf@intel.com> References: <1471639838-25591-1-git-send-email-daniel.vetter@ffwll.ch> <1471851386-24414-1-git-send-email-daniel.vetter@ffwll.ch> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by gabe.freedesktop.org (Postfix) with ESMTPS id 38A956E3D4 for ; Mon, 22 Aug 2016 08:11:00 +0000 (UTC) In-Reply-To: <1471851386-24414-1-git-send-email-daniel.vetter@ffwll.ch> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: DRI Development Cc: Daniel Vetter , Liviu Dudau , Laurent Pinchart , Daniel Vetter , Thomas Hellstrom , Alexey Brodkin , Xinliang Liu , Tomi Valkeinen , Ben Skeggs , Russell King , Gerd Hoffmann , Alex Deucher , Maxime Ripard , Christian =?utf-8?Q?K=C3=B6nig?= List-Id: dri-devel@lists.freedesktop.org T24gTW9uLCAyMiBBdWcgMjAxNiwgRGFuaWVsIFZldHRlciA8ZGFuaWVsLnZldHRlckBmZndsbC5j aD4gd3JvdGU6Cj4gRXZlcnlvbmUga25vd3MgdGhlbSwgZXhjZXB0IGFsbCB0aGUgbmV3IGZvbGtz IGpvaW5pbmcgZnJvbSB0aGUgQVJNCj4gc2lkZSBoYXZlbid0IGxpdmVkIHRocm91Z2ggYWxsIHRo ZSBwYWluIG9mIHRoZSBwYXN0IHllYXJzIGFuZCBhcmUKPiBlbnRpcmVseSBzdXJwcmlzZWQgd2hl biBJIHJhaXNlIHRoaXMuIERlZmluaXRlbHkgdGltZSB0byBkb2N1bWVudAo+IHRoaXMuCj4KPiBM YXN0IHRpbWUgdGhpcyB3YXMgYSBiaWcgZGlzY3Vzc2lvbiB3YXMgYWJvdXQgNiB5ZWFycyBhZ28s IHdoZW4gcWNvbQo+IHRyaWVkIHRvIGxhbmQgYSBrZXJuZWwgZHJpdmVyIHdpdGhvdXQgdXNlcnNw YWNlLiBEYXZlIEFpcmxpZSBtYWRlIHRoZQo+IHJ1bGVzIHJlYWxseSBjbGVhcjoKPgo+IGh0dHA6 Ly9haXJsaWVkLmxpdmVqb3VybmFsLmNvbS83MzExNS5odG1sCj4KPiBUaGlzIHdyaXRlLXVwIGhl cmUgaXMgZXNzZW50aWFsbHkgd2hhdCBJJ3ZlIHB1dCBpbnRvIGEgcHJlc2VudGF0aW9uIGEKPiB3 aGlsZSBhZ28sIHdoaWNoIHdhcyBhbHNvIHJldmlld2VkIGJ5IERhdmU6Cj4KPiBodHRwOi8vYmxv Zy5mZndsbC5jaC8yMDE1LzA1L2dmeC1rZXJuZWwtdXBzdHJlYW1pbmctcmVxdWlyZW1lbnRzLmh0 bWwKPgo+IHYyOiBGaXggdHlwb3MgRXJpYyZSb2Igc3BvdHRlZC4KPgo+IENjOiBEYXZlIEFpcmxp ZSA8YWlybGllZEBnbWFpbC5jb20+Cj4gQ2M6IE9kZWQgR2FiYmF5IDxvZGVkLmdhYmJheUBnbWFp bC5jb20+Cj4gQ2M6IFJ1c3NlbGwgS2luZyA8cm1rK2tlcm5lbEBhcm1saW51eC5vcmcudWs+Cj4g Q2M6IFRvbWkgVmFsa2VpbmVuIDx0b21pLnZhbGtlaW5lbkB0aS5jb20+Cj4gQ2M6IEVyaWMgQW5o b2x0IDxlcmljQGFuaG9sdC5uZXQ+Cj4gQ2M6IFRob21hcyBIZWxsc3Ryb20gPHRoZWxsc3Ryb21A dm13YXJlLmNvbT4KPiBDYzogU2luY2xhaXIgWWVoIDxzeWVoQHZtd2FyZS5jb20+Cj4gQ2M6IEx1 Y2FzIFN0YWNoIDxsLnN0YWNoQHBlbmd1dHJvbml4LmRlPgo+IENjOiBCZW5qYW1pbiBHYWlnbmFy ZCA8YmVuamFtaW4uZ2FpZ25hcmRAbGluYXJvLm9yZz4KPiBDYzogTWFyayBZYW8gPG1hcmsueWFv QHJvY2stY2hpcHMuY29tPgo+IENjOiBMYXVyZW50IFBpbmNoYXJ0IDxsYXVyZW50LnBpbmNoYXJ0 QGlkZWFzb25ib2FyZC5jb20+Cj4gQ2M6IEJlbiBTa2VnZ3MgPGJza2VnZ3NAcmVkaGF0LmNvbT4K PiBDYzogUm9iIENsYXJrIDxyb2JkY2xhcmtAZ21haWwuY29tPgo+IENjOiBDSyBIdSA8Y2suaHVA bWVkaWF0ZWsuY29tPgo+IENjOiBYaW5saWFuZyBMaXUgPHoubGl1eGlubGlhbmdAaGlzaWxpY29u LmNvbT4KPiBDYzogUGhpbGlwcCBaYWJlbCA8cC56YWJlbEBwZW5ndXRyb25peC5kZT4KPiBDYzog U3RlZmFuIEFnbmVyIDxzdGVmYW5AYWduZXIuY2g+Cj4gQ2M6IElua2kgRGFlIDxpbmtpLmRhZUBz YW1zdW5nLmNvbT4KPiBDYzogTWF4aW1lIFJpcGFyZCAgPG1heGltZS5yaXBhcmRAZnJlZS1lbGVj dHJvbnMuY29tPgo+IENjOiBCb3JpcyBCcmV6aWxsb24gPGJvcmlzLmJyZXppbGxvbkBmcmVlLWVs ZWN0cm9ucy5jb20+Cj4gQ2M6IEphbmkgTmlrdWxhIDxqYW5pLm5pa3VsYUBsaW51eC5pbnRlbC5j b20+Cj4gQ2M6IERhbmllbCBWZXR0ZXIgPGRhbmllbC52ZXR0ZXJAaW50ZWwuY29tPgo+IENjOiBU aGllcnJ5IFJlZGluZyA8dGhpZXJyeS5yZWRpbmdAZ21haWwuY29tPgo+IENjOiBDaHJpc3RpYW4g S8O2bmlnIDxjaHJpc3RpYW4ua29lbmlnQGFtZC5jb20+Cj4gQ2M6IEFsZXggRGV1Y2hlciA8YWxl eGFuZGVyLmRldWNoZXJAYW1kLmNvbT4KPiBDYzogR2VyZCBIb2ZmbWFubiA8a3JheGVsQHJlZGhh dC5jb20+Cj4gQ2M6IEJyaWFuIFN0YXJrZXkgPGJyaWFuLnN0YXJrZXlAYXJtLmNvbT4KPiBDYzog TGl2aXUgRHVkYXUgPGxpdml1LmR1ZGF1QGFybS5jb20+Cj4gQ2M6IEFsZXhleSBCcm9ka2luIDxh YnJvZGtpbkBzeW5vcHN5cy5jb20+Cj4gQWNrZWQtYnk6IERhdmUgQWlybGllIDxhaXJsaWVkQGdt YWlsLmNvbT4KPiBSZXZpZXdlZC1ieTogUm9iIENsYXJrIDxyb2JkY2xhcmtAZ21haWwuY29tPgo+ IFJldmlld2VkLWJ5OiBDaHJpc3RpYW4gS8O2bmlnIDxjaHJpc3RpYW4ua29lbmlnQGFtZC5jb20+ Cj4gUmV2aWV3ZWQtYnk6IEVyaWMgQW5ob2x0IDxlcmljQGFuaG9sdC5uZXQ+Cj4gU2lnbmVkLW9m Zi1ieTogRGFuaWVsIFZldHRlciA8ZGFuaWVsLnZldHRlckBpbnRlbC5jb20+Cj4gLS0tCj4gIERv Y3VtZW50YXRpb24vZ3B1L2RybS11YXBpLnJzdCB8IDY3ICsrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKwo+ICAxIGZpbGUgY2hhbmdlZCwgNjcgaW5zZXJ0aW9ucygrKQo+ Cj4gZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vZ3B1L2RybS11YXBpLnJzdCBiL0RvY3VtZW50 YXRpb24vZ3B1L2RybS11YXBpLnJzdAo+IGluZGV4IDk0ODc2OTM4YWVmMy4uNzQ3YjUxZjhjNDIy IDEwMDY0NAo+IC0tLSBhL0RvY3VtZW50YXRpb24vZ3B1L2RybS11YXBpLnJzdAo+ICsrKyBiL0Rv Y3VtZW50YXRpb24vZ3B1L2RybS11YXBpLnJzdAo+IEBAIC0zNiw2ICszNiw3MyBAQCBQcmltYXJ5 IE5vZGVzLCBEUk0gTWFzdGVyIGFuZCBBdXRoZW50aWNhdGlvbgo+ICBPcGVuLVNvdXJjZSBVc2Vy c3BhY2UgUmVxdWlyZW1lbnRzCj4gID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0K PiAgCj4gK1RoZSBEUk0gc3Vic3lzdGVtIGhhcyBzdHJpY3RlciByZXF1aXJlbWVudHMgb24gd2hh dCB0aGUgdXNlcnNwYWNlIHNpZGUgZm9yIG5ldwo+ICt1QVBJIG5lZWRzIHRvIGxvb2sgbGlrZS4g VGhpcyBzZWN0aW9uIGhlcmUgZXhwbGFpbnMgd2hhdCBleGFjdGx5IHRob3NlCj4gK3JlcXVpcmVt ZW50cyBhcmUsIGFuZCB3aHkgdGhleSBleGlzdC4KCk5pdHBpY2ssIHN0cmljdGVyIHJlcXVpcmVt ZW50cyB0aGFuIHdoYXQ/IEkga25vdyB3aGF0IHlvdSBtZWFuLCBidXQgdGhlCmNvbXBhcmF0aXZl IGJlZ3MgZm9yIHRoZSB0aGluZyB0byBjb21wYXJlIGFnYWluc3QuCgpPdGhlcndpc2UsCgpSZXZp ZXdlZC1ieTogSmFuaSBOaWt1bGEgPGphbmkubmlrdWxhQGludGVsLmNvbT4KCj4gKwo+ICtUaGUg c2hvcnQgc3VtbWFyeSBpcyB0aGF0IGFueSBhZGRpdGlvbiBvZiBEUk0gdUFQSSByZXF1aXJlcyBj b3JyZXNwb25kaW5nCj4gK29wZW4tc291cmNlZCB1c2Vyc3BhY2UgcGF0Y2hlcywgYW5kIHRob3Nl IHBhdGNoZXMgbXVzdCBiZSByZXZpZXdlZCBhbmQgcmVhZHkgZm9yCj4gK21lcmdpbmcgaW50byBh IHN1aXRhYmxlIGFuZCBjYW5vbmljYWwgdXBzdHJlYW0gcHJvamVjdC4KPiArCj4gK0dGWCBkZXZp Y2VzIChib3RoIGRpc3BsYXkgYW5kIHJlbmRlci9HUFUgc2lkZSkgYXJlIHJlYWxseSBjb21wbGV4 IGJpdHMgb2YKPiAraGFyZHdhcmUsIHdpdGggdXNlcnNwYWNlIGFuZCBrZXJuZWwgYnkgbmVjZXNz aXR5IGhhdmluZyB0byB3b3JrIHRvZ2V0aGVyIHJlYWxseQo+ICtjbG9zZWx5LiAgVGhlIGludGVy ZmFjZXMsIGZvciByZW5kZXJpbmcgYW5kIG1vZGVzZXR0aW5nLCBtdXN0IGJlIGV4dHJlbWVseSB3 aWRlCj4gK2FuZCBmbGV4aWJsZSwgYW5kIHRoZXJlZm9yZSBpdCBpcyBhbG1vc3QgYWx3YXlzIGlt cG9zc2libGUgdG8gcHJlY2lzZWx5IGRlZmluZQo+ICt0aGVtIGZvciBldmVyeSBwb3NzaWJsZSBj b3JuZXIgY2FzZS4gVGhpcyBpbiB0dXJuIG1ha2VzIGl0IHJlYWxseSBwcmFjdGljYWxseQo+ICtp bmZlYXNpYmxlIHRvIGRpZmZlcmVudGlhdGUgYmV0d2VlbiBiZWhhdmlvdXIgdGhhdCdzIHJlcXVp cmVkIGJ5IHVzZXJzcGFjZSwgYW5kCj4gK3doaWNoIG11c3Qgbm90IGJlIGNoYW5nZWQgdG8gYXZv aWQgcmVncmVzc2lvbnMsIGFuZCBiZWhhdmlvdXIgd2hpY2ggaXMgb25seSBhbgo+ICthY2NpZGVu dGFsIGFydGlmYWN0IG9mIHRoZSBjdXJyZW50IGltcGxlbWVudGF0aW9uLgo+ICsKPiArV2l0aG91 dCBhY2Nlc3MgdG8gdGhlIGZ1bGwgc291cmNlIGNvZGUgb2YgYWxsIHVzZXJzcGFjZSB1c2VycyB0 aGF0IG1lYW5zIGl0Cj4gK2JlY29tZXMgaW1wb3NzaWJsZSB0byBjaGFuZ2UgdGhlIGltcGxlbWVu dGF0aW9uIGRldGFpbHMsIHNpbmNlIHVzZXJzcGFjZSBjb3VsZAo+ICtkZXBlbmQgdXBvbiB0aGUg YWNjaWRlbnRhbCBiZWhhdmlvdXIgb2YgdGhlIGN1cnJlbnQgaW1wbGVtZW50YXRpb24gaW4gbWlu dXRlCj4gK2RldGFpbHMuIEFuZCBkZWJ1Z2dpbmcgc3VjaCByZWdyZXNzaW9ucyB3aXRob3V0IGFj Y2VzcyB0byBzb3VyY2UgY29kZSBpcyBwcmV0dHkKPiArbXVjaCBpbXBvc3NpYmxlLiBBcyBhIGNv bnNlcXVlbmNlIHRoaXMgbWVhbnM6Cj4gKwo+ICstIFRoZSBMaW51eCBrZXJuZWwncyAibm8gcmVn cmVzc2lvbiIgcG9saWN5IGhvbGRzIGluIHByYWN0aWNlIG9ubHkgZm9yCj4gKyAgb3Blbi1zb3Vy Y2UgdXNlcnNwYWNlIG9mIHRoZSBEUk0gc3Vic3lzdGVtLiBEUk0gZGV2ZWxvcGVycyBhcmUgcGVy ZmVjdGx5IGZpbmUKPiArICBpZiBjbG9zZWQtc291cmNlIGJsb2IgZHJpdmVycyBpbiB1c2Vyc3Bh Y2UgdXNlIHRoZSBzYW1lIHVBUEkgYXMgdGhlIG9wZW4KPiArICBkcml2ZXJzLCBidXQgdGhleSBt dXN0IGRvIHNvIGluIHRoZSBleGFjdCBzYW1lIHdheSBhcyB0aGUgb3BlbiBkcml2ZXJzLgo+ICsg IENyZWF0aXZlIChhYil1c2Ugb2YgdGhlIGludGVyZmFjZXMgd2lsbCwgYW5kIGluIHRoZSBwYXN0 IHJvdXRpbmVseSBoYXMsIGxlYWQKPiArICB0byBicmVha2FnZS4KPiArCj4gKy0gQW55IG5ldyB1 c2Vyc3BhY2UgaW50ZXJmYWNlIG11c3QgaGF2ZSBhbiBvcGVuLXNvdXJjZSBpbXBsZW1lbnRhdGlv biBhcwo+ICsgIGRlbW9uc3RyYXRpb24gdmVoaWNsZS4KPiArCj4gK1RoZSBvdGhlciByZWFzb24g Zm9yIHJlcXVpcmluZyBvcGVuLXNvdXJjZSB1c2Vyc3BhY2UgaXMgdUFQSSByZXZpZXcuIFNpbmNl IHRoZQo+ICtrZXJuZWwgYW5kIHVzZXJzcGFjZSBwYXJ0cyBvZiBhIEdGWCBzdGFjayBtdXN0IHdv cmsgdG9nZXRoZXIgc28gY2xvc2VseSwgY29kZQo+ICtyZXZpZXcgY2FuIG9ubHkgYXNzZXNzIHdo ZXRoZXIgYSBuZXcgaW50ZXJmYWNlIGFjaGlldmVzIGl0cyBnb2FscyBieSBsb29raW5nIGF0Cj4g K2JvdGggc2lkZXMuIE1ha2luZyBzdXJlIHRoYXQgdGhlIGludGVyZmFjZSBpbmRlZWQgY292ZXJz IHRoZSB1c2UtY2FzZSBmdWxseQo+ICtsZWFkcyB0byBhIGZldyBhZGRpdGlvbmFsIHJlcXVpcmVt ZW50czoKPiArCj4gKy0gVGhlIG9wZW4tc291cmNlIHVzZXJzcGFjZSBtdXN0IG5vdCBiZSBhIHRv eS90ZXN0IGFwcGxpY2F0aW9uLCBidXQgdGhlIHJlYWwKPiArICB0aGluZy4gU3BlY2lmaWNhbGx5 IGl0IG5lZWRzIHRvIGhhbmRsZSBhbGwgdGhlIHVzdWFsIGVycm9yIGFuZCBjb3JuZXIgY2FzZXMu Cj4gKyAgVGhlc2UgYXJlIG9mdGVuIHRoZSBwbGFjZXMgd2hlcmUgbmV3IHVBUEkgZmFsbHMgYXBh cnQgYW5kIGhlbmNlIGVzc2VudGlhbCB0bwo+ICsgIGFzc2VzcyB0aGUgZml0bmVzcyBvZiBhIHBy b3Bvc2VkIGludGVyZmFjZS4KPiArCj4gKy0gVGhlIHVzZXJzcGFjZSBzaWRlIG11c3QgYmUgZnVs bHkgcmV2aWV3ZWQgYW5kIHRlc3RlZCB0byB0aGUgc3RhbmRhcmRzIG9mIHRoYXQKPiArICB1c2Vy c3BhY2UgcHJvamVjdC4gRm9yIGUuZy4gbWVzYSB0aGlzIG1lYW5zIHBpZ2xpdCB0ZXN0Y2FzZXMg YW5kIHJldmlldyBvbiB0aGUKPiArICBtYWlsaW5nIGxpc3QuIFRoaXMgaXMgYWdhaW4gdG8gZW5z dXJlIHRoYXQgdGhlIG5ldyBpbnRlcmZhY2UgYWN0dWFsbHkgZ2V0cyB0aGUKPiArICBqb2IgZG9u ZS4KPiArCj4gKy0gVGhlIHVzZXJzcGFjZSBwYXRjaGVzIG11c3QgYmUgYWdhaW5zdCB0aGUgY2Fu b25pY2FsIHVwc3RyZWFtLCBub3Qgc29tZSB2ZW5kb3IKPiArICBmb3JrLiBUaGlzIGlzIHRvIG1h a2Ugc3VyZSB0aGF0IG5vIG9uZSBjaGVhdHMgb24gdGhlIHJldmlldyBhbmQgdGVzdGluZwo+ICsg IHJlcXVpcmVtZW50cyBieSBkb2luZyBhIHF1aWNrIGZvcmsuCj4gKwo+ICstIFRoZSBrZXJuZWwg cGF0Y2ggY2FuIG9ubHkgYmUgbWVyZ2VkIGFmdGVyIGFsbCB0aGUgYWJvdmUgcmVxdWlyZW1lbnRz IGFyZSBtZXQsCj4gKyAgYnV0IGl0ICoqbXVzdCoqIGJlIG1lcmdlZCAqKmJlZm9yZSoqIHRoZSB1 c2Vyc3BhY2UgcGF0Y2hlcyBsYW5kLiB1QVBJIGFsd2F5cyBmbG93cwo+ICsgIGZyb20gdGhlIGtl cm5lbCwgZG9pbmcgdGhpbmdzIHRoZSBvdGhlciB3YXkgcm91bmQgcmlza3MgZGl2ZXJnZW5jZSBv ZiB0aGUgdUFQSQo+ICsgIGRlZmluaXRpb25zIGFuZCBoZWFkZXIgZmlsZXMuCj4gKwo+ICtUaGVz ZSBhcmUgZmFpcmx5IHN0ZWVwIHJlcXVpcmVtZW50cywgYnV0IGhhdmUgZ3Jvd24gb3V0IGZyb20g eWVhcnMgb2Ygc2hhcmVkCj4gK3BhaW4gYW5kIGV4cGVyaWVuY2Ugd2l0aCB1QVBJIGFkZGVkIGhh c3RpbHksIGFuZCBhbG1vc3QgYWx3YXlzIHJlZ3JldHRlZCBhYm91dAo+ICtqdXN0IGFzIGZhc3Qu IEdGWCBkZXZpY2VzIGNoYW5nZSByZWFsbHkgZmFzdCwgcmVxdWlyaW5nIGEgcGFyYWRpZ20gc2hp ZnQgYW5kCj4gK2VudGlyZSBuZXcgc2V0IG9mIHVBUEkgaW50ZXJmYWNlcyBldmVyeSBmZXcgeWVh cnMgYXQgbGVhc3QuIFRvZ2V0aGVyIHdpdGggdGhlCj4gK0xpbnV4IGtlcm5lbCdzIGd1YXJhbnRl ZSB0byBrZWVwIGV4aXN0aW5nIHVzZXJzcGFjZSBydW5uaW5nIGZvciAxMCsgeWVhcnMgdGhpcwo+ ICtpcyBhbHJlYWR5IHJhdGhlciBwYWluZnVsIGZvciB0aGUgRFJNIHN1YnN5c3RlbSwgd2l0aCBt dWx0aXBsZSBkaWZmZXJlbnQgdUFQSXMKPiArZm9yIHRoZSBzYW1lIHRoaW5nIGNvLWV4aXN0aW5n LiBJZiB3ZSBhZGQgYSBmZXcgbW9yZSBjb21wbGV0ZSBtaXN0YWtlcyBpbnRvIHRoZQo+ICttaXgg ZXZlcnkgeWVhciBpdCB3b3VsZCBiZSBlbnRpcmVseSB1bm1hbmFnZWFibGUuCj4gKwo+ICBSZW5k ZXIgbm9kZXMKPiAgPT09PT09PT09PT09CgotLSAKSmFuaSBOaWt1bGEsIEludGVsIE9wZW4gU291 cmNlIFRlY2hub2xvZ3kgQ2VudGVyCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fCmRyaS1kZXZlbCBtYWlsaW5nIGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVk ZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZv L2RyaS1kZXZlbAo=