From: Robert Bragg Subject: [PATCH v3 11/11] drm/i915: Add a kerneldoc summary for i915_perf.c Date: Mon, 15 Aug 2016 15:41:28 +0100 Message-ID: <20160815144128.7847-12-robert@sixbynine.org> References: <20160815144128.7847-1-robert@sixbynine.org> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20160815144128.7847-1-robert@sixbynine.org> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: intel-gfx@lists.freedesktop.org Cc: David Airlie , dri-devel@lists.freedesktop.org, Sourab Gupta , Daniel Vetter List-Id: dri-devel@lists.freedesktop.org SW4gcGFydGljdWxhciB0aGlzIHRyaWVzIHRvIGNhcHR1cmUgZm9yIHBvc3Rlcml0eSBzb21lIG9m IHRoZSBlYXJseQpjaGFsbGVuZ2VzIHdlIGhhZCB3aXRoIHVzaW5nIHRoZSBjb3JlIHBlcmYgaW5m cmFzdHJ1Y3R1cmUgaW4gY2FzZSB3ZQpldmVyIHdhbnQgdG8gcmV2aXNpdCBhZGFwdGluZyBwZXJm IGZvciBkZXZpY2UgbWV0cmljcy4KCkNjOiBDaHJpcyBXaWxzb24gPGNocmlzQGNocmlzLXdpbHNv bi5jby51az4KU2lnbmVkLW9mZi1ieTogUm9iZXJ0IEJyYWdnIDxyb2JlcnRAc2l4YnluaW5lLm9y Zz4KLS0tCiBkcml2ZXJzL2dwdS9kcm0vaTkxNS9pOTE1X3BlcmYuYyB8IDE2MyArKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAxNjMgaW5zZXJ0 aW9ucygrKQoKZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfcGVyZi5jIGIv ZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9wZXJmLmMKaW5kZXggMThjYjY1MS4uNTRkZGY3NCAx MDA2NDQKLS0tIGEvZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9wZXJmLmMKKysrIGIvZHJpdmVy cy9ncHUvZHJtL2k5MTUvaTkxNV9wZXJmLmMKQEAgLTI0LDYgKzI0LDE2OSBAQAogICogICBSb2Jl cnQgQnJhZ2cgPHJvYmVydEBzaXhieW5pbmUub3JnPgogICovCiAKKworLyoqCisgKiBET0M6IGk5 MTUgUGVyZiwgc3RyZWFtaW5nIEFQSSBmb3IgR1BVIG1ldHJpY3MKKyAqCisgKiBHZW4gZ3JhcGhp Y3Mgc3VwcG9ydHMgYSBsYXJnZSBudW1iZXIgb2YgcGVyZm9ybWFuY2UgY291bnRlcnMgdGhhdCBj YW4gaGVscAorICogZHJpdmVyIGFuZCBhcHBsaWNhdGlvbiBkZXZlbG9wZXJzIHVuZGVyc3RhbmQg YW5kIG9wdGltaXplIHRoZWlyIHVzZSBvZiB0aGUKKyAqIEdQVS4KKyAqCisgKiBUaGlzIGk5MTUg cGVyZiBpbnRlcmZhY2UgZW5hYmxlcyB1c2Vyc3BhY2UgdG8gY29uZmlndXJlIGFuZCBvcGVuIGEg ZmlsZQorICogZGVzY3JpcHRvciByZXByZXNlbnRpbmcgYSBzdHJlYW0gb2YgR1BVIG1ldHJpY3Mg d2hpY2ggY2FuIHRoZW4gYmUgcmVhZCgpIGFzCisgKiBhIHN0cmVhbSBvZiBzYW1wbGUgcmVjb3Jk cy4KKyAqCisgKiBUaGUgaW50ZXJmYWNlIGlzIHBhcnRpY3VsYXJseSBzdWl0ZWQgdG8gZXhwb3Np bmcgYnVmZmVyZWQgbWV0cmljcyB0aGF0IGFyZQorICogY2FwdHVyZWQgYnkgRE1BIGZyb20gdGhl IEdQVSwgdW5zeW5jaHJvbml6ZWQgd2l0aCBhbmQgdW5yZWxhdGVkIHRvIHRoZSBDUFUuCisgKgor ICogU3RyZWFtcyByZXByZXNlbnRpbmcgYSBzaW5nbGUgY29udGV4dCBhcmUgYWNjZXNzaWJsZSB0 byBhcHBsaWNhdGlvbnMgd2l0aCBhCisgKiBjb3JyZXNwb25kaW5nIGRybSBmaWxlIGRlc2NyaXB0 b3IsIHN1Y2ggdGhhdCBPcGVuR0wgY2FuIHVzZSB0aGUgaW50ZXJmYWNlCisgKiB3aXRob3V0IHNw ZWNpYWwgcHJpdmlsZWdlcy4gQWNjZXNzIHRvIHN5c3RlbS13aWRlIG1ldHJpY3MgcmVxdWlyZXMg cm9vdAorICogcHJpdmlsZWdlcyBieSBkZWZhdWx0LCB1bmxlc3MgY2hhbmdlZCB2aWEgdGhlIGRl di5pOTE1LnBlcmZfZXZlbnRfcGFyYW5vaWQKKyAqIHN5c2N0bCBvcHRpb24uCisgKgorICoKKyAq IFRoZSBpbnRlcmZhY2Ugd2FzIGluaXRpYWxseSBpbnNwaXJlZCBieSB0aGUgY29yZSBQZXJmIGlu ZnJhc3RydWN0dXJlIGJ1dAorICogc29tZSBub3RhYmxlIGRpZmZlcmVuY2VzIGFyZToKKyAqCisg KiBpOTE1IHBlcmYgZmlsZSBkZXNjcmlwdG9ycyByZXByZXNlbnQgYSAic3RyZWFtIiBpbnN0ZWFk IG9mIGFuICJldmVudCI7IHdoZXJlCisgKiBhIHBlcmYgZXZlbnQgcHJpbWFyaWx5IGNvcnJlc3Bv bmRzIHRvIGEgc2luZ2xlIDY0Yml0IHZhbHVlLCB3aGlsZSBhIHN0cmVhbQorICogbWlnaHQgc2Ft cGxlIHNldHMgb2YgdGlnaHRseS1jb3VwbGVkIGNvdW50ZXJzLCBkZXBlbmRpbmcgb24gdGhlCisg KiBjb25maWd1cmF0aW9uLiAgRm9yIGV4YW1wbGUgdGhlIEdlbiBPQSB1bml0IGlzbid0IGRlc2ln bmVkIHRvIHN1cHBvcnQKKyAqIG9ydGhvZ29uYWwgY29uZmlndXJhdGlvbnMgb2YgaW5kaXZpZHVh bCBjb3VudGVyczsgaXQncyBjb25maWd1cmVkIGZvciBhIHNldAorICogb2YgcmVsYXRlZCBjb3Vu dGVycy4gU2FtcGxlcyBmb3IgYW4gaTkxNSBwZXJmIHN0cmVhbSBjYXB0dXJpbmcgT0EgbWV0cmlj cworICogd2lsbCBpbmNsdWRlIGEgc2V0IG9mIGNvdW50ZXIgdmFsdWVzIHBhY2tlZCBpbiBhIGNv bXBhY3QgSFcgc3BlY2lmaWMgZm9ybWF0LgorICogVGhlIE9BIHVuaXQgc3VwcG9ydHMgYSBudW1i ZXIgb2YgZGlmZmVyZW50IHBhY2tpbmcgZm9ybWF0cyB3aGljaCBjYW4gYmUKKyAqIHNlbGVjdGVk IGJ5IHRoZSB1c2VyIG9wZW5pbmcgdGhlIHN0cmVhbS4gUGVyZiBoYXMgc3VwcG9ydCBmb3IgZ3Jv dXBpbmcKKyAqIGV2ZW50cywgYnV0IGVhY2ggZXZlbnQgaW4gdGhlIGdyb3VwIGlzIGNvbmZpZ3Vy ZWQsIHZhbGlkYXRlZCBhbmQKKyAqIGF1dGhlbnRpY2F0ZWQgaW5kaXZpZHVhbGx5IHdpdGggc2Vw YXJhdGUgc3lzdGVtIGNhbGxzLgorICoKKyAqIGk5MTUgcGVyZiBzdHJlYW0gY29uZmlndXJhdGlv bnMgYXJlIHByb3ZpZGVkIGFzIGFuIGFycmF5IG9mIHU2NCAoa2V5LHZhbHVlKQorICogcGFpcnMs IGluc3RlYWQgb2YgYSBmaXhlZCBzdHJ1Y3Qgd2l0aCBtdWx0aXBsZSBtaXNjZWxsYW5lb3VzIGNv bmZpZyBtZW1iZXJzLAorICogaW50ZXJsZWF2ZWQgd2l0aCBldmVudC10eXBlIHNwZWNpZmljIG1l bWJlcnMuCisgKgorICogaTkxNSBwZXJmIGRvZXNuJ3Qgc3VwcG9ydCBleHBvc2luZyBtZXRyaWNz IHZpYSBhbiBtbWFwJ2QgY2lyY3VsYXIgYnVmZmVyLgorICogVGhlIHN1cHBvcnRlZCBtZXRyaWNz IGFyZSBiZWluZyB3cml0dGVuIHRvIG1lbW9yeSBieSB0aGUgR1BVIHVuc3luY2hyb25pemVkCisg KiB3aXRoIHRoZSBDUFUsIHVzaW5nIEhXIHNwZWNpZmljIHBhY2tpbmcgZm9ybWF0cyBmb3IgY291 bnRlciBzZXRzLiBTb21ldGltZXMKKyAqIHRoZSBjb25zdHJhaW50cyBvbiBIVyBjb25maWd1cmF0 aW9uIHJlcXVpcmUgcmVwb3J0cyB0byBiZSBmaWx0ZXJlZCBiZWZvcmUgaXQKKyAqIHdvdWxkIGJl IGFjY2VwdGFibGUgdG8gZXhwb3NlIHRoZW0gdG8gdW5wcml2aWxlZ2VkIGFwcGxpY2F0aW9ucyAt IHRvIGhpZGUKKyAqIHRoZSBtZXRyaWNzIG9mIG90aGVyIHByb2Nlc3Nlcy9jb250ZXh0cy4gRm9y IHRoZXNlIHVzZSBjYXNlcyBhIHJlYWQoKSBiYXNlZAorICogaW50ZXJmYWNlIGlzIGEgZ29vZCBm aXQsIGFuZCBwcm92aWRlcyBhbiBvcHBvcnR1bml0eSB0byBmaWx0ZXIgZGF0YSBhcyBpdAorICog Z2V0cyBjb3BpZWQgZnJvbSB0aGUgR1BVIG1hcHBlZCBidWZmZXJzIHRvIHVzZXJzcGFjZSBidWZm ZXJzLgorICoKKyAqCisgKiBTb21lIG5vdGVzIHJlZ2FyZGluZyBMaW51eCBQZXJmOgorICogLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KKyAqCisgKiBUaGUgZmlyc3QgcHJvdG90eXBl IG9mIHRoaXMgZHJpdmVyIHdhcyBiYXNlZCBvbiB0aGUgY29yZSBwZXJmCisgKiBpbmZyYXN0cnVj dHVyZSwgYW5kIHdoaWxlIHdlIGRpZCBtYWtlIHRoYXQgbW9zdGx5IHdvcmssIHdpdGggc29tZSBj aGFuZ2VzIHRvCisgKiBwZXJmLCB3ZSBmb3VuZCB3ZSB3ZXJlIGJyZWFraW5nIG9yIHdvcmtpbmcg YXJvdW5kIHRvbyBtYW55IGFzc3VtcHRpb25zIGJha2VkCisgKiBpbnRvIHBlcmYncyBjdXJyZW50 bHkgY3B1IGNlbnRyaWMgZGVzaWduLgorICoKKyAqIEluIHRoZSBlbmQgd2UgZGlkbid0IHNlZSBh IGNsZWFyIGJlbmVmaXQgdG8gbWFraW5nIHBlcmYncyBpbXBsZW1lbnRhdGlvbiBhbmQKKyAqIGlu dGVyZmFjZSBtb3JlIGNvbXBsZXggYnkgY2hhbmdpbmcgZGVzaWduIGFzc3VtcHRpb25zIHdoaWxl IHdlIGtuZXcgd2Ugc3RpbGwKKyAqIHdvdWxkbid0IGJlIGFibGUgdG8gdXNlIGFueSBleGlzdGlu ZyBwZXJmIGJhc2VkIHVzZXJzcGFjZSB0b29scy4KKyAqCisgKiBBbHNvIGNvbnNpZGVyaW5nIHRo ZSBHZW4gc3BlY2lmaWMgbmF0dXJlIG9mIHRoZSBPYnNlcnZhYmlsaXR5IGhhcmR3YXJlIGFuZAor ICogaG93IHVzZXJzcGFjZSB3aWxsIHNvbWV0aW1lcyBuZWVkIHRvIGNvbWJpbmUgaTkxNSBwZXJm IE9BIG1ldHJpY3Mgd2l0aAorICogc2lkZS1iYW5kIE9BIGRhdGEgY2FwdHVyZWQgdmlhIE1JX1JF UE9SVF9QRVJGX0NPVU5UIGNvbW1hbmRzOyB3ZSdyZQorICogZXhwZWN0aW5nIHRoZSBpbnRlcmZh Y2UgdG8gYmUgdXNlZCBieSBhIHBsYXRmb3JtIHNwZWNpZmljIHVzZXJzcGFjZSBzdWNoIGFzCisg KiBPcGVuR0wgb3IgdG9vbHMuIFRoaXMgaXMgdG8gc2F5OyB3ZSBhcmVuJ3QgaW5oZXJlbnRseSBt aXNzaW5nIG91dCBvbiBoYXZpbmcKKyAqIGEgc3RhbmRhcmQgdmVuZG9yL2FyY2hpdGVjdHVyZSBh Z25vc3RpYyBpbnRlcmZhY2UgYnkgbm90IHVzaW5nIHBlcmYuCisgKgorICoKKyAqIEZvciBwb3N0 ZXJpdHksIGluIGNhc2Ugd2UgbWlnaHQgcmUtdmlzaXQgdHJ5aW5nIHRvIGFkYXB0IGNvcmUgcGVy ZiB0byBiZQorICogYmV0dGVyIHN1aXRlZCB0byBleHBvc2luZyBpOTE1IG1ldHJpY3MgdGhlc2Ug d2VyZSB0aGUgbWFpbiBwYWluIHBvaW50cyB3ZQorICogaGl0OgorICoKKyAqIC0gVGhlIHBlcmYg YmFzZWQgT0EgUE1VIGRyaXZlciBicm9rZSBzb21lIHNpZ25pZmljYW50IGRlc2lnbiBhc3N1bXB0 aW9uczoKKyAqCisgKiAgIEV4aXN0aW5nIHBlcmYgcG11cyBhcmUgdXNlZCBmb3IgcHJvZmlsaW5n IHdvcmsgb24gYSBjcHUgYW5kIHdlIHdlcmUKKyAqICAgaW50cm9kdWNpbmcgdGhlIGlkZWEgb2Yg X0lTX0RFVklDRSBwbXVzIHdpdGggZGlmZmVyZW50IHNlY3VyaXR5CisgKiAgIGltcGxpY2F0aW9u cywgdGhlIG5lZWQgdG8gZmFrZSBjcHUtcmVsYXRlZCBkYXRhIChzdWNoIGFzIHVzZXIva2VybmVs CisgKiAgIHJlZ2lzdGVycykgdG8gZml0IHdpdGggcGVyZidzIGN1cnJlbnQgZGVzaWduLCBhbmQg YWRkaW5nIF9ERVZJQ0UgcmVjb3JkcworICogICBhcyBhIHdheSB0byBmb3J3YXJkIGRldmljZS1z cGVjaWZpYyBzdGF0dXMgcmVjb3Jkcy4KKyAqCisgKiAgIFRoZSBPQSB1bml0IHdyaXRlcyByZXBv cnRzIG9mIGNvdW50ZXJzIGludG8gYSBjaXJjdWxhciBidWZmZXIsIHdpdGhvdXQKKyAqICAgaW52 b2x2ZW1lbnQgZnJvbSB0aGUgQ1BVLCBtYWtpbmcgb3VyIFBNVSBkcml2ZXIgdGhlIGZpcnN0IG9m IGEga2luZC4KKyAqCisgKiAgIEdpdmVuIHRoZSB3YXkgd2Ugd2VyZSBwZXJpb2RpY2FsbHkgZm9y d2FyZCBkYXRhIGZyb20gdGhlIEdQVS1tYXBwZWQsIE9BCisgKiAgIGJ1ZmZlciB0byBwZXJmJ3Mg YnVmZmVyLCB0aG9zZSBidXJzdHMgb2Ygc2FtcGxlIHdyaXRlcyBsb29rZWQgdG8gcGVyZiBsaWtl CisgKiAgIHdlIHdlcmUgc2FtcGxpbmcgdG9vIGZhc3QgYW5kIHNvIHdlIGhhZCB0byBzdWJ2ZXJ0 IGl0cyB0aHJvdHRsaW5nIGNoZWNrcy4KKyAqCisgKiAgIFBlcmYgc3VwcG9ydHMgZ3JvdXBzIG9m IGNvdW50ZXJzIGFuZCBhbGxvd3MgdGhvc2UgdG8gYmUgcmVhZCB2aWEKKyAqICAgdHJhbnNhY3Rp b25zIGludGVybmFsbHkgYnV0IHRyYW5zYWN0aW9ucyBjdXJyZW50bHkgc2VlbSBkZXNpZ25lZCB0 byBiZQorICogICBleHBsaWNpdGx5IGluaXRpYXRlZCBmcm9tIHRoZSBjcHUgKHNheSBpbiByZXNw b25zZSB0byBhIHVzZXJzcGFjZSByZWFkKCkpCisgKiAgIGFuZCB3aGlsZSB3ZSBjb3VsZCBwdWxs IGEgcmVwb3J0IG91dCBvZiB0aGUgT0EgYnVmZmVyIHdlIGNhbid0CisgKiAgIHRyaWdnZXIgYSBy ZXBvcnQgZnJvbSB0aGUgY3B1IG9uIGRlbWFuZC4KKyAqCisgKiAgIFJlbGF0ZWQgdG8gYmVpbmcg cmVwb3J0IGJhc2VkOyB0aGUgT0EgY291bnRlcnMgYXJlIGNvbmZpZ3VyZWQgaW4gSFcgYXMgYQor ICogICBzZXQgd2hpbGUgcGVyZiBnZW5lcmFsbHkgZXhwZWN0cyBjb3VudGVyIGNvbmZpZ3VyYXRp b25zIHRvIGJlIG9ydGhvZ29uYWwuCisgKiAgIEFsdGhvdWdoIGNvdW50ZXJzIGNhbiBiZSBhc3Nv Y2lhdGVkIHdpdGggYSBncm91cCBsZWFkZXIgYXMgdGhleSBhcmUKKyAqICAgb3BlbmVkLCB0aGVy ZSdzIG5vIGNsZWFyIHByZWNlZGVudCBmb3IgYmVpbmcgYWJsZSB0byBwcm92aWRlIGdyb3VwLXdp ZGUKKyAqICAgY29uZmlndXJhdGlvbiBhdHRyaWJ1dGVzIChmb3IgZXhhbXBsZSB3ZSB3YW50IHRv IGxldCB1c2Vyc3BhY2UgY2hvb3NlIHRoZQorICogICBPQSB1bml0IHJlcG9ydCBmb3JtYXQgdXNl ZCB0byBjYXB0dXJlIGFsbCBjb3VudGVycyBpbiBhIHNldCwgb3Igc3BlY2lmeSBhCisgKiAgIEdQ VSBjb250ZXh0IHRvIGZpbHRlciBtZXRyaWNzIG9uKS4gV2UgYXZvaWRlZCB1c2luZyBwZXJmJ3Mg Z3JvdXBpbmcKKyAqICAgZmVhdHVyZSBhbmQgZm9yd2FyZGVkIE9BIHJlcG9ydHMgdG8gdXNlcnNw YWNlIHZpYSBwZXJmJ3MgJ3Jhdycgc2FtcGxlCisgKiAgIGZpZWxkLiBUaGlzIHN1aXRlZCBvdXIg dXNlcnNwYWNlIHdlbGwgY29uc2lkZXJpbmcgaG93IGNvdXBsZWQgdGhlIGNvdW50ZXJzCisgKiAg IGFyZSB3aGVuIGRlYWxpbmcgd2l0aCBub3JtYWxpemluZy4gSXQgd291bGQgYmUgaW5jb252ZW5p ZW50IHRvIHNwbGl0CisgKiAgIGNvdW50ZXJzIHVwIGludG8gc2VwYXJhdGUgZXZlbnRzLCBvbmx5 IHRvIHJlcXVpcmUgdXNlcnNwYWNlIHRvIHJlY29tYmluZQorICogICB0aGVtLiBGb3IgTWVzYSBp dCdzIGFsc28gY29udmVuaWVudCB0byBiZSBmb3J3YXJkZWQgcmF3LCBwZXJpb2RpYyByZXBvcnRz CisgKiAgIGZvciBjb21iaW5pbmcgd2l0aCB0aGUgc2lkZS1iYW5kIHJhdyByZXBvcnRzIGl0IGNh cHR1cmVzIHVzaW5nCisgKiAgIE1JX1JFUE9SVF9QRVJGX0NPVU5UIGNvbW1hbmRzLgorICoKKyAq ICAgXyBBcyBhIHNpZGUgbm90ZSBvbiBwZXJmJ3MgZ3JvdXBpbmcgZmVhdHVyZTsgdGhlcmUgd2Fz IGFsc28gc29tZSBjb25jZXJuCisgKiAgICAgdGhhdCB1c2luZyBQRVJGX0ZPUk1BVF9HUk9VUCBh cyBhIHdheSB0byBwYWNrIHRvZ2V0aGVyIGNvdW50ZXIgdmFsdWVzCisgKiAgICAgd291bGQgcXVp dGUgZHJhc3RpY2FsbHkgaW5mbGF0ZSBvdXIgc2FtcGxlIHNpemVzLCB3aGljaCB3b3VsZCBsaWtl bHkKKyAqICAgICBsb3dlciB0aGUgZWZmZWN0aXZlIHNhbXBsaW5nIHJlc29sdXRpb25zIHdlIGNv dWxkIHVzZSB3aGVuIHRoZSBhdmFpbGFibGUKKyAqICAgICBtZW1vcnkgYmFuZHdpZHRoIGlzIGxp bWl0ZWQuCisgKgorICogICAgIFdpdGggdGhlIE9BIHVuaXQncyByZXBvcnQgZm9ybWF0cywgY291 bnRlcnMgYXJlIHBhY2tlZCB0b2dldGhlciBhcyAzMgorICogICAgIG9yIDQwYml0IHZhbHVlcywg d2l0aCB0aGUgbGFyZ2VzdCByZXBvcnQgc2l6ZSBiZWluZyAyNTYgYnl0ZXMuCisgKgorICogICAg IFBFUkZfRk9STUFUX0dST1VQIHZhbHVlcyBhcmUgNjRiaXQsIGJ1dCB0aGVyZSBkb2Vzbid0IGFw cGVhciB0byBiZSBhCisgKiAgICAgZG9jdW1lbnRlZCBvcmRlcmluZyB0byB0aGUgdmFsdWVzLCBp bXBseWluZyBQRVJGX0ZPUk1BVF9JRCBtdXN0IGFsc28gYmUKKyAqICAgICB1c2VkIHRvIGFkZCBh IDY0Yml0IElEIGJlZm9yZSBlYWNoIHZhbHVlOyBnaXZpbmcgMTYgYnl0ZXMgcGVyIGNvdW50ZXIu CisgKgorICogICBSZWxhdGVkIHRvIGNvdW50ZXIgb3J0aG9nb25hbGl0eTsgd2UgY2FuJ3QgdGlt ZSBzaGFyZSB0aGUgT0EgdW5pdCwgd2hpbGUKKyAqICAgZXZlbnQgc2NoZWR1bGluZyBpcyBhIGNl bnRyYWwgZGVzaWduIGlkZWEgd2l0aGluIHBlcmYgZm9yIGFsbG93aW5nCisgKiAgIHVzZXJzcGFj ZSB0byBvcGVuICsgZW5hYmxlIG1vcmUgZXZlbnRzIHRoYW4gY2FuIGJlIGNvbmZpZ3VyZWQgaW4g SFcgYXQgYW55CisgKiAgIG9uZSB0aW1lLiAgVGhlIE9BIHVuaXQgaXMgbm90IGRlc2lnbmVkIHRv IGFsbG93IHJlLWNvbmZpZ3VyYXRpb24gd2hpbGUgaW4KKyAqICAgdXNlLiBXZSBjYW4ndCByZWNv bmZpZ3VyZSB0aGUgT0EgdW5pdCB3aXRob3V0IGxvb3NpbmcgaW50ZXJuYWwgT0EgdW5pdAorICog ICBzdGF0ZSB3aGljaCB3ZSBjYW4ndCBhY2Nlc3MgZXhwbGljaXRseSB0byBzYXZlIGFuZCByZXN0 b3JlLiBSZWNvbmZpZ3VyaW5nCisgKiAgIHRoZSBPQSB1bml0IGlzIGFsc28gcmVsYXRpdmVseSBz bG93LCBpbnZvbHZpbmcgfjEwMCByZWdpc3RlciB3cml0ZXMuIEZyb20KKyAqICAgdXNlcnNwYWNl IE1lc2EgYWxzbyBkZXBlbmRzIG9uIGEgc3RhYmxlIE9BIGNvbmZpZ3VyYXRpb24gd2hlbiBlbWl0 dGluZworICogICBNSV9SRVBPUlRfUEVSRl9DT1VOVCBjb21tYW5kcyBhbmQgaW1wb3J0YW50bHkg dGhlIE9BIHVuaXQgY2FuJ3QgYmUKKyAqICAgZGlzYWJsZWQgd2hpbGUgdGhlcmUgYXJlIG91dHN0 YW5kaW5nIE1JX1JQQyBjb21tYW5kcyBsZXN0IHdlIGhhbmcgdGhlCisgKiAgIGNvbW1hbmQgc3Ry ZWFtZXIuCisgKgorICogICBUaGUgY29udGVudHMgb2Ygc2FtcGxlIHJlY29yZHMgYXJlbid0IGV4 dGVuc2libGUgYnkgZGV2aWNlIGRyaXZlcnMgKGkuZS4KKyAqICAgdGhlIHNhbXBsZV90eXBlIGJp dHMpLiBBcyBhbiBleGFtcGxlOyBTb3VyYWIgR3VwdGEgaGFkIGJlZW4gbG9va2luZyB0bworICog ICBhdHRhY2ggR1BVIHRpbWVzdGFtcHMgdG8gb3VyIE9BIHNhbXBsZXMuIFdlIHdlcmUgc2hvZWhv cm5pbmcgT0EgcmVwb3J0cworICogICBpbnRvIHNhbXBsZSByZWNvcmRzIGJ5IHVzaW5nIHRoZSAn cmF3JyBmaWVsZCwgYnV0IGl0J3MgdHJpY2t5IHRvIHBhY2sgbW9yZQorICogICB0aGFuIG9uZSB0 aGluZyBpbnRvIHRoaXMgZmllbGQgYmVjYXVzZSBldmVudHMvY29yZS5jIGN1cnJlbnRseSBvbmx5 IGxldHMgYQorICogICBwbXUgZ2l2ZSBhIHNpbmdsZSByYXcgZGF0YSBwb2ludGVyIHBsdXMgbGVu IHdoaWNoIHdpbGwgYmUgY29waWVkIGludG8gdGhlCisgKiAgIHJpbmcgYnVmZmVyLiBUbyBpbmNs dWRlIG1vcmUgdGhhbiB0aGUgT0EgcmVwb3J0IHdlJ2QgaGF2ZSB0byBjb3B5IHRoZQorICogICBy ZXBvcnQgaW50byBhbiBpbnRlcm1lZGlhdGUgbGFyZ2VyIGJ1ZmZlci4gSSdkIGJlZW4gY29uc2lk ZXJpbmcgYWxsb3dpbmcgYQorICogICB2ZWN0b3Igb2YgZGF0YStsZW4gdmFsdWVzIHRvIGJlIHNw ZWNpZmllZCBmb3IgY29weWluZyB0aGUgcmF3IGRhdGEsIGJ1dAorICogICBpdCBmZWx0IGxpa2Ug YSBrbHVkZ2UgdG8gYmVpbmcgdXNpbmcgdGhlIHJhdyBmaWVsZCBmb3IgdGhpcyBwdXJwb3NlLgor ICoKKyAqIC0gSXQgZmVsdCBsaWtlIG91ciBwZXJmIGJhc2VkIFBNVSB3YXMgbWFraW5nIHNvbWUg dGVjaG5pY2FsIGNvbXByb21pc2VzCisgKiAgIGp1c3QgZm9yIHRoZSBzYWtlIG9mIHVzaW5nIHBl cmY6CisgKgorICogICBwZXJmX2V2ZW50X29wZW4oKSByZXF1aXJlcyBldmVudHMgdG8gZWl0aGVy IHJlbGF0ZSB0byBhIHBpZCBvciBhIHNwZWNpZmljCisgKiAgIGNwdSBjb3JlLCB3aGlsZSBvdXIg ZGV2aWNlIHBtdSByZWxhdGVkIHRvIG5laXRoZXIuICBFdmVudHMgb3BlbmVkIHdpdGggYQorICog ICBwaWQgd2lsbCBiZSBhdXRvbWF0aWNhbGx5IGVuYWJsZWQvZGlzYWJsZWQgYWNjb3JkaW5nIHRv IHRoZSBzY2hlZHVsaW5nIG9mCisgKiAgIHRoYXQgcHJvY2VzcyAtIHNvIG5vdCBhcHByb3ByaWF0 ZSBmb3IgdXMuIFdoZW4gYW4gZXZlbnQgaXMgcmVsYXRlZCB0byBhCisgKiAgIGNwdSBpZCwgcGVy ZiBlbnN1cmVzIHBtdSBtZXRob2RzIHdpbGwgYmUgaW52b2tlZCB2aWEgYW4gaW50ZXIgcHJvY2Vz cworICogICBpbnRlcnJ1cHQgb24gdGhhdCBjb3JlLiBUbyBhdm9pZCBpbnZhc2l2ZSBjaGFuZ2Vz IG91ciB1c2Vyc3BhY2Ugb3BlbmVkIE9BCisgKiAgIHBlcmYgZXZlbnRzIGZvciBhIHNwZWNpZmlj IGNwdS4gVGhpcyB3YXMgd29ya2FibGUgYnV0IGl0IG1lYW50IHRoZQorICogICBtYWpvcml0eSBv ZiB0aGUgT0EgZHJpdmVyIHJhbiBpbiBhdG9taWMgY29udGV4dCwgaW5jbHVkaW5nIGFsbCBPQSBy ZXBvcnQKKyAqICAgZm9yd2FyZGluZywgd2hpY2ggd2Fzbid0IHJlYWxseSBuZWNlc3NhcnkgaW4g b3VyIGNhc2UgYW5kIHNlZW1zIHRvIG1ha2UKKyAqICAgb3VyIGxvY2tpbmcgcmVxdWlyZW1lbnRz IHNvbWV3aGF0IGNvbXBsZXggYXMgd2UgaGFuZGxlZCB0aGUgaW50ZXJhY3Rpb24KKyAqICAgd2l0 aCB0aGUgcmVzdCBvZiB0aGUgaTkxNSBkcml2ZXIuCisgKi8KKwogI2luY2x1ZGUgPGxpbnV4L2Fu b25faW5vZGVzLmg+CiAjaW5jbHVkZSA8bGludXgvc2l6ZXMuaD4KIAotLSAKMi45LjIKCl9fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCkludGVsLWdmeCBtYWls aW5nIGxpc3QKSW50ZWwtZ2Z4QGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZy ZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2ludGVsLWdmeAo=