From mboxrd@z Thu Jan  1 00:00:00 1970
From: Oscar Mateo <oscar.mateo@intel.com>
Subject: [07/11] drm/i915/guc: Improve the GuC documentation &
	comments about proxy submissions
Date: Fri, 10 Mar 2017 08:28:54 -0800
Message-ID: <1489163337-36080-8-git-send-email-oscar.mateo@intel.com>
References: <1489163337-36080-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: <intel-gfx-bounces@lists.freedesktop.org>
Received: from mga01.intel.com (mga01.intel.com [192.55.52.88])
 by gabe.freedesktop.org (Postfix) with ESMTPS id 555DE6E11A
 for <intel-gfx@lists.freedesktop.org>; Sat, 11 Mar 2017 00:28:49 +0000 (UTC)
In-Reply-To: <1489163337-36080-1-git-send-email-oscar.mateo@intel.com>
List-Unsubscribe: <https://lists.freedesktop.org/mailman/options/intel-gfx>,
 <mailto:intel-gfx-request@lists.freedesktop.org?subject=unsubscribe>
List-Archive: <https://lists.freedesktop.org/archives/intel-gfx>
List-Post: <mailto:intel-gfx@lists.freedesktop.org>
List-Help: <mailto:intel-gfx-request@lists.freedesktop.org?subject=help>
List-Subscribe: <https://lists.freedesktop.org/mailman/listinfo/intel-gfx>,
 <mailto:intel-gfx-request@lists.freedesktop.org?subject=subscribe>
Errors-To: intel-gfx-bounces@lists.freedesktop.org
Sender: "Intel-gfx" <intel-gfx-bounces@lists.freedesktop.org>
To: intel-gfx@lists.freedesktop.org
List-Id: intel-gfx@lists.freedesktop.org

V2hpbGUgYXQgaXQsIGZpeCBhIHR5cG8gKHMvcmluZ19sY3JhL3JpbmdfbHJjYSkgYW5kIGltcHJv
dmUgdGhlIG5hbWluZyBvZiBvbmUKZmlyd2FyZSBpbnRlcmZhY2UgZmllbGQgKHMvcmluZ190YWls
L3N1Ym1pdF9lbGVtZW50X2luZm8sIHNpbmNlIGl0IGNhbiBjb250YWluCm1vcmUgdGhhbiBqdXN0
IHRoZSByaW5nIHRhaWwpLgoKTm8gY2hhbmdlIGluIGZ1bmN0aW9uYWxpdHkuCgpTaWduZWQtb2Zm
LWJ5OiBPc2NhciBNYXRlbyA8b3NjYXIubWF0ZW9AaW50ZWwuY29tPgotLS0KIGRyaXZlcnMvZ3B1
L2RybS9pOTE1L2k5MTVfZ3VjX3N1Ym1pc3Npb24uYyB8IDQyICsrKysrKysrKysrKysrKysrKyst
LS0tLS0tLS0tLQogZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfZ3VjX2Z3aWYuaCAgICAgIHwg
IDQgKy0tCiAyIGZpbGVzIGNoYW5nZWQsIDI5IGluc2VydGlvbnMoKyksIDE3IGRlbGV0aW9ucygt
KQoKZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfZ3VjX3N1Ym1pc3Npb24u
YyBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfZ3VjX3N1Ym1pc3Npb24uYwppbmRleCA5OTZl
OWYzLi40ZTgyYmU2IDEwMDY0NAotLS0gYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pOTE1X2d1Y19z
dWJtaXNzaW9uLmMKKysrIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9ndWNfc3VibWlzc2lv
bi5jCkBAIC0yOCwxNiArMjgsMjUgQEAKIC8qKgogICogRE9DOiBHdUMtYmFzZWQgY29tbWFuZCBz
dWJtaXNzaW9uCiAgKgotICogaTkxNV9ndWNfY2xpZW50OgotICogV2UgdXNlIHRoZSB0ZXJtIGNs
aWVudCB0byBhdm9pZCBjb25mdXNpb24gd2l0aCBjb250ZXh0cy4gQSBpOTE1X2d1Y19jbGllbnQg
aXMKLSAqIGVxdWl2YWxlbnQgdG8gR3VDIG9iamVjdCBndWNfY29udGV4dF9kZXNjLiBUaGlzIGNv
bnRleHQgZGVzY3JpcHRvciBpcwotICogYWxsb2NhdGVkIGZyb20gYSBwb29sIG9mIDEwMjQgZW50
cmllcy4gS2VybmVsIGRyaXZlciB3aWxsIGFsbG9jYXRlIGRvb3JiZWxsCi0gKiBhbmQgd29ya3F1
ZXVlIGZvciBpdC4gQWxzbyB0aGUgcHJvY2VzcyBkZXNjcmlwdG9yIChndWNfcHJvY2Vzc19kZXNj
KSwgd2hpY2gKLSAqIGlzIG1hcHBlZCB0byBjbGllbnQgc3BhY2UuIFNvIHRoZSBjbGllbnQgY2Fu
IHdyaXRlIFdvcmsgSXRlbSB0aGVuIHJpbmcgdGhlCi0gKiBkb29yYmVsbC4KKyAqIEd1QyBjbGll
bnQ6CisgKiBBIGk5MTVfZ3VjX2NsaWVudCByZWZlcnMgdG8gYSB1bmlxdWUgdXNlciBvZiB0aGUg
R3VDLiBDdXJyZW50bHksIHRoZXJlIGlzCisgKiBvbmx5IG9uZSBvZiB0aGVzZSAodGhlIGV4ZWNi
dWZfY2xpZW50KSBhbmQgdGhpcyBvbmUgaXMgY2hhcmdlZCB3aXRoIGFsbAorICogc3VibWlzc2lv
bnMgdG8gdGhlIEd1Qy4gVGhpcyBzdHJ1Y3QgaXMgdGhlIG93bmVyIG9mIGEgZG9vcmJlbGwsIGEg
cHJvY2VzcworICogZGVzY3JpcHRvciBhbmQgYSB3b3JrcXVldWUgKGFsbCBvZiB0aGVtIGluc2lk
ZSBhIHNpbmdsZSBnZW0gb2JqZWN0IHRoYXQKKyAqIGNvbnRhaW5zIGFsbCByZXF1aXJlZCBwYWdl
cyBmb3IgdGhlc2UgZWxlbWVudHMpLgogICoKLSAqIFRvIHNpbXBsaWZ5IHRoZSBpbXBsZW1lbnRh
dGlvbiwgd2UgYWxsb2NhdGUgb25lIGdlbSBvYmplY3QgdGhhdCBjb250YWlucyBhbGwKLSAqIHBh
Z2VzIGZvciBkb29yYmVsbCwgcHJvY2VzcyBkZXNjcmlwdG9yIGFuZCB3b3JrcXVldWUuCisgKiBH
dUMgY29udGV4dCBkZXNjcmlwdG9yOgorICogRHVyaW5nIGluaXRpYWxpemF0aW9uLCB0aGUgZHJp
dmVyIGFsbG9jYXRlcyBhIHN0YXRpYyBwb29sIG9mIDEwMjQgc3VjaAorICogZGVzY3JpcHRvcnMs
IGFuZCBzaGFyZXMgdGhlbSB3aXRoIHRoZSBHdUMuCisgKiBDdXJyZW50bHksIHRoZXJlIGV4aXN0
cyBhIDE6MSBtYXBwaW5nIGJldHdlZW4gYSBpOTE1X2d1Y19jbGllbnQgYW5kIGEKKyAqIGd1Y19j
b250ZXh0X2Rlc2MgKHZpYSB0aGUgY2xpZW50J3MgY29udGV4dF9pbmRleCksIHNvIGVmZmVjdGl2
ZWx5IG9ubHkKKyAqIG9uZSBndWNfY29udGV4dF9kZXNjIGdldHMgdXNlZC4gVGhpcyBjb250ZXh0
IGRlc2NyaXB0b3IgbGV0cyB0aGUgR3VDIGtub3cKKyAqIGFib3V0IHRoZSBkb29yYmVsbCwgd29y
a3F1ZXVlIGFuZCBwcm9jZXNzIGRlc2NyaXB0b3IuIFRoZW9yZXRpY2FsbHksIGl0IGFsc28KKyAq
IGxldHMgdGhlIEd1QyBrbm93IGFib3V0IG91ciBIVyBjb250ZXh0cyAoQ29udGV4dCBJRCwgZXRj
Li4uKSwgYnV0IHdlIGFjdHVhbGx5CisgKiBlbXBsb3kgYSBraW5kIG9mIHN1Ym1pc3Npb24gd2hl
cmUgdGhlIEd1QyB1c2VzIHRoZSBMUkNBIHNlbnQgdmlhIHRoZSB3b3JrCisgKiBpdGVtIGluc3Rl
YWQgKHRoZSBzaW5nbGUgZ3VjX2NvbnRleHRfZGVzYyBhc3NvY2lhdGVkIHRvIGV4ZWNidWYgY2xp
ZW50CisgKiBjb250YWlucyBpbmZvcm1hdGlvbiBhYm91dCB0aGUgZGVmYXVsdCBrZXJuZWwgY29u
dGV4dCBvbmx5LCBidXQgdGhpcyBpcworICogZXNzZW50aWFsbHkgdW51c2VkKS4gVGhpcyBpcyBj
YWxsZWQgYSAicHJveHkiIHN1Ym1pc3Npb24uCiAgKgogICogVGhlIFNjcmF0Y2ggcmVnaXN0ZXJz
OgogICogVGhlcmUgYXJlIDE2IE1NSU8tYmFzZWQgcmVnaXN0ZXJzIHN0YXJ0IGZyb20gMHhDMTgw
LiBUaGUga2VybmVsIGRyaXZlciB3cml0ZXMKQEAgLTMwOCwxMCArMzE3LDE3IEBAIHN0YXRpYyB2
b2lkIGd1Y19jdHhfZGVzY19pbml0KHN0cnVjdCBpbnRlbF9ndWMgKmd1YywKIAkJaWYgKCFjZS0+
c3RhdGUpCiAJCQlicmVhazsJLyogWFhYOiBjb250aW51ZT8gKi8KIAorCQkvKgorCQkgKiBYWFg6
IFdoZW4gdGhpcyBpcyBhIEdVQ19DVFhfREVTQ19BVFRSX0tFUk5FTCBjbGllbnQgKHByb3h5CisJ
CSAqIHN1Ym1pc3Npb24gb3IsIGluIG90aGVyIHdvcmRzLCBub3QgdXNpbmcgYSBkaXJlY3Qgc3Vi
bWlzc2lvbgorCQkgKiBtb2RlbCkgdGhlIEtNRCdzIExSQ0EgaXMgbm90IHVzZWQgZm9yIGFueSB3
b3JrIHN1Ym1pc3Npb24uCisJCSAqIEluc3RlYWQsIHRoZSBHdUMgdXNlcyB0aGUgTFJDQSBvZiB0
aGUgdXNlciBtb2RlIGNvbnRleHQgKHNlZQorCQkgKiBndWNfd3FfaXRlbV9hcHBlbmQgYmVsb3cp
LgorCQkgKi8KIAkJbHJjLT5jb250ZXh0X2Rlc2MgPSBsb3dlcl8zMl9iaXRzKGNlLT5scmNfZGVz
Yyk7CiAKIAkJLyogVGhlIHN0YXRlIHBhZ2UgaXMgYWZ0ZXIgUFBIV1NQICovCi0JCWxyYy0+cmlu
Z19sY3JhID0KKwkJbHJjLT5yaW5nX2xyY2EgPQogCQkJZ3VjX2dndHRfb2Zmc2V0KGNlLT5zdGF0
ZSkgKyBMUkNfU1RBVEVfUE4gKiBQQUdFX1NJWkU7CiAJCWxyYy0+Y29udGV4dF9pZCA9IChjbGll
bnQtPmN0eF9pbmRleCA8PCBHVUNfRUxDX0NUWElEX09GRlNFVCkgfAogCQkJCShndWNfZW5naW5l
X2lkIDw8IEdVQ19FTENfRU5HSU5FX09GRlNFVCk7CkBAIC0zNDIsMTAgKzM1OCw2IEBAIHN0YXRp
YyB2b2lkIGd1Y19jdHhfZGVzY19pbml0KHN0cnVjdCBpbnRlbF9ndWMgKmd1YywKIAlkZXNjLT53
cV9hZGRyID0gZ2Z4X2FkZHIgKyBjbGllbnQtPndxX29mZnNldDsKIAlkZXNjLT53cV9zaXplID0g
Y2xpZW50LT53cV9zaXplOwogCi0JLyoKLQkgKiBYWFg6IFRha2UgTFJDcyBmcm9tIGFuIGV4aXN0
aW5nIGNvbnRleHQgaWYgdGhpcyBpcyBub3QgYW4KLQkgKiBJc0tNRENyZWF0ZWRDb250ZXh0IGNs
aWVudAotCSAqLwogCWRlc2MtPmRlc2NfcHJpdmF0ZSA9ICh1aW50cHRyX3QpY2xpZW50OwogfQog
CkBAIC00NjksNyArNDgxLDcgQEAgc3RhdGljIHZvaWQgZ3VjX3dxX2l0ZW1fYXBwZW5kKHN0cnVj
dCBpOTE1X2d1Y19jbGllbnQgKmNsaWVudCwKIAkvKiBUaGUgR3VDIHdhbnRzIG9ubHkgdGhlIGxv
dy1vcmRlciB3b3JkIG9mIHRoZSBjb250ZXh0IGRlc2NyaXB0b3IgKi8KIAl3cWktPmNvbnRleHRf
ZGVzYyA9ICh1MzIpaW50ZWxfbHJfY29udGV4dF9kZXNjcmlwdG9yKHJxLT5jdHgsIGVuZ2luZSk7
CiAKLQl3cWktPnJpbmdfdGFpbCA9IHRhaWwgPDwgV1FfUklOR19UQUlMX1NISUZUOworCXdxaS0+
c3VibWl0X2VsZW1lbnRfaW5mbyA9IHRhaWwgPDwgV1FfUklOR19UQUlMX1NISUZUOwogCXdxaS0+
ZmVuY2VfaWQgPSBycS0+Z2xvYmFsX3NlcW5vOwogfQogCmRpZmYgLS1naXQgYS9kcml2ZXJzL2dw
dS9kcm0vaTkxNS9pbnRlbF9ndWNfZndpZi5oIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxf
Z3VjX2Z3aWYuaAppbmRleCAzYWU4Y2VmLi40ZWRmNDBmIDEwMDY0NAotLS0gYS9kcml2ZXJzL2dw
dS9kcm0vaTkxNS9pbnRlbF9ndWNfZndpZi5oCisrKyBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2lu
dGVsX2d1Y19md2lmLmgKQEAgLTI1MSw3ICsyNTEsNyBAQCBzdHJ1Y3QgZ3VjX2Rvb3JiZWxsX2lu
Zm8gewogc3RydWN0IGd1Y193cV9pdGVtIHsKIAl1MzIgaGVhZGVyOwogCXUzMiBjb250ZXh0X2Rl
c2M7Ci0JdTMyIHJpbmdfdGFpbDsKKwl1MzIgc3VibWl0X2VsZW1lbnRfaW5mbzsKIAl1MzIgZmVu
Y2VfaWQ7CiB9IF9fcGFja2VkOwogCkBAIC0yNzgsNyArMjc4LDcgQEAgc3RydWN0IGd1Y19leGVj
bGlzdF9jb250ZXh0IHsKIAl1MzIgY29udGV4dF9kZXNjOwogCXUzMiBjb250ZXh0X2lkOwogCXUz
MiByaW5nX3N0YXR1czsKLQl1MzIgcmluZ19sY3JhOworCXUzMiByaW5nX2xyY2E7CiAJdTMyIHJp
bmdfYmVnaW47CiAJdTMyIHJpbmdfZW5kOwogCXUzMiByaW5nX25leHRfZnJlZV9sb2NhdGlvbjsK
LS0gCjEuOS4xCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f
XwpJbnRlbC1nZnggbWFpbGluZyBsaXN0CkludGVsLWdmeEBsaXN0cy5mcmVlZGVza3RvcC5vcmcK
aHR0cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9pbnRlbC1nZngK