From mboxrd@z Thu Jan 1 00:00:00 1970 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: [v3,2/3] Documentation: usb: add documentation for USB CCID Gadget Device From: Marcus Folkesson Message-Id: <20180529185021.13738-2-marcus.folkesson@gmail.com> Date: Tue, 29 May 2018 20:50:20 +0200 To: Greg Kroah-Hartman , Jonathan Corbet , Felipe Balbi , davem@davemloft.net, Mauro Carvalho Chehab , Andrew Morton , Randy Dunlap , Ruslan Bilovol , Thomas Gleixner , Kate Stewart Cc: linux-usb@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Marcus Folkesson List-ID: QWRkIGRvY3VtZW50YXRpb24gdG8gZ2l2ZSBhIGJyaWVmIGRlc2NyaXB0aW9uIG9uIGhvdyB0byB1 c2UgdGhlCkNDSUQgR2FkZ2V0IERldmljZS4KVGhpcyBpbmNsdWRlcyBhIGRlc2NyaXB0aW9uIGZv ciBhbGwgYXR0cmlidXRlcyBmb2xsb3dlZCBieSBhbiBleGFtcGxlIG9uCmhvdyB0byBzZXR1cCB0 aGUgZGV2aWNlIHdpdGggQ29uZmlnRlMuCgpTaWduZWQtb2ZmLWJ5OiBNYXJjdXMgRm9sa2Vzc29u IDxtYXJjdXMuZm9sa2Vzc29uQGdtYWlsLmNvbT4KLS0tCgpOb3RlczoKICAgIHYzOgogICAgCS0g Y29ycmVjdCB0aGUgZ3JhbW1lciAodGhhbmtzIFJhbmR5KQogICAgdjI6CiAgICAJLSBhZGQgdGhl IG1pc3NpbmcgY2hhbmdlbG9nIHRleHQKCiBEb2N1bWVudGF0aW9uL3VzYi9nYWRnZXRfY2NpZC5y c3QgfCAyNjcgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBj aGFuZ2VkLCAyNjcgaW5zZXJ0aW9ucygrKQogY3JlYXRlIG1vZGUgMTAwNjQ0IERvY3VtZW50YXRp b24vdXNiL2dhZGdldF9jY2lkLnJzdAoKZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vdXNiL2dh ZGdldF9jY2lkLnJzdCBiL0RvY3VtZW50YXRpb24vdXNiL2dhZGdldF9jY2lkLnJzdApuZXcgZmls ZSBtb2RlIDEwMDY0NAppbmRleCAwMDAwMDAwMDAwMDAuLjUyNGZlOWU2YWMxOQotLS0gL2Rldi9u dWxsCisrKyBiL0RvY3VtZW50YXRpb24vdXNiL2dhZGdldF9jY2lkLnJzdApAQCAtMCwwICsxLDI2 NyBAQAorLi4gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEdQTC0yLjAKKworPT09PT09PT09PT09 CitDQ0lEIEdhZGdldAorPT09PT09PT09PT09CisKKzpBdXRob3I6IE1hcmN1cyBGb2xrZXNzb24g PG1hcmN1cy5mb2xrZXNzb25AZ21haWwuY29tPgorCitJbnRyb2R1Y3Rpb24KKz09PT09PT09PT09 PQorCitUaGUgQ0NJRCBHYWRnZXQgd2lsbCBwcmVzZW50IGl0c2VsZiBhcyBhIENDSUQgZGV2aWNl IHRvIHRoZSBob3N0IHN5c3RlbS4KK1RoZSBkZXZpY2Ugc3VwcG9ydHMgdHdvIGVuZHBvaW50cyBm b3Igbm93OyBCVUxLIElOIGFuZCBCVUxLIE9VVC4KK1RoZXNlIGVuZHBvaW50cyBhcmUgZXhwb3Nl ZCB0byB1c2Vyc3BhY2UgdmlhIC9kZXYvY2NpZGcqLgorCitBbGwgQ0NJRCBjb21tYW5kcyBhcmUg c2VudCBvbiB0aGUgQlVMSy1PVVQgZW5kcG9pbnQuIEVhY2ggY29tbWFuZCBzZW50IHRvIHRoZSBD Q0lECitoYXMgYW4gYXNzb2NpYXRlZCBlbmRpbmcgcmVzcG9uc2UuIFNvbWUgY29tbWFuZHMgY2Fu IGFsc28gaGF2ZSBpbnRlcm1lZGlhdGUKK3Jlc3BvbnNlcy4gVGhlIHJlc3BvbnNlIGlzIHNlbnQg b24gdGhlIEJVTEstSU4gZW5kcG9pbnQuCitTZWUgRmlndXJlIDMtMyBpbiB0aGUgQ0NJRCBTcGVj aWZpY2F0aW9uIFsxXV8gZm9yIG1vcmUgZGV0YWlscy4KKworVGhlIENDSUQgY29tbWFuZHMgbXVz dCBiZSBoYW5kbGVkIGluIHVzZXJzcGFjZSBzaW5jZSB0aGUgZHJpdmVyIGlzIG9ubHkgd29ya2lu ZworYXMgYSB0cmFuc3BvcnQgbGF5ZXIgZm9yIHRoZSBUUERVcy4KKworCitDQ0lEIENvbW1hbmRz CistLS0tLS0tLS0tLS0tLQorCitBbGwgQ0NJRCBjb21tYW5kcyBiZWdpbnMgd2l0aCBhIDEwLWJ5 dGUgaGVhZGVyIGZvbGxvd2VkIGJ5IGFuIG9wdGlvbmFsCitkYXRhIGZpZWxkIGRlcGVuZGluZyBv biBtZXNzYWdlIHR5cGUuCisKKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCit8IE9mZnNldCB8IEZpZWxkICAgICAgICB8 IFNpemUgIHwgRGVzY3JpcHRpb24gICAgICAgICAgICAgICAgICAgICAgfAorKz09PT09PT09Kz09 PT09PT09PT09PT09Kz09PT09PT0rPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PSsK K3wgMCAgICAgIHwgYk1lc3NhZ2VUeXBlIHwgMSAgICAgfCBUeXBlIG9mIG1lc3NhZ2UgICAgICAg ICAgICAgICAgICB8CisrLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0rLS0tLS0tLSstLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCAxICAgICAgfCBkd0xlbmd0aCAgICAgfCA0ICAg ICB8IE1lc3NhZ2Ugc3BlY2lmaWMgZGF0YSBsZW5ndGggICAgIHwKK3wgICAgICAgIHwgICAgICAg ICAgICAgIHwgICAgICAgfCAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB8CisrLS0t LS0tLS0rLS0tLS0tLS0tLS0tLS0rLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tKworfCA1ICAgICAgfCBiU2xvdCAgICAgICAgfCAxICAgICB8IElkZW50aWZpZXMgdGhl IHNsb3QgbnVtYmVyICAgICAgIHwKK3wgICAgICAgIHwgICAgICAgICAgICAgIHwgICAgICAgfCBm b3IgdGhpcyBjb21tYW5kICAgICAgICAgICAgICAgICB8CisrLS0tLS0tLS0rLS0tLS0tLS0tLS0t LS0rLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfCA2ICAgICAg fCBiU2VxICAgICAgICAgfCAxICAgICB8IFNlcXVlbmNlIG51bWJlciBmb3IgY29tbWFuZCAgICAg IHwKKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0rCit8IDcgICAgICB8IC4uLiAgICAgICAgICB8IDMgICAgIHwgRmllbGRz IGRlcGVuZHMgb24gbWVzc2FnZSB0eXBlICAgfAorKy0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tKy0t LS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMTAgICAgIHwgYWJE YXRhICAgICAgIHwgYXJyYXkgfCBNZXNzYWdlIHNwZWNpZmljIGRhdGEgKE9QVElPTkFMKSB8Cisr LS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0rLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tKworCisKK011bHRpcGxlIENDSUQgZ2FkZ2V0cworLS0tLS0tLS0tLS0tLS0tLS0t LS0tLQorCitJdCBpcyBwb3NzaWJsZSB0byBjcmVhdGUgbXVsdGlwbGUgaW5zdGFuY2VzIG9mIHRo ZSBDQ0lEIGdhZGdldCwgaG93ZXZlciwKK2EgbXVjaCBtb3JlIGZsZXhpYmxlIHdheSBpcyB0byBj cmVhdGUgb25lIGdhZGdldCBhbmQgc2V0IHRoZSBgbnNsb3RzYCBhdHRyaWJ1dGUKK3RvIHRoZSBu dW1iZXIgb2YgZGVzaXJlZCBDQ0lEIGRldmljZXMuCisKK0FsbCBDQ0lEIGNvbW1hbmRzIHNwZWNp Znkgd2hpY2ggc2xvdCBpcyB0aGUgcmVjZWl2ZXIgaW4gdGhlIGBiU2xvdGAgZmllbGQKK29mIHRo ZSBDQ0lEIGhlYWRlci4KKworVXNhZ2UKKz09PT09CisKK0FjY2VzcyBmcm9tIHVzZXJzcGFjZQor LS0tLS0tLS0tLS0tLS0tLS0tLS0tLQorQWxsIGNvbW11bmljYXRpb24gaXMgYnkgcmVhZCgyKSBh bmQgd3JpdGUoMikgdG8gdGhlIGNvcnJlc3BvbmRpbmcgL2Rldi9jY2lkZyogZGV2aWNlLgorT25s eSBvbmUgZmlsZSBkZXNjcmlwdG9yIGlzIGFsbG93ZWQgdG8gYmUgb3BlbiB0byB0aGUgZGV2aWNl IGF0IGEgdGltZS4KKworVGhlIGJ1ZmZlciBzaXplIHByb3ZpZGVkIHRvIHJlYWQoMikgKiptdXN0 IGJlIGF0IGxlYXN0KiogNTIyICgxMCBieXRlcyBoZWFkZXIgKyA1MTIgYnl0ZXMgcGF5bG9hZCkK K2J5dGVzIGFzIHdlIGFyZSB3b3JraW5nIHdpdGggd2hvbGUgY29tbWFuZHMuCisKK1RoZSBidWZm ZXIgc2l6ZSBwcm92aWRlZCB0byB3cml0ZSgyKSAqKm1heSBub3QgZXhjZWVkKiogNTIyICgxMCBi eXRlcyBoZWFkZXIgKyA1MTIgYnl0ZXMgcGF5bG9hZCkKK2J5dGVzIGFzIHdlIGFyZSB3b3JraW5n IHdpdGggd2hvbGUgY29tbWFuZHMuCisKKworQ29uZmlndXJhdGlvbiB3aXRoIGNvbmZpZ2ZzCist LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCisKK0NvbmZpZ0ZTIGlzIHVzZWQgdG8gY3JlYXRl IGFuZCBjb25maWd1cmUgdGhlIENDSUQgZ2FkZ2V0LgorSW4gb3JkZXIgdG8gZ2V0IGEgZGV2aWNl IHRvIHdvcmsgYXMgaW50ZW5kZWQsIGEgZmV3IGF0dHJpYnV0ZXMgbXVzdAorYmUgY29uc2lkZXJl ZC4KKworVGhlIGF0dHJpYnV0ZXMgYXJlIGRlc2NyaWJlZCBiZWxvdyBmb2xsb3dlZCBieSBhbiBl eGFtcGxlLgorCitmZWF0dXJlcworfn5+fn5+fn5+CisKK1RoZSBgZmVhdHVyZWAgYXR0cmlidXRl IHdyaXRlcyB0byB0aGUgZHdGZWF0dXJlcyBmaWVsZCBpbiB0aGUgY2xhc3MgZGVzY3JpcHRvci4K K1NlZSBUYWJsZSA1LjEtMSBTbWFydCBDYXJkIERldmljZSBEZXNjcmlwdG9ycyBpbiB0aGUgQ0NJ RCBTcGVjaWZpY2F0aW9uIFsxXV8uCisKK1RoZSB2YWx1ZSBpbmRpY2F0ZXMgd2hhdCBpbnRlbGxp Z2VudCBmZWF0dXJlcyB0aGUgQ0NJRCBoYXMuCitUaGVzZSB2YWx1ZXMgYXJlIGF2YWlsYWJsZSB0 byB1c2VyIGFwcGxpY2F0aW9uIGFzIGRlZmluZWQgaW4gY2NpZC5oIFsyXV8uCitUaGUgZGVmYXVs dCB2YWx1ZSBpcyAweDAwMDAwMDAwLgorCitUaGUgdmFsdWUgaXMgYSBiaXR3aXNlIE9SIG9wZXJh dGlvbiBwZXJmb3JtZWQgb24gdGhlIGZvbGxvd2luZyB2YWx1ZXM6CisKKystLS0tLS0tLS0tLS0r LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLSsKK3wgVmFsdWUgICAgICB8IERlc2NyaXB0aW9uICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHwKKys9PT09PT09PT09PT0rPT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PSsK K3wgMHgwMDAwMDAwMCB8IE5vIHNwZWNpYWwgY2hhcmFjdGVyaXN0aWNzICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgwMDAw MDAwMiB8IEF1dG9tYXRpYyBwYXJhbWV0ZXIgY29uZmlndXJhdGlvbiBiYXNlZCBvbiBBVFIgZGF0 YSAgICAgICAgICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgwMDAwMDAwNCB8IEF1 dG9tYXRpYyBhY3RpdmF0aW9uIG9mIElDQyBvbiBpbnNlcnRpbmcgICAgICAgICAgICAgICAgICAg ICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgwMDAwMDAwOCB8IEF1dG9tYXRpYyBJ Q0Mgdm9sdGFnZSBzZWxlY3Rpb24gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHwKKyst LS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgwMDAwMDAxMCB8IEF1dG9tYXRpYyBJQ0MgY2xvY2sg ZnJlcXVlbmN5IGNoYW5nZSBhY2NvcmRpbmcgdG8gYWN0aXZlICAgICAgIHwKK3wgICAgICAgICAg ICB8IHBhcmFtZXRlcnMgcHJvdmlkZWQgYnkgdGhlIEhvc3Qgb3Igc2VsZiBkZXRlcm1pbmVkICAg ICAgICAgICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgwMDAwMDAyMCB8IEF1dG9t YXRpYyBiYXVkIHJhdGUgY2hhbmdlIGFjY29yZGluZyB0byBhY3RpdmUgICAgICAgICAgICAgICAg IHwKK3wgICAgICAgICAgICB8IHBhcmFtZXRlcnMgcHJvdmlkZWQgYnkgdGhlIEhvc3Qgb3Igc2Vs ZiBkZXRlcm1pbmVkICAgICAgICAgICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgw MDAwMDA0MCB8IEF1dG9tYXRpYyBwYXJhbWV0ZXJzIG5lZ290aWF0aW9uIG1hZGUgYnkgdGhlIEND SUQgICAgICAgICAgICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgwMDAwMDA4MCB8 IEF1dG9tYXRpYyBQUFMgbWFkZSBieSB0aGUgQ0NJRCBhY2NvcmRpbmcgdG8gdGhlICAgICAgICAg ICAgICAgIHwKK3wgICAgICAgICAgICB8IGFjdGl2ZSBwYXJhbWV0ZXJzICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsK K3wgMHgwMDAwMDEwMCB8IENDSUQgY2FuIHNldCBJQ0MgaW4gY2xvY2sgc3RvcCBtb2RlICAgICAg ICAgICAgICAgICAgICAgICAgICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgwMDAw MDIwMCB8IE5BRCB2YWx1ZSBvdGhlciB0aGFuIDAwIGFjY2VwdGVkIChUPTEgcHJvdG9jb2wgaW4g dXNlKSAgICAgICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgwMDAwMDQwMCB8IEF1 dG9tYXRpYyBJRlNEIGV4Y2hhbmdlIGFzIGZpcnN0IGV4Y2hhbmdlICAgICAgICAgICAgICAgICAg ICAgIHwKKystLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKKworCitPbmx5IG9uZSBvZiB0aGUgZm9sbG93 aW5nIHZhbHVlcyBtYXkgYmUgcHJlc2VudCB0byBzZWxlY3QgYSBsZXZlbCBvZiBleGNoYW5nZToK KworKy0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLSsKK3wgVmFsdWUgICAgICB8IERlc2NyaXB0aW9uICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICB8CisrPT09PT09PT09PT09Kz09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09KworfCAweDAwMDEwMDAwIHwgVFBEVSBsZXZl bCBleGNoYW5nZXMgd2l0aCBDQ0lEICAgICAgICAgICAgICAgICAgIHwKKystLS0tLS0tLS0tLS0r LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCit8IDB4 MDAwMjAwMDAgfCBTaG9ydCBBUERVIGxldmVsIGV4Y2hhbmdlIHdpdGggQ0NJRCAgICAgICAgICAg ICAgfAorKy0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLSsKK3wgMHgwMDA0MDAwMCB8IFNob3J0IGFuZCBFeHRlbmRlZCBBUERVIGxl dmVsIGV4Y2hhbmdlIHdpdGggQ0NJRCB8CisrLS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworCitJZiBub25lIG9mIHRob3NlIHZh bHVlcyBpcyBpbmRpY2F0ZWQgdGhlIGxldmVsIG9mIGV4Y2hhbmdlIGlzCitjaGFyYWN0ZXIuCisK KworcHJvdG9jb2xzCit+fn5+fn5+fn5+CitUaGUgYHByb3RvY29sc2AgYXR0cmlidXRlIHdyaXRl cyB0byB0aGUgZHdQcm90b2NvbHMgZmllbGQgaW4gdGhlIGNsYXNzIGRlc2NyaXB0b3IuCitTZWUg VGFibGUgNS4xLTEgU21hcnQgQ2FyZCBEZXZpY2UgRGVzY3JpcHRvcnMgaW4gdGhlIENDSUQgU3Bl Y2lmaWNhdGlvbiBbMV1fLgorCitUaGUgdmFsdWUgaXMgYSBiaXR3aXNlIE9SIG9wZXJhdGlvbiBw ZXJmb3JtZWQgb24gdGhlIGZvbGxvd2luZyB2YWx1ZXM6CisKKystLS0tLS0tLSstLS0tLS0tLS0t LS0tLSsKK3wgVmFsdWUgIHwgRGVzY3JpcHRpb24gIHwKKys9PT09PT09PSs9PT09PT09PT09PT09 PSsKK3wgMHgwMDAxIHwgUHJvdG9jb2wgVD0wIHwKKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSsK K3wgMHgwMDAyIHwgUHJvdG9jb2wgVD0xIHwKKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLSsKKwor SWYgbm8gcHJvdG9jb2wgaXMgc2VsZWN0ZWQgYm90aCBUPTAgYW5kIFQ9MSB3aWxsIGJlIHN1cHBv cnRlZCAoYHByb3RvY29sc2AgPSAweDAwMDMpLgorCituc2xvdHMKK35+fn5+fgorCitUaGUgYG5z bG90c2AgYXR0cmlidXRlIHdyaXRlcyB0byB0aGUgYk1heFNsb3RJbmRleCBmaWVsZCBpbiB0aGUg Y2xhc3MgZGVzY3JpcHRvci4KK1NlZSBUYWJsZSA1LjEtMSBTbWFydCBDYXJkIERldmljZSBEZXNj cmlwdG9ycyBpbiB0aGUgQ0NJRCBTcGVjaWZpY2F0aW9uIFsxXV8uCisKK1RoaXMgaXMgdGhlIGlu ZGV4IG9mIHRoZSBoaWdoZXN0IGF2YWlsYWJsZSBzbG90IG9uIHRoaXMgZGV2aWNlLiBBbGwgc2xv dHMgYXJlIGNvbnNlY3V0aXZlIHN0YXJ0aW5nIGF0IDAwaC4KK2kuZS4gMEZoID0gMTYgc2xvdHMg b24gdGhpcyBkZXZpY2UgbnVtYmVyZWQgMDBoIHRvIDBGaC4KKworVGhlIGRlZmF1bHQgdmFsdWUg aXMgMCwgd2hpY2ggbWVhbnMgb25lIHNsb3QuCisKKworcGluc3VwcG9ydAorfn5+fn5+fn5+fn5+ CisKK1RoaXMgdmFsdWUgaW5kaWNhdGVzIHdoYXQgUElOIHN1cHBvcnQgZmVhdHVyZXMgdGhlIEND SUQgaGFzLgorCitUaGUgYHBpbnN1cHBvcnRgIGF0dHJpYnV0ZSB3cml0ZXMgdG8gdGhlIGR3UElO U3VwcG9ydCBmaWVsZCBpbiB0aGUgY2xhc3MgZGVzY3JpcHRvci4KK1NlZSBUYWJsZSA1LjEtMSBT bWFydCBDYXJkIERldmljZSBEZXNjcmlwdG9ycyBpbiB0aGUgQ0NJRCBTcGVjaWZpY2F0aW9uIFsx XV8uCisKKworVGhlIHZhbHVlIGlzIGEgYml0d2lzZSBPUiBvcGVyYXRpb24gcGVyZm9ybWVkIG9u IHRoZSBmb2xsb3dpbmcgdmFsdWVzOgorCisrLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLSsKK3wgVmFsdWUgIHwgRGVzY3JpcHRpb24gICAgICAgICAgICAgICAgfAorKz09PT09 PT09Kz09PT09PT09PT09PT09PT09PT09PT09PT09PT0rCit8IDB4MDAgICB8IE5vIFBJTiBzdXBw b3J0ICAgICAgICAgICAgIHwKKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t KworfCAweDAxICAgfCBQSU4gVmVyaWZpY2F0aW9uIHN1cHBvcnRlZCB8CisrLS0tLS0tLS0rLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgMHgwMiAgIHwgUElOIE1vZGlmaWNhdGlvbiBz dXBwb3J0ZWQgfAorKy0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCisKK1Ro ZSBkZWZhdWx0IHZhbHVlIGlzIHNldCB0byAweDAwLgorCisKK2xjZGxheW91dAorfn5+fn5+fn5+ fgorCitOdW1iZXIgb2YgbGluZXMgYW5kIGNoYXJhY3RlcnMgZm9yIHRoZSBMQ0QgZGlzcGxheSB1 c2VkIHRvIHNlbmQgbWVzc2FnZXMgZm9yIFBJTiBlbnRyeS4KKworVGhlIGBsY2RMYXlvdXRgIGF0 dHJpYnV0ZSB3cml0ZXMgdG8gdGhlIHdMY2RMYXlvdXQgZmllbGQgaW4gdGhlIGNsYXNzIGRlc2Ny aXB0b3IuCitTZWUgVGFibGUgNS4xLTEgU21hcnQgQ2FyZCBEZXZpY2UgRGVzY3JpcHRvcnMgaW4g dGhlIENDSUQgU3BlY2lmaWNhdGlvbiBbMV1fLgorCisKK1RoZSB2YWx1ZSBpcyBzZXQgYXMgZm9s bG93czoKKworKy0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsK K3wgVmFsdWUgIHwgRGVzY3JpcHRpb24gICAgICAgICAgICAgICAgICAgICAgICB8CisrPT09PT09 PT0rPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09KworfCAweDAwMDAgfCBObyBM Q0QgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHwKKystLS0tLS0tLSstLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCit8IDB4WFhZWSB8IFhYOiBudW1iZXIgb2YgbGluZXMg ICAgICAgICAgICAgICAgfAorfCAgICAgICAgfCBZWTogbnVtYmVyIG9mIGNoYXJhY3RlcnMgcGVy IGxpbmUuIHwKKystLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0r CisKK1RoZSBkZWZhdWx0IHZhbHVlIGlzIHNldCB0byAweDAwMDAuCisKKworRXhhbXBsZQorLS0t LS0tLQorCitIZXJlIGlzIGFuIGV4YW1wbGUgb24gaG93IHRvIHNldHVwIGEgQ0NJRCBnYWRnZXQg d2l0aCBjb25maWdmcyA6OgorCisgICAgIyEvYmluL3NoCisKKyAgICBDT05GSUdESVI9L3N5cy9r ZXJuZWwvY29uZmlnCisgICAgR0FER0VUPSRDT05GSUdESVIvdXNiX2dhZGdldC9nMAorICAgIEZV TkNUSU9OPSRHQURHRVQvZnVuY3Rpb25zL2NjaWQuc2MwCisKKyAgICBWSUQ9WU9VUl9WRU5ET1Jf SURfSEVSRQorICAgIFBJRD1ZT1VSX1BST0RVQ1RfSURfSEVSRQorICAgIFVEQz1ZT1VSX1VEQ19I RVJFCisKKyAgICAjTW91bnQgZmlsZXN5c3RlbQorICAgIG1vdW50IG5vbmUgLXQgY29uZmlnZnMg JENPTkZJR0RJUgorCisgICAgI1BvcHVsYXRlIElEOnMKKyAgICBlY2hvICRWSUQgPiAkR0FER0VU L2lkVmVuZG9yCisgICAgZWNobyAkUElEID4gJEdBREdFVC9pZFByb2R1Y3QKKworICAgICNDcmVh dGUgYW5kIGNvbmZpZ3VyZSB0aGUgZ2FkZ2V0CisgICAgbWtkaXIgJEZVTkNUSU9OCisgICAgZWNo byAweDAwMDQwN0I4ID4gJEZVTkNUSU9OL2ZlYXR1cmVzCisgICAgZWNobyAweDAyID4gJEZVTkNU SU9OL3Byb3RvY29scworCisgICAgI0NyZWF0ZSBvdXIgZW5nbGlzaCBzdHJpbmdzCisgICAgbWtk aXIgICRHQURHRVQvc3RyaW5ncy8weDQwOQorICAgIGVjaG8gNTU2Njc3ID4gJEdBREdFVC9zdHJp bmdzLzB4NDA5L3NlcmlhbG51bWJlcgorICAgIGVjaG8gIkh1bmdyeSBQZW5ndWlucyIgPiAkR0FE R0VUL3N0cmluZ3MvMHg0MDkvbWFudWZhY3R1cmVyCisgICAgZWNobyAiSGFycG9vbiBXaXRoIFNt YXJ0Q2FyZCIgID4gJEdBREdFVC9zdHJpbmdzLzB4NDA5L3Byb2R1Y3QKKworICAgICNDcmVhdGUg Y29uZmlndXJhdGlvbgorICAgIG1rZGlyICAkR0FER0VUL2NvbmZpZ3MvYy4xCisgICAgbWtkaXIg ICRHQURHRVQvY29uZmlncy9jLjEvc3RyaW5ncy8weDQwOQorICAgIGVjaG8gQ29uZmlnMSA+ICRH QURHRVQvY29uZmlncy9jLjEvc3RyaW5ncy8weDQwOS9jb25maWd1cmF0aW9uCisKKyAgICAjVXNl IGBDb25maWcxYCBmb3Igb3VyIENDSUQgZ2FkZ2V0CisgICAgbG4gLXMgJEZVTkNUSU9OICRHQURH RVQvY29uZmlncy9jLjEKKworICAgICNFeGVjdXRlCisgICAgZWNobyAkVURDID4gJEdBREdFVC9V REMKKworCitSZWZlcmVuY2VzCis9PT09PT09PT09CisKKy4uIFsxXSBodHRwOi8vd3d3LnVzYi5v cmcvZGV2ZWxvcGVycy9kb2NzL2RldmNsYXNzX2RvY3MvRFdHX1NtYXJ0LUNhcmRfQ0NJRF9SZXYx MTAucGRmCisuLiBbMl0gaW5jbHVkZS91YXBpL2xpbnV4L3VzYi9jY2lkLmgK