From: Sean Paul Subject: [PATCH 2/2] drm/doc: Document the writeback prepare/cleanup jobs Date: Thu, 2 May 2019 16:24:30 -0400 Message-ID: <20190502202449.237184-2-sean@poorly.run> References: <20190502202449.237184-1-sean@poorly.run> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-qt1-x841.google.com (mail-qt1-x841.google.com [IPv6:2607:f8b0:4864:20::841]) by gabe.freedesktop.org (Postfix) with ESMTPS id 799548987C for ; Thu, 2 May 2019 20:25:07 +0000 (UTC) Received: by mail-qt1-x841.google.com with SMTP id j6so4258751qtq.1 for ; Thu, 02 May 2019 13:25:07 -0700 (PDT) In-Reply-To: <20190502202449.237184-1-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: dri-devel@lists.freedesktop.org Cc: Laurent Pinchart , Maxime Ripard , Liviu Dudau , David Airlie , Sean Paul , Sean Paul List-Id: dri-devel@lists.freedesktop.org RnJvbTogU2VhbiBQYXVsIDxzZWFucGF1bEBjaHJvbWl1bS5vcmc+CgpUaGVzZSBmdW5jdGlvbnMg d2VyZSBtaXNzaW5nIGRvY3VtZW50YXRpb24uCgpGaXhlcyB0aGUgd2FybmluZzoKLi4vaW5jbHVk ZS9kcm0vZHJtX21vZGVzZXRfaGVscGVyX3Z0YWJsZXMuaDoxMDAwOiB3YXJuaW5nOiBGdW5jdGlv biBwYXJhbWV0ZXIgb3IgbWVtYmVyICdwcmVwYXJlX3dyaXRlYmFja19qb2InIG5vdCBkZXNjcmli ZWQgaW4gJ2RybV9jb25uZWN0b3JfaGVscGVyX2Z1bmNzJwouLi9pbmNsdWRlL2RybS9kcm1fbW9k ZXNldF9oZWxwZXJfdnRhYmxlcy5oOjEwMDA6IHdhcm5pbmc6IEZ1bmN0aW9uIHBhcmFtZXRlciBv ciBtZW1iZXIgJ2NsZWFudXBfd3JpdGViYWNrX2pvYicgbm90IGRlc2NyaWJlZCBpbiAnZHJtX2Nv bm5lY3Rvcl9oZWxwZXJfZnVuY3MnCgpGaXhlczogOWQyMjMwZGMxMzUxICgiZHJtOiB3cml0ZWJh Y2s6IEFkZCBqb2IgcHJlcGFyZSBhbmQgY2xlYW51cCBvcGVyYXRpb25zIikKQ2M6IExhdXJlbnQg UGluY2hhcnQgPGxhdXJlbnQucGluY2hhcnQrcmVuZXNhc0BpZGVhc29uYm9hcmQuY29tPgpDYzog TGl2aXUgRHVkYXUgPGxpdml1LmR1ZGF1QGFybS5jb20+CkNjOiBNYWFydGVuIExhbmtob3JzdCA8 bWFhcnRlbi5sYW5raG9yc3RAbGludXguaW50ZWwuY29tPgpDYzogTWF4aW1lIFJpcGFyZCA8bWF4 aW1lLnJpcGFyZEBib290bGluLmNvbT4KQ2M6IFNlYW4gUGF1bCA8c2VhbkBwb29ybHkucnVuPgpD YzogRGF2aWQgQWlybGllIDxhaXJsaWVkQGxpbnV4LmllPgpDYzogRGFuaWVsIFZldHRlciA8ZGFu aWVsQGZmd2xsLmNoPgpDYzogZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpTaWduZWQt b2ZmLWJ5OiBTZWFuIFBhdWwgPHNlYW5wYXVsQGNocm9taXVtLm9yZz4KLS0tCiBkcml2ZXJzL2dw dS9kcm0vZHJtX3dyaXRlYmFjay5jICAgICAgICAgIHwgMjAgKysrKysrKysrKysrKysrKysrKysK IGluY2x1ZGUvZHJtL2RybV9tb2Rlc2V0X2hlbHBlcl92dGFibGVzLmggfCAyMCArKysrKysrKysr KysrKysrKysrKwogMiBmaWxlcyBjaGFuZ2VkLCA0MCBpbnNlcnRpb25zKCspCgpkaWZmIC0tZ2l0 IGEvZHJpdmVycy9ncHUvZHJtL2RybV93cml0ZWJhY2suYyBiL2RyaXZlcnMvZ3B1L2RybS9kcm1f d3JpdGViYWNrLmMKaW5kZXggNzlhYzAxNDcwMWM4Li5lZjZmODU5NjY1NDYgMTAwNjQ0Ci0tLSBh L2RyaXZlcnMvZ3B1L2RybS9kcm1fd3JpdGViYWNrLmMKKysrIGIvZHJpdmVycy9ncHUvZHJtL2Ry bV93cml0ZWJhY2suYwpAQCAtMjU4LDYgKzI1OCwxNSBAQCBpbnQgZHJtX3dyaXRlYmFja19zZXRf ZmIoc3RydWN0IGRybV9jb25uZWN0b3Jfc3RhdGUgKmNvbm5fc3RhdGUsCiAJcmV0dXJuIDA7CiB9 CiAKKy8qKgorICogZHJtX3dyaXRlYmFja19wcmVwYXJlX2pvYiAtIEdpdmVzIGRyaXZlciBhIGNo YW5jZSB0byBwcmVwYXJlIGZvciB3cml0ZWJhY2sKKyAqIEBqb2I6IFRoZSB3cml0ZWJhY2sgam9i IHRvIGJlIHByZXBhcmVkCisgKgorICogVGhpcyBmdW5jdGlvbiBpcyBjYWxsZWQgZnJvbSAmZHJt X2F0b21pY19oZWxwZXJfcHJlcGFyZV9wbGFuZXMoKSwgYW5kIGFsbG93cworICogdGhlIGRyaXZl ciB0byBzZXR1cCB0aGUgdXBjb21pbmcgd3JpdGViYWNrIGpvYi4gVGhlIGpvYiB3aWxsIGJlCisg KiBkZXN0cm95ZWQvY2xlYW5lZCB1cCBpbiAmZHJtX3dyaXRlYmFja19jbGVhbnVwX2pvYiB3aGVu IHRoZSBjb25uZWN0b3Igc3RhdGUKKyAqIGlzIGRlc3Ryb3llZC4KKyAqLwogaW50IGRybV93cml0 ZWJhY2tfcHJlcGFyZV9qb2Ioc3RydWN0IGRybV93cml0ZWJhY2tfam9iICpqb2IpCiB7CiAJc3Ry dWN0IGRybV93cml0ZWJhY2tfY29ubmVjdG9yICpjb25uZWN0b3IgPSBqb2ItPmNvbm5lY3RvcjsK QEAgLTMxMCw2ICszMTksMTcgQEAgdm9pZCBkcm1fd3JpdGViYWNrX3F1ZXVlX2pvYihzdHJ1Y3Qg ZHJtX3dyaXRlYmFja19jb25uZWN0b3IgKndiX2Nvbm5lY3RvciwKIH0KIEVYUE9SVF9TWU1CT0wo ZHJtX3dyaXRlYmFja19xdWV1ZV9qb2IpOwogCisvKioKKyAqIGRybV93cml0ZWJhY2tfY2xlYW51 cF9qb2IgLSBHaXZlcyBkcml2ZXIgYSBjaGFuY2UgdG8gY2xlYW51cCBhIHdyaXRlYmFjayBqb2IK KyAqIEBqb2I6IFRoZSB3cml0ZWJhY2sgam9iIHRvIGJlIGNsZWFuZWQgdXAKKyAqCisgKiBUaGlz IGZ1bmN0aW9uIGlzIGNhbGxlZCBmcm9tICZhdG9taWNfaGVscGVyX2Nvbm5lY3Rvcl9kZXN0cm95 X3N0YXRlKCkgYW5kCisgKiBhbGxvd3MgdGhlIGRyaXZlciB0byBjbGVhbiB1cCB0aGUgbm93IGZp bmlzaGVkIHdyaXRlYmFjayBqb2IuCisgKgorICogTm90aWNlIHRoZSBhc3ltbWV0cnkgZnJvbSBw cmVwYXJlLCB0aGlzIGlzIGNhbGxlZCBvbiBkZXN0cm95IHRvCisgKiBlbnN1cmUgdGhlIGpvYiBp cyBub3QgZGVzdHJveWVkIGJlZm9yZSB0aGFuIHRoZSB3cml0ZWJhY2sgb3BlcmF0aW9uCisgKiBo YXMgY29tcGxldGVkLgorICovCiB2b2lkIGRybV93cml0ZWJhY2tfY2xlYW51cF9qb2Ioc3RydWN0 IGRybV93cml0ZWJhY2tfam9iICpqb2IpCiB7CiAJc3RydWN0IGRybV93cml0ZWJhY2tfY29ubmVj dG9yICpjb25uZWN0b3IgPSBqb2ItPmNvbm5lY3RvcjsKZGlmZiAtLWdpdCBhL2luY2x1ZGUvZHJt L2RybV9tb2Rlc2V0X2hlbHBlcl92dGFibGVzLmggYi9pbmNsdWRlL2RybS9kcm1fbW9kZXNldF9o ZWxwZXJfdnRhYmxlcy5oCmluZGV4IDhmMzYwMjgxMWViNS4uYTAwMTdmMzdlZjU1IDEwMDY0NAot LS0gYS9pbmNsdWRlL2RybS9kcm1fbW9kZXNldF9oZWxwZXJfdnRhYmxlcy5oCisrKyBiL2luY2x1 ZGUvZHJtL2RybV9tb2Rlc2V0X2hlbHBlcl92dGFibGVzLmgKQEAgLTk5Miw4ICs5OTIsMjggQEAg c3RydWN0IGRybV9jb25uZWN0b3JfaGVscGVyX2Z1bmNzIHsKIAl2b2lkICgqYXRvbWljX2NvbW1p dCkoc3RydWN0IGRybV9jb25uZWN0b3IgKmNvbm5lY3RvciwKIAkJCSAgICAgIHN0cnVjdCBkcm1f Y29ubmVjdG9yX3N0YXRlICpzdGF0ZSk7CiAKKwkvKioKKwkgKiBAcHJlcGFyZV93cml0ZWJhY2tf am9iOgorCSAqCisJICogQ2FsbGVkIGZyb20gJmRybV9hdG9taWNfaGVscGVyX3ByZXBhcmVfcGxh bmVzKCksIHByb3ZpZGVzIHRoZSBkcml2ZXIKKwkgKiBhIGNoYW5jZSB0byBzZXR1cCB0aGluZ3Mg aW4gcHJlcGFyYXRpb24gZm9yIGEgd3JpdGViYWNrIGpvYi4KKwkgKgorCSAqIFRoaXMgaG9vayBp cyBvcHRpb25hbC4KKwkgKi8KIAlpbnQgKCpwcmVwYXJlX3dyaXRlYmFja19qb2IpKHN0cnVjdCBk cm1fd3JpdGViYWNrX2Nvbm5lY3RvciAqY29ubmVjdG9yLAogCQkJCSAgICAgc3RydWN0IGRybV93 cml0ZWJhY2tfam9iICpqb2IpOworCisJLyoqCisJICogQGNsZWFudXBfd3JpdGViYWNrX2pvYjoK KwkgKgorCSAqIENhbGxlZCBmcm9tICZkcm1fYXRvbWljX2hlbHBlcl9jb25uZWN0b3JfZGVzdHJv eV9zdGF0ZSgpLCBhbmQKKwkgKiBwcm92aWRlcyB0aGUgZHJpdmVyIGFuIG9wcG9ydHVuaXR5IHRv IGNsZWFudXAgdGhlIHdyaXRlYmFjayBqb2IuCisJICogTm90aWNlIHRoZSBhc3ltbWV0cnkgZnJv bSBwcmVwYXJlLCB0aGlzIGlzIGNhbGxlZCBvbiBkZXN0cm95IHRvCisJICogZW5zdXJlIHRoZSBq b2IgaXMgbm90IGRlc3Ryb3llZCBiZWZvcmUgdGhhbiB0aGUgd3JpdGViYWNrIG9wZXJhdGlvbgor CSAqIGhhcyBjb21wbGV0ZWQuCisJICoKKwkgKiBUaGlzIGhvb2sgaXMgb3B0aW9uYWwuCisJICov CiAJdm9pZCAoKmNsZWFudXBfd3JpdGViYWNrX2pvYikoc3RydWN0IGRybV93cml0ZWJhY2tfY29u bmVjdG9yICpjb25uZWN0b3IsCiAJCQkJICAgICAgc3RydWN0IGRybV93cml0ZWJhY2tfam9iICpq b2IpOwogfTsKLS0gClNlYW4gUGF1bCwgU29mdHdhcmUgRW5naW5lZXIsIEdvb2dsZSAvIENocm9t aXVtIE9TCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpk cmktZGV2ZWwgbWFpbGluZyBsaXN0CmRyaS1kZXZlbEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0 cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9kcmktZGV2ZWw=