From: Oscar Mateo Subject: [PATCH v2 07/13] drm/i915/guc: Improve the GuC documentation & comments about proxy submissions Date: Wed, 22 Mar 2017 10:39:50 -0700 Message-ID: <1490204396-3395-8-git-send-email-oscar.mateo@intel.com> References: <1490204396-3395-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 2497D6E9DD for ; Thu, 23 Mar 2017 00:39:54 +0000 (UTC) In-Reply-To: <1490204396-3395-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 RGFuaWVsZSkKClNpZ25lZC1vZmYtYnk6IE9zY2FyIE1hdGVvIDxvc2Nhci5tYXRlb0BpbnRlbC5j b20+ClJldmlld2VkLWJ5OiBEYW5pZWxlIENlcmFvbG8gU3B1cmlvIDxkYW5pZWxlLmNlcmFvbG9z cHVyaW9AaW50ZWwuY29tPgotLS0KIGRyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfZ3VjX3N1Ym1p c3Npb24uYyB8IDQyICsrKysrKysrKysrKysrKysrKystLS0tLS0tLS0tLQogZHJpdmVycy9ncHUv ZHJtL2k5MTUvaW50ZWxfZ3VjX2Z3aWYuaCAgICAgIHwgIDQgKy0tCiBkcml2ZXJzL2dwdS9kcm0v aTkxNS9pbnRlbF91Yy5oICAgICAgICAgICAgfCAgNiArKystLQogMyBmaWxlcyBjaGFuZ2VkLCAz MyBpbnNlcnRpb25zKCspLCAxOSBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9kcml2ZXJzL2dw dS9kcm0vaTkxNS9pOTE1X2d1Y19zdWJtaXNzaW9uLmMgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9p OTE1X2d1Y19zdWJtaXNzaW9uLmMKaW5kZXggYjNkMWQ1Yy4uYzAyMTY3YyAxMDA2NDQKLS0tIGEv ZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9ndWNfc3VibWlzc2lvbi5jCisrKyBiL2RyaXZlcnMv Z3B1L2RybS9pOTE1L2k5MTVfZ3VjX3N1Ym1pc3Npb24uYwpAQCAtMzAsMTYgKzMwLDI1IEBACiAv KioKICAqIERPQzogR3VDLWJhc2VkIGNvbW1hbmQgc3VibWlzc2lvbgogICoKLSAqIGk5MTVfZ3Vj X2NsaWVudDoKLSAqIFdlIHVzZSB0aGUgdGVybSBjbGllbnQgdG8gYXZvaWQgY29uZnVzaW9uIHdp dGggY29udGV4dHMuIEEgaTkxNV9ndWNfY2xpZW50IGlzCi0gKiBlcXVpdmFsZW50IHRvIEd1QyBv YmplY3QgZ3VjX2NvbnRleHRfZGVzYy4gVGhpcyBjb250ZXh0IGRlc2NyaXB0b3IgaXMKLSAqIGFs bG9jYXRlZCBmcm9tIGEgcG9vbCBvZiAxMDI0IGVudHJpZXMuIEtlcm5lbCBkcml2ZXIgd2lsbCBh bGxvY2F0ZSBkb29yYmVsbAotICogYW5kIHdvcmtxdWV1ZSBmb3IgaXQuIEFsc28gdGhlIHByb2Nl c3MgZGVzY3JpcHRvciAoZ3VjX3Byb2Nlc3NfZGVzYyksIHdoaWNoCi0gKiBpcyBtYXBwZWQgdG8g Y2xpZW50IHNwYWNlLiBTbyB0aGUgY2xpZW50IGNhbiB3cml0ZSBXb3JrIEl0ZW0gdGhlbiByaW5n IHRoZQotICogZG9vcmJlbGwuCisgKiBHdUMgY2xpZW50OgorICogQSBpOTE1X2d1Y19jbGllbnQg cmVmZXJzIHRvIGEgc3VibWlzc2lvbiBwYXRoIHRocm91Z2ggR3VDLiBDdXJyZW50bHksIHRoZXJl CisgKiBpcyBvbmx5IG9uZSBvZiB0aGVzZSAodGhlIGV4ZWNidWZfY2xpZW50KSBhbmQgdGhpcyBv bmUgaXMgY2hhcmdlZCB3aXRoIGFsbAorICogc3VibWlzc2lvbnMgdG8gdGhlIEd1Qy4gVGhpcyBz dHJ1Y3QgaXMgdGhlIG93bmVyIG9mIGEgZG9vcmJlbGwsIGEgcHJvY2VzcworICogZGVzY3JpcHRv ciBhbmQgYSB3b3JrcXVldWUgKGFsbCBvZiB0aGVtIGluc2lkZSBhIHNpbmdsZSBnZW0gb2JqZWN0 IHRoYXQKKyAqIGNvbnRhaW5zIGFsbCByZXF1aXJlZCBwYWdlcyBmb3IgdGhlc2UgZWxlbWVudHMp LgogICoKLSAqIFRvIHNpbXBsaWZ5IHRoZSBpbXBsZW1lbnRhdGlvbiwgd2UgYWxsb2NhdGUgb25l IGdlbSBvYmplY3QgdGhhdCBjb250YWlucyBhbGwKLSAqIHBhZ2VzIGZvciBkb29yYmVsbCwgcHJv Y2VzcyBkZXNjcmlwdG9yIGFuZCB3b3JrcXVldWUuCisgKiBHdUMgY29udGV4dCBkZXNjcmlwdG9y OgorICogRHVyaW5nIGluaXRpYWxpemF0aW9uLCB0aGUgZHJpdmVyIGFsbG9jYXRlcyBhIHN0YXRp YyBwb29sIG9mIDEwMjQgc3VjaAorICogZGVzY3JpcHRvcnMsIGFuZCBzaGFyZXMgdGhlbSB3aXRo IHRoZSBHdUMuCisgKiBDdXJyZW50bHksIHRoZXJlIGV4aXN0cyBhIDE6MSBtYXBwaW5nIGJldHdl ZW4gYSBpOTE1X2d1Y19jbGllbnQgYW5kIGEKKyAqIGd1Y19jb250ZXh0X2Rlc2MgKHZpYSB0aGUg Y2xpZW50J3MgY29udGV4dF9pbmRleCksIHNvIGVmZmVjdGl2ZWx5IG9ubHkKKyAqIG9uZSBndWNf Y29udGV4dF9kZXNjIGdldHMgdXNlZC4gVGhpcyBjb250ZXh0IGRlc2NyaXB0b3IgbGV0cyB0aGUg R3VDIGtub3cKKyAqIGFib3V0IHRoZSBkb29yYmVsbCwgd29ya3F1ZXVlIGFuZCBwcm9jZXNzIGRl c2NyaXB0b3IuIFRoZW9yZXRpY2FsbHksIGl0IGFsc28KKyAqIGxldHMgdGhlIEd1QyBrbm93IGFi b3V0IG91ciBIVyBjb250ZXh0cyAoQ29udGV4dCBJRCwgZXRjLi4uKSwgYnV0IHdlIGFjdHVhbGx5 CisgKiBlbXBsb3kgYSBraW5kIG9mIHN1Ym1pc3Npb24gd2hlcmUgdGhlIEd1QyB1c2VzIHRoZSBM UkNBIHNlbnQgdmlhIHRoZSB3b3JrCisgKiBpdGVtIGluc3RlYWQgKHRoZSBzaW5nbGUgZ3VjX2Nv bnRleHRfZGVzYyBhc3NvY2lhdGVkIHRvIGV4ZWNidWYgY2xpZW50CisgKiBjb250YWlucyBpbmZv cm1hdGlvbiBhYm91dCB0aGUgZGVmYXVsdCBrZXJuZWwgY29udGV4dCBvbmx5LCBidXQgdGhpcyBp cworICogZXNzZW50aWFsbHkgdW51c2VkKS4gVGhpcyBpcyBjYWxsZWQgYSAicHJveHkiIHN1Ym1p c3Npb24uCiAgKgogICogVGhlIFNjcmF0Y2ggcmVnaXN0ZXJzOgogICogVGhlcmUgYXJlIDE2IE1N SU8tYmFzZWQgcmVnaXN0ZXJzIHN0YXJ0IGZyb20gMHhDMTgwLiBUaGUga2VybmVsIGRyaXZlciB3 cml0ZXMKQEAgLTMwOCwxMCArMzE3LDE3IEBAIHN0YXRpYyB2b2lkIGd1Y19jdHhfZGVzY19pbml0 KHN0cnVjdCBpbnRlbF9ndWMgKmd1YywKIAkJaWYgKCFjZS0+c3RhdGUpCiAJCQlicmVhazsJLyog WFhYOiBjb250aW51ZT8gKi8KIAorCQkvKgorCQkgKiBYWFg6IFdoZW4gdGhpcyBpcyBhIEdVQ19D VFhfREVTQ19BVFRSX0tFUk5FTCBjbGllbnQgKHByb3h5CisJCSAqIHN1Ym1pc3Npb24gb3IsIGlu IG90aGVyIHdvcmRzLCBub3QgdXNpbmcgYSBkaXJlY3Qgc3VibWlzc2lvbgorCQkgKiBtb2RlbCkg dGhlIEtNRCdzIExSQ0EgaXMgbm90IHVzZWQgZm9yIGFueSB3b3JrIHN1Ym1pc3Npb24uCisJCSAq IEluc3RlYWQsIHRoZSBHdUMgdXNlcyB0aGUgTFJDQSBvZiB0aGUgdXNlciBtb2RlIGNvbnRleHQg KHNlZQorCQkgKiBndWNfd3FfaXRlbV9hcHBlbmQgYmVsb3cpLgorCQkgKi8KIAkJbHJjLT5jb250 ZXh0X2Rlc2MgPSBsb3dlcl8zMl9iaXRzKGNlLT5scmNfZGVzYyk7CiAKIAkJLyogVGhlIHN0YXRl IHBhZ2UgaXMgYWZ0ZXIgUFBIV1NQICovCi0JCWxyYy0+cmluZ19sY3JhID0KKwkJbHJjLT5yaW5n X2xyY2EgPQogCQkJZ3VjX2dndHRfb2Zmc2V0KGNlLT5zdGF0ZSkgKyBMUkNfU1RBVEVfUE4gKiBQ QUdFX1NJWkU7CiAJCWxyYy0+Y29udGV4dF9pZCA9IChjbGllbnQtPmN0eF9pbmRleCA8PCBHVUNf RUxDX0NUWElEX09GRlNFVCkgfAogCQkJCShndWNfZW5naW5lX2lkIDw8IEdVQ19FTENfRU5HSU5F X09GRlNFVCk7CkBAIC0zNDEsMTAgKzM1Nyw2IEBAIHN0YXRpYyB2b2lkIGd1Y19jdHhfZGVzY19p bml0KHN0cnVjdCBpbnRlbF9ndWMgKmd1YywKIAlkZXNjLT53cV9hZGRyID0gZ2Z4X2FkZHIgKyBj bGllbnQtPndxX29mZnNldDsKIAlkZXNjLT53cV9zaXplID0gY2xpZW50LT53cV9zaXplOwogCi0J LyoKLQkgKiBYWFg6IFRha2UgTFJDcyBmcm9tIGFuIGV4aXN0aW5nIGNvbnRleHQgaWYgdGhpcyBp cyBub3QgYW4KLQkgKiBJc0tNRENyZWF0ZWRDb250ZXh0IGNsaWVudAotCSAqLwogCWRlc2MtPmRl c2NfcHJpdmF0ZSA9ICh1aW50cHRyX3QpY2xpZW50OwogfQogCkBAIC00NjgsNyArNDgwLDcgQEAg c3RhdGljIHZvaWQgZ3VjX3dxX2l0ZW1fYXBwZW5kKHN0cnVjdCBpOTE1X2d1Y19jbGllbnQgKmNs aWVudCwKIAkvKiBUaGUgR3VDIHdhbnRzIG9ubHkgdGhlIGxvdy1vcmRlciB3b3JkIG9mIHRoZSBj b250ZXh0IGRlc2NyaXB0b3IgKi8KIAl3cWktPmNvbnRleHRfZGVzYyA9ICh1MzIpaW50ZWxfbHJf Y29udGV4dF9kZXNjcmlwdG9yKHJxLT5jdHgsIGVuZ2luZSk7CiAKLQl3cWktPnJpbmdfdGFpbCA9 IHRhaWwgPDwgV1FfUklOR19UQUlMX1NISUZUOworCXdxaS0+c3VibWl0X2VsZW1lbnRfaW5mbyA9 IHRhaWwgPDwgV1FfUklOR19UQUlMX1NISUZUOwogCXdxaS0+ZmVuY2VfaWQgPSBycS0+Z2xvYmFs X3NlcW5vOwogfQogCmRpZmYgLS1naXQgYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9ndWNf ZndpZi5oIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfZ3VjX2Z3aWYuaAppbmRleCAzYWU4 Y2VmLi40ZWRmNDBmIDEwMDY0NAotLS0gYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9ndWNf ZndpZi5oCisrKyBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX2d1Y19md2lmLmgKQEAgLTI1 MSw3ICsyNTEsNyBAQCBzdHJ1Y3QgZ3VjX2Rvb3JiZWxsX2luZm8gewogc3RydWN0IGd1Y193cV9p dGVtIHsKIAl1MzIgaGVhZGVyOwogCXUzMiBjb250ZXh0X2Rlc2M7Ci0JdTMyIHJpbmdfdGFpbDsK Kwl1MzIgc3VibWl0X2VsZW1lbnRfaW5mbzsKIAl1MzIgZmVuY2VfaWQ7CiB9IF9fcGFja2VkOwog CkBAIC0yNzgsNyArMjc4LDcgQEAgc3RydWN0IGd1Y19leGVjbGlzdF9jb250ZXh0IHsKIAl1MzIg Y29udGV4dF9kZXNjOwogCXUzMiBjb250ZXh0X2lkOwogCXUzMiByaW5nX3N0YXR1czsKLQl1MzIg cmluZ19sY3JhOworCXUzMiByaW5nX2xyY2E7CiAJdTMyIHJpbmdfYmVnaW47CiAJdTMyIHJpbmdf ZW5kOwogCXUzMiByaW5nX25leHRfZnJlZV9sb2NhdGlvbjsKZGlmZiAtLWdpdCBhL2RyaXZlcnMv Z3B1L2RybS9pOTE1L2ludGVsX3VjLmggYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF91Yy5o CmluZGV4IDNlYzU0YTEuLjY1ZDBiNTkgMTAwNjQ0Ci0tLSBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1 L2ludGVsX3VjLmgKKysrIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfdWMuaApAQCAtMzQs NyArMzQsOSBAQAogCiAvKgogICogVGhpcyBzdHJ1Y3R1cmUgcHJpbWFyaWx5IGRlc2NyaWJlcyB0 aGUgR0VNIG9iamVjdCBzaGFyZWQgd2l0aCB0aGUgR3VDLgotICogVGhlIEdFTSBvYmplY3QgaXMg aGVsZCBmb3IgdGhlIGVudGlyZSBsaWZldGltZSBvZiBvdXIgaW50ZXJhY3Rpb24gd2l0aAorICog VGhlIHNwZWNzIHNvbWV0aW1lcyByZWZlciB0byB0aGlzIG9iamVjdCBhcyBhICJHdUMgY29udGV4 dCIsIGJ1dCB3ZSB1c2UKKyAqIHRoZSB0ZXJtICJjbGllbnQiIHRvIGF2b2lkIGNvbmZ1c2lvbiB3 aXRoIGhhcmR3YXJlIGNvbnRleHRzLiBUaGlzCisgKiBHRU0gb2JqZWN0IGlzIGhlbGQgZm9yIHRo ZSBlbnRpcmUgbGlmZXRpbWUgb2Ygb3VyIGludGVyYWN0aW9uIHdpdGgKICAqIHRoZSBHdUMsIGJl aW5nIGFsbG9jYXRlZCBiZWZvcmUgdGhlIEd1QyBpcyBsb2FkZWQgd2l0aCBpdHMgZmlybXdhcmUu CiAgKiBCZWNhdXNlIHRoZXJlJ3Mgbm8gd2F5IHRvIHVwZGF0ZSB0aGUgYWRkcmVzcyB1c2VkIGJ5 IHRoZSBHdUMgYWZ0ZXIKICAqIGluaXRpYWxpc2F0aW9uLCB0aGUgc2hhcmVkIG9iamVjdCBtdXN0 IHN0YXkgcGlubmVkIGludG8gdGhlIEdHVFQgYXMKQEAgLTQ0LDcgKzQ2LDcgQEAKICAqCiAgKiBU aGUgc2luZ2xlIEdFTSBvYmplY3QgZGVzY3JpYmVkIGhlcmUgaXMgYWN0dWFsbHkgbWFkZSB1cCBv ZiBzZXZlcmFsCiAgKiBzZXBhcmF0ZSBhcmVhcywgYXMgZmFyIGFzIHRoZSBHdUMgaXMgY29uY2Vy bmVkLiBUaGUgZmlyc3QgcGFnZSAoa2VwdAotICoga21hcCdkKSBpbmNsdWRlcyB0aGUgInByb2Nl c3MgZGVjcmlwdG9yIiB3aGljaCBob2xkcyBzZXF1ZW5jZSBkYXRhIGZvcgorICoga21hcCdkKSBp bmNsdWRlcyB0aGUgInByb2Nlc3MgZGVzY3JpcHRvciIgd2hpY2ggaG9sZHMgc2VxdWVuY2UgZGF0 YSBmb3IKICAqIHRoZSBkb29yYmVsbCwgYW5kIG9uZSBjYWNoZWxpbmUgd2hpY2ggYWN0dWFsbHkg KmlzKiB0aGUgZG9vcmJlbGw7IGEKICAqIHdyaXRlIHRvIHRoaXMgd2lsbCAicmluZyB0aGUgZG9v cmJlbGwiIChpLmUuIHNlbmQgYW4gaW50ZXJydXB0IHRvIHRoZQogICogR3VDKS4gVGhlIHN1YnNl cXVlbnQgIHBhZ2VzIG9mIHRoZSBjbGllbnQgb2JqZWN0IGNvbnN0aXR1dGUgdGhlIHdvcmsKLS0g CjEuOS4xCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpJ bnRlbC1nZnggbWFpbGluZyBsaXN0CkludGVsLWdmeEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0 cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9pbnRlbC1nZngK