From mboxrd@z Thu Jan 1 00:00:00 1970 From: Max Staudt Subject: [RFC PATCH v2 10/13] Documentation: Add bootsplash main documentation Date: Wed, 13 Dec 2017 20:47:52 +0100 Message-ID: <20171213194755.3409-11-mstaudt@suse.de> References: <20171213194755.3409-1-mstaudt@suse.de> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mx2.suse.de (mx2.suse.de [195.135.220.15]) by gabe.freedesktop.org (Postfix) with ESMTPS id 5873D6E59F for ; Wed, 13 Dec 2017 19:48:46 +0000 (UTC) In-Reply-To: <20171213194755.3409-1-mstaudt@suse.de> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: b.zolnierkie@samsung.com, linux-fbdev@vger.kernel.org Cc: michal@markovi.net, sndirsch@suse.com, oneukum@suse.com, tiwai@suse.com, dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org, mstaudt@suse.de, bernhard.rosenkranzer@linaro.org, philm@manjaro.org List-Id: dri-devel@lists.freedesktop.org U2lnbmVkLW9mZi1ieTogTWF4IFN0YXVkdCA8bXN0YXVkdEBzdXNlLmRlPgotLS0KIC4uLi9BQkkv dGVzdGluZy9zeXNmcy1wbGF0Zm9ybS1ib290c3BsYXNoICAgICAgICAgIHwgIDExICsrCiBEb2N1 bWVudGF0aW9uL2Jvb3RzcGxhc2gucnN0ICAgICAgICAgICAgICAgICAgICAgICB8IDE3NyArKysr KysrKysrKysrKysrKysrKysKIE1BSU5UQUlORVJTICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgIHwgICAyICsKIDMgZmlsZXMgY2hhbmdlZCwgMTkwIGluc2VydGlvbnMoKykK IGNyZWF0ZSBtb2RlIDEwMDY0NCBEb2N1bWVudGF0aW9uL0FCSS90ZXN0aW5nL3N5c2ZzLXBsYXRm b3JtLWJvb3RzcGxhc2gKIGNyZWF0ZSBtb2RlIDEwMDY0NCBEb2N1bWVudGF0aW9uL2Jvb3RzcGxh c2gucnN0CgpkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9BQkkvdGVzdGluZy9zeXNmcy1wbGF0 Zm9ybS1ib290c3BsYXNoIGIvRG9jdW1lbnRhdGlvbi9BQkkvdGVzdGluZy9zeXNmcy1wbGF0Zm9y bS1ib290c3BsYXNoCm5ldyBmaWxlIG1vZGUgMTAwNjQ0CmluZGV4IDAwMDAwMDAwMDAwMC4uNzQy YzdiMDM1ZGVkCi0tLSAvZGV2L251bGwKKysrIGIvRG9jdW1lbnRhdGlvbi9BQkkvdGVzdGluZy9z eXNmcy1wbGF0Zm9ybS1ib290c3BsYXNoCkBAIC0wLDAgKzEsMTEgQEAKK1doYXQ6CQkvc3lzL2Rl dmljZXMvcGxhdGZvcm0vYm9vdHNwbGFzaC4wL2VuYWJsZWQKK0RhdGU6CQlPY3QgMjAxNworS2Vy bmVsVmVyc2lvbjoJNC4xNAorQ29udGFjdDoJTWF4IFN0YXVkdCA8bXN0YXVkdEBzdXNlLmRlPgor RGVzY3JpcHRpb246CisJCUNhbiBiZSBzZXQgYW5kIHJlYWQuCisKKwkJMDogU3BsYXNoIGlzIGRp c2FibGVkLgorCQkxOiBTcGxhc2ggaXMgc2hvd24gd2hlbmV2ZXIgZmJjb24gd291bGQgc2hvdyBh IHRleHQgY29uc29sZQorCQkgICAoaS5lLiBubyBncmFwaGljYWwgYXBwbGljYXRpb24gaXMgcnVu bmluZyksIGFuZCBhIHNwbGFzaAorCQkgICBmaWxlIGlzIGxvYWRlZC4KZGlmZiAtLWdpdCBhL0Rv Y3VtZW50YXRpb24vYm9vdHNwbGFzaC5yc3QgYi9Eb2N1bWVudGF0aW9uL2Jvb3RzcGxhc2gucnN0 Cm5ldyBmaWxlIG1vZGUgMTAwNjQ0CmluZGV4IDAwMDAwMDAwMDAwMC4uOGJkNjgwNWFmNmJmCi0t LSAvZGV2L251bGwKKysrIGIvRG9jdW1lbnRhdGlvbi9ib290c3BsYXNoLnJzdApAQCAtMCwwICsx LDE3NyBAQAorPT09PT09PT09PT09PT09PT09PT0KK1RoZSBMaW51eCBib290c3BsYXNoCis9PT09 PT09PT09PT09PT09PT09PQorCis6RGF0ZTogTm92ZW1iZXIsIDIwMTcKKzpBdXRob3I6IE1heCBT dGF1ZHQgPG1zdGF1ZHRAc3VzZS5kZT4KKworCitUaGUgTGludXggYm9vdHNwbGFzaCBpcyBhIGdy YXBoaWNhbCByZXBsYWNlbWVudCBmb3IgdGhlICdgYHF1aWV0YGAnIGJvb3QKK29wdGlvbiwgdHlw aWNhbGx5IHNob3dpbmcgYSBsb2dvIGFuZCBhIHNwaW5uZXIgYW5pbWF0aW9uIGFzIHRoZSBzeXN0 ZW0gc3RhcnRzLgorCitDdXJyZW50bHksIGl0IGlzIGEgcGFydCBvZiB0aGUgRnJhbWVidWZmZXIg Q29uc29sZSBzdXBwb3J0LCBhbmQgY2FuIGJlIGZvdW5kCithcyBgYENPTkZJR19CT09UU1BMQVNI YGAgaW4gdGhlIGtlcm5lbCBjb25maWd1cmF0aW9uLiBUaGlzIG1lYW5zIHRoYXQgYXMgbG9uZwor YXMgaXQgaXMgZW5hYmxlZCwgaXQgaGlqYWNrcyBmYmNvbidzIG91dHB1dCBhbmQgZHJhd3MgYSBz cGxhc2ggc2NyZWVuIGluc3RlYWQuCisKK1B1cmVseSBjb21waWxpbmcgaW4gdGhlIGJvb3RzcGxh c2ggd2lsbCBub3QgcmVuZGVyIGl0IGZ1bmN0aW9uYWwgLSB0byBhY3R1YWxseQorcmVuZGVyIGEg c3BsYXNoLCB5b3Ugd2lsbCBhbHNvIG5lZWQgYSBzcGxhc2ggdGhlbWUgZmlsZS4gU2VlIHRoZSBl eGFtcGxlCit1dGlsaXR5IGFuZCBzY3JpcHQgaW4gYGB0b29scy9ib290c3BsYXNoYGAgZm9yIGEg bGl2ZSBkZW1vLgorCisKKworTW90aXZhdGlvbgorPT09PT09PT09PQorCistIFRoZSAnYGBxdWll dGBgJyBib290IG9wdGlvbiBvbmx5IHN1cHByZXNzZXMgbW9zdCBtZXNzYWdlcyBkdXJpbmcgYm9v dCwgYnV0CisgIGVycm9ycyBhcmUgc3RpbGwgc2hvd24uCisKKy0gQSB1c2VyIHNwYWNlIGltcGxl bWVudGF0aW9uIGNhbiBvbmx5IHNob3cgYSBsb2dvIG9uY2UgdXNlciBzcGFjZSBoYXMgYmVlbgor ICBpbml0aWFsaXplZCBmYXIgZW5vdWdoIHRvIGFsbG93IHRoaXMuIEEga2VybmVsIHNwbGFzaCBj YW4gZGlzcGxheSBhIHNwbGFzaAorICBpbW1lZGlhdGVseSBhcyBzb29uIGFzIGZiY29uIGNhbiBi ZSBkaXNwbGF5ZWQuCisKKy0gSW1wbGVtZW50aW5nIGEgc3BsYXNoIHNjcmVlbiBpbiB1c2VyIHNw YWNlIChlLmcuIFBseW1vdXRoKSBpcyBwcm9ibGVtYXRpYworICBkdWUgdG8gcmVzb3VyY2UgY29u ZmxpY3RzLgorCisgIEZvciBleGFtcGxlLCBpZiBQbHltb3V0aCBpcyBrZWVwaW5nIGBgL2Rldi9m YjBgYCAocHJvdmlkZWQgdmlhIHZlc2FmYi9lZmlmYikKKyAgb3BlbiwgdGhlbiBtb3N0IERSTSBk cml2ZXJzIGNhbid0IHJlcGxhY2UgaXQgYmVjYXVzZSB0aGUgYWRkcmVzcyBzcGFjZSBpcworICBz dGlsbCBidXN5IC0gdGh1cyBsZWFkaW5nIHRvIGEgVlJBTSByZXNlcnZhdGlvbiBlcnJvci4KKwor ICBTZWU6IGh0dHBzOi8vYnVnemlsbGEub3BlbnN1c2Uub3JnL3Nob3dfYnVnLmNnaT9pZD05ODA3 NTAKKworCisKK0NvbW1hbmQgbGluZSBhcmd1bWVudHMKKz09PT09PT09PT09PT09PT09PT09PT0K KworYGBib290c3BsYXNoLmJvb3RmaWxlYGAKKyAgV2hpY2ggZmlsZSBpbiB0aGUgaW5pdHJkIHRv IGxvYWQuCisgIERlZmF1bHQ6IG5vbmUsIGkuZS4gYSBub24tZnVuY3Rpb25hbCBzcGxhc2gsIGZh bGxpbmcgYmFjayB0byBzaG93aW5nIHRleHQuCisKKworCitzeXNmcyBydW4tdGltZSBjb25maWd1 cmF0aW9uCis9PT09PT09PT09PT09PT09PT09PT09PT09PT09CisKK2BgL3N5cy9kZXZpY2VzL3Bs YXRmb3JtL2Jvb3RzcGxhc2guMC9lbmFibGVkYGAKKyAgRW5hYmxlL2Rpc2FibGUgdGhlIGJvb3Rz cGxhc2guCisgIFRoZSBzeXN0ZW0gYm9vdHMgd2l0aCB0aGlzIHNldCB0byAxLCBidXQgd2lsbCBu b3Qgc2hvdyBhIHNwbGFzaCB1bmxlc3MKKyAgYSBzcGxhc2ggdGhlbWUgZmlsZSBpcyBhbHNvIGxv YWRlZC4KKworCisKK0tjb25maWcKKz09PT09PT0KKworYGBCT09UU1BMQVNIYGAKKyAgV2hldGhl ciB0byBjb21waWxlIGluIGJvb3RzcGxhc2ggc3VwcG9ydAorICAoZGVwZW5kcyBvbiBmYmNvbiBj b21waWxlZCBpbiwgaS5lLiBgYEZSQU1FQlVGRkVSX0NPTlNPTEU9eWBgKQorCisKKworQm9vdHNw bGFzaCBmaWxlIGZvcm1hdAorPT09PT09PT09PT09PT09PT09PT09PQorCitBIGZpbGUgc3BlY2lm aWVkIGluIHRoZSBrZXJuZWwgY29uZmlndXJhdGlvbiBhcyBgYENPTkZJR19CT09UU1BMQVNIX0ZJ TEVgYAorb3Igc3BlY2lmaWVkIG9uIHRoZSBjb21tYW5kIGxpbmUgYXMgYGBib290c3BsYXNoLmJv b3RmaWxlYGAgd2lsbCBiZSBsb2FkZWQKK2FuZCBkaXNwbGF5ZWQgYXMgc29vbiBhcyBmYmNvbiBp cyBpbml0aWFsaXplZC4KKworCitNYWluIGJsb2NrcworLS0tLS0tLS0tLS0KKworVGhlcmUgYXJl IDMgbWFpbiBibG9ja3MgaW4gZWFjaCBmaWxlOgorCisgIC0gb25lIEZpbGUgaGVhZGVyCisgIC0g ICBuIFBpY3R1cmUgaGVhZGVycworICAtICAgbSAoQmxvYiBoZWFkZXIgKyBwYXlsb2FkKSBibG9j a3MKKworCitTdHJ1Y3R1cmVzCistLS0tLS0tLS0tCisKK1RoZSBvbi1kaXNrIHN0cnVjdHVyZXMg YXJlIGRlZmluZWQgaW4KK2BgZHJpdmVycy92aWRlby9mYmRldi9jb3JlL2Jvb3RzcGxhc2hfZmls ZS5oYGAgYW5kIHJlcHJlc2VudCB0aGVzZSBibG9ja3M6CisKKyAgLSBgYHN0cnVjdCBzcGxhc2hf ZmlsZV9oZWFkZXJgYAorCisgICAgUmVwcmVzZW50cyB0aGUgZmlsZSBoZWFkZXIsIHdpdGggc3Bs YXNoLXdpZGUgaW5mb3JtYXRpb24gaW5jbHVkaW5nOgorCisgICAgICAtIFRoZSBtYWdpYyBzdHJp bmcgImBgTGludXggYm9vdHNwbGFzaGBgIiBvbiBiaWctZW5kaWFuIHBsYXRmb3JtcworICAgICAg ICAodGhlIHJldmVyc2Ugb24gbGl0dGxlIGVuZGlhbikKKyAgICAgIC0gVGhlIGZpbGUgZm9ybWF0 IHZlcnNpb24gKGZvciBpbmNvbXBhdGlibGUgdXBkYXRlcywgaG9wZWZ1bGx5IG5ldmVyKQorICAg ICAgLSBUaGUgYmFja2dyb3VuZCBjb2xvcgorICAgICAgLSBOdW1iZXIgb2YgcGljdHVyZSBhbmQg YmxvYiBibG9ja3MKKyAgICAgIC0gQW5pbWF0aW9uIHNwZWVkICh3ZSBvbmx5IGFsbG93IG9uZSBk ZWxheSBmb3IgYWxsIGFuaW1hdGlvbnMpCisKKyAgICBUaGUgZmlsZSBoZWFkZXIgaXMgZm9sbG93 ZWQgYnkgdGhlIGZpcnN0IHBpY3R1cmUgaGVhZGVyLgorCisKKyAgLSBgYHN0cnVjdCBzcGxhc2hf cGljdHVyZV9oZWFkZXJgYAorCisgICAgUmVwcmVzZW50cyBhbiBvYmplY3QgKHBpY3R1cmUpIGRy YXduIG9uIHNjcmVlbiwgaW5jbHVkaW5nIGl0cyBpbW11dGFibGUKKyAgICBwcm9wZXJ0aWVzOgor ICAgICAgLSBXaWR0aCwgaGVpZ2h0CisgICAgICAtIFBvc2l0aW9uaW5nIHJlbGF0aXZlIHRvIHNj cmVlbiBjb3JuZXJzIG9yIGluIHRoZSBjZW50ZXIKKyAgICAgIC0gQW5pbWF0aW9uLCBpZiBhbnkK KyAgICAgIC0gQW5pbWF0aW9uIHR5cGUKKyAgICAgIC0gTnVtYmVyIG9mIGJsb2JzCisKKyAgICBU aGUgcGljdHVyZSBoZWFkZXIgaXMgZm9sbG93ZWQgYnkgYW5vdGhlciBwaWN0dXJlIGhlYWRlciwg dXAgdW50aWwgbgorICAgIHBpY3R1cmUgaGVhZGVycyAoYXMgZGVmaW5lZCBpbiB0aGUgZmlsZSBo ZWFkZXIpIGhhdmUgYmVlbiByZWFkLiBUaGVuLAorICAgIHRoZSAoYmxvYiBoZWFkZXIsIHBheWxv YWQpIHBhaXJzIGZvbGxvdy4KKworCisgIC0gYGBzdHJ1Y3Qgc3BsYXNoX2Jsb2JfaGVhZGVyYGAK KyAgICAoZm9sbG93ZWQgYnkgcGF5bG9hZCkKKworICAgIFJlcHJlc2VudHMgb25lIHJhdyBkYXRh IHN0cmVhbS4gU28gZmFyLCBvbmx5IHBpY3R1cmUgZGF0YSBpcyBkZWZpbmVkLgorCisgICAgVGhl IGJsb2IgaGVhZGVyIGlzIGZvbGxvd2VkIGJ5IGEgcGF5bG9hZCwgdGhlbiBwYWRkaW5nIHRvIG4q MTYgYnl0ZXMsCisgICAgdGhlbiAoaWYgZnVydGhlciBibG9icyBhcmUgZGVmaW5lZCBpbiB0aGUg ZmlsZSBoZWFkZXIpIGEgZnVydGhlciBibG9iCisgICAgaGVhZGVyLgorCisKK0FsaWdubWVudAor LS0tLS0tLS0tCisKK1RoZSBib290c3BsYXNoIGZpbGUgaXMgZGVzaWduZWQgdG8gYmUgbG9hZGVk IGludG8gbWVtb3J5IGFzLWlzLgorCitBbGwgc3RydWN0dXJlcyBhcmUgYSBtdWx0aXBsZSBvZiAx NiBieXRlcyBsb25nLCBhbGwgZWxlbWVudHMgdGhlcmVpbiBhcmUKK2FsaWduZWQgdG8gbXVsdGlw bGVzIG9mIHRoZWlyIGxlbmd0aCwgYW5kIHRoZSBwYXlsb2FkcyBhcmUgYWx3YXlzIHBhZGRlZAor dXAgdG8gbXVsdGlwbGVzIG9mIDE2IGJ5dGVzLiBUaGlzIGlzIHRvIGFsbG93IGFsaWduZWQgYWNj ZXNzZXMgaW4gYWxsCitjYXNlcyB3aGlsZSBzdGlsbCBzaW1wbHkgbWFwcGluZyB0aGUgc3RydWN0 dXJlcyBvdmVyIGFuIGluLW1lbW9yeSBjb3B5IG9mCit0aGUgYm9vdHNwbGFzaCBmaWxlLgorCisK K0Z1cnRoZXIgaW5mb3JtYXRpb24KKy0tLS0tLS0tLS0tLS0tLS0tLS0KKworUGxlYXNlIHNlZSBg YGRyaXZlcnMvdmlkZW8vZmJkZXYvY29yZS9ib290c3BsYXNoX2ZpbGUuaGBgIGZvciBmdXJ0aGVy CitkZXRhaWxzIGFuZCBwb3NzaWJsZSB2YWx1ZXMgaW4gdGhlIGZpbGUuCisKKworCitIb29rcyAt IGhvdyB0aGUgYm9vdHNwbGFzaCBpcyBpbnRlZ3JhdGVkCis9PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09CisKK2BgZHJpdmVycy92aWRlby9mYmRldi9jb3JlL2ZiY29uLmNg YAorICBgYGZiY29uX2luaXQoKWBgIGNhbGxzIGBgYm9vdHNwbGFzaF9pbml0KClgYCwgd2hpY2gg bG9hZHMgdGhlIGRlZmF1bHQKKyAgYm9vdHNwbGFzaCBmaWxlIG9yIHRoZSBvbmUgc3BlY2lmaWVk IG9uIHRoZSBrZXJuZWwgY29tbWFuZCBsaW5lLgorCisgIGBgZmJjb25fc3dpdGNoKClgYCBkcmF3 cyB0aGUgYm9vdHNwbGFzaCB3aGVuIGl0J3MgYWN0aXZlLCBhbmQgaXMgYWxzbworICBvbmUgb2Yg dGhlIGNhbGxlcnMgb2YgYGBzZXRfYmxpdHRpbmdfdHlwZSgpYGAuCisKKyAgYGBzZXRfYmxpdHRp bmdfdHlwZSgpYGAgY2FsbHMgYGBmYmNvbl9zZXRfZHVtbXlvcHMoKWBgIHdoZW4gdGhlCisgIGJv b3RzcGxhc2ggaXMgYWN0aXZlLCBvdmVycmlkaW5nIHRoZSB0ZXh0IHJlbmRlcmluZyBmdW5jdGlv bnMuCisKKyAgYGBmYmNvbl9jdXJzb3IoKWBgIHdpbGwgY2FsbCBgYGJvb3RzcGxhc2hfZGlzYWJs ZSgpYGAgd2hlbiBhbiBvb3BzIGlzCisgIGJlaW5nIHByaW50ZWQgaW4gb3JkZXIgdG8gbWFrZSBh IGtlcm5lbCBwYW5pYyB2aXNpYmxlLgorCitgYGRyaXZlcnMvdmlkZW8vZmJkZXYvY29yZS9kdW1t eWJsaXQuY2BgCisgIFRoaXMgY29udGFpbnMgdGhlIGR1bW15IHRleHQgcmVuZGVyaW5nIGZ1bmN0 aW9ucyB1c2VkIHRvIHN1cHByZXNzIHRleHQKKyAgb3V0cHV0IHdoaWxlIHRoZSBib290c3BsYXNo IGlzIHNob3duLgorCitgYGRyaXZlcnMvdHR5L3Z0L2tleWJvYXJkLmNgYAorICBgYGtiZF9rZXlj b2RlKClgYCBjYW4gY2FsbCBgYGJvb3RzcGxhc2hfZGlzYWJsZSgpYGAgd2hlbiB0aGUgdXNlcgor ICBwcmVzc2VzIEVTQyBvciBGMS1GMTIgKGNoYW5naW5nIFZUKS4gVGhpcyBpcyB0byBwcm92aWRl IGEgYnVpbHQtaW4gd2F5CisgIG9mIGRpc2FibGluZyB0aGUgc3BsYXNoIG1hbnVhbGx5IGF0IGFu eSB0aW1lLgpkaWZmIC0tZ2l0IGEvTUFJTlRBSU5FUlMgYi9NQUlOVEFJTkVSUwppbmRleCA1YzIz NzQ0NTc2MWUuLjdmZmFjMjcyNDM0ZSAxMDA2NDQKLS0tIGEvTUFJTlRBSU5FUlMKKysrIGIvTUFJ TlRBSU5FUlMKQEAgLTI3MDksNiArMjcwOSw4IEBAIEJPT1RTUExBU0gKIE06CU1heCBTdGF1ZHQg PG1zdGF1ZHRAc3VzZS5kZT4KIEw6CWxpbnV4LWZiZGV2QHZnZXIua2VybmVsLm9yZwogUzoJTWFp bnRhaW5lZAorRjoJRG9jdW1lbnRhdGlvbi9BQkkvdGVzdGluZy9zeXNmcy1wbGF0Zm9ybS1ib290 c3BsYXNoCitGOglEb2N1bWVudGF0aW9uL2Jvb3RzcGxhc2gucnN0CiBGOglkcml2ZXJzL3ZpZGVv L2ZiZGV2L2NvcmUvYm9vdHNwbGFzaCouKgogRjoJZHJpdmVycy92aWRlby9mYmRldi9jb3JlL2R1 bW15Y29uLmMKIEY6CWluY2x1ZGUvbGludXgvYm9vdHNwbGFzaC5oCi0tIAoyLjEyLjMKCl9fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBtYWls aW5nIGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZy ZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAo=