From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?UTF-8?Q?Christian_K=c3=b6nig?= Subject: Re: [RFC] drm/amdgpu: Add macros and documentation for format modifiers. Date: Tue, 4 Sep 2018 15:12:42 +0200 Message-ID: <164b70a7-8a7d-60ca-480b-04453ca95b90@gmail.com> References: <20180904010033.67611-1-bas@basnieuwenhuizen.nl> <72744df1-001b-bcd4-dcba-b6966a62c4ce@gmail.com> <20180904122604.GO21634@phenom.ffwll.local> <20180904130353.GQ21634@phenom.ffwll.local> Reply-To: christian.koenig@amd.com Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20180904130353.GQ21634@phenom.ffwll.local> Content-Language: en-US List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Daniel Vetter , Bas Nieuwenhuizen Cc: =?UTF-8?Q?Nicolai_H=c3=a4hnle?= , daniel.vetter@ffwll.ch, Chad Versace , ML dri-devel , christian.koenig@amd.com, amd-gfx@lists.freedesktop.org, alexander.deucher@amd.com, Dave Airlie , =?UTF-8?B?TWFyZWsgT2zFocOhaw==?= List-Id: dri-devel@lists.freedesktop.org QW0gMDQuMDkuMjAxOCB1bSAxNTowMyBzY2hyaWViIERhbmllbCBWZXR0ZXI6Cj4gT24gVHVlLCBT ZXAgMDQsIDIwMTggYXQgMDI6MzM6MDJQTSArMDIwMCwgQmFzIE5pZXV3ZW5odWl6ZW4gd3JvdGU6 Cj4+IE9uIFR1ZSwgU2VwIDQsIDIwMTggYXQgMjoyNiBQTSBEYW5pZWwgVmV0dGVyIDxkYW5pZWxA ZmZ3bGwuY2g+IHdyb3RlOgo+Pj4gT24gVHVlLCBTZXAgMDQsIDIwMTggYXQgMTI6NDQ6MTlQTSAr MDIwMCwgQ2hyaXN0aWFuIEvDtm5pZyB3cm90ZToKPj4+PiBBbSAwNC4wOS4yMDE4IHVtIDEyOjE1 IHNjaHJpZWIgRGFuaWVsIFN0b25lOgo+Pj4+PiBIaSwKPj4+Pj4KPj4+Pj4gT24gVHVlLCA0IFNl cCAyMDE4IGF0IDExOjA1LCBEYW5pZWwgVmV0dGVyIDxkYW5pZWwudmV0dGVyQGZmd2xsLmNoPiB3 cm90ZToKPj4+Pj4+IE9uIFR1ZSwgU2VwIDQsIDIwMTggYXQgMzowMCBBTSwgQmFzIE5pZXV3ZW5o dWl6ZW4gPGJhc0BiYXNuaWV1d2VuaHVpemVuLm5sPiB3cm90ZToKPj4+Pj4+PiArLyogVGhlIGNo aXAgdGhpcyBpcyBjb21wYXRpYmxlIHdpdGguCj4+Pj4+Pj4gKyAqCj4+Pj4+Pj4gKyAqIElmIGNv bXByZXNzaW9uIGlzIGRpc2FibGVkLCB1c2UKPj4+Pj4+PiArICogICAtIEFNREdQVV9DSElQX1RB SElUSSBmb3IgR0ZYNi1HRlg4Cj4+Pj4+Pj4gKyAqICAgLSBBTURHUFVfQ0hJUF9WRUdBMTAgZm9y IEdGWDkrCj4+Pj4+Pj4gKyAqCj4+Pj4+Pj4gKyAqIFdpdGggY29tcHJlc3Npb24gZW5hYmxlZCBw bGVhc2UgdXNlIHRoZSBleGFjdCBjaGlwLgo+Pj4+Pj4+ICsgKgo+Pj4+Pj4+ICsgKiBUT0RPOiBE byBzb21lIGdlbmVyYXRpb25zIHNoYXJlIERDQyBmb3JtYXQ/Cj4+Pj4+Pj4gKyAqLwo+Pj4+Pj4+ ICsjZGVmaW5lIEFNREdQVV9NT0RJRklFUl9DSElQX0dFTl9TSElGVCAgICAgICAgICAgICAgICAg NDAKPj4+Pj4+PiArI2RlZmluZSBBTURHUFVfTU9ESUZJRVJfQ0hJUF9HRU5fTUFTSyAgICAgICAg ICAgICAgICAgIDB4ZmYKPj4+Pj4+IERvIHlvdSByZWFsbHkgbmVlZCBhbGwgdGhlIGNvbWJpbmF0 aW9ucyBoZXJlIG9mIERDQyArIGdwdSBnZW4gKyB0aWxpbmcKPj4+Pj4+IGRldGFpbHM/IFdoZW4g d2UgaGFkIHRoZSBlbnRpcmUgZGlzY3Vzc2lvbiB3aXRoIG52aWRpYSBmb2xrcyB0aGV5Cj4+Pj4+ PiBldmVudHVhbGx5IGFncmVlZCB0aGF0IHRoZXkgZG9uJ3QgbmVlZCB0aGUgbWFzc2l2ZSBwaWxl IHdpdGggZXZlcnkKPj4+Pj4+IHBvc3NpYmxlIGNvbWJpbmF0aW9uLiBEbyB5b3UgcmVhbGx5IHBs YW4gdG8gc2hhcmUgYWxsIHRoZXNlIGRpZmZlcmVudAo+Pj4+Pj4gdGhpbmdzPwo+Pj4+Pj4KPj4+ Pj4+IE5vdGUgdGhhdCBlLmcuIG9uIGk5MTUgd2Ugc3BlYyBzb21lIG9mIHRoZSB0aWxpbmcgZGVw ZW5kaW5nIHVwb24KPj4+Pj4+IGJ1ZmZlciBzaXplIGFuZCBidWZmZXIgZm9ybWF0IChiZWNhdXNl IHRoYXQncyBob3cgdGhlIGh3IHdvcmtzKSwgbm90Cj4+Pj4+PiB1c2luZyBleHBsaWNpdCBtb2Rp ZmllciBmbGFncyBmb3IgZXZlcnl0aGluZy4KPj4+Pj4gUmlnaHQuIFRoZSBjb25jbHVzaW9uLCBh ZnRlciBwZW9wbGUgd2VudCB0aHJvdWdoIGFuZCBzdGFydGVkIHNvcnRpbmcKPj4+Pj4gb3V0IHRo ZSBraW5kcyBvZiBmb3JtYXRzIGZvciB3aGljaCB0aGV5IHdvdWxkIF9hY3R1YWxseV8gZXhwb3J0 IHJlYWwKPj4+Pj4gY29sb3VyIGJ1ZmZlcnMgZm9yLCB0aGF0IG1vc3QgdmVuZG9ycyBkZWZpbml0 ZWx5IGhhdmUgZmV3ZXIgdGhhbgo+Pj4+PiAxMTUsNzkyLDA4OSwyMzcsMzE2LDE5NSw0MjMsNTcw LDk4NSwwMDgsNjg3LDkwNyw4NTMsMjY5LDk4NCw2NjUsNjQwLDU2NCwwMzksNDU3LDU4NCwwMDcs OTEzLDEyOSw2MzksOTM2Cj4+Pj4+IHBvc3NpYmxlIGZvcm1hdHMgdG8gcmVwcmVzZW50LCB2ZXJ5 IGxpa2VseSBmZXdlciB0aGFuCj4+Pj4+IDM0MCwyODIsMzY2LDkyMCw5MzgsNDYzLDQ2MywzNzQs NjA3LDQzMSw3NjgsMjExLDQ1NiBmb3JtYXRzLCBwcm9iYWJseQo+Pj4+PiBmZXdlciB0aGFuIDcy LDA1Nyw1OTQsMDM3LDkyNyw5MzYgZm9ybWF0cywgYW5kIGV2ZW4gc3RpbGwgZ2VuZXJhbGx5Cj4+ Pj4+IGZld2VyIHRoYW4gMjgxLDQ3NCw5NzYsNzEwLDY1NiBpZiB5b3Ugd2FudCB0byBiZSBnZW5l cm91cyBhbmQgbGVhdmUgOAo+Pj4+PiBiaXRzIG9mIHRoZSA1NiBhdmFpbGFibGUuCj4+Pj4gVGhl IHByb2JsZW0gaGVyZSBpcyB0aGF0IGF0IGxlYXN0IGZvciBzb21lIHBhcmFtZXRlcnMgd2UgYWN0 dWFsbHkgZG9uJ3Qga25vdwo+Pj4+IHdoaWNoIGZvcm1hdHMgYXJlIGFjdHVhbGx5IHVzZWQuCj4+ Pj4KPj4+PiBUaGUgZm9sbG93aW5nIGFyZSBub3QgcmVhbCB3b3JsZCBleGFtcGxlcywgYnV0IGp1 c3QgdG8gZXhwbGFpbiB0aGUgZ2VuZXJhbAo+Pj4+IHByb2JsZW0uCj4+Pj4KPj4+PiBUaGUgbWVt b3J5IGNvbmZpZ3VyYXRpb24gZm9yIGV4YW1wbGUgY2FuIGJlIG5vdCBBU0lDIHNwZWNpZmljLCBi dXQgcmF0aGVyCj4+Pj4gZGV0ZXJtaW5lZCBieSB3aG9ldmVyIHRvb2sgdGhlIEFTSUMgYW5kIGds dWVkIGl0IHRvZ2V0aGVyIHdpdGggVlJBTSBvbiBhCj4+Pj4gYm9hcmQuIEl0IGlzIG5vdCBsaWtl bHkgdGhhdCBzb21lYm9keSBwdXRzIGFsbCB0aGUgVlJBTSBjaGlwcyBvbiBvbmUKPj4+PiBjaGFu bmVsLCBidXQgaXQgaXMgc3RpbGwgcGVyZmVjdGx5IHBvc3NpYmxlLgo+Pj4+Cj4+Pj4gU2FtZSBp cyB0cnVlIGZvciB0aGluZ3MgbGlrZSBoYXJ2ZXN0aW5nLCBlLmcuIG9mIDE2IGNoYW5uZWxzIGhh bHZlIG9mIHRoZW0KPj4+PiBjb3VsZCBiZSBiYWQgYW5kIHdlIG5lZWQgdG8ga25vdyB3aGljaCB0 byBhY3R1YWxseSB1c2UuCj4+PiBGb3IgbXkgdW5kZXJzdGFuZGluZzogVGhpcyBsZWFrcyBvdXRz aWRlIHRoZSBjaGlwIHdoZW4gc2hhcmluZyBidWZmZXJzPwo+Pj4gQWxsIHRoZSBpbmZvcm1hdGlv biB5b3Ugb25seSBuZWVkIGxvY2FsbHkgdG8gYSBnaXZlbiBhbWRncHUgaW5zdGFuY2UKPj4+IGRv bid0IHJlYWxseSBuZWVkIHRvIGJlIGVuY29kZWQgaW4gbW9kaWZpZXJzLgo+Pj4KPj4+IFBvaW50 ZXJzIHRvIGNvZGUgd2hlcmUgdGhpcyBpcyBhbGwgZGVjaWRlZCAoa2VybmVsIGFuZCByYWRlb25z aSB3b3VsZCBiZQo+Pj4gZ29vZCBzdGFydGVycyBJIGd1ZXNzKSB3b3VsZCBiZSByZWFsbHkgZ29v ZCBoZXJlLgo+PiBJIGV4dHJhY3RlZCB0aGUgaW5mb3JtYXRpb24gb24gd2hpY2ggYml0cyBhcmUg cmVsZXZhbnQgbW9zdGx5IGZyb20gdGhlCj4+IEFkZHJGcm9tQ29vcmQgZnVuY3Rpb25zIGluIGFk ZHJsaWIgaW4gbWVzYToKPj4KPj4gZm9yIG1hY3JvLXRpbGVzOgo+PiBodHRwczovL2dpdGxhYi5m cmVlZGVza3RvcC5vcmcvbWVzYS9tZXNhL2Jsb2IvbWFzdGVyL3NyYy9hbWQvYWRkcmxpYi9yODAw L2VnYmFkZHJsaWIuY3BwI0wxNTg3Cj4+Cj4+IGZvciBtaWNyby10aWxlcyAob3IgdGhlIG1pY3Jv LXRpbGVzIGluIG1hY3JvLXRpbGVzKToKPj4KPj4gaHR0cHM6Ly9naXRsYWIuZnJlZWRlc2t0b3Au b3JnL21lc2EvbWVzYS9ibG9iL21hc3Rlci9zcmMvYW1kL2FkZHJsaWIvY29yZS9hZGRybGliMS5j cHAjTDMwMTYKPiBTbyB0aGlzIGlzIHRoZSBkZWNvZGluZyB0aGluZy4gSG93IG1hbnkgb2YgdGhl c2UgYWN0dWFsbHkgZXhpc3QsIGV2ZW4gd2hlbgo+IHRha2luZyBhbGwgdGhlIG90aGVyIGluZm9y bWF0aW9uIGludG8gYWNjb3VudD8KPgo+IEUuZy4gZ2l2ZW4gYSBwbGF0Zm9ybSArIG1lbW9yeSBj b25maWcgKHNlZW1zIG5lZWRlZCkgKyBkcm1fZm91cmNjICsgc3RyaWRlCj4gKyBoZWlnaHQgKyB3 aWR0aCwgaG93IG11Y2ggb2YgYWxsIHRoZXNlIGJpdHMgZG8geW91IGFjdHVhbGx5IHN0aWxsIGZy ZWVseQo+IHBpY2s/Cj4KPiBJdCBtaWdodCBiZSB0aGF0IGFsbCB0aGUgdGhpbmdzIHlvdSBuZWVk IHRvIGtub3cgZnJvbSB0aGUgbWVtb3J5IGNvbmZpZwo+IGRvbid0IGVuY29kZSBzbWFsbGVyIHRo YW4gdGhlIG1hY3JvL21pY3JvL3doYXRldmVyIGVsc2Ugc3R1ZmYuIEJ1dCB0aGF0J3MKPiBraW5k YSB0aGUgYW5nbGUgdGhhdCB3ZSBsb29rZWQgYXQgdGhpcyBmb3IgZXZlcnlvbmUgZWxzZS4KPgo+ IEUuZy4gZm9yIG11bHRpLXBsYW5lIHN0dWZmLCBpZiBldmVyeW9uZSBwaWNrcyB0aGUgc2FtZSBj b25maWcgZm9yIHRoZQo+IDJuZC8zcmQgcGxhbmUsIHRoZW4geW91IGRvbid0IGFjdHVhbGx5IG5l ZWQgdG8gZW5jb2RlIHRoYXQuIEl0IGp1c3QKPiBiZWNvbWVzIHBhcnQgb2YgdGhlIGltcGxpZWQg c3R1ZmYgaW4gdGhlIG1vZGlmaWVyLgoKVGhlIHBpcGUvYmFuayBjb25maWd1cmF0aW9uIGZvciB0 aGUgMm5kLzNyZCBwbGFuZSBpcyB0aGUgc2FtZSwgYnV0IHRoZSAKdGlsZSBjb25maWd1cmF0aW9u IGlzIHBvdGVudGlhbGx5IGRpZmZlcmVudC4KCldlIGNhbiBtYWtlIGFuIGVkdWNhdGVkIGd1ZXNz LCBidXQgSSBkb24ndCB0aGluayB0aGF0IHRoaXMgaXMgdW5pdmVyc2FsIAphcHBsaWNhYmxlIGFz IHdlbGwuCgpSZWdhcmRzLApDaHJpc3RpYW4uCgo+IC1EYW5pZWwKPgo+Pj4gLURhbmllbAo+Pj4K Pj4+PiBSZWdhcmRzLAo+Pj4+IENocmlzdGlhbi4KPj4+Pgo+Pj4+PiBJZiB5b3UgZG8gdXNlIDI1 NiBiaXRzIGluIG9yZGVyIHRvIHJlcHJlc2VudAo+Pj4+PiAxMTUsNzkyLDA4OSwyMzcsMzE2LDE5 NSw0MjMsNTcwLDk4NSwwMDgsNjg3LDkwNyw4NTMsMjY5LDk4NCw2NjUsNjQwLDU2NCwwMzksNDU3 LDU4NCwwMDcsOTEzLDEyOSw2MzksOTM2Cj4+Pj4+IG1vZGlmaWVycyBwZXIgZm9ybWF0LCB1c2Vy c3BhY2Ugd291bGQgc3RhcnQgaGl0dGluZyBPT00gcHJldHR5IHF1aWNrbHkKPj4+Pj4gYXMgaXQg YXR0ZW1wdGVkIHRvIGVudW1lcmF0ZSBhbmQgbmVnb3RpYXRlIGFjY2VwdGFibGUgbW9kaWZpZXJz Lgo+Pj4+PiBFaXRoZXIgdGhhdCBvciB3ZSBuZWVkIHRvIHJlcGxhY2UgdGhlIGZpeGVkIDY0LWJp dCBtb2RpZmllciB0b2tlbnMKPj4+Pj4gd2l0aCBzb21lIGtpbmQgb2YgZUJQRiBzY3JpcHQuCj4+ Pj4+Cj4+Pj4+IENoZWVycywKPj4+Pj4gRGFuaWVsCj4+Pj4+IF9fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fCj4+Pj4+IGRyaS1kZXZlbCBtYWlsaW5nIGxpc3QK Pj4+Pj4gZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwo+Pj4+PiBodHRwczovL2xpc3Rz LmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAo+Pj4gLS0KPj4+IERh bmllbCBWZXR0ZXIKPj4+IFNvZnR3YXJlIEVuZ2luZWVyLCBJbnRlbCBDb3Jwb3JhdGlvbgo+Pj4g aHR0cDovL2Jsb2cuZmZ3bGwuY2gKPj4+IF9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fCj4+PiBkcmktZGV2ZWwgbWFpbGluZyBsaXN0Cj4+PiBkcmktZGV2ZWxA bGlzdHMuZnJlZWRlc2t0b3Aub3JnCj4+PiBodHRwczovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9t YWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxAbGlzdHMu ZnJlZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlz dGluZm8vZHJpLWRldmVsCg==