From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniele Ceraolo Spurio Subject: Re: [07/11] drm/i915/guc: Improve the GuC documentation & comments about proxy submissions Date: Mon, 13 Mar 2017 14:37:10 -0700 Message-ID: <434c8edb-0bdd-1f42-4e71-81420a7d5b59@intel.com> References: <1489163337-36080-1-git-send-email-oscar.mateo@intel.com> <1489163337-36080-8-git-send-email-oscar.mateo@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by gabe.freedesktop.org (Postfix) with ESMTPS id B76E96E52C for ; Mon, 13 Mar 2017 21:37:11 +0000 (UTC) In-Reply-To: <1489163337-36080-8-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: Oscar Mateo , intel-gfx@lists.freedesktop.org List-Id: intel-gfx@lists.freedesktop.org CgpPbiAxMC8wMy8xNyAwODoyOCwgT3NjYXIgTWF0ZW8gd3JvdGU6Cj4gV2hpbGUgYXQgaXQsIGZp eCBhIHR5cG8gKHMvcmluZ19sY3JhL3JpbmdfbHJjYSkgYW5kIGltcHJvdmUgdGhlIG5hbWluZyBv ZiBvbmUKPiBmaXJ3YXJlIGludGVyZmFjZSBmaWVsZCAocy9yaW5nX3RhaWwvc3VibWl0X2VsZW1l bnRfaW5mbywgc2luY2UgaXQgY2FuIGNvbnRhaW4KPiBtb3JlIHRoYW4ganVzdCB0aGUgcmluZyB0 YWlsKS4KPgo+IE5vIGNoYW5nZSBpbiBmdW5jdGlvbmFsaXR5Lgo+Cj4gU2lnbmVkLW9mZi1ieTog T3NjYXIgTWF0ZW8gPG9zY2FyLm1hdGVvQGludGVsLmNvbT4KPiAtLS0KPiAgZHJpdmVycy9ncHUv ZHJtL2k5MTUvaTkxNV9ndWNfc3VibWlzc2lvbi5jIHwgNDIgKysrKysrKysrKysrKysrKysrKy0t LS0tLS0tLS0tCj4gIGRyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX2d1Y19md2lmLmggICAgICB8 ICA0ICstLQo+ICAyIGZpbGVzIGNoYW5nZWQsIDI5IGluc2VydGlvbnMoKyksIDE3IGRlbGV0aW9u cygtKQo+Cj4gZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfZ3VjX3N1Ym1p c3Npb24uYyBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfZ3VjX3N1Ym1pc3Npb24uYwo+IGlu ZGV4IDk5NmU5ZjMuLjRlODJiZTYgMTAwNjQ0Cj4gLS0tIGEvZHJpdmVycy9ncHUvZHJtL2k5MTUv aTkxNV9ndWNfc3VibWlzc2lvbi5jCj4gKysrIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9n dWNfc3VibWlzc2lvbi5jCj4gQEAgLTI4LDE2ICsyOCwyNSBAQAo+ICAvKioKPiAgICogRE9DOiBH dUMtYmFzZWQgY29tbWFuZCBzdWJtaXNzaW9uCj4gICAqCj4gLSAqIGk5MTVfZ3VjX2NsaWVudDoK PiAtICogV2UgdXNlIHRoZSB0ZXJtIGNsaWVudCB0byBhdm9pZCBjb25mdXNpb24gd2l0aCBjb250 ZXh0cy4gQSBpOTE1X2d1Y19jbGllbnQgaXMKPiAtICogZXF1aXZhbGVudCB0byBHdUMgb2JqZWN0 IGd1Y19jb250ZXh0X2Rlc2MuIFRoaXMgY29udGV4dCBkZXNjcmlwdG9yIGlzCj4gLSAqIGFsbG9j YXRlZCBmcm9tIGEgcG9vbCBvZiAxMDI0IGVudHJpZXMuIEtlcm5lbCBkcml2ZXIgd2lsbCBhbGxv Y2F0ZSBkb29yYmVsbAo+IC0gKiBhbmQgd29ya3F1ZXVlIGZvciBpdC4gQWxzbyB0aGUgcHJvY2Vz cyBkZXNjcmlwdG9yIChndWNfcHJvY2Vzc19kZXNjKSwgd2hpY2gKPiAtICogaXMgbWFwcGVkIHRv IGNsaWVudCBzcGFjZS4gU28gdGhlIGNsaWVudCBjYW4gd3JpdGUgV29yayBJdGVtIHRoZW4gcmlu ZyB0aGUKPiAtICogZG9vcmJlbGwuCj4gKyAqIEd1QyBjbGllbnQ6Cj4gKyAqIEEgaTkxNV9ndWNf Y2xpZW50IHJlZmVycyB0byBhIHVuaXF1ZSB1c2VyIG9mIHRoZSBHdUMuIEN1cnJlbnRseSwgdGhl cmUgaXMKCkFmdGVyIHJlLXJlYWRpbmcgdGhpcyBJIHRoaW5rIHRoYXQgbWF0Y2hpbmcgYSBjbGll bnQgd2l0aCBhICJ1bmlxdWUgCnVzZXIiIGlzIHNsaWdodGx5IG1pc2xlYWRpbmcgYmVjYXVzZSBp OTE1IGNhbiBoYXZlIG11bHRpcGxlIAppOTE1X2d1Y19jbGllbnQgb2JqZWN0cyBidXQgaXQgc3Rp bGwgY291bnRzIGFzIGEgc2luZ2xlIHVzZXIuIE1heWJlIHdlIApjb3VsZCBkZWZpbmUgdGhlIGNs aWVudCBhcyBhICJzdWJtaXNzaW9uIHBhdGgiIHRocm91Z2ggR3VDIChhIHNldCBvZiAKd29yay1x dWV1ZSwgZG9vcmJlbGwsIHByaW9yaXR5KSBvciBzb21ldGhpbmcgc2ltaWxhci4KCkl0IG1pZ2h0 IGJlIGFsc28gd29ydGgga2VlcGluZyB0aGUgc3RhdGVtZW50IGFib3V0IHRoZSB0ZXJtICJjbGll bnQiIApiZWluZyBpbnRyb2R1Y2VkIGJ5IHVzIHRvIHJlZHVjZSBjb25mdXNpb24uCgpUaGFua3Ms CkRhbmllbGUKCj4gKyAqIG9ubHkgb25lIG9mIHRoZXNlICh0aGUgZXhlY2J1Zl9jbGllbnQpIGFu ZCB0aGlzIG9uZSBpcyBjaGFyZ2VkIHdpdGggYWxsCj4gKyAqIHN1Ym1pc3Npb25zIHRvIHRoZSBH dUMuIFRoaXMgc3RydWN0IGlzIHRoZSBvd25lciBvZiBhIGRvb3JiZWxsLCBhIHByb2Nlc3MKPiAr ICogZGVzY3JpcHRvciBhbmQgYSB3b3JrcXVldWUgKGFsbCBvZiB0aGVtIGluc2lkZSBhIHNpbmds ZSBnZW0gb2JqZWN0IHRoYXQKPiArICogY29udGFpbnMgYWxsIHJlcXVpcmVkIHBhZ2VzIGZvciB0 aGVzZSBlbGVtZW50cykuCj4gICAqCj4gLSAqIFRvIHNpbXBsaWZ5IHRoZSBpbXBsZW1lbnRhdGlv biwgd2UgYWxsb2NhdGUgb25lIGdlbSBvYmplY3QgdGhhdCBjb250YWlucyBhbGwKPiAtICogcGFn ZXMgZm9yIGRvb3JiZWxsLCBwcm9jZXNzIGRlc2NyaXB0b3IgYW5kIHdvcmtxdWV1ZS4KPiArICog R3VDIGNvbnRleHQgZGVzY3JpcHRvcjoKPiArICogRHVyaW5nIGluaXRpYWxpemF0aW9uLCB0aGUg ZHJpdmVyIGFsbG9jYXRlcyBhIHN0YXRpYyBwb29sIG9mIDEwMjQgc3VjaAo+ICsgKiBkZXNjcmlw dG9ycywgYW5kIHNoYXJlcyB0aGVtIHdpdGggdGhlIEd1Qy4KPiArICogQ3VycmVudGx5LCB0aGVy ZSBleGlzdHMgYSAxOjEgbWFwcGluZyBiZXR3ZWVuIGEgaTkxNV9ndWNfY2xpZW50IGFuZCBhCj4g KyAqIGd1Y19jb250ZXh0X2Rlc2MgKHZpYSB0aGUgY2xpZW50J3MgY29udGV4dF9pbmRleCksIHNv IGVmZmVjdGl2ZWx5IG9ubHkKPiArICogb25lIGd1Y19jb250ZXh0X2Rlc2MgZ2V0cyB1c2VkLiBU aGlzIGNvbnRleHQgZGVzY3JpcHRvciBsZXRzIHRoZSBHdUMga25vdwo+ICsgKiBhYm91dCB0aGUg ZG9vcmJlbGwsIHdvcmtxdWV1ZSBhbmQgcHJvY2VzcyBkZXNjcmlwdG9yLiBUaGVvcmV0aWNhbGx5 LCBpdCBhbHNvCj4gKyAqIGxldHMgdGhlIEd1QyBrbm93IGFib3V0IG91ciBIVyBjb250ZXh0cyAo Q29udGV4dCBJRCwgZXRjLi4uKSwgYnV0IHdlIGFjdHVhbGx5Cj4gKyAqIGVtcGxveSBhIGtpbmQg b2Ygc3VibWlzc2lvbiB3aGVyZSB0aGUgR3VDIHVzZXMgdGhlIExSQ0Egc2VudCB2aWEgdGhlIHdv cmsKPiArICogaXRlbSBpbnN0ZWFkICh0aGUgc2luZ2xlIGd1Y19jb250ZXh0X2Rlc2MgYXNzb2Np YXRlZCB0byBleGVjYnVmIGNsaWVudAo+ICsgKiBjb250YWlucyBpbmZvcm1hdGlvbiBhYm91dCB0 aGUgZGVmYXVsdCBrZXJuZWwgY29udGV4dCBvbmx5LCBidXQgdGhpcyBpcwo+ICsgKiBlc3NlbnRp YWxseSB1bnVzZWQpLiBUaGlzIGlzIGNhbGxlZCBhICJwcm94eSIgc3VibWlzc2lvbi4KPiAgICoK PiAgICogVGhlIFNjcmF0Y2ggcmVnaXN0ZXJzOgo+ICAgKiBUaGVyZSBhcmUgMTYgTU1JTy1iYXNl ZCByZWdpc3RlcnMgc3RhcnQgZnJvbSAweEMxODAuIFRoZSBrZXJuZWwgZHJpdmVyIHdyaXRlcwo+ IEBAIC0zMDgsMTAgKzMxNywxNyBAQCBzdGF0aWMgdm9pZCBndWNfY3R4X2Rlc2NfaW5pdChzdHJ1 Y3QgaW50ZWxfZ3VjICpndWMsCj4gIAkJaWYgKCFjZS0+c3RhdGUpCj4gIAkJCWJyZWFrOwkvKiBY WFg6IGNvbnRpbnVlPyAqLwo+Cj4gKwkJLyoKPiArCQkgKiBYWFg6IFdoZW4gdGhpcyBpcyBhIEdV Q19DVFhfREVTQ19BVFRSX0tFUk5FTCBjbGllbnQgKHByb3h5Cj4gKwkJICogc3VibWlzc2lvbiBv ciwgaW4gb3RoZXIgd29yZHMsIG5vdCB1c2luZyBhIGRpcmVjdCBzdWJtaXNzaW9uCj4gKwkJICog bW9kZWwpIHRoZSBLTUQncyBMUkNBIGlzIG5vdCB1c2VkIGZvciBhbnkgd29yayBzdWJtaXNzaW9u Lgo+ICsJCSAqIEluc3RlYWQsIHRoZSBHdUMgdXNlcyB0aGUgTFJDQSBvZiB0aGUgdXNlciBtb2Rl IGNvbnRleHQgKHNlZQo+ICsJCSAqIGd1Y193cV9pdGVtX2FwcGVuZCBiZWxvdykuCj4gKwkJICov Cj4gIAkJbHJjLT5jb250ZXh0X2Rlc2MgPSBsb3dlcl8zMl9iaXRzKGNlLT5scmNfZGVzYyk7Cj4K PiAgCQkvKiBUaGUgc3RhdGUgcGFnZSBpcyBhZnRlciBQUEhXU1AgKi8KPiAtCQlscmMtPnJpbmdf bGNyYSA9Cj4gKwkJbHJjLT5yaW5nX2xyY2EgPQo+ICAJCQlndWNfZ2d0dF9vZmZzZXQoY2UtPnN0 YXRlKSArIExSQ19TVEFURV9QTiAqIFBBR0VfU0laRTsKPiAgCQlscmMtPmNvbnRleHRfaWQgPSAo Y2xpZW50LT5jdHhfaW5kZXggPDwgR1VDX0VMQ19DVFhJRF9PRkZTRVQpIHwKPiAgCQkJCShndWNf ZW5naW5lX2lkIDw8IEdVQ19FTENfRU5HSU5FX09GRlNFVCk7Cj4gQEAgLTM0MiwxMCArMzU4LDYg QEAgc3RhdGljIHZvaWQgZ3VjX2N0eF9kZXNjX2luaXQoc3RydWN0IGludGVsX2d1YyAqZ3VjLAo+ ICAJZGVzYy0+d3FfYWRkciA9IGdmeF9hZGRyICsgY2xpZW50LT53cV9vZmZzZXQ7Cj4gIAlkZXNj LT53cV9zaXplID0gY2xpZW50LT53cV9zaXplOwo+Cj4gLQkvKgo+IC0JICogWFhYOiBUYWtlIExS Q3MgZnJvbSBhbiBleGlzdGluZyBjb250ZXh0IGlmIHRoaXMgaXMgbm90IGFuCj4gLQkgKiBJc0tN RENyZWF0ZWRDb250ZXh0IGNsaWVudAo+IC0JICovCj4gIAlkZXNjLT5kZXNjX3ByaXZhdGUgPSAo dWludHB0cl90KWNsaWVudDsKPiAgfQo+Cj4gQEAgLTQ2OSw3ICs0ODEsNyBAQCBzdGF0aWMgdm9p ZCBndWNfd3FfaXRlbV9hcHBlbmQoc3RydWN0IGk5MTVfZ3VjX2NsaWVudCAqY2xpZW50LAo+ICAJ LyogVGhlIEd1QyB3YW50cyBvbmx5IHRoZSBsb3ctb3JkZXIgd29yZCBvZiB0aGUgY29udGV4dCBk ZXNjcmlwdG9yICovCj4gIAl3cWktPmNvbnRleHRfZGVzYyA9ICh1MzIpaW50ZWxfbHJfY29udGV4 dF9kZXNjcmlwdG9yKHJxLT5jdHgsIGVuZ2luZSk7Cj4KPiAtCXdxaS0+cmluZ190YWlsID0gdGFp bCA8PCBXUV9SSU5HX1RBSUxfU0hJRlQ7Cj4gKwl3cWktPnN1Ym1pdF9lbGVtZW50X2luZm8gPSB0 YWlsIDw8IFdRX1JJTkdfVEFJTF9TSElGVDsKPiAgCXdxaS0+ZmVuY2VfaWQgPSBycS0+Z2xvYmFs X3NlcW5vOwo+ICB9Cj4KPiBkaWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxf Z3VjX2Z3aWYuaCBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX2d1Y19md2lmLmgKPiBpbmRl eCAzYWU4Y2VmLi40ZWRmNDBmIDEwMDY0NAo+IC0tLSBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2lu dGVsX2d1Y19md2lmLmgKPiArKysgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9ndWNfZndp Zi5oCj4gQEAgLTI1MSw3ICsyNTEsNyBAQCBzdHJ1Y3QgZ3VjX2Rvb3JiZWxsX2luZm8gewo+ICBz dHJ1Y3QgZ3VjX3dxX2l0ZW0gewo+ICAJdTMyIGhlYWRlcjsKPiAgCXUzMiBjb250ZXh0X2Rlc2M7 Cj4gLQl1MzIgcmluZ190YWlsOwo+ICsJdTMyIHN1Ym1pdF9lbGVtZW50X2luZm87Cj4gIAl1MzIg ZmVuY2VfaWQ7Cj4gIH0gX19wYWNrZWQ7Cj4KPiBAQCAtMjc4LDcgKzI3OCw3IEBAIHN0cnVjdCBn dWNfZXhlY2xpc3RfY29udGV4dCB7Cj4gIAl1MzIgY29udGV4dF9kZXNjOwo+ICAJdTMyIGNvbnRl eHRfaWQ7Cj4gIAl1MzIgcmluZ19zdGF0dXM7Cj4gLQl1MzIgcmluZ19sY3JhOwo+ICsJdTMyIHJp bmdfbHJjYTsKPiAgCXUzMiByaW5nX2JlZ2luOwo+ICAJdTMyIHJpbmdfZW5kOwo+ICAJdTMyIHJp bmdfbmV4dF9mcmVlX2xvY2F0aW9uOwo+Cl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fCkludGVsLWdmeCBtYWlsaW5nIGxpc3QKSW50ZWwtZ2Z4QGxpc3RzLmZy ZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3Rp bmZvL2ludGVsLWdmeAo=