From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: [PATCH] drm/doc: atomic overview, with graph Date: Wed, 1 Mar 2017 09:35:34 +0100 Message-ID: <20170301083534.1522-1-daniel.vetter@ffwll.ch> References: <20170228171319.1786-7-daniel.vetter@ffwll.ch> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-wm0-x242.google.com (mail-wm0-x242.google.com [IPv6:2a00:1450:400c:c09::242]) by gabe.freedesktop.org (Postfix) with ESMTPS id 813526E8CC for ; Wed, 1 Mar 2017 08:35:46 +0000 (UTC) Received: by mail-wm0-x242.google.com with SMTP id u63so6024422wmu.2 for ; Wed, 01 Mar 2017 00:35:46 -0800 (PST) In-Reply-To: <20170228171319.1786-7-daniel.vetter@ffwll.ch> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: linux-doc@vger.kernel.org Cc: Daniel Vetter , DRI Development , Laurent Pinchart , Daniel Vetter List-Id: dri-devel@lists.freedesktop.org SSB3YW50IHRvIHNwbGl0IHVwIGEgZmV3IG1vcmUgdGhpbmdzIGFuZCBkb2N1bWVudCBzb21lIGRl dGFpbHMgYmV0dGVyCihsaWtlIGhvdyBleGFjdGx5IHRvIHN1YmNsYXNzIGRybV9hdG9taWNfc3Rh dGUpLiBBbmQgbWF5YmUgYWxzbyBzcGxpdAp1cCB0aGUgaGVscGVycyBhIGJpdCBwZXItdG9waWMs IGJ1dCB0aGlzIHNob3VsZCBiZSBhIG9rLWlzaCBzdGFydCBmb3IKYmV0dGVyIGF0b21pYyBvdmVy dmlldy4KCk9uZSB0aGluZyBJIGZhaWxlZCBhdCBpcyBnZXR0aW5nIERPVCB0byBsYXlvdXQgdGhl IG92ZXJ2aWV3IGdyYXBoIGhvdwpJIHdhbnQgaXQuIFRoZSBoaWdobGV2ZWwgc3RydWN0dXJlIEkg d2FudCBpczoKCglGcmVlLXN0YW5kaW5nIFN0YXRlCgoJQ3VycmVudCBTdGF0ZQoKaS5lLiBvbmUg b3ZlciB0aGUgb3RoZXIuIEN1cnJlbnRseSBpdCBsYXlzIGl0IG91dCBzaWRlLWJ5LXNpZGUsIGJ1 dApub3QgZXZlbiB0aGF0IHJlYWxseSAtICJDdXJyZW50IFN0YXRlIiBpcyBzb21ld2hhdCBvZmZz ZXQgYmVsb3cuIE1ha2VzCnRoZSBncmFwaCBsb29rIGxpa2UgZ2FyYmFnZSwgYW5kIGFsc28gd2F5 IHRvbyB3aWRlIGZvciBwcm9wZXIKcmVuZGVyaW5nLiBJZGVhcyBhcHByZWNpYXRlZC4KCnYyOiBT cGVsbGluZyBhbmQgY2xhcmlmaWNhdGlvbnMgKEVyaWMpLgoKQ2M6IEVyaWMgQW5ob2x0IDxlcmlj QGFuaG9sdC5uZXQ+CkNjOiBMYXVyZW50IFBpbmNoYXJ0IDxsYXVyZW50LnBpbmNoYXJ0QGlkZWFz b25ib2FyZC5jb20+CkNjOiBIYXJyeSBXZW50bGFuZCA8aGFycnkud2VudGxhbmRAYW1kLmNvbT4K U2lnbmVkLW9mZi1ieTogRGFuaWVsIFZldHRlciA8ZGFuaWVsLnZldHRlckBpbnRlbC5jb20+Ci0t LQogRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy1oZWxwZXJzLnJzdCB8ICAyICsKIERvY3VtZW50 YXRpb24vZ3B1L2RybS1rbXMucnN0ICAgICAgICAgfCA4NiArKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrLQogMiBmaWxlcyBjaGFuZ2VkLCA4NyBpbnNlcnRpb25zKCspLCAxIGRlbGV0 aW9uKC0pCgpkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy1oZWxwZXJzLnJz dCBiL0RvY3VtZW50YXRpb24vZ3B1L2RybS1rbXMtaGVscGVycy5yc3QKaW5kZXggMDUwZWJlODFk MjU2Li5hYzUzYzBiODkzZjYgMTAwNjQ0Ci0tLSBhL0RvY3VtZW50YXRpb24vZ3B1L2RybS1rbXMt aGVscGVycy5yc3QKKysrIGIvRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy1oZWxwZXJzLnJzdApA QCAtNDIsNiArNDIsOCBAQCBNb2Rlc2V0IEhlbHBlciBSZWZlcmVuY2UgZm9yIENvbW1vbiBWdGFi bGVzCiAuLiBrZXJuZWwtZG9jOjogaW5jbHVkZS9kcm0vZHJtX21vZGVzZXRfaGVscGVyX3Z0YWJs ZXMuaAogICAgOmludGVybmFsOgogCisuLiBfZHJtX2F0b21pY19oZWxwZXI6CisKIEF0b21pYyBN b2Rlc2V0IEhlbHBlciBGdW5jdGlvbnMgUmVmZXJlbmNlCiA9PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09PQogCmRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL2dwdS9kcm0t a21zLnJzdCBiL0RvY3VtZW50YXRpb24vZ3B1L2RybS1rbXMucnN0CmluZGV4IGE1MDRkOWVlNGQ5 NC4uNDgyM2RmMDNjNzczIDEwMDY0NAotLS0gYS9Eb2N1bWVudGF0aW9uL2dwdS9kcm0ta21zLnJz dAorKysgYi9Eb2N1bWVudGF0aW9uL2dwdS9kcm0ta21zLnJzdApAQCAtMTg5LDggKzE4OSw5MiBA QCBtdWx0aXBsZSB0aW1lcyB0byBkaWZmZXJlbnQgb2JqZWN0cyB1c2luZyA6YzpmdW5jOmBkcm1f b2JqZWN0X2F0dGFjaF9wcm9wZXJ0eSgpCiAuLiBrZXJuZWwtZG9jOjogZHJpdmVycy9ncHUvZHJt L2RybV9tb2RlX29iamVjdC5jCiAgICA6ZXhwb3J0OgogCitBdG9taWMgTW9kZSBTZXR0aW5nCis9 PT09PT09PT09PT09PT09PT09CisKKworLi4gRklYTUU6IFRoZSBJIHdhbnQgdGhlIGJlbG93IGdy YXBoIHRvIGJlIGxhaWQgb3V0IHNvIHRoYXQgdGhlIDIgc3ViZ3JhcGgKKyAgIGNsdXN0ZXJzIGFy ZSBiZWxvdyBlYWNoIGFub3RoZXIuIEJ1dCBJIGZhaWxlZC4KKworLi4ga2VybmVsLXJlbmRlcjo6 IERPVAorICAgOmFsdDogTW9kZSBPYmplY3RzIGFuZCBQcm9wZXJ0aWVzCisgICA6Y2FwdGlvbjog TW9kZSBPYmplY3RzIGFuZCBQcm9wZXJ0aWVzCisKKyAgIGRpZ3JhcGggeworICAgICAgbm9kZSBb c2hhcGU9Ym94XQorCisgICAgICBzdWJncmFwaCBjbHVzdGVyX3N0YXRlIHsKKyAgICAgICAgICBz dHlsZT1kYXNoZWQKKyAgICAgICAgICBsYWJlbD0iRnJlZS1zdGFuZGluZyBzdGF0ZSIKKworICAg ICAgICAgICJkcm1fYXRvbWljX3N0YXRlIiAtPiAiZHVwbGljYXRlZCBkcm1fcGxhbmVfc3RhdGUg QSIKKyAgICAgICAgICAiZHJtX2F0b21pY19zdGF0ZSIgLT4gImR1cGxpY2F0ZWQgZHJtX3BsYW5l X3N0YXRlIEIiCisgICAgICAgICAgImRybV9hdG9taWNfc3RhdGUiIC0+ICJkdXBsaWNhdGVkIGRy bV9jcnRjX3N0YXRlIgorICAgICAgICAgICJkcm1fYXRvbWljX3N0YXRlIiAtPiAiZHVwbGljYXRl ZCBkcm1fY29ubmVjdG9yX3N0YXRlIgorICAgICAgICAgICJkcm1fYXRvbWljX3N0YXRlIiAtPiAi ZHVwbGljYXRlZCBkcml2ZXIgcHJpdmF0ZSBzdGF0ZSIKKyAgICAgIH0KKworICAgICAgc3ViZ3Jh cGggY2x1c3Rlcl9jdXJyZW50IHsKKyAgICAgICAgICBzdHlsZT1kYXNoZWQKKyAgICAgICAgICBs YWJlbD0iQ3VycmVudCBzdGF0ZSIKKworICAgICAgICAgICJkcm1fZGV2aWNlIiAtPiAiZHJtX3Bs YW5lIEEiCisgICAgICAgICAgImRybV9kZXZpY2UiIC0+ICJkcm1fcGxhbmUgQiIKKyAgICAgICAg ICAiZHJtX2RldmljZSIgLT4gImRybV9jcnRjIgorICAgICAgICAgICJkcm1fZGV2aWNlIiAtPiAi ZHJtX2Nvbm5lY3RvciIKKyAgICAgICAgICAiZHJtX2RldmljZSIgLT4gImRyaXZlciBwcml2YXRl IG9iamVjdCIKKworICAgICAgICAgICJkcm1fcGxhbmUgQSIgLT4gImRybV9wbGFuZV9zdGF0ZSBB IgorICAgICAgICAgICJkcm1fcGxhbmUgQiIgLT4gImRybV9wbGFuZV9zdGF0ZSBCIgorICAgICAg ICAgICJkcm1fY3J0YyIgLT4gImRybV9jcnRjX3N0YXRlIgorICAgICAgICAgICJkcm1fY29ubmVj dG9yIiAtPiAiZHJtX2Nvbm5lY3Rvcl9zdGF0ZSIKKyAgICAgICAgICAiZHJpdmVyIHByaXZhdGUg b2JqZWN0IiAtPiAiZHJpdmVyIHByaXZhdGUgc3RhdGUiCisgICAgICB9CisKKyAgICAgICJkcm1f YXRvbWljX3N0YXRlIiAtPiAiZHJtX2RldmljZSIgW2xhYmVsPSJhdG9taWNfY29tbWl0Il0KKyAg IH0KKworQXRvbWljIHByb3ZpZGVzIHRyYW5zYWN0aW9uYWwgbW9kZXNldCAoaW5jbHVkaW5nIHBs YW5lcykgdXBkYXRlcywgYnV0IGEKK2JpdCBkaWZmZXJlbnRseSBmcm9tIHRoZSB1c3VhbCB0cmFu c2FjdGlvbmFsIGFwcHJvYWNoIG9mIHRyeS1jb21taXQgYW5kCityb2xsYmFjazoKKworLSBGaXJz dGx5LCBubyBoYXJkd2FyZSBjaGFuZ2VzIGFyZSBhbGxvd2VkIHdoZW4gdGhlIGNvbW1pdCB3b3Vs ZCBmYWlsLiBUaGlzCisgIGFsbG93cyB1cyB0byBpbXBsZW1lbnQgdGhlIERSTV9NT0RFX0FUT01J Q19URVNUX09OTFkgbW9kZSwgd2hpY2ggYWxsb3dzCisgIHVzZXJzcGFjZSB0byBleHBsb3JlIHdo ZXRoZXIgY2VydGFpbiBjb25maWd1cmF0aW9ucyB3b3VsZCB3b3JrIG9yIG5vdC4KKworLSBUaGlz IHdvdWxkIHN0aWxsIGFsbG93IHNldHRpbmcgYW5kIHJvbGxiYWNrIG9mIGp1c3QgdGhlIHNvZnR3 YXJlIHN0YXRlLAorICBzaW1wbGlmeWluZyBjb252ZXJzaW9uIG9mIGV4aXN0aW5nIGRyaXZlcnMu IEJ1dCBhdWRpdGluZyBkcml2ZXJzIGZvcgorICBjb3JyZWN0bmVzcyBvZiB0aGUgYXRvbWljX2No ZWNrIGNvZGUgYmVjb21lcyByZWFsbHkgaGFyZCB3aXRoIHRoYXQ6IFJvbGxpbmcKKyAgYmFjayBj aGFuZ2VzIGluIGRhdGEgc3RydWN0dXJlcyBhbGwgb3ZlciB0aGUgcGxhY2UgaXMgaGFyZCB0byBn ZXQgcmlnaHQuCisKKy0gTGFzdGx5LCBmb3IgYmFja3dhcmRzIGNvbXBhdGliaWxpdHkgYW5kIHRv IHN1cHBvcnQgYWxsIHVzZS1jYXNlcywgYXRvbWljCisgIHVwZGF0ZXMgbmVlZCB0byBiZSBpbmNy ZW1lbnRhbCBhbmQgYmUgYWJsZSB0byBleGVjdXRlIGluIHBhcmFsbGVsLiBIYXJkd2FyZQorICBk b2Vzbid0IGFsd2F5cyBhbGxvdyBpdCwgYnV0IHdoZXJlIHBvc3NpYmxlIHBsYW5lIHVwZGF0ZXMg b24gZGlmZmVyZW50IENSVENzCisgIHNob3VsZCBub3QgaW50ZXJmZXJlLCBhbmQgbm90IGdldCBz dGFsbGVkIGR1ZSB0byBvdXRwdXQgcm91dGluZyBjaGFuZ2luZyBvbgorICBkaWZmZXJlbnQgQ1JU Q3MuCisKK1Rha2VuIGFsbCB0b2dldGhlciB0aGVyZSdzIHR3byBjb25zZXF1ZW5jZXMgZm9yIHRo ZSBhdG9taWMgZGVzaWduOgorCistIFRoZSBvdmVyYWxsIHN0YXRlIGlzIHNwbGl0IHVwIGludG8g cGVyLW9iamVjdCBzdGF0ZSBzdHJ1Y3R1cmVzOgorICA6Yzp0eXBlOmBzdHJ1Y3QgZHJtX3BsYW5l X3N0YXRlIDxkcm1fcGxhbmVfc3RhdGU+YCBmb3IgcGxhbmVzLCA6Yzp0eXBlOmBzdHJ1Y3QKKyAg ZHJtX2NydGNfc3RhdGUgPGRybV9jcnRjX3N0YXRlPmAgZm9yIENSVENzIGFuZCA6Yzp0eXBlOmBz dHJ1Y3QKKyAgZHJtX2Nvbm5lY3Rvcl9zdGF0ZSA8ZHJtX2Nvbm5lY3Rvcl9zdGF0ZWAgZm9yIGNv bm5lY3RvcnMuIFRoZXNlIGFyZSB0aGUgb25seQorICBvYmplY3RzIHdpdGggdXNlcnNwYWNlLXZp c2libGUgYW5kIHNldHRhYmxlIHN0YXRlLiBGb3IgaW50ZXJuYWwgc3RhdGUgZHJpdmVycworICBj YW4gc3ViY2xhc3MgdGhlc2Ugc3RydWN0dXJlcyB0aHJvdWdoIGVtYmVkZGVkaW5nLCBvciBhZGQg ZW50aXJlbHkgbmV3IHN0YXRlCisgIHN0cnVjdHVyZXMgZm9yIHRoZWlyIGdsb2JhbGx5IHNoYXJl ZCBoYXJkd2FyZSBmdW5jdGlvbnMuCisKKy0gQW4gYXRvbWljIHVwZGF0ZSBpcyBhc3NlbWJsZWQg YW5kIHZhbGlkYXRlZCBhcyBhbiBlbnRlcmlseSBmcmVlLXN0YW5kaW5nIHBpbGUKKyAgb2Ygc3Ry dWN0dXJlcyB3aXRoaW4gdGhlIDpjOnR5cGU6YGRybV9hdG9taWNfc3RhdGUgPGRybV9hdG9taWNf c3RhdGU+YAorICBjb250YWluZXIuIEFnYWluIGRyaXZlcnMgY2FuIHN1YmNsYXNzIHRoYXQgY29u dGFpbmVyIGZvciB0aGVpciBvd24gc3RhdGUKKyAgc3RydWN0dXJlIHRyYWNraW5nIG5lZWRzLiBP bmx5IHdoZW4gYSBzdGF0ZSBpcyBjb21taXR0ZWQgaXMgaXQgYXBwbGllZCB0byB0aGUKKyAgZHJp dmVyIGFuZCBtb2Rlc2V0IG9iamVjdHMuIFRoaXMgd2F5IHJvbGxpbmcgYmFjayBhbiB1cGRhdGUg Ym9pbHMgZG93biB0bworICByZWxlYXNpbmcgbWVtb3J5IGFuZCB1bnJlZmVyZW5jaW5nIG9iamVj dHMgbGlrZSBmcmFtZWJ1ZmZlcnMuCisKK1JlYWQgb24gaW4gdGhpcyBjaGFwdGVyLCBhbmQgYWxz byBpbiA6cmVmOmBkcm1fYXRvbWljX2hlbHBlcmAgZm9yIG1vcmUgZGV0YWlsZWQKK2NvdmVyYWdl IG9mIHNwZWNpZmljIHRvcGljcy4KKwogQXRvbWljIE1vZGUgU2V0dGluZyBGdW5jdGlvbiBSZWZl cmVuY2UKLT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09CistLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQogCiAuLiBrZXJuZWwtZG9jOjogaW5jbHVkZS9k cm0vZHJtX2F0b21pYy5oCiAgICA6aW50ZXJuYWw6Ci0tIAoyLjExLjAKCl9fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBtYWlsaW5nIGxpc3QK ZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZyZWVkZXNrdG9w Lm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAo=