From: Oscar Mateo Subject: [PATCH 07/12] drm/i915/guc: Improve the GuC documentation & comments about proxy submissions Date: Tue, 21 Mar 2017 02:02:52 -0700 Message-ID: <1490086977-9282-8-git-send-email-oscar.mateo@intel.com> References: <1490086977-9282-1-git-send-email-oscar.mateo@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by gabe.freedesktop.org (Postfix) with ESMTPS id 41E656E734 for ; Tue, 21 Mar 2017 16:03:04 +0000 (UTC) In-Reply-To: <1490086977-9282-1-git-send-email-oscar.mateo@intel.com> 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 List-Id: intel-gfx@lists.freedesktop.org V2hpbGUgYXQgaXQsIGZpeCBhIHR5cG8gKHMvcmluZ19sY3JhL3JpbmdfbHJjYSkgYW5kIGltcHJv dmUgdGhlIG5hbWluZyBvZiBvbmUKZmlyd2FyZSBpbnRlcmZhY2UgZmllbGQgKHMvcmluZ190YWls L3N1Ym1pdF9lbGVtZW50X2luZm8sIHNpbmNlIGl0IGNhbiBjb250YWluCm1vcmUgdGhhbiBqdXN0 IHRoZSByaW5nIHRhaWwpLgoKTm8gY2hhbmdlIGluIGZ1bmN0aW9uYWxpdHkuCgp2MjoKICAtIFJl bW92ZSByZWZlcmVuY2UgdG8gInVuaXF1ZSB1c2VyIiBvZiB0aGUgR3VDIChEYW5pZWxlKQogIC0g S2VlcCBtZW50aW9uIHRvIHJlbmFtaW5nIGZyb20gIkd1QyBjb250ZXh0IiB0byAiY2xpZW50IiAo RGFuaWVsZSkKCkNjOiBEYW5pZWxlIENlcmFvbG8gU3B1cmlvIDxkYW5pZWxlLmNlcmFvbG9zcHVy aW9AaW50ZWwuY29tPgpTaWduZWQtb2ZmLWJ5OiBPc2NhciBNYXRlbyA8b3NjYXIubWF0ZW9AaW50 ZWwuY29tPgotLS0KIGRyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfZ3VjX3N1Ym1pc3Npb24uYyB8 IDQyICsrKysrKysrKysrKysrKysrKystLS0tLS0tLS0tLQogZHJpdmVycy9ncHUvZHJtL2k5MTUv aW50ZWxfZ3VjX2Z3aWYuaCAgICAgIHwgIDQgKy0tCiBkcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRl bF91Yy5oICAgICAgICAgICAgfCAgNiArKystLQogMyBmaWxlcyBjaGFuZ2VkLCAzMyBpbnNlcnRp b25zKCspLCAxOSBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9kcml2ZXJzL2dwdS9kcm0vaTkx NS9pOTE1X2d1Y19zdWJtaXNzaW9uLmMgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pOTE1X2d1Y19z dWJtaXNzaW9uLmMKaW5kZXggZmY4MjM1YTEuLjg1NTExMmQgMTAwNjQ0Ci0tLSBhL2RyaXZlcnMv Z3B1L2RybS9pOTE1L2k5MTVfZ3VjX3N1Ym1pc3Npb24uYworKysgYi9kcml2ZXJzL2dwdS9kcm0v aTkxNS9pOTE1X2d1Y19zdWJtaXNzaW9uLmMKQEAgLTMwLDE2ICszMCwyNSBAQAogLyoqCiAgKiBE T0M6IEd1Qy1iYXNlZCBjb21tYW5kIHN1Ym1pc3Npb24KICAqCi0gKiBpOTE1X2d1Y19jbGllbnQ6 Ci0gKiBXZSB1c2UgdGhlIHRlcm0gY2xpZW50IHRvIGF2b2lkIGNvbmZ1c2lvbiB3aXRoIGNvbnRl eHRzLiBBIGk5MTVfZ3VjX2NsaWVudCBpcwotICogZXF1aXZhbGVudCB0byBHdUMgb2JqZWN0IGd1 Y19jb250ZXh0X2Rlc2MuIFRoaXMgY29udGV4dCBkZXNjcmlwdG9yIGlzCi0gKiBhbGxvY2F0ZWQg ZnJvbSBhIHBvb2wgb2YgMTAyNCBlbnRyaWVzLiBLZXJuZWwgZHJpdmVyIHdpbGwgYWxsb2NhdGUg ZG9vcmJlbGwKLSAqIGFuZCB3b3JrcXVldWUgZm9yIGl0LiBBbHNvIHRoZSBwcm9jZXNzIGRlc2Ny aXB0b3IgKGd1Y19wcm9jZXNzX2Rlc2MpLCB3aGljaAotICogaXMgbWFwcGVkIHRvIGNsaWVudCBz cGFjZS4gU28gdGhlIGNsaWVudCBjYW4gd3JpdGUgV29yayBJdGVtIHRoZW4gcmluZyB0aGUKLSAq IGRvb3JiZWxsLgorICogR3VDIGNsaWVudDoKKyAqIEEgaTkxNV9ndWNfY2xpZW50IHJlZmVycyB0 byBhIHN1Ym1pc3Npb24gcGF0aCB0aHJvdWdoIEd1Qy4gQ3VycmVudGx5LCB0aGVyZQorICogaXMg b25seSBvbmUgb2YgdGhlc2UgKHRoZSBleGVjYnVmX2NsaWVudCkgYW5kIHRoaXMgb25lIGlzIGNo YXJnZWQgd2l0aCBhbGwKKyAqIHN1Ym1pc3Npb25zIHRvIHRoZSBHdUMuIFRoaXMgc3RydWN0IGlz IHRoZSBvd25lciBvZiBhIGRvb3JiZWxsLCBhIHByb2Nlc3MKKyAqIGRlc2NyaXB0b3IgYW5kIGEg d29ya3F1ZXVlIChhbGwgb2YgdGhlbSBpbnNpZGUgYSBzaW5nbGUgZ2VtIG9iamVjdCB0aGF0Cisg KiBjb250YWlucyBhbGwgcmVxdWlyZWQgcGFnZXMgZm9yIHRoZXNlIGVsZW1lbnRzKS4KICAqCi0g KiBUbyBzaW1wbGlmeSB0aGUgaW1wbGVtZW50YXRpb24sIHdlIGFsbG9jYXRlIG9uZSBnZW0gb2Jq ZWN0IHRoYXQgY29udGFpbnMgYWxsCi0gKiBwYWdlcyBmb3IgZG9vcmJlbGwsIHByb2Nlc3MgZGVz Y3JpcHRvciBhbmQgd29ya3F1ZXVlLgorICogR3VDIGNvbnRleHQgZGVzY3JpcHRvcjoKKyAqIER1 cmluZyBpbml0aWFsaXphdGlvbiwgdGhlIGRyaXZlciBhbGxvY2F0ZXMgYSBzdGF0aWMgcG9vbCBv ZiAxMDI0IHN1Y2gKKyAqIGRlc2NyaXB0b3JzLCBhbmQgc2hhcmVzIHRoZW0gd2l0aCB0aGUgR3VD LgorICogQ3VycmVudGx5LCB0aGVyZSBleGlzdHMgYSAxOjEgbWFwcGluZyBiZXR3ZWVuIGEgaTkx NV9ndWNfY2xpZW50IGFuZCBhCisgKiBndWNfY29udGV4dF9kZXNjICh2aWEgdGhlIGNsaWVudCdz IGNvbnRleHRfaW5kZXgpLCBzbyBlZmZlY3RpdmVseSBvbmx5CisgKiBvbmUgZ3VjX2NvbnRleHRf ZGVzYyBnZXRzIHVzZWQuIFRoaXMgY29udGV4dCBkZXNjcmlwdG9yIGxldHMgdGhlIEd1QyBrbm93 CisgKiBhYm91dCB0aGUgZG9vcmJlbGwsIHdvcmtxdWV1ZSBhbmQgcHJvY2VzcyBkZXNjcmlwdG9y LiBUaGVvcmV0aWNhbGx5LCBpdCBhbHNvCisgKiBsZXRzIHRoZSBHdUMga25vdyBhYm91dCBvdXIg SFcgY29udGV4dHMgKENvbnRleHQgSUQsIGV0Yy4uLiksIGJ1dCB3ZSBhY3R1YWxseQorICogZW1w bG95IGEga2luZCBvZiBzdWJtaXNzaW9uIHdoZXJlIHRoZSBHdUMgdXNlcyB0aGUgTFJDQSBzZW50 IHZpYSB0aGUgd29yaworICogaXRlbSBpbnN0ZWFkICh0aGUgc2luZ2xlIGd1Y19jb250ZXh0X2Rl c2MgYXNzb2NpYXRlZCB0byBleGVjYnVmIGNsaWVudAorICogY29udGFpbnMgaW5mb3JtYXRpb24g YWJvdXQgdGhlIGRlZmF1bHQga2VybmVsIGNvbnRleHQgb25seSwgYnV0IHRoaXMgaXMKKyAqIGVz c2VudGlhbGx5IHVudXNlZCkuIFRoaXMgaXMgY2FsbGVkIGEgInByb3h5IiBzdWJtaXNzaW9uLgog ICoKICAqIFRoZSBTY3JhdGNoIHJlZ2lzdGVyczoKICAqIFRoZXJlIGFyZSAxNiBNTUlPLWJhc2Vk IHJlZ2lzdGVycyBzdGFydCBmcm9tIDB4QzE4MC4gVGhlIGtlcm5lbCBkcml2ZXIgd3JpdGVzCkBA IC0zMDgsMTAgKzMxNywxNyBAQCBzdGF0aWMgdm9pZCBndWNfY3R4X2Rlc2NfaW5pdChzdHJ1Y3Qg aW50ZWxfZ3VjICpndWMsCiAJCWlmICghY2UtPnN0YXRlKQogCQkJYnJlYWs7CS8qIFhYWDogY29u dGludWU/ICovCiAKKwkJLyoKKwkJICogWFhYOiBXaGVuIHRoaXMgaXMgYSBHVUNfQ1RYX0RFU0Nf QVRUUl9LRVJORUwgY2xpZW50IChwcm94eQorCQkgKiBzdWJtaXNzaW9uIG9yLCBpbiBvdGhlciB3 b3Jkcywgbm90IHVzaW5nIGEgZGlyZWN0IHN1Ym1pc3Npb24KKwkJICogbW9kZWwpIHRoZSBLTUQn cyBMUkNBIGlzIG5vdCB1c2VkIGZvciBhbnkgd29yayBzdWJtaXNzaW9uLgorCQkgKiBJbnN0ZWFk LCB0aGUgR3VDIHVzZXMgdGhlIExSQ0Egb2YgdGhlIHVzZXIgbW9kZSBjb250ZXh0IChzZWUKKwkJ ICogZ3VjX3dxX2l0ZW1fYXBwZW5kIGJlbG93KS4KKwkJICovCiAJCWxyYy0+Y29udGV4dF9kZXNj ID0gbG93ZXJfMzJfYml0cyhjZS0+bHJjX2Rlc2MpOwogCiAJCS8qIFRoZSBzdGF0ZSBwYWdlIGlz IGFmdGVyIFBQSFdTUCAqLwotCQlscmMtPnJpbmdfbGNyYSA9CisJCWxyYy0+cmluZ19scmNhID0K IAkJCWd1Y19nZ3R0X29mZnNldChjZS0+c3RhdGUpICsgTFJDX1NUQVRFX1BOICogUEFHRV9TSVpF OwogCQlscmMtPmNvbnRleHRfaWQgPSAoY2xpZW50LT5jdHhfaW5kZXggPDwgR1VDX0VMQ19DVFhJ RF9PRkZTRVQpIHwKIAkJCQkoZ3VjX2VuZ2luZV9pZCA8PCBHVUNfRUxDX0VOR0lORV9PRkZTRVQp OwpAQCAtMzQxLDEwICszNTcsNiBAQCBzdGF0aWMgdm9pZCBndWNfY3R4X2Rlc2NfaW5pdChzdHJ1 Y3QgaW50ZWxfZ3VjICpndWMsCiAJZGVzYy0+d3FfYWRkciA9IGdmeF9hZGRyICsgY2xpZW50LT53 cV9vZmZzZXQ7CiAJZGVzYy0+d3Ffc2l6ZSA9IGNsaWVudC0+d3Ffc2l6ZTsKIAotCS8qCi0JICog WFhYOiBUYWtlIExSQ3MgZnJvbSBhbiBleGlzdGluZyBjb250ZXh0IGlmIHRoaXMgaXMgbm90IGFu Ci0JICogSXNLTURDcmVhdGVkQ29udGV4dCBjbGllbnQKLQkgKi8KIAlkZXNjLT5kZXNjX3ByaXZh dGUgPSAodWludHB0cl90KWNsaWVudDsKIH0KIApAQCAtNDY4LDcgKzQ4MCw3IEBAIHN0YXRpYyB2 b2lkIGd1Y193cV9pdGVtX2FwcGVuZChzdHJ1Y3QgaTkxNV9ndWNfY2xpZW50ICpjbGllbnQsCiAJ LyogVGhlIEd1QyB3YW50cyBvbmx5IHRoZSBsb3ctb3JkZXIgd29yZCBvZiB0aGUgY29udGV4dCBk ZXNjcmlwdG9yICovCiAJd3FpLT5jb250ZXh0X2Rlc2MgPSAodTMyKWludGVsX2xyX2NvbnRleHRf ZGVzY3JpcHRvcihycS0+Y3R4LCBlbmdpbmUpOwogCi0Jd3FpLT5yaW5nX3RhaWwgPSB0YWlsIDw8 IFdRX1JJTkdfVEFJTF9TSElGVDsKKwl3cWktPnN1Ym1pdF9lbGVtZW50X2luZm8gPSB0YWlsIDw8 IFdRX1JJTkdfVEFJTF9TSElGVDsKIAl3cWktPmZlbmNlX2lkID0gcnEtPmdsb2JhbF9zZXFubzsK IH0KIApkaWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfZ3VjX2Z3aWYuaCBi L2RyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX2d1Y19md2lmLmgKaW5kZXggM2FlOGNlZi4uNGVk ZjQwZiAxMDA2NDQKLS0tIGEvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfZ3VjX2Z3aWYuaAor KysgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9ndWNfZndpZi5oCkBAIC0yNTEsNyArMjUx LDcgQEAgc3RydWN0IGd1Y19kb29yYmVsbF9pbmZvIHsKIHN0cnVjdCBndWNfd3FfaXRlbSB7CiAJ dTMyIGhlYWRlcjsKIAl1MzIgY29udGV4dF9kZXNjOwotCXUzMiByaW5nX3RhaWw7CisJdTMyIHN1 Ym1pdF9lbGVtZW50X2luZm87CiAJdTMyIGZlbmNlX2lkOwogfSBfX3BhY2tlZDsKIApAQCAtMjc4 LDcgKzI3OCw3IEBAIHN0cnVjdCBndWNfZXhlY2xpc3RfY29udGV4dCB7CiAJdTMyIGNvbnRleHRf ZGVzYzsKIAl1MzIgY29udGV4dF9pZDsKIAl1MzIgcmluZ19zdGF0dXM7Ci0JdTMyIHJpbmdfbGNy YTsKKwl1MzIgcmluZ19scmNhOwogCXUzMiByaW5nX2JlZ2luOwogCXUzMiByaW5nX2VuZDsKIAl1 MzIgcmluZ19uZXh0X2ZyZWVfbG9jYXRpb247CmRpZmYgLS1naXQgYS9kcml2ZXJzL2dwdS9kcm0v aTkxNS9pbnRlbF91Yy5oIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfdWMuaAppbmRleCAz ZWM1NGExLi42NWQwYjU5IDEwMDY0NAotLS0gYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF91 Yy5oCisrKyBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX3VjLmgKQEAgLTM0LDcgKzM0LDkg QEAKIAogLyoKICAqIFRoaXMgc3RydWN0dXJlIHByaW1hcmlseSBkZXNjcmliZXMgdGhlIEdFTSBv YmplY3Qgc2hhcmVkIHdpdGggdGhlIEd1Qy4KLSAqIFRoZSBHRU0gb2JqZWN0IGlzIGhlbGQgZm9y IHRoZSBlbnRpcmUgbGlmZXRpbWUgb2Ygb3VyIGludGVyYWN0aW9uIHdpdGgKKyAqIFRoZSBzcGVj cyBzb21ldGltZXMgcmVmZXIgdG8gdGhpcyBvYmplY3QgYXMgYSAiR3VDIGNvbnRleHQiLCBidXQg d2UgdXNlCisgKiB0aGUgdGVybSAiY2xpZW50IiB0byBhdm9pZCBjb25mdXNpb24gd2l0aCBoYXJk d2FyZSBjb250ZXh0cy4gVGhpcworICogR0VNIG9iamVjdCBpcyBoZWxkIGZvciB0aGUgZW50aXJl IGxpZmV0aW1lIG9mIG91ciBpbnRlcmFjdGlvbiB3aXRoCiAgKiB0aGUgR3VDLCBiZWluZyBhbGxv Y2F0ZWQgYmVmb3JlIHRoZSBHdUMgaXMgbG9hZGVkIHdpdGggaXRzIGZpcm13YXJlLgogICogQmVj YXVzZSB0aGVyZSdzIG5vIHdheSB0byB1cGRhdGUgdGhlIGFkZHJlc3MgdXNlZCBieSB0aGUgR3VD IGFmdGVyCiAgKiBpbml0aWFsaXNhdGlvbiwgdGhlIHNoYXJlZCBvYmplY3QgbXVzdCBzdGF5IHBp bm5lZCBpbnRvIHRoZSBHR1RUIGFzCkBAIC00NCw3ICs0Niw3IEBACiAgKgogICogVGhlIHNpbmds ZSBHRU0gb2JqZWN0IGRlc2NyaWJlZCBoZXJlIGlzIGFjdHVhbGx5IG1hZGUgdXAgb2Ygc2V2ZXJh bAogICogc2VwYXJhdGUgYXJlYXMsIGFzIGZhciBhcyB0aGUgR3VDIGlzIGNvbmNlcm5lZC4gVGhl IGZpcnN0IHBhZ2UgKGtlcHQKLSAqIGttYXAnZCkgaW5jbHVkZXMgdGhlICJwcm9jZXNzIGRlY3Jp cHRvciIgd2hpY2ggaG9sZHMgc2VxdWVuY2UgZGF0YSBmb3IKKyAqIGttYXAnZCkgaW5jbHVkZXMg dGhlICJwcm9jZXNzIGRlc2NyaXB0b3IiIHdoaWNoIGhvbGRzIHNlcXVlbmNlIGRhdGEgZm9yCiAg KiB0aGUgZG9vcmJlbGwsIGFuZCBvbmUgY2FjaGVsaW5lIHdoaWNoIGFjdHVhbGx5ICppcyogdGhl IGRvb3JiZWxsOyBhCiAgKiB3cml0ZSB0byB0aGlzIHdpbGwgInJpbmcgdGhlIGRvb3JiZWxsIiAo aS5lLiBzZW5kIGFuIGludGVycnVwdCB0byB0aGUKICAqIEd1QykuIFRoZSBzdWJzZXF1ZW50ICBw YWdlcyBvZiB0aGUgY2xpZW50IG9iamVjdCBjb25zdGl0dXRlIHRoZSB3b3JrCi0tIAoxLjkuMQoK X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KSW50ZWwtZ2Z4 IG1haWxpbmcgbGlzdApJbnRlbC1nZnhAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlz dHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vaW50ZWwtZ2Z4Cg==