From: Daniel Vetter Subject: Re: [PATCH 2/2] drm/doc: Document the writeback prepare/cleanup jobs Date: Fri, 3 May 2019 09:18:23 +0200 Message-ID: <20190503071823.GE3271@phenom.ffwll.local> References: <20190502202449.237184-1-sean@poorly.run> <20190502202449.237184-2-sean@poorly.run> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-ed1-x542.google.com (mail-ed1-x542.google.com [IPv6:2a00:1450:4864:20::542]) by gabe.freedesktop.org (Postfix) with ESMTPS id 395D3897F0 for ; Fri, 3 May 2019 07:18:28 +0000 (UTC) Received: by mail-ed1-x542.google.com with SMTP id w33so2527501edb.10 for ; Fri, 03 May 2019 00:18:28 -0700 (PDT) Content-Disposition: inline In-Reply-To: <20190502202449.237184-2-sean@poorly.run> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Sean Paul Cc: Laurent Pinchart , Maxime Ripard , Liviu Dudau , dri-devel@lists.freedesktop.org, David Airlie , Sean Paul List-Id: dri-devel@lists.freedesktop.org T24gVGh1LCBNYXkgMDIsIDIwMTkgYXQgMDQ6MjQ6MzBQTSAtMDQwMCwgU2VhbiBQYXVsIHdyb3Rl Ogo+IEZyb206IFNlYW4gUGF1bCA8c2VhbnBhdWxAY2hyb21pdW0ub3JnPgo+IAo+IFRoZXNlIGZ1 bmN0aW9ucyB3ZXJlIG1pc3NpbmcgZG9jdW1lbnRhdGlvbi4KPiAKPiBGaXhlcyB0aGUgd2Fybmlu ZzoKPiAuLi9pbmNsdWRlL2RybS9kcm1fbW9kZXNldF9oZWxwZXJfdnRhYmxlcy5oOjEwMDA6IHdh cm5pbmc6IEZ1bmN0aW9uIHBhcmFtZXRlciBvciBtZW1iZXIgJ3ByZXBhcmVfd3JpdGViYWNrX2pv Yicgbm90IGRlc2NyaWJlZCBpbiAnZHJtX2Nvbm5lY3Rvcl9oZWxwZXJfZnVuY3MnCj4gLi4vaW5j bHVkZS9kcm0vZHJtX21vZGVzZXRfaGVscGVyX3Z0YWJsZXMuaDoxMDAwOiB3YXJuaW5nOiBGdW5j dGlvbiBwYXJhbWV0ZXIgb3IgbWVtYmVyICdjbGVhbnVwX3dyaXRlYmFja19qb2InIG5vdCBkZXNj cmliZWQgaW4gJ2RybV9jb25uZWN0b3JfaGVscGVyX2Z1bmNzJwo+IAo+IEZpeGVzOiA5ZDIyMzBk YzEzNTEgKCJkcm06IHdyaXRlYmFjazogQWRkIGpvYiBwcmVwYXJlIGFuZCBjbGVhbnVwIG9wZXJh dGlvbnMiKQo+IENjOiBMYXVyZW50IFBpbmNoYXJ0IDxsYXVyZW50LnBpbmNoYXJ0K3JlbmVzYXNA aWRlYXNvbmJvYXJkLmNvbT4KCk9oIExhdXJlbnQgZGlkbid0IHR5cGUgZG9jdW1lbnRhdGlvbiwg SSdsbCByZW1lbWJlciB0aGF0IG9uZSA6LSkKCj4gQ2M6IExpdml1IER1ZGF1IDxsaXZpdS5kdWRh dUBhcm0uY29tPgo+IENjOiBNYWFydGVuIExhbmtob3JzdCA8bWFhcnRlbi5sYW5raG9yc3RAbGlu dXguaW50ZWwuY29tPgo+IENjOiBNYXhpbWUgUmlwYXJkIDxtYXhpbWUucmlwYXJkQGJvb3RsaW4u Y29tPgo+IENjOiBTZWFuIFBhdWwgPHNlYW5AcG9vcmx5LnJ1bj4KPiBDYzogRGF2aWQgQWlybGll IDxhaXJsaWVkQGxpbnV4LmllPgo+IENjOiBEYW5pZWwgVmV0dGVyIDxkYW5pZWxAZmZ3bGwuY2g+ Cj4gQ2M6IGRyaS1kZXZlbEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKPiBTaWduZWQtb2ZmLWJ5OiBT ZWFuIFBhdWwgPHNlYW5wYXVsQGNocm9taXVtLm9yZz4KPiAtLS0KPiAgZHJpdmVycy9ncHUvZHJt L2RybV93cml0ZWJhY2suYyAgICAgICAgICB8IDIwICsrKysrKysrKysrKysrKysrKysrCj4gIGlu Y2x1ZGUvZHJtL2RybV9tb2Rlc2V0X2hlbHBlcl92dGFibGVzLmggfCAyMCArKysrKysrKysrKysr KysrKysrKwo+ICAyIGZpbGVzIGNoYW5nZWQsIDQwIGluc2VydGlvbnMoKykKPiAKPiBkaWZmIC0t Z2l0IGEvZHJpdmVycy9ncHUvZHJtL2RybV93cml0ZWJhY2suYyBiL2RyaXZlcnMvZ3B1L2RybS9k cm1fd3JpdGViYWNrLmMKPiBpbmRleCA3OWFjMDE0NzAxYzguLmVmNmY4NTk2NjU0NiAxMDA2NDQK PiAtLS0gYS9kcml2ZXJzL2dwdS9kcm0vZHJtX3dyaXRlYmFjay5jCj4gKysrIGIvZHJpdmVycy9n cHUvZHJtL2RybV93cml0ZWJhY2suYwo+IEBAIC0yNTgsNiArMjU4LDE1IEBAIGludCBkcm1fd3Jp dGViYWNrX3NldF9mYihzdHJ1Y3QgZHJtX2Nvbm5lY3Rvcl9zdGF0ZSAqY29ubl9zdGF0ZSwKPiAg CXJldHVybiAwOwo+ICB9Cj4gIAo+ICsvKioKPiArICogZHJtX3dyaXRlYmFja19wcmVwYXJlX2pv YiAtIEdpdmVzIGRyaXZlciBhIGNoYW5jZSB0byBwcmVwYXJlIGZvciB3cml0ZWJhY2sKPiArICog QGpvYjogVGhlIHdyaXRlYmFjayBqb2IgdG8gYmUgcHJlcGFyZWQKPiArICoKPiArICogVGhpcyBm dW5jdGlvbiBpcyBjYWxsZWQgZnJvbSAmZHJtX2F0b21pY19oZWxwZXJfcHJlcGFyZV9wbGFuZXMo KSwgYW5kIGFsbG93cwo+ICsgKiB0aGUgZHJpdmVyIHRvIHNldHVwIHRoZSB1cGNvbWluZyB3cml0 ZWJhY2sgam9iLiBUaGUgam9iIHdpbGwgYmUKPiArICogZGVzdHJveWVkL2NsZWFuZWQgdXAgaW4g JmRybV93cml0ZWJhY2tfY2xlYW51cF9qb2Igd2hlbiB0aGUgY29ubmVjdG9yIHN0YXRlCj4gKyAq IGlzIGRlc3Ryb3llZC4KClRoaXMgaXMgbWlzc2luZyB0aGUgc3RhbmRhcmQgIlJldHVybnMgMCBv biBzdWNjZXNzLCBuZWdhdGl2ZSBlcnJvciBjb2RlcwpvbiBmYWlsdXJlcy4iCj4gKyAqLwo+ICBp bnQgZHJtX3dyaXRlYmFja19wcmVwYXJlX2pvYihzdHJ1Y3QgZHJtX3dyaXRlYmFja19qb2IgKmpv YikKPiAgewo+ICAJc3RydWN0IGRybV93cml0ZWJhY2tfY29ubmVjdG9yICpjb25uZWN0b3IgPSBq b2ItPmNvbm5lY3RvcjsKPiBAQCAtMzEwLDYgKzMxOSwxNyBAQCB2b2lkIGRybV93cml0ZWJhY2tf cXVldWVfam9iKHN0cnVjdCBkcm1fd3JpdGViYWNrX2Nvbm5lY3RvciAqd2JfY29ubmVjdG9yLAo+ ICB9Cj4gIEVYUE9SVF9TWU1CT0woZHJtX3dyaXRlYmFja19xdWV1ZV9qb2IpOwo+ICAKPiArLyoq Cj4gKyAqIGRybV93cml0ZWJhY2tfY2xlYW51cF9qb2IgLSBHaXZlcyBkcml2ZXIgYSBjaGFuY2Ug dG8gY2xlYW51cCBhIHdyaXRlYmFjayBqb2IKPiArICogQGpvYjogVGhlIHdyaXRlYmFjayBqb2Ig dG8gYmUgY2xlYW5lZCB1cAo+ICsgKgo+ICsgKiBUaGlzIGZ1bmN0aW9uIGlzIGNhbGxlZCBmcm9t ICZhdG9taWNfaGVscGVyX2Nvbm5lY3Rvcl9kZXN0cm95X3N0YXRlKCkgYW5kCj4gKyAqIGFsbG93 cyB0aGUgZHJpdmVyIHRvIGNsZWFuIHVwIHRoZSBub3cgZmluaXNoZWQgd3JpdGViYWNrIGpvYi4K PiArICoKPiArICogTm90aWNlIHRoZSBhc3ltbWV0cnkgZnJvbSBwcmVwYXJlLCB0aGlzIGlzIGNh bGxlZCBvbiBkZXN0cm95IHRvCj4gKyAqIGVuc3VyZSB0aGUgam9iIGlzIG5vdCBkZXN0cm95ZWQg YmVmb3JlIHRoYW4gdGhlIHdyaXRlYmFjayBvcGVyYXRpb24KCnMvdGhhbi8vIEkgdGhpbmsuCgpC dXQgSSdtIG5vdCByZWFsbHkgY2xlYXIgb24gd2hhdCBleGFjdGx5IHRoZSBhc3ltbWV0cnkgaXMu CgpQbHVzIGl0J3Mgbm90IG9ubHkgY2FsbGVkIGZyb20gZGVzdHJ5X3N0YXRlLCBidXQgYWxzbyB0 aHJvdWdoIGEgd29ya2VyCnRoYXQncyBsYXVuY2hlZCBieSBkcm1fd3JpdGViYWNrX3NpZ25hbF9j b21wbGV0aW9uLgoKSSB0aGluayB5b3UncmUgZG9jcyBoZXJlIGRvbid0IHJlZmxlY3QgcmVhbGl0 eS4gQnV0IHllYWggSSB0aGluayB0aGVyZSdzCnNvbWUgYXN5bW1ldHJ5LCBhcyBpbiBjbGVhbnVw X2pvYiBpcyBhbHdheXMgY2FsbGVkLCBldmVuIGlmIHByZXBhcmVfam9iCndhc24ndC4gTm90IHRo ZSBncmVhdGVzdCBpbnRlcmZhY2UgSSB0aGluaywgcHJvYmFibHkgc2hvdWxkIHJlbmFtZSBjbGVh bnVwCnRvIHJlbGVhc2UvZnJlZS4gU2luY2UgdGhhdCdzIHdoYXQgaXQncyBzdXBwb3NlZCB0byBk byBJIHRoaW5rLgoKPiArICogaGFzIGNvbXBsZXRlZC4KPiArICovCj4gIHZvaWQgZHJtX3dyaXRl YmFja19jbGVhbnVwX2pvYihzdHJ1Y3QgZHJtX3dyaXRlYmFja19qb2IgKmpvYikKPiAgewo+ICAJ c3RydWN0IGRybV93cml0ZWJhY2tfY29ubmVjdG9yICpjb25uZWN0b3IgPSBqb2ItPmNvbm5lY3Rv cjsKPiBkaWZmIC0tZ2l0IGEvaW5jbHVkZS9kcm0vZHJtX21vZGVzZXRfaGVscGVyX3Z0YWJsZXMu aCBiL2luY2x1ZGUvZHJtL2RybV9tb2Rlc2V0X2hlbHBlcl92dGFibGVzLmgKPiBpbmRleCA4ZjM2 MDI4MTFlYjUuLmEwMDE3ZjM3ZWY1NSAxMDA2NDQKPiAtLS0gYS9pbmNsdWRlL2RybS9kcm1fbW9k ZXNldF9oZWxwZXJfdnRhYmxlcy5oCj4gKysrIGIvaW5jbHVkZS9kcm0vZHJtX21vZGVzZXRfaGVs cGVyX3Z0YWJsZXMuaAo+IEBAIC05OTIsOCArOTkyLDI4IEBAIHN0cnVjdCBkcm1fY29ubmVjdG9y X2hlbHBlcl9mdW5jcyB7Cj4gIAl2b2lkICgqYXRvbWljX2NvbW1pdCkoc3RydWN0IGRybV9jb25u ZWN0b3IgKmNvbm5lY3RvciwKPiAgCQkJICAgICAgc3RydWN0IGRybV9jb25uZWN0b3Jfc3RhdGUg KnN0YXRlKTsKPiAgCj4gKwkvKioKPiArCSAqIEBwcmVwYXJlX3dyaXRlYmFja19qb2I6Cj4gKwkg Kgo+ICsJICogQ2FsbGVkIGZyb20gJmRybV9hdG9taWNfaGVscGVyX3ByZXBhcmVfcGxhbmVzKCks IHByb3ZpZGVzIHRoZSBkcml2ZXIKPiArCSAqIGEgY2hhbmNlIHRvIHNldHVwIHRoaW5ncyBpbiBw cmVwYXJhdGlvbiBmb3IgYSB3cml0ZWJhY2sgam9iLgo+ICsJICoKCk1pc3Npbmcgc3RhbmRhcmQg Ym9pbGVycGxhdGUgYWJvdXQgcmV0dXJuIHZhbHVlcy4KCj4gKwkgKiBUaGlzIGhvb2sgaXMgb3B0 aW9uYWwuCj4gKwkgKi8KPiAgCWludCAoKnByZXBhcmVfd3JpdGViYWNrX2pvYikoc3RydWN0IGRy bV93cml0ZWJhY2tfY29ubmVjdG9yICpjb25uZWN0b3IsCj4gIAkJCQkgICAgIHN0cnVjdCBkcm1f d3JpdGViYWNrX2pvYiAqam9iKTsKPiArCj4gKwkvKioKPiArCSAqIEBjbGVhbnVwX3dyaXRlYmFj a19qb2I6Cj4gKwkgKgo+ICsJICogQ2FsbGVkIGZyb20gJmRybV9hdG9taWNfaGVscGVyX2Nvbm5l Y3Rvcl9kZXN0cm95X3N0YXRlKCksIGFuZAo+ICsJICogcHJvdmlkZXMgdGhlIGRyaXZlciBhbiBv cHBvcnR1bml0eSB0byBjbGVhbnVwIHRoZSB3cml0ZWJhY2sgam9iLgo+ICsJICogTm90aWNlIHRo ZSBhc3ltbWV0cnkgZnJvbSBwcmVwYXJlLCB0aGlzIGlzIGNhbGxlZCBvbiBkZXN0cm95IHRvCj4g KwkgKiBlbnN1cmUgdGhlIGpvYiBpcyBub3QgZGVzdHJveWVkIGJlZm9yZSB0aGFuIHRoZSB3cml0 ZWJhY2sgb3BlcmF0aW9uCj4gKwkgKiBoYXMgY29tcGxldGVkLgo+ICsJICoKPiArCSAqIFRoaXMg aG9vayBpcyBvcHRpb25hbC4KPiArCSAqLwo+ICAJdm9pZCAoKmNsZWFudXBfd3JpdGViYWNrX2pv Yikoc3RydWN0IGRybV93cml0ZWJhY2tfY29ubmVjdG9yICpjb25uZWN0b3IsCj4gIAkJCQkgICAg ICBzdHJ1Y3QgZHJtX3dyaXRlYmFja19qb2IgKmpvYik7Cj4gIH07CgpTbyBJIGxvb2tlZCB0aHJv dWdoIHRoZSB3cml0ZWJhY2sgY29kZSBzb21lIG1vcmUsIGFuZCByZWFsaXplZCB0aGF0IHRoaXMK aGVyZSBpcyBwcm9iYWJseSBtb3JlIGhlbHBlciBjb2RlIChpdCdzIG1vc3RseSBjYWxsZWQgZnJv bSBoZWxwZXJzLCB0aGUKdmZ1bmNzIGFyZSBpbiBoZWxwZXJzKSwgYnV0IGl0J3MgaW4gY29yZSBj b2RlLgoKSSB0aGluayBiZWZvcmUgd2UgZG9jdW1lbnQgdGhlIGRldGFpbHMgb2YgdGhpcyB3ZSBh bHNvIG5lZWQgdG8gcmV0aGluayB0aGUKbGF5ZXJpbmcgaGVyZSwgYXRtIGl0IGxvb2tzIGxpa2Ug c29tZW9uZSBzbWFzaGVkIGEgcGVubmUgdmVydGljYWxseSBpbnRvCm91ciB2ZXJ5IG5pY2Uga21z IGNvcmUvaGVscGVyIGxhc2FnbmEgLi4uIFdvdWxkIGJlIHJlYWxseSBuaWNlIHRvIGNsZWFuCnRo aXMgdXAgdG9vIGFuZCBlaXRoZXIgbWFrZSBpdCBhbGwgY29yZSAod2hpY2ggZmVlbHMgd3Jvbmcp IG9yIG1vdmUgaW50bwpoZWxwZXJzIChwcm9iYWJseSBuZWVkcyBhIHdyaXRlYmFja19oZWxwZXIu YyBmb3IgdGhpcywgb3Igd2Ugc3R1ZmYgaXQgaW50bwpkcm1fYXRvbWljX2hlbHBlci5jKS4KCkNo ZWVycywgRGFuaWVsCi0tIApEYW5pZWwgVmV0dGVyClNvZnR3YXJlIEVuZ2luZWVyLCBJbnRlbCBD b3Jwb3JhdGlvbgpodHRwOi8vYmxvZy5mZndsbC5jaApfX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fXwpkcmktZGV2ZWwgbWFpbGluZyBsaXN0CmRyaS1kZXZlbEBs aXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1h bi9saXN0aW5mby9kcmktZGV2ZWw=