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:23:56 +0200 Message-ID: <66171bd8-5d18-1117-8bcd-7fc5cebae37e@amd.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> <164b70a7-8a7d-60ca-480b-04453ca95b90@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: 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 Cc: =?UTF-8?Q?Nicolai_H=c3=a4hnle?= , Chad Versace , ML dri-devel , amd-gfx list , Alex Deucher , Dave Airlie , =?UTF-8?B?TWFyZWsgT2zFocOhaw==?= List-Id: dri-devel@lists.freedesktop.org QW0gMDQuMDkuMjAxOCB1bSAxNToxNyBzY2hyaWViIERhbmllbCBWZXR0ZXI6Cj4gT24gVHVlLCBT ZXAgNCwgMjAxOCBhdCAzOjEyIFBNLCBDaHJpc3RpYW4gS8O2bmlnCj4gPGNrb2VuaWcubGVpY2h0 enVtZXJrZW5AZ21haWwuY29tPiB3cm90ZToKPj4gQW0gMDQuMDkuMjAxOCB1bSAxNTowMyBzY2hy aWViIERhbmllbCBWZXR0ZXI6Cj4+PiBPbiBUdWUsIFNlcCAwNCwgMjAxOCBhdCAwMjozMzowMlBN ICswMjAwLCBCYXMgTmlldXdlbmh1aXplbiB3cm90ZToKPj4+PiBPbiBUdWUsIFNlcCA0LCAyMDE4 IGF0IDI6MjYgUE0gRGFuaWVsIFZldHRlciA8ZGFuaWVsQGZmd2xsLmNoPiB3cm90ZToKPj4+Pj4g T24gVHVlLCBTZXAgMDQsIDIwMTggYXQgMTI6NDQ6MTlQTSArMDIwMCwgQ2hyaXN0aWFuIEvDtm5p ZyB3cm90ZToKPj4+Pj4+IEFtIDA0LjA5LjIwMTggdW0gMTI6MTUgc2NocmllYiBEYW5pZWwgU3Rv bmU6Cj4+Pj4+Pj4gSGksCj4+Pj4+Pj4KPj4+Pj4+PiBPbiBUdWUsIDQgU2VwIDIwMTggYXQgMTE6 MDUsIERhbmllbCBWZXR0ZXIgPGRhbmllbC52ZXR0ZXJAZmZ3bGwuY2g+Cj4+Pj4+Pj4gd3JvdGU6 Cj4+Pj4+Pj4+IE9uIFR1ZSwgU2VwIDQsIDIwMTggYXQgMzowMCBBTSwgQmFzIE5pZXV3ZW5odWl6 ZW4KPj4+Pj4+Pj4gPGJhc0BiYXNuaWV1d2VuaHVpemVuLm5sPiB3cm90ZToKPj4+Pj4+Pj4+ICsv KiBUaGUgY2hpcCB0aGlzIGlzIGNvbXBhdGlibGUgd2l0aC4KPj4+Pj4+Pj4+ICsgKgo+Pj4+Pj4+ Pj4gKyAqIElmIGNvbXByZXNzaW9uIGlzIGRpc2FibGVkLCB1c2UKPj4+Pj4+Pj4+ICsgKiAgIC0g QU1ER1BVX0NISVBfVEFISVRJIGZvciBHRlg2LUdGWDgKPj4+Pj4+Pj4+ICsgKiAgIC0gQU1ER1BV X0NISVBfVkVHQTEwIGZvciBHRlg5Kwo+Pj4+Pj4+Pj4gKyAqCj4+Pj4+Pj4+PiArICogV2l0aCBj b21wcmVzc2lvbiBlbmFibGVkIHBsZWFzZSB1c2UgdGhlIGV4YWN0IGNoaXAuCj4+Pj4+Pj4+PiAr ICoKPj4+Pj4+Pj4+ICsgKiBUT0RPOiBEbyBzb21lIGdlbmVyYXRpb25zIHNoYXJlIERDQyBmb3Jt YXQ/Cj4+Pj4+Pj4+PiArICovCj4+Pj4+Pj4+PiArI2RlZmluZSBBTURHUFVfTU9ESUZJRVJfQ0hJ UF9HRU5fU0hJRlQgICAgICAgICAgICAgICAgIDQwCj4+Pj4+Pj4+PiArI2RlZmluZSBBTURHUFVf TU9ESUZJRVJfQ0hJUF9HRU5fTUFTSyAgICAgICAgICAgICAgICAgIDB4ZmYKPj4+Pj4+Pj4gRG8g eW91IHJlYWxseSBuZWVkIGFsbCB0aGUgY29tYmluYXRpb25zIGhlcmUgb2YgRENDICsgZ3B1IGdl biArCj4+Pj4+Pj4+IHRpbGluZwo+Pj4+Pj4+PiBkZXRhaWxzPyBXaGVuIHdlIGhhZCB0aGUgZW50 aXJlIGRpc2N1c3Npb24gd2l0aCBudmlkaWEgZm9sa3MgdGhleQo+Pj4+Pj4+PiBldmVudHVhbGx5 IGFncmVlZCB0aGF0IHRoZXkgZG9uJ3QgbmVlZCB0aGUgbWFzc2l2ZSBwaWxlIHdpdGggZXZlcnkK Pj4+Pj4+Pj4gcG9zc2libGUgY29tYmluYXRpb24uIERvIHlvdSByZWFsbHkgcGxhbiB0byBzaGFy ZSBhbGwgdGhlc2UgZGlmZmVyZW50Cj4+Pj4+Pj4+IHRoaW5ncz8KPj4+Pj4+Pj4KPj4+Pj4+Pj4g Tm90ZSB0aGF0IGUuZy4gb24gaTkxNSB3ZSBzcGVjIHNvbWUgb2YgdGhlIHRpbGluZyBkZXBlbmRp bmcgdXBvbgo+Pj4+Pj4+PiBidWZmZXIgc2l6ZSBhbmQgYnVmZmVyIGZvcm1hdCAoYmVjYXVzZSB0 aGF0J3MgaG93IHRoZSBodyB3b3JrcyksIG5vdAo+Pj4+Pj4+PiB1c2luZyBleHBsaWNpdCBtb2Rp ZmllciBmbGFncyBmb3IgZXZlcnl0aGluZy4KPj4+Pj4+PiBSaWdodC4gVGhlIGNvbmNsdXNpb24s IGFmdGVyIHBlb3BsZSB3ZW50IHRocm91Z2ggYW5kIHN0YXJ0ZWQgc29ydGluZwo+Pj4+Pj4+IG91 dCB0aGUga2luZHMgb2YgZm9ybWF0cyBmb3Igd2hpY2ggdGhleSB3b3VsZCBfYWN0dWFsbHlfIGV4 cG9ydCByZWFsCj4+Pj4+Pj4gY29sb3VyIGJ1ZmZlcnMgZm9yLCB0aGF0IG1vc3QgdmVuZG9ycyBk ZWZpbml0ZWx5IGhhdmUgZmV3ZXIgdGhhbgo+Pj4+Pj4+Cj4+Pj4+Pj4gMTE1LDc5MiwwODksMjM3 LDMxNiwxOTUsNDIzLDU3MCw5ODUsMDA4LDY4Nyw5MDcsODUzLDI2OSw5ODQsNjY1LDY0MCw1NjQs MDM5LDQ1Nyw1ODQsMDA3LDkxMywxMjksNjM5LDkzNgo+Pj4+Pj4+IHBvc3NpYmxlIGZvcm1hdHMg dG8gcmVwcmVzZW50LCB2ZXJ5IGxpa2VseSBmZXdlciB0aGFuCj4+Pj4+Pj4gMzQwLDI4MiwzNjYs OTIwLDkzOCw0NjMsNDYzLDM3NCw2MDcsNDMxLDc2OCwyMTEsNDU2IGZvcm1hdHMsIHByb2JhYmx5 Cj4+Pj4+Pj4gZmV3ZXIgdGhhbiA3MiwwNTcsNTk0LDAzNyw5MjcsOTM2IGZvcm1hdHMsIGFuZCBl dmVuIHN0aWxsIGdlbmVyYWxseQo+Pj4+Pj4+IGZld2VyIHRoYW4gMjgxLDQ3NCw5NzYsNzEwLDY1 NiBpZiB5b3Ugd2FudCB0byBiZSBnZW5lcm91cyBhbmQgbGVhdmUgOAo+Pj4+Pj4+IGJpdHMgb2Yg dGhlIDU2IGF2YWlsYWJsZS4KPj4+Pj4+IFRoZSBwcm9ibGVtIGhlcmUgaXMgdGhhdCBhdCBsZWFz dCBmb3Igc29tZSBwYXJhbWV0ZXJzIHdlIGFjdHVhbGx5IGRvbid0Cj4+Pj4+PiBrbm93Cj4+Pj4+ PiB3aGljaCBmb3JtYXRzIGFyZSBhY3R1YWxseSB1c2VkLgo+Pj4+Pj4KPj4+Pj4+IFRoZSBmb2xs b3dpbmcgYXJlIG5vdCByZWFsIHdvcmxkIGV4YW1wbGVzLCBidXQganVzdCB0byBleHBsYWluIHRo ZQo+Pj4+Pj4gZ2VuZXJhbAo+Pj4+Pj4gcHJvYmxlbS4KPj4+Pj4+Cj4+Pj4+PiBUaGUgbWVtb3J5 IGNvbmZpZ3VyYXRpb24gZm9yIGV4YW1wbGUgY2FuIGJlIG5vdCBBU0lDIHNwZWNpZmljLCBidXQK Pj4+Pj4+IHJhdGhlcgo+Pj4+Pj4gZGV0ZXJtaW5lZCBieSB3aG9ldmVyIHRvb2sgdGhlIEFTSUMg YW5kIGdsdWVkIGl0IHRvZ2V0aGVyIHdpdGggVlJBTSBvbgo+Pj4+Pj4gYQo+Pj4+Pj4gYm9hcmQu IEl0IGlzIG5vdCBsaWtlbHkgdGhhdCBzb21lYm9keSBwdXRzIGFsbCB0aGUgVlJBTSBjaGlwcyBv biBvbmUKPj4+Pj4+IGNoYW5uZWwsIGJ1dCBpdCBpcyBzdGlsbCBwZXJmZWN0bHkgcG9zc2libGUu Cj4+Pj4+Pgo+Pj4+Pj4gU2FtZSBpcyB0cnVlIGZvciB0aGluZ3MgbGlrZSBoYXJ2ZXN0aW5nLCBl LmcuIG9mIDE2IGNoYW5uZWxzIGhhbHZlIG9mCj4+Pj4+PiB0aGVtCj4+Pj4+PiBjb3VsZCBiZSBi YWQgYW5kIHdlIG5lZWQgdG8ga25vdyB3aGljaCB0byBhY3R1YWxseSB1c2UuCj4+Pj4+IEZvciBt eSB1bmRlcnN0YW5kaW5nOiBUaGlzIGxlYWtzIG91dHNpZGUgdGhlIGNoaXAgd2hlbiBzaGFyaW5n IGJ1ZmZlcnM/Cj4+Pj4+IEFsbCB0aGUgaW5mb3JtYXRpb24geW91IG9ubHkgbmVlZCBsb2NhbGx5 IHRvIGEgZ2l2ZW4gYW1kZ3B1IGluc3RhbmNlCj4+Pj4+IGRvbid0IHJlYWxseSBuZWVkIHRvIGJl IGVuY29kZWQgaW4gbW9kaWZpZXJzLgo+Pj4+Pgo+Pj4+PiBQb2ludGVycyB0byBjb2RlIHdoZXJl IHRoaXMgaXMgYWxsIGRlY2lkZWQgKGtlcm5lbCBhbmQgcmFkZW9uc2kgd291bGQgYmUKPj4+Pj4g Z29vZCBzdGFydGVycyBJIGd1ZXNzKSB3b3VsZCBiZSByZWFsbHkgZ29vZCBoZXJlLgo+Pj4+IEkg ZXh0cmFjdGVkIHRoZSBpbmZvcm1hdGlvbiBvbiB3aGljaCBiaXRzIGFyZSByZWxldmFudCBtb3N0 bHkgZnJvbSB0aGUKPj4+PiBBZGRyRnJvbUNvb3JkIGZ1bmN0aW9ucyBpbiBhZGRybGliIGluIG1l c2E6Cj4+Pj4KPj4+PiBmb3IgbWFjcm8tdGlsZXM6Cj4+Pj4KPj4+PiBodHRwczovL2dpdGxhYi5m cmVlZGVza3RvcC5vcmcvbWVzYS9tZXNhL2Jsb2IvbWFzdGVyL3NyYy9hbWQvYWRkcmxpYi9yODAw L2VnYmFkZHJsaWIuY3BwI0wxNTg3Cj4+Pj4KPj4+PiBmb3IgbWljcm8tdGlsZXMgKG9yIHRoZSBt aWNyby10aWxlcyBpbiBtYWNyby10aWxlcyk6Cj4+Pj4KPj4+Pgo+Pj4+IGh0dHBzOi8vZ2l0bGFi LmZyZWVkZXNrdG9wLm9yZy9tZXNhL21lc2EvYmxvYi9tYXN0ZXIvc3JjL2FtZC9hZGRybGliL2Nv cmUvYWRkcmxpYjEuY3BwI0wzMDE2Cj4+PiBTbyB0aGlzIGlzIHRoZSBkZWNvZGluZyB0aGluZy4g SG93IG1hbnkgb2YgdGhlc2UgYWN0dWFsbHkgZXhpc3QsIGV2ZW4gd2hlbgo+Pj4gdGFraW5nIGFs bCB0aGUgb3RoZXIgaW5mb3JtYXRpb24gaW50byBhY2NvdW50Pwo+Pj4KPj4+IEUuZy4gZ2l2ZW4g YSBwbGF0Zm9ybSArIG1lbW9yeSBjb25maWcgKHNlZW1zIG5lZWRlZCkgKyBkcm1fZm91cmNjICsg c3RyaWRlCj4+PiArIGhlaWdodCArIHdpZHRoLCBob3cgbXVjaCBvZiBhbGwgdGhlc2UgYml0cyBk byB5b3UgYWN0dWFsbHkgc3RpbGwgZnJlZWx5Cj4+PiBwaWNrPwo+Pj4KPj4+IEl0IG1pZ2h0IGJl IHRoYXQgYWxsIHRoZSB0aGluZ3MgeW91IG5lZWQgdG8ga25vdyBmcm9tIHRoZSBtZW1vcnkgY29u ZmlnCj4+PiBkb24ndCBlbmNvZGUgc21hbGxlciB0aGFuIHRoZSBtYWNyby9taWNyby93aGF0ZXZl ciBlbHNlIHN0dWZmLiBCdXQgdGhhdCdzCj4+PiBraW5kYSB0aGUgYW5nbGUgdGhhdCB3ZSBsb29r ZWQgYXQgdGhpcyBmb3IgZXZlcnlvbmUgZWxzZS4KPj4+Cj4+PiBFLmcuIGZvciBtdWx0aS1wbGFu ZSBzdHVmZiwgaWYgZXZlcnlvbmUgcGlja3MgdGhlIHNhbWUgY29uZmlnIGZvciB0aGUKPj4+IDJu ZC8zcmQgcGxhbmUsIHRoZW4geW91IGRvbid0IGFjdHVhbGx5IG5lZWQgdG8gZW5jb2RlIHRoYXQu IEl0IGp1c3QKPj4+IGJlY29tZXMgcGFydCBvZiB0aGUgaW1wbGllZCBzdHVmZiBpbiB0aGUgbW9k aWZpZXIuCj4+Cj4+IFRoZSBwaXBlL2JhbmsgY29uZmlndXJhdGlvbiBmb3IgdGhlIDJuZC8zcmQg cGxhbmUgaXMgdGhlIHNhbWUsIGJ1dCB0aGUgdGlsZQo+PiBjb25maWd1cmF0aW9uIGlzIHBvdGVu dGlhbGx5IGRpZmZlcmVudC4KPj4KPj4gV2UgY2FuIG1ha2UgYW4gZWR1Y2F0ZWQgZ3Vlc3MsIGJ1 dCBJIGRvbid0IHRoaW5rIHRoYXQgdGhpcyBpcyB1bml2ZXJzYWwKPj4gYXBwbGljYWJsZSBhcyB3 ZWxsLgo+IFdoeT8gVGhlIHNvdXJjZSBjb2RlIGZvciBhbWRncHUua28sIG1lc2EsIHJhZHYsIGFt ZHZrIGlzIGFsbCBvcGVuLgo+IFNob3VsZCBiZSBwb3NzaWJsZSB0byBmaWd1cmUgb3V0IHdoYXQn cyBhY3R1YWxseSB1c2VkIChvbiBidWZmZXJzIHlvdQo+IHdhbnQgdG8gc2hhcmUpLCBhbmQgdGhl biBmaWd1cmluZyBvdXQgaG93IHRvIGJlc3QgZW5jb2RlIHRoZQo+IGluZm9ybWF0aW9uIHlvdSBu ZWVkIHRvIHJlY29uc3RydWN0IGFsbCB0aGUgaW5mb3JtYXRpb24uIFlvdSBtaWdodAo+IG5lZWQg dG8gb2NjYXNpb25hbGx5IHJlc3BpbiB0aGF0IGlmIGJlc3QgcHJhY3RpY2VzIGZvciBob3cgdG8g bGF5IG91dAo+IGJ1ZmZlcnMgY2hhbmdlcyBhZnRlciB5b3Ugc3RhcnRlZCB1cHN0cmVhbWluZyBm b3IgYSBnaXZlbiBnZW5lcmF0aW9uLgo+IEJ1dCBpbWUgaHcgcGVvcGxlIGhhdmUgcHJldHR5IHN0 cm9uZyBvcGluaW9ucyBvbiBob3cgdG8gYmVzdCB0aWxlCj4gdGhpbmdzLiBZb3UgZXZlbiBrbm93 IHdoYXQncyBjb21pbmcgZG93biB0aGUgaW50ZXJuYWwgcGlwZWxpbmUuCj4KPiBPciBkbyB5b3Ug bWVhbiBzb21ldGhpbmcgZWxzZSB3aXRoICJlZHVjYXRlZCBndWVzcyI/CgpJIG1lYW4gc29tZXRo aW5nIGVsc2UuIEl0IGNhbiBkZXBlbmQgb24gdGhlIHVzZSBjYXNlIHdoYXQgYSBidWZmZXIgCm9i amVjdCBlbmRzIHVwIHdpdGguCgpJbiBvdGhlciB3b3JkcyB3aGVuIHlvdSB3YW50IHRvIHRyYW5z Y29kZSBhIHZpZGVvIHlvdSBjb3VsZCB1c2UgYSAKZGlmZmVyZW50IGxheW91dCBhcyB3aGVuIHlv dSB3YW50IHRvIGRpc3BsYXkgdGhlIHJlc3VsdGluZyBpbWFnZS4KClNvIGVzc2VudGlhbGx5IHdl IHdvdWxkIG5lZWQgdG8gZW5jb2RlIHRoZSB1c2UgY2FzZSBhbmQgbm90IHRoZSBmb3JtYXQgCm9m IHRoZSBidWZmZXIuCgpUaGF0IG1pZ2h0IHdvcmssIGJ1dCBteSBndXQgZmVlbGluZyBzdHJvbmds eSB0ZWxscyBtZSB0aGF0IHRoaXMgaXMgdGhlIAp3cm9uZyBhcHByb2FjaC4KCkNocmlzdGlhbi4K Cj4gLURhbmllbAo+Cj4+IFJlZ2FyZHMsCj4+IENocmlzdGlhbi4KPj4KPj4KPj4+IC1EYW5pZWwK Pj4+Cj4+Pj4+IC1EYW5pZWwKPj4+Pj4KPj4+Pj4+IFJlZ2FyZHMsCj4+Pj4+PiBDaHJpc3RpYW4u Cj4+Pj4+Pgo+Pj4+Pj4+IElmIHlvdSBkbyB1c2UgMjU2IGJpdHMgaW4gb3JkZXIgdG8gcmVwcmVz ZW50Cj4+Pj4+Pj4KPj4+Pj4+PiAxMTUsNzkyLDA4OSwyMzcsMzE2LDE5NSw0MjMsNTcwLDk4NSww MDgsNjg3LDkwNyw4NTMsMjY5LDk4NCw2NjUsNjQwLDU2NCwwMzksNDU3LDU4NCwwMDcsOTEzLDEy OSw2MzksOTM2Cj4+Pj4+Pj4gbW9kaWZpZXJzIHBlciBmb3JtYXQsIHVzZXJzcGFjZSB3b3VsZCBz dGFydCBoaXR0aW5nIE9PTSBwcmV0dHkgcXVpY2tseQo+Pj4+Pj4+IGFzIGl0IGF0dGVtcHRlZCB0 byBlbnVtZXJhdGUgYW5kIG5lZ290aWF0ZSBhY2NlcHRhYmxlIG1vZGlmaWVycy4KPj4+Pj4+PiBF aXRoZXIgdGhhdCBvciB3ZSBuZWVkIHRvIHJlcGxhY2UgdGhlIGZpeGVkIDY0LWJpdCBtb2RpZmll ciB0b2tlbnMKPj4+Pj4+PiB3aXRoIHNvbWUga2luZCBvZiBlQlBGIHNjcmlwdC4KPj4+Pj4+Pgo+ Pj4+Pj4+IENoZWVycywKPj4+Pj4+PiBEYW5pZWwKPj4+Pj4+PiBfX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fXwo+Pj4+Pj4+IGRyaS1kZXZlbCBtYWlsaW5nIGxp c3QKPj4+Pj4+PiBkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCj4+Pj4+Pj4gaHR0cHM6 Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9kcmktZGV2ZWwKPj4+Pj4g LS0KPj4+Pj4gRGFuaWVsIFZldHRlcgo+Pj4+PiBTb2Z0d2FyZSBFbmdpbmVlciwgSW50ZWwgQ29y cG9yYXRpb24KPj4+Pj4gaHR0cDovL2Jsb2cuZmZ3bGwuY2gKPj4+Pj4gX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KPj4+Pj4gZHJpLWRldmVsIG1haWxpbmcg bGlzdAo+Pj4+PiBkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCj4+Pj4+IGh0dHBzOi8v bGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vZHJpLWRldmVsCj4+Cj4KPgoK X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KZHJpLWRldmVs IG1haWxpbmcgbGlzdApkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlz dHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vZHJpLWRldmVsCg==