6159 2014-04-14 10:46:05 +0000 Document how to resolve QA issues 2014-10-08 12:53:47 +0000 1 1 9 Documentation Development Manual development unspecified All Multiple VERIFIED FIXED 02 June 2014: RESOLVED High enhancement 1.7 M2 1 bluelightning srifenbark bluelightning bogdanx.a.voiculescu srifenbark bogdanx.a.voiculescu --- --- Done (doc changes complete) oldest_to_newest 42640 0 bluelightning 2014-04-14 10:46:05 +0000 We have a reference section for insane.bbclass, but this doesn't tell you how to actually resolve them; and for new users fixing QA issues can represent a significant amount of time spent when writing a new recipe. Worse still, in the absence of documentation on how to fix the issues, users can be tempted to just ignore or disable the QA checks entirely. We should have a section listing the QA failure messages that get printed, and for each one an explanation of the issue that is being checked for and what needs to be done to resolve it properly. I can provide all of the background information for this. (I'm not sure if this would fully replace the insane.bbclass reference listing all checks by name, since having that reference may also be useful e.g. if you're looking through the list of checks in ERROR_QA/WARN_QA and want to know what they mean.) 43403 1 srifenbark 2014-05-19 08:36:45 +0000 I think it is good to keep the list in the insane.bbclass reference. I can get working on this when I start getting some information on how to actually interpret and deal with the QA messages and issues. Scott 43431 2 1969 bluelightning 2014-05-20 14:50:05 +0000 Created attachment 1969 List of QA checks and descriptions 43432 3 bluelightning 2014-05-20 14:50:38 +0000 I've attached a list of QA issue messages and for each one a description of what the failure means, plus in most cases hints on how you would go about fixing it. 43485 4 srifenbark 2014-05-22 08:26:27 +0000 Hi, See the http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html#ref-qa-checks link to see the new QA messages chapter in the ref-manual. Once the content is approved, I will move the bug to RESOLVED. Scott 43486 5 srifenbark 2014-05-22 08:27:27 +0000 Setting target milestone to 1.7 M2. 43610 6 srifenbark 2014-05-28 08:34:03 +0000 I have added some edits to the new section as directed by Paul Eggleton's review. Once these are approved (via his email). I will mark the bug as RESOLVED and flip the doc flag to "Done." Scott 43703 7 srifenbark 2014-06-02 13:19:39 +0000 Hi, All review comments in and approved. Marking as RESOLVED and flipping the doc flag to "Done." Scott 46192 8 bogdanx.a.voiculescu 2014-10-08 12:53:47 +0000 Documentation is present and reviewed. 1969 2014-05-20 14:50:05 +0000 2014-05-20 14:50:05 +0000 List of QA checks and descriptions qa-checks2.txt text/plain 14160 bluelightning PHBhY2thZ2VuYW1lPjogPHBhdGg+IGlzIHVzaW5nIGxpYmV4ZWMgcGxlYXNlIHJlbG9jYXRlIHRv IDxsaWJleGVjZGlyPiBbbGliZXhlY10KCiAgICBUaGUgc3BlY2lmaWVkIHBhY2thZ2UgY29udGFp bnMgZmlsZXMgaW4gL3Vzci9saWJleGVjLiBCeSBkZWZhdWx0IGxpYmV4ZWNkaXIgaXMgc2V0IHRv ICIke2xpYmRpcn0vJHtCUE59IiByYXRoZXIgdGhhbiAiL3Vzci9saWJleGVjIiwgc28gaW5zdGFs bGluZyB0byAvdXNyL2xpYmV4ZWMgaXMgbGlrZWx5IG5vdCBkZXNpcmFibGUuCgpwYWNrYWdlIDxw YWNrYWdlbmFtZT4gY29udGFpbnMgYmFkIFJQQVRIIDxycGF0aD4gaW4gZmlsZSA8ZmlsZT4gW3Jw YXRoc10KCiAgICBUaGUgc3BlY2lmaWVkIGJpbmFyeSBwcm9kdWNlZCBieSB0aGUgcmVjaXBlIGNv bnRhaW5zIGR5bmFtaWMgbGlicmFyeSBsb2FkIHBhdGhzIChycGF0aHMpIHRoYXQgY29udGFpbiBi dWlsZCBzeXN0ZW0gcGF0aHMgc3VjaCBhcyBUTVBESVIsIHdoaWNoIG1heSBwb3RlbnRpYWxseSBi ZSBhIHNlY3VyaXR5IGlzc3VlLiBDaGVjayBmb3IgYmFkIC1ycGF0aCBvcHRpb25zIGJlaW5nIHBh c3NlZCB0byB0aGUgbGlua2VyIGluIHlvdXIgZG9fY29tcGlsZSBsb2cuIERlcGVuZGluZyBvbiB0 aGUgYnVpbGQgc3lzdGVtIHVzZWQgYnkgdGhlIHNvZnR3YXJlIGJlaW5nIGJ1aWx0LCB0aGVyZSBt YXkgYmUgYSBjb25maWd1cmUgb3B0aW9uIHRvIGRpc2FibGUgcnBhdGggdXNhZ2UgY29tcGxldGVs eSB3aXRoaW4gdGhlIGJ1aWxkIG9mIHRoZSBzb2Z0d2FyZS4KCjxwYWNrYWdlbmFtZT46IDxmaWxl PiBjb250YWlucyBwcm9iYWJseS1yZWR1bmRhbnQgUlBBVEggPHJwYXRoPiBbdXNlbGVzcy1ycGF0 aHNdCgogICAgVGhlIHNwZWNpZmllZCBiaW5hcnkgcHJvZHVjZWQgYnkgdGhlIHJlY2lwZSBjb250 YWlucyBkeW5hbWljIGxpYnJhcnkgbG9hZCBwYXRocyAocnBhdGhzKSB0aGF0IG9uIGEgc3RhbmRh cmQgc3lzdGVtIGFyZSBzZWFyY2hlZCBieSBkZWZhdWx0IGJ5IHRoZSBsaW5rZXIgKGUuZy4gL2xp YiBhbmQgL3Vzci9saWIpLiBXaGlsZSB0aGVzZSBwYXRocyB3aWxsIG5vdCBjYXVzZSBhbnkgYnJl YWthZ2UsIHRoZXkgZG8gd2FzdGUgc3BhY2UgYW5kIGFyZSB1bm5lY2Vzc2FyeS4gRGVwZW5kaW5n IG9uIHRoZSBidWlsZCBzeXN0ZW0gdXNlZCBieSB0aGUgc29mdHdhcmUgYmVpbmcgYnVpbHQsIHRo ZXJlIG1heSBiZSBhIGNvbmZpZ3VyZSBvcHRpb24gdG8gZGlzYWJsZSBycGF0aCB1c2FnZSBjb21w bGV0ZWx5IHdpdGhpbiB0aGUgYnVpbGQgb2YgdGhlIHNvZnR3YXJlLgoKbm9uIC1kZXYvLWRiZy8t bmF0aXZlc2RrIHBhY2thZ2UgY29udGFpbnMgc3ltbGluayAuc286IDxwYWNrYWdlbmFtZT4gcGF0 aCAnPHBhdGg+JyBbZGV2LXNvXQoKICAgIFN5bWxpbmsgLnNvIGZpbGVzIGFyZSBmb3IgZGV2ZWxv cG1lbnQgb25seSwgYW5kIHNob3VsZCB0aGVyZWZvcmUgZ28gaW50byB0aGUgLWRldiBwYWNrYWdl LiBUaGlzIG1heSBvY2N1ciBpZiB5b3UgYWRkICouc28qIHJhdGhlciB0aGFuICouc28uKiB0byBh IG5vbi1kZXYgcGFja2FnZS4gQ2hhbmdlIEZJTEVTIChhbmQgcG9zc2libHkgUEFDS0FHRVMpIHN1 Y2ggdGhhdCB0aGUgc3BlY2lmaWVkIC5zbyBmaWxlIGdvZXMgaW50byBhbiBhcHByb3ByaWF0ZSAt ZGV2IHBhY2thZ2UuCgpub24gLXN0YXRpY2RldiBwYWNrYWdlIGNvbnRhaW5zIHN0YXRpYyAuYSBs aWJyYXJ5OiA8cGFja2FnZW5hbWU+IHBhdGggJzxwYXRoPicgW3N0YXRpY2Rldl0KCiAgICBTdGF0 aWMgLmEgbGlicmFyeSBmaWxlcyBzaG91bGQgZ28gaW50byBhIC1zdGF0aWNkZXYgcGFja2FnZS4g Q2hhbmdlIEZJTEVTIChhbmQgcG9zc2libHkgUEFDS0FHRVMpIHN1Y2ggdGhhdCB0aGUgc3BlY2lm aWVkIC5hIGZpbGUgZ29lcyBpbnRvIGFuIGFwcHJvcHJpYXRlIC1zdGF0aWNkZXYgcGFja2FnZS4K CjxwYWNrYWdlbmFtZT46IGZvdW5kIGxpYnJhcnkgaW4gd3JvbmcgbG9jYXRpb24gW2xpYmRpcl0K CiAgICBUaGUgc3BlY2lmaWVkIGZpbGUgbWF5IGhhdmUgYmVlbiBpbnN0YWxsZWQgaW50byBhbiBp bmNvcnJlY3QgKHBvc3NpYmx5IGhhcmRjb2RlZCkgaW5zdGFsbGF0aW9uIHBhdGguIEZvciBleGFt cGxlLCB0aGlzIHRlc3Qgd2lsbCBjYXRjaCByZWNpcGVzIHRoYXQgaW5zdGFsbCAvbGliL2Jhci5z byB3aGVuICR7YmFzZV9saWJkaXJ9IGlzICJsaWIzMiIuIEFub3RoZXIgZXhhbXBsZSBpcyB3aGVu IHJlY2lwZXMgaW5zdGFsbCAvdXNyL2xpYjY0L2Zvby5zbyB3aGVuICR7bGliZGlyfSBpcyAiL3Vz ci9saWIiLiBUaGVyZSBhcmUgb2NjYXNpb25hbGx5IGZhbHNlIHBvc2l0aXZlcywgaW4gd2hpY2gg Y2FzZSBhZGQgImxpYmRpciIgdG8gSU5TQU5FX1NLSVAgZm9yIHRoZSBwYWNrYWdlLgoKbm9uIGRl YnVnIHBhY2thZ2UgY29udGFpbnMgLmRlYnVnIGRpcmVjdG9yeTogPHBhY2thZ2VuYW1lPiBwYXRo IDxwYXRoPiBbZGVidWctZmlsZXNdCgogICAgVGhlIHNwZWNpZmllZCBwYWNrYWdlIGNvbnRhaW5z IGEgLmRlYnVnIGRpcmVjdG9yeSwgd2hpY2ggc2hvdWxkIG5vdCBhcHBlYXIgaW4gYW55dGhpbmcg YnV0IHRoZSAtZGJnIHBhY2thZ2UuIFRoaXMgbWF5IG9jY3VyIGlmIHlvdSBhZGQgYSBwYXRoIHdo aWNoIGNvbnRhaW5zIGEgLmRlYnVnIGRpcmVjdG9yeSBhbmQgZG8gbm90IGV4cGxpY2l0bHkgYWRk IHRoZSAuZGVidWcgZGlyZWN0b3J5IHRvIHRoZSAtZGJnIHBhY2thZ2U7IGlmIHRoaXMgaXMgdGhl IGNhc2UsIGFkZCB0aGUgLmRlYnVnIGRpcmVjdG9yeSBleHBsaWNpdGx5IHRvIEZJTEVTXyR7UE59 LWRiZy4KCkFyY2hpdGVjdHVyZSBkaWQgbm90IG1hdGNoICg8bWFjaGluZV9hcmNoPiB0byA8Zmls ZV9hcmNoPikgb24gPGZpbGU+CkJpdCBzaXplIGRpZCBub3QgbWF0Y2ggKDxtYWNoaW5lX2JpdHM+ IHRvIDxmaWxlX2JpdHM+KSA8cmVjaXBlPiBvbiA8ZmlsZT4KRW5kaWFubmVzcyBkaWQgbm90IG1h dGNoICg8bWFjaGluZV9lbmRpYW5uZXNzPiB0byA8ZmlsZV9lbmRpYW5uZXNzPikgb24gPGZpbGU+ IFthcmNoXQoKICAgIEJ5IGRlZmF1bHQsIHRoZSBPcGVuRW1iZWRkZWQgYnVpbGQgc3lzdGVtIGNo ZWNrcyB0aGUgRXhlY3V0YWJsZSBhbmQgTGlua2FibGUgRm9ybWF0IChFTEYpIHR5cGUsIGJpdCBz aXplLCBhbmQgZW5kaWFubmVzcyBvZiBhbnkgYmluYXJpZXMgdG8gZW5zdXJlIHRoZXkgbWF0Y2gg dGhlIHRhcmdldCBhcmNoaXRlY3R1cmUuIFRoaXMgdGVzdCBmYWlscyBpZiBhbnkgYmluYXJpZXMg ZG8gbm90IG1hdGNoIHRoZSB0eXBlIHNpbmNlIHRoZXJlIHdvdWxkIGJlIGFuIGluY29tcGF0aWJp bGl0eS4gVGhlIHRlc3QgY291bGQgaW5kaWNhdGUgdGhhdCB0aGUgd3JvbmcgY29tcGlsZXIgb3Ig Y29tcGlsZXIgb3B0aW9ucyBoYXZlIGJlZW4gdXNlZC4gU29tZXRpbWVzIHNvZnR3YXJlLCBsaWtl IGJvb3Rsb2FkZXJzLCBtaWdodCBuZWVkIHRvIGJ5cGFzcyB0aGlzIGNoZWNrLiBJZiB0aGUgZmls ZSB5b3UgcmVjZWl2ZSB0aGUgZXJyb3IgZm9yIGlzIGZpcm13YXJlIHRoYXQgaXMgbm90IGludGVu ZGVkIHRvIGJlIGV4ZWN1dGVkIHdpdGhpbiB0aGUgdGFyZ2V0IG9wZXJhdGluZyBzeXN0ZW0gb3Ig aXMgaW50ZW5kZWQgdG8gcnVuIG9uIGEgc2VwYXJhdGUgcHJvY2Vzc29yIHdpdGhpbiB0aGUgZGV2 aWNlLCB5b3UgY2FuIGFkZCAiYXJjaCIgdG8gSU5TQU5FX1NLSVAgZm9yIHRoZSBwYWNrYWdlOyBv dGhlcndpc2UgeW91IHNob3VsZCBjaGVjayB0aGUgZG9fY29tcGlsZSBsb2cgYW5kIHZlcmlmeSB0 aGF0IHRoZSBjb21waWxlciBvcHRpb25zIGJlaW5nIHVzZWQgYXJlIGNvcnJlY3QuCgpFTEYgYmlu YXJ5ICc8ZmlsZT4nIGhhcyByZWxvY2F0aW9ucyBpbiAudGV4dCBbdGV4dHJlbF0KCiAgICBUaGUg c3BlY2lmaWVkIEVMRiBiaW5hcnkgY29udGFpbnMgcmVsb2NhdGlvbnMgaW4gaXRzIC50ZXh0IHNl Y3Rpb25zLCB3aGljaCBjYW4gcmVzdWx0IGluIGEgcGVyZm9ybWFuY2UgaW1wYWN0IGF0IHJ1bnRp bWUuCiAgICBOb3RlOiB0aGVyZSBpcyBjdXJyZW50bHkgYSBidWcgd2hpY2ggY2F1c2VzIHRoaXMg d2FybmluZyB0byBhcHBlYXIgZXJyb25lb3VzbHk6IGh0dHBzOi8vYnVnemlsbGEueW9jdG9wcm9q ZWN0Lm9yZy9zaG93X2J1Zy5jZ2k/aWQ9NjEwNAoKTm8gR05VX0hBU0ggaW4gdGhlIGVsZiBiaW5h cnk6ICc8ZmlsZT4nIFtsZGZsYWdzXQoKICAgIFRoaXMgaW5kaWNhdGVzIHRoYXQgYmluYXJpZXMg cHJvZHVjZWQgd2hlbiBidWlsZGluZyB0aGUgcmVjaXBlIGhhdmUgbm90IGJlZW4gbGlua2VkIHdp dGggdGhlIExERkxBR1Mgb3B0aW9ucyBwcm92aWRlZCBieSB0aGUgYnVpbGQgc3lzdGVtLiBDaGVj ayB0aGF0IHRoZSBMREZMQUdTIHZhcmlhYmxlIGlzIGJlaW5nIHBhc3NlZCB0byB0aGUgbGlua2Vy IGNvbW1hbmQuIEEgY29tbW9uIHdvcmthcm91bmQgZm9yIHRoaXMgaXMgdG8gcGFzcyBpbiBMREZM QUdTIGlzIHZpYSBUQVJHRVRfQ0NfQVJDSCB3aXRoaW4gdGhlIHJlY2lwZToKCiAgICAgICAgVEFS R0VUX0NDX0FSQ0ggKz0gIiR7TERGTEFHU30iCgpQYWNrYWdlIDxwYWNrYWdlbmFtZT4gY29udGFp bnMgWG9yZyBkcml2ZXIgKDxkcml2ZXI+KSBidXQgbm8geG9yZy1hYmktIGRlcGVuZGVuY2llcyBb eG9yZy1kcml2ZXItYWJpXQoKICAgIFRoZSBzcGVjaWZpZWQgcGFja2FnZSBjb250YWlucyBhbiBY b3JnIGRyaXZlciwgYnV0IGRvZXMgbm90IGhhdmUgYSBjb3JyZXNwb25kaW5nIEFCSSBwYWNrYWdl IGRlcGVuZGVuY3kuIFRoZSB4c2VydmVyLXhvcmcgcmVjaXBlIHByb3ZpZGVzIGRyaXZlciBBQkkg bmFtZXMuIEFsbCBkcml2ZXJzIHNob3VsZCBkZXBlbmQgb24gdGhlIEFCSSB2ZXJzaW9ucyB0aGF0 IHRoZXkgaGF2ZSBiZWVuIGJ1aWx0IGFnYWluc3QuIERyaXZlciByZWNpcGVzIHRoYXQgaW5jbHVk ZSB4b3JnLWRyaXZlci1pbnB1dC5pbmMgb3IgeG9yZy1kcml2ZXItdmlkZW8uaW5jIHdpbGwgYXV0 b21hdGljYWxseSBnZXQgdGhlc2UgdmVyc2lvbnMuIENvbnNlcXVlbnRseSwgeW91IHNob3VsZCBv bmx5IG5lZWQgdG8gZXhwbGljaXRseSBhZGQgZGVwZW5kZW5jaWVzIHRvIGJpbmFyeSBkcml2ZXIg cmVjaXBlcy4gCgpUaGUgL3Vzci9zaGFyZS9pbmZvL2RpciBmaWxlIGlzIG5vdCBtZWFudCB0byBi ZSBzaGlwcGVkIGluIGEgcGFydGljdWxhciBwYWNrYWdlLiBbaW5mb2Rpcl0KCiAgICAvdXNyL3No YXJlL2luZm8vZGlyIHNob3VsZCBub3QgYmUgcGFja2FnZWQuIEFkZCB0aGUgZm9sbG93aW5nIGxp bmUgdG8geW91ciBkb19pbnN0YWxsIG9yIGRvX2luc3RhbGxfYXBwZW5kIHdpdGhpbiB0aGUgcmVj aXBlOgoKICAgICAgICBybSAke0R9JHtpbmZvZGlyfS9kaXIKClN5bWxpbmsgPHBhdGg+IGluIDxw YWNrYWdlbmFtZT4gcG9pbnRzIHRvIFRNUERJUiBbc3ltbGluay10by1zeXNyb290XQoKICAgIFRo ZSBzcGVjaWZpZWQgc3ltbGluayBwb2ludHMgaW50byBUTVBESVIgb24gdGhlIGhvc3QuIFN1Y2gg c3ltbGlua3Mgd2lsbCB3b3JrIG9uIHRoZSBob3N0LCBidXQgYXJlIGNsZWFybHkgaW52YWxpZCB3 aGVuIHJ1bm5pbmcgb24gdGhlIHRhcmdldC4gVGhlIHN5bWxpbmsgc2hvdWxkIGJlIGNvcnJlY3Rl ZCB0byB1c2UgYSByZWxhdGl2ZSBwYXRoLCBvciBzaG91bGQgYmUgcmVtb3ZlZC4gCgo8ZmlsZT4g ZmFpbGVkIHNhbml0eSB0ZXN0ICh3b3JrZGlyKSBpbiBwYXRoIDxwYXRoPiBbbGFdCgogICAgVGhl IHNwZWNpZmllZCAubGEgZmlsZSBjb250YWlucyBUTVBESVIgcGF0aHMuIEFueSAubGEgZmlsZSBj b250YWluaW5nIHRoZXNlIHBhdGhzIGlzIGluY29ycmVjdCBzaW5jZSBsaWJ0b29sIGFkZHMgdGhl IGNvcnJlY3Qgc3lzcm9vdCBwcmVmaXggd2hlbiB1c2luZyB0aGUgZmlsZXMgYXV0b21hdGljYWxs eSBpdHNlbGYuCgo8ZmlsZT4gZmFpbGVkIHNhbml0eSB0ZXN0ICh0bXBkaXIpIGluIHBhdGggPHBh dGg+IFtwa2djb25maWddCgogICAgVGhlIHNwZWNpZmllZCAucGMgZmlsZSBjb250YWlucyBUTVBE SVIvV09SS0RJUiBwYXRocy4gQW55IC5wYyBmaWxlIGNvbnRhaW5pbmcgdGhlc2UgcGF0aHMgaXMg aW5jb3JyZWN0IHNpbmNlIHBrZy1jb25maWcgaXRzZWxmIGFkZHMgdGhlIGNvcnJlY3Qgc3lzcm9v dCBwcmVmaXggd2hlbiB0aGUgZmlsZXMgYXJlIGFjY2Vzc2VkLgoKPHBhY2thZ2VuYW1lPiByZGVw ZW5kcyBvbiA8ZGVidWdfcGFja2FnZW5hbWU+IFtkZWJ1Zy1kZXBzXQoKICAgIEEgZGVwZW5kZW5j eSBleGlzdHMgYmV0d2VlbiB0aGUgc3BlY2lmaWVkIG5vbi1kYmcgcGFja2FnZSAoYSBwYWNrYWdl IHdob3NlIG5hbWUgZG9lcyBub3QgZW5kIGluIC1kYmcpIGFuZCBhIHBhY2thZ2UgdGhhdCBpcyBh IGRiZyBwYWNrYWdlLiBkYmcgcGFja2FnZXMgY29udGFpbiBkZWJ1ZyBzeW1ib2xzIGFuZCBhcmUg dXN1YWxseSBicm91Z2h0IGluIHVzaW5nIHRoZSBkYmctcGtncyBJTUFHRV9GRUFUVVJFUyB2YWx1 ZSBvciBleHBsaWNpdGx5IGJyb3VnaHQgaW50byB0aGUgaW1hZ2UgdmlhIElNQUdFX0lOU1RBTEwg KG9yIGFzIGEgZGVwZW5kZW5jeSBvZiBhbm90aGVyIGRiZyBwYWNrYWdlIGJyb3VnaHQgaW4gdmlh IGVpdGhlciBtZXRob2QpLiBUaGUgZGVwZW5kZW5jeSBtYXkgaGF2ZSBiZWVuIGF1dG9tYXRpY2Fs bHkgYWRkZWQgKGJlY2F1c2UgdGhlIGRiZyBwYWNrYWdlIGVycm9uZW91c2x5IGNvbnRhaW5zIGZp bGVzIHRoYXQgaXQgc2hvdWxkbid0LCBmb3IgZXhhbXBsZSBhIG5vbi1zeW1saW5rIC5zbyBmaWxl KSBvciBpdCBtYXkgaGF2ZSBiZWVuIGFkZGVkIG1hbnVhbGx5IGUuZy4gYnkgYWRkaW5nIHRvIFJE RVBFTkRTLgoKPHBhY2thZ2VuYW1lPiByZGVwZW5kcyBvbiA8ZGV2X3BhY2thZ2VuYW1lPiBbZGV2 LWRlcHNdCgogICAgQSBkZXBlbmRlbmN5IGV4aXN0cyBiZXR3ZWVuIHRoZSBzcGVjaWZpZWQgbm9u LWRldiBwYWNrYWdlIChhIHBhY2thZ2Ugd2hvc2UgbmFtZSBkb2VzIG5vdCBlbmQgaW4gLWRldikg YW5kIGEgcGFja2FnZSB0aGF0IGlzIGEgZGV2IHBhY2thZ2UuIGRldiBwYWNrYWdlcyBjb250YWlu IGRldmVsb3BtZW50IGhlYWRlcnMgYW5kIGFyZSB1c3VhbGx5IGJyb3VnaHQgaW4gdXNpbmcgdGhl IGRldi1wa2dzIElNQUdFX0ZFQVRVUkVTIHZhbHVlIG9yIGV4cGxpY2l0bHkgYnJvdWdodCBpbnRv IHRoZSBpbWFnZSB2aWEgSU1BR0VfSU5TVEFMTCAob3IgYXMgYSBkZXBlbmRlbmN5IG9mIGFub3Ro ZXIgZGV2IHBhY2thZ2UgYnJvdWdodCBpbiB2aWEgZWl0aGVyIG1ldGhvZCkuIFRoZSBkZXBlbmRl bmN5IG1heSBoYXZlIGJlZW4gYXV0b21hdGljYWxseSBhZGRlZCAoYmVjYXVzZSB0aGUgZGV2IHBh Y2thZ2UgZXJyb25lb3VzbHkgY29udGFpbnMgZmlsZXMgdGhhdCBpdCBzaG91bGRuJ3QsIGZvciBl eGFtcGxlIGEgbm9uLXN5bWxpbmsgLnNvIGZpbGUpIG9yIGl0IG1heSBoYXZlIGJlZW4gYWRkZWQg bWFudWFsbHkgZS5nLiBieSBhZGRpbmcgdG8gUkRFUEVORFMuCgo8dmFyPl88cGFja2FnZW5hbWU+ IGlzIGludmFsaWQ6IDxjb21wYXJpc29uPiAoPHZhbHVlPikgICBvbmx5IGNvbXBhcmlzb25zIDws ID0sID4sIDw9LCBhbmQgPj0gYXJlIGFsbG93ZWQgW2RlcC1jbXBdCgogICAgSWYgeW91IGFyZSBh ZGRpbmcgYSB2ZXJzaW9uZWQgZGVwZW5kZW5jeSByZWxhdGlvbnNoaXAgdG8gb25lIG9mIHRoZSBk ZXBlbmRlbmN5IHZhcmlhYmxlcyAoUkRFUEVORFMsIFJSRUNPTU1FTkRTLCBSU1VHR0VTVFMsIFJQ Uk9WSURFUywgUlJFUExBQ0VTLCBSQ09ORkxJQ1RTKSwgeW91IG11c3Qgb25seSB1c2UgdGhlIG5h bWVkIGNvbXBhcmlzb24gb3BlcmF0b3JzLiAgQ2hhbmdlIHRoZSB2ZXJzaW9uZWQgZGVwZW5kZW5j eSB2YWx1ZXMgeW91IGFyZSBhZGRpbmcgdG8gbWF0Y2ggdGhvc2UgbGlzdGVkIGluIHRoZSBtZXNz YWdlLgoKPHJlY2lwZW5hbWU+OiBUaGUgY29tcGlsZSBsb2cgaW5kaWNhdGVzIHRoYXQgaG9zdCBp bmNsdWRlIGFuZC9vciBsaWJyYXJ5IHBhdGhzIHdlcmUgdXNlZC4gUGxlYXNlIGNoZWNrIHRoZSBs b2cgJzxsb2dmaWxlPicgZm9yIG1vcmUgaW5mb3JtYXRpb24uIFtjb21waWxlLWhvc3QtcGF0aF0K CiAgICBUaGUgbG9nIGZvciB0aGUgZG9fY29tcGlsZSBzdGVwIGluZGljYXRlcyB0aGF0IHBhdGhz IG9uIHRoZSBob3N0IHdlcmUgc2VhcmNoZWQgZm9yIGZpbGVzLCB3aGljaCBpcyBub3QgYXBwcm9w cmlhdGUgd2hlbiBjcm9zcy1jb21waWxpbmcuIExvb2sgZm9yICJpcyB1bnNhZmUgZm9yIGNyb3Nz LWNvbXBpbGF0aW9uIiBvciAiQ1JPU1MgQ09NUElMRSBCYWRuZXNzIiBpbiB0aGUgc3BlY2lmaWVk IGxvZyBmaWxlLgoKPHJlY2lwZW5hbWU+OiBUaGUgaW5zdGFsbCBsb2cgaW5kaWNhdGVzIHRoYXQg aG9zdCBpbmNsdWRlIGFuZC9vciBsaWJyYXJ5IHBhdGhzIHdlcmUgdXNlZC4gUGxlYXNlIGNoZWNr IHRoZSBsb2cgJzxsb2dmaWxlPicgZm9yIG1vcmUgaW5mb3JtYXRpb24uIFtpbnN0YWxsLWhvc3Qt cGF0aF0KCiAgICBUaGUgbG9nIGZvciB0aGUgZG9faW5zdGFsbCBzdGVwIGluZGljYXRlcyB0aGF0 IHBhdGhzIG9uIHRoZSBob3N0IHdlcmUgc2VhcmNoZWQgZm9yIGZpbGVzLCB3aGljaCBpcyBub3Qg YXBwcm9wcmlhdGUgd2hlbiBjcm9zcy1jb21waWxpbmcuIExvb2sgZm9yICJpcyB1bnNhZmUgZm9y IGNyb3NzLWNvbXBpbGF0aW9uIiBvciAiQ1JPU1MgQ09NUElMRSBCYWRuZXNzIiBpbiB0aGUgc3Bl Y2lmaWVkIGxvZyBmaWxlLgoKVGhpcyBhdXRvY29uZiBsb2cgaW5kaWNhdGVzIGVycm9ycywgaXQg bG9va2VkIGF0IGhvc3QgaW5jbHVkZSBhbmQvb3IgbGlicmFyeSBwYXRocyB3aGlsZSBkZXRlcm1p bmluZyBzeXN0ZW0gY2FwYWJpbGl0aWVzLiBSZXJ1biBjb25maWd1cmUgdGFzayBhZnRlciBmaXhp bmcgdGhpcy4gVGhlIHBhdGggd2FzICc8cGF0aD4nCgogICAgVGhlIGxvZyBmb3IgdGhlIGRvX2Nv bmZpZ3VyZSBzdGVwIGluZGljYXRlcyB0aGF0IHBhdGhzIG9uIHRoZSBob3N0IHdlcmUgc2VhcmNo ZWQgZm9yIGZpbGVzLCB3aGljaCBpcyBub3QgYXBwcm9wcmlhdGUgd2hlbiBjcm9zcy1jb21waWxp bmcuIExvb2sgZm9yICJpcyB1bnNhZmUgZm9yIGNyb3NzLWNvbXBpbGF0aW9uIiBvciAiQ1JPU1Mg Q09NUElMRSBCYWRuZXNzIiBpbiB0aGUgc3BlY2lmaWVkIGxvZyBmaWxlLgoKPHBhY2thZ2VuYW1l PiBkb2Vzbid0IG1hdGNoIHRoZSBbYS16MC05ListXSsgcmVnZXggW3BrZ25hbWVdCgogICAgVGhl IGNvbnZlbnRpb24gd2l0aGluIHRoZSBPcGVuRW1iZWRkZWQgYnVpbGQgc3lzdGVtIGlzIGZvciBw YWNrYWdlIG5hbWVzIChzb21ldGltZXMgZW5mb3JjZWQgYnkgdGhlIHBhY2thZ2UgbWFuYWdlciBp dHNlbGYpIGlzIHRvIHJlcXVpcmUgdGhhdCBwYWNrYWdlIG5hbWVzIGFyZSBhbGwgbG93ZXIgY2Fz ZSBhbmQgaGF2ZSBhIHJlc3RyaWN0ZWQgc2V0IG9mIGNoYXJhY3RlcnMgYWxsb3dlZC4gSWYgeW91 ciByZWNpcGUgbmFtZSBkb2VzIG5vdCBtYXRjaCB0aGlzLCBvciB5b3UgYWRkIHBhY2thZ2VzIHRv IFBBQ0tBR0VTIHdoaWNoIGRvIG5vdCBjb25mb3JtIHRvIHRoZSBjb252ZW50aW9uLCB0aGVuIHlv dSB3aWxsIHJlY2VpdmUgdGhpcyBlcnJvci4gUmVuYW1lIHlvdXIgcmVjaXBlLCBvciBpZiB5b3Ug aGF2ZSBhZGRlZCBhIG5vbi1jb25mb3JtaW5nIHBhY2thZ2UgbmFtZSB0byBQQUNLQUdFUywgY2hh bmdlIHRoZSBwYWNrYWdlIG5hbWUgYXMgYXBwcm9wcmlhdGUuCgo8cmVjaXBlPjogY29uZmlndXJl IHdhcyBwYXNzZWQgdW5yZWNvZ25pc2VkIG9wdGlvbnM6IDxvcHRpb25zPiBbdW5rbm93bi1jb25m aWd1cmUtb3B0aW9uXQoKICAgIFRoZSBjb25maWd1cmUgc2NyaXB0IGlzIHJlcG9ydGluZyB0aGF0 IHRoZSBzcGVjaWZpZWQgb3B0aW9ucyBhcmUgdW5yZWNvZ25pc2VkLiBUaGlzIGNvdWxkIGJlIGJl Y2F1c2UgdGhleSB3ZXJlIHByZXZpb3VzbHkgdmFsaWQgYnV0IGhhdmUgYmVlbiByZW1vdmVkLCBv ciB0aGVyZSB3YXMgYSBtaXN0YWtlIHdoZW4gdGhlIG9wdGlvbnMgd2VyZSBhZGRlZCBhbmQgdGhl cmUgaXMgYW5vdGhlciBvcHRpb24gdGhhdCBzaG91bGQgYmUgdXNlZCBpbnN0ZWFkLiBJZiB5b3Ug YXJlIHVuc3VyZSwgY29uc3VsdCB0aGUgdXBzdHJlYW0gYnVpbGQgZG9jdW1lbnRhdGlvbiwgLi9j b25maWd1cmUgLS1oZWxwIG91dHB1dCwgYW5kIHVwc3RyZWFtIGNoYW5nZSBsb2cgb3IgcmVsZWFz ZSBub3Rlcy4gT25jZSB5b3UgaGF2ZSB3b3JrZWQgb3V0IHdoYXQgdGhlIGFwcHJvcHJpYXRlIGNo YW5nZSBpcywgeW91IGNhbiB1cGRhdGUgRVhUUkFfT0VDT05GIG9yIGluZGl2aWR1YWwgUEFDS0FH RUNPTkZJRyBvcHRpb24gdmFsdWVzIGFjY29yZGluZ2x5LgoKUmVjaXBlIDxyZWNpcGVmaWxlPiBo YXMgUE4gb2YgIjxyZWNpcGVuYW1lPiIgd2hpY2ggaXMgaW4gT1ZFUlJJREVTLCB0aGlzIGNhbiBy ZXN1bHQgaW4gdW5leHBlY3RlZCBiZWhhdmlvdXIuIFtwbi1vdmVycmlkZXNdCgogICAgVGhlIHNw ZWNpZmllZCByZWNpcGUgaGFzIGEgbmFtZSAoUE4pIHZhbHVlIHRoYXQgYXBwZWFycyBpbiBPVkVS UklERVMuIElmIGEgcmVjaXBlIGlzIG5hbWVkIHN1Y2ggdGhhdCBpdHMgUE4gdmFsdWUgbWF0Y2hl cyBzb21ldGhpbmcgYWxyZWFkeSBpbiBPVkVSUklERVMgKGUuZy4gUE4gaGFwcGVucyB0byBiZSB0 aGUgc2FtZSBhcyBNQUNISU5FIG9yIERJU1RSTyksIGl0IGNhbiBoYXZlIHVuZXhwZWN0ZWQgY29u c2VxdWVuY2VzLiBGb3IgZXhhbXBsZSwgYXNzaWdubWVudHMgc3VjaCBhcyBGSUxFU18ke1BOfSA9 ICJ4eXoiIGVmZmVjdGl2ZWx5IHR1cm4gaW50byBGSUxFUyA9ICJ4eXoiLiBSZW5hbWUgeW91ciBy ZWNpcGUgKG9yIGlmIFBOIGlzIGJlaW5nIHNldCBleHBsaWNpdGx5LCBjaGFuZ2UgdGhlIFBOIHZh bHVlKSBzbyB0aGF0IHRoZSBjb25mbGljdCBkb2VzIG5vdCBvY2N1ci4KCjxyZWNpcGVmaWxlPjog VmFyaWFibGUgPHZhcmlhYmxlPiBpcyBzZXQgYXMgbm90IGJlaW5nIHBhY2thZ2Ugc3BlY2lmaWMs IHBsZWFzZSBmaXggdGhpcy4gW3BrZ3ZhcmNoZWNrXQoKICAgIENlcnRhaW4gdmFyaWFibGVzIChS REVQRU5EUywgUlJFQ09NTUVORFMsIFJTVUdHRVNUUywgUkNPTkZMSUNUUywgUlBST1ZJREVTLCBS UkVQTEFDRVMsIEZJTEVTLCBwa2dfcHJlaW5zdCwgcGtnX3Bvc3RpbnN0LCBwa2dfcHJlcm0sIHBr Z19wb3N0cm0sIEFMTE9XX0VNUFRZKSBzaG91bGQgYWx3YXlzIGJlIHNldCBzcGVjaWZpYyB0byBh IHBhY2thZ2UgKGkuZS4gdGhleSBzaG91bGQgYmUgc2V0IHdpdGggYSBwYWNrYWdlIG5hbWUgb3Zl cnJpZGUsIGZvciBleGFtcGxlIFJERVBFTkRTXyR7UE59ID0gInZhbHVlIiByYXRoZXIgdGhhbiBS REVQRU5EUyA9ICJ2YWx1ZSIpLiBJZiB5b3UgcmVjZWl2ZSB0aGlzIGVycm9yLCBjb3JyZWN0IGFu eSBhc3NpZ25tZW50cyB0byB0aGVzZSB2YXJpYWJsZXMgd2l0aGluIHlvdXIgcmVjaXBlLgoKRmls ZSAnPGZpbGU+JyBmcm9tIDxyZWNpcGVuYW1lPiB3YXMgYWxyZWFkeSBzdHJpcHBlZCwgdGhpcyB3 aWxsIHByZXZlbnQgZnV0dXJlIGRlYnVnZ2luZyEgW2FscmVhZHktc3RyaXBwZWRdCgogICAgUHJv ZHVjZWQgYmluYXJpZXMgaGF2ZSBhbHJlYWR5IGJlZW4gc3RyaXBwZWQgcHJpb3IgdG8gdGhlIGJ1 aWxkIHN5c3RlbSBleHRyYWN0aW5nIGRlYnVnIHN5bWJvbHMuIEl0IGlzIGNvbW1vbiBmb3IgdXBz dHJlYW0gc29mdHdhcmUgcHJvamVjdHMgdG8gZGVmYXVsdCB0byBzdHJpcHBpbmcgZGVidWcgc3lt Ym9scyBmb3Igb3V0cHV0IGJpbmFyaWVzLiBJbiBvcmRlciBmb3IgZGVidWdnaW5nIHRvIHdvcmsg b24gdGhlIHRhcmdldCB1c2luZyAtZGJnIHBhY2thZ2VzLCB0aGlzIHN0cmlwcGluZyBtdXN0IGJl IGRpc2FibGVkLiBEZXBlbmRpbmcgb24gdGhlIGJ1aWxkIHN5c3RlbSB1c2VkIGJ5IHRoZSBzb2Z0 d2FyZSBiZWluZyBidWlsdCwgdGhpcyBtYXkgYmUgYXMgZWFzeSBhcyBzcGVjaWZ5aW5nIGFuIGFk ZGl0aW9uYWwgY29uZmlndXJlIG9wdGlvbiwgb3IgaXQgbWF5IGludm9sdmUgcGF0Y2hpbmcgdGhl IGJ1aWxkIHNjcmlwdHMuCgo8cGFja2FnZW5hbWU+IGlzIGxpc3RlZCBpbiBQQUNLQUdFUyBtdWx0 aXBsZSB0aW1lcywgdGhpcyBsZWFkcyB0byBwYWNrYWdpbmcgZXJyb3JzLiBbcGFja2FnZXMtbGlz dF0KCiAgICBQYWNrYWdlIG5hbWVzIG11c3QgYXBwZWFyIG9ubHkgb25jZSBpbiB0aGUgUEFDS0FH RVMgdmFyaWFibGUuIFlvdSBtYXkgcmVjZWl2ZSB0aGlzIGVycm9yIGlmIHlvdSBhcmUgYXR0ZW1w dGluZyB0byBhZGQgYSBwYWNrYWdlIHRvIFBBQ0tBR0VTIHdoaWNoIGlzIGFscmVhZHkgaW4gdGhl IHZhcmlhYmxlJ3MgdmFsdWUuCgpGSUxFUyB2YXJpYWJsZSBmb3IgcGFja2FnZSA8cGFja2FnZW5h bWU+IGNvbnRhaW5zICcvLycgd2hpY2ggaXMgaW52YWxpZC4gQXR0ZW1wdGluZyB0byBmaXggdGhp cyBidXQgeW91IHNob3VsZCBjb3JyZWN0IHRoZSBtZXRhZGF0YS4gW2ZpbGVzLWludmFsaWRdCgog ICAgLy8gaXMgaW52YWxpZCBpbiBhIFVuaXggcGF0aDsgd2hlcmUgdGhpcyBhcHBlYXJzIGluIGEg RklMRVMgdmFyaWFibGUsIGNvcnJlY3QgaXQgc28gdGhhdCB0aGVyZSBpcyBvbmx5IGEgc2luZ2xl IC8uCgo8cmVjaXBlbmFtZT46IEZpbGVzL2RpcmVjdG9yaWVzIHdlcmUgaW5zdGFsbGVkIGJ1dCBu b3Qgc2hpcHBlZCBbaW5zdGFsbGVkLXZzLXNoaXBwZWRdCgogICAgRmlsZXMgaGF2ZSBiZWVuIGlu c3RhbGxlZCB3aXRoaW4gZG9faW5zdGFsbCBidXQgaGF2ZSBub3QgYmVlbiBpbmNsdWRlZCBpbiBh bnkgcGFja2FnZSBieSB3YXkgb2YgdGhlIEZJTEVTIHZhcmlhYmxlLiBGaWxlcyB0aGF0IGRvIG5v dCBhcHBlYXIgaW4gYW55IHBhY2thZ2UgY2Fubm90IGJlIHByZXNlbnQgaW4gYW4gaW1hZ2UgbGF0 ZXIgb24gaW4gdGhlIGJ1aWxkIHByb2Nlc3MuIFlvdSBuZWVkIHRvIGVpdGhlcjoKCiAgICBhKSBB ZGQgdGhlIGZpbGVzIHRvIEZJTEVTIGZvciB0aGUgcGFja2FnZSB5b3Ugd2FudCB0aGVtIHRvIGFw cGVhciBpbiAoRklMRVNfJHtQTn0gZm9yIHRoZSBtYWluIHBhY2thZ2UpLCBvcgogICAgYikgRGVs ZXRlIHRoZSBmaWxlcyBhdCB0aGUgZW5kIG9mIGRvX2luc3RhbGwgaWYgdGhlIGZpbGVzIGFyZSBu b3QgbmVlZGVkIGluIGFueSBwYWNrYWdlCgo8b2xkcGFja2FnZT4tPG9sZHBrZ3ZlcnNpb24+IHdh cyByZWdpc3RlcmVkIGFzIHNobGliIHByb3ZpZGVyIGZvciA8bGlicmFyeT4sIGNoYW5naW5nIGl0 IHRvIDxuZXdwYWNrYWdlPi08bmV3cGtndmVyc2lvbj4gYmVjYXVzZSBpdCB3YXMgYnVpbHQgbGF0 ZXIKCiAgICBUaGlzIG1lYW5zIHRoYXQgYm90aCA8b2xkcGFja2FnZT4gYW5kIDxuZXdwYWNrYWdl PiBwcm92aWRlIHRoZSBzcGVjaWZpZWQgc2hhcmVkIGxpYnJhcnkuIFRoaXMgbWF5IGJlIGV4cGVj dGVkIGluIHRoZSBjYXNlIHdoZXJlIGEgcmVjaXBlIGhhcyBiZWVuIHJlbmFtZWQsIGhvd2V2ZXIg aW4gb3RoZXIgY2FzZXMgaXQgbWF5IGluZGljYXRlIHRoYXQgYSBwcml2YXRlIHZlcnNpb24gb2Yg YSBsaWJyYXJ5IGlzIGJlaW5nIGVycm9uZW91c2x5IHBpY2tlZCB1cCBhcyB0aGUgcHJvdmlkZXIg Zm9yIGEgY29tbW9uIGxpYnJhcnkuIEluIHRoZSBsYXR0ZXIgY2FzZSwgdGhlIGxpYnJhcnkncyAu c28gZmlsZSBuYW1lIHNob3VsZCBiZSBhZGRlZCB0byBQUklWQVRFX0xJQlMgaW4gdGhlIHJlY2lw ZSBwcm92aWRpbmcgdGhlIHByaXZhdGUgdmVyc2lvbiBvZiB0aGUgbGlicmFyeS4KCgoKKEkgZG9u J3QgdGhpbmsgd2Ugc2hvdWxkIGRvY3VtZW50IHRoZSBmb2xsb3dpbmcgc2luY2UgdGhlIFFBIGNo ZWNrcyBhcmVuJ3QgZW5hYmxlZCBieSBkZWZhdWx0LCBidXQganVzdCBpbiBjYXNlKToKCkRlc2t0 b3AgZmlsZSBpc3N1ZTogPGVycm9yPiBbZGVza3RvcF0KCjxwYWNrYWdlbmFtZT46IDxmaWxlPiwg aW5zdGFsbGVkIGluIHRoZSBiYXNlX3ByZWZpeCwgcmVxdWlyZXMgYSBzaGFyZWQgbGlicmFyeSB1 bmRlciBleGVjX3ByZWZpeCAoPGV4ZWNfcHJlZml4PikgW3Vuc2FmZS1yZWZlcmVuY2VzLWluLWJp bmFyaWVzXQoKPHBhY2thZ2VuYW1lPjogRm91bmQgYSByZWZlcmVuY2UgdG8gPGV4ZWNfcHJlZml4 Pi8gaW4gPHBhdGg+IC0gU2hlbGwgc2NyaXB0cyBpbiBiYXNlX2JpbmRpciBhbmQgYmFzZV9zYmlu ZGlyIHNob3VsZCBub3QgcmVmZXJlbmNlIGFueXRoaW5nIGluIGV4ZWNfcHJlZml4IFt1bnNhZmUt cmVmZXJlbmNlcy1pbi1zY3JpcHRzXQoK