From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: [PATCH] drm/doc: atomic overview, with graph Date: Thu, 2 Mar 2017 08:19:58 +0100 Message-ID: <20170302071958.25203-1-daniel.vetter@ffwll.ch> References: <20170301083534.1522-1-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-x241.google.com (mail-wm0-x241.google.com [IPv6:2a00:1450:400c:c09::241]) by gabe.freedesktop.org (Postfix) with ESMTPS id 4EDCA6EA5E for ; Thu, 2 Mar 2017 07:20:07 +0000 (UTC) Received: by mail-wm0-x241.google.com with SMTP id m70so10837172wma.1 for ; Wed, 01 Mar 2017 23:20:07 -0800 (PST) In-Reply-To: <20170301083534.1522-1-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 , Gabriel Krisman Bertazi List-Id: dri-devel@lists.freedesktop.org SSB3YW50IHRvIHNwbGl0IHVwIGEgZmV3IG1vcmUgdGhpbmdzIGFuZCBkb2N1bWVudCBzb21lIGRl dGFpbHMgYmV0dGVyCihsaWtlIGhvdyBleGFjdGx5IHRvIHN1YmNsYXNzIGRybV9hdG9taWNfc3Rh dGUpLiBBbmQgbWF5YmUgYWxzbyBzcGxpdAp1cCB0aGUgaGVscGVycyBhIGJpdCBwZXItdG9waWMs IGJ1dCB0aGlzIHNob3VsZCBiZSBhIG9rLWlzaCBzdGFydCBmb3IKYmV0dGVyIGF0b21pYyBvdmVy dmlldy4KCnYyOiBTcGVsbGluZyBhbmQgY2xhcmlmaWNhdGlvbnMgKEVyaWMpLgoKdjM6IEltcGxl bWVudCBzdWdnZXN0aW9uIGZyb20gR2FicmllbCB0byBmaXggdGhlIGdyYXBoLgoKQ2M6IEdhYnJp ZWwgS3Jpc21hbiBCZXJ0YXppIDxrcmlzbWFuQGNvbGxhYm9yYS5jby51az4KQWNrZWQtYnk6IEVy aWMgQW5ob2x0IDxlcmljQGFuaG9sdC5uZXQ+CkNjOiBFcmljIEFuaG9sdCA8ZXJpY0BhbmhvbHQu bmV0PgpDYzogTGF1cmVudCBQaW5jaGFydCA8bGF1cmVudC5waW5jaGFydEBpZGVhc29uYm9hcmQu Y29tPgpDYzogSGFycnkgV2VudGxhbmQgPGhhcnJ5LndlbnRsYW5kQGFtZC5jb20+ClNpZ25lZC1v ZmYtYnk6IERhbmllbCBWZXR0ZXIgPGRhbmllbC52ZXR0ZXJAaW50ZWwuY29tPgotLS0KIERvY3Vt ZW50YXRpb24vZ3B1L2RybS1rbXMtaGVscGVycy5yc3QgfCAgMiArCiBEb2N1bWVudGF0aW9uL2dw dS9kcm0ta21zLnJzdCAgICAgICAgIHwgODQgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKy0KIDIgZmlsZXMgY2hhbmdlZCwgODUgaW5zZXJ0aW9ucygrKSwgMSBkZWxldGlvbigtKQoK ZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vZ3B1L2RybS1rbXMtaGVscGVycy5yc3QgYi9Eb2N1 bWVudGF0aW9uL2dwdS9kcm0ta21zLWhlbHBlcnMucnN0CmluZGV4IDA1MGViZTgxZDI1Ni4uYWM1 M2MwYjg5M2Y2IDEwMDY0NAotLS0gYS9Eb2N1bWVudGF0aW9uL2dwdS9kcm0ta21zLWhlbHBlcnMu cnN0CisrKyBiL0RvY3VtZW50YXRpb24vZ3B1L2RybS1rbXMtaGVscGVycy5yc3QKQEAgLTQyLDYg KzQyLDggQEAgTW9kZXNldCBIZWxwZXIgUmVmZXJlbmNlIGZvciBDb21tb24gVnRhYmxlcwogLi4g a2VybmVsLWRvYzo6IGluY2x1ZGUvZHJtL2RybV9tb2Rlc2V0X2hlbHBlcl92dGFibGVzLmgKICAg IDppbnRlcm5hbDoKIAorLi4gX2RybV9hdG9taWNfaGVscGVyOgorCiBBdG9taWMgTW9kZXNldCBI ZWxwZXIgRnVuY3Rpb25zIFJlZmVyZW5jZQogPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT0KIApkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy5yc3Qg Yi9Eb2N1bWVudGF0aW9uL2dwdS9kcm0ta21zLnJzdAppbmRleCBhNTA0ZDllZTRkOTQuLmViOWQy OTg2NWM0MSAxMDA2NDQKLS0tIGEvRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy5yc3QKKysrIGIv RG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy5yc3QKQEAgLTE4OSw4ICsxODksOTAgQEAgbXVsdGlw bGUgdGltZXMgdG8gZGlmZmVyZW50IG9iamVjdHMgdXNpbmcgOmM6ZnVuYzpgZHJtX29iamVjdF9h dHRhY2hfcHJvcGVydHkoKQogLi4ga2VybmVsLWRvYzo6IGRyaXZlcnMvZ3B1L2RybS9kcm1fbW9k ZV9vYmplY3QuYwogICAgOmV4cG9ydDoKIAorQXRvbWljIE1vZGUgU2V0dGluZworPT09PT09PT09 PT09PT09PT09PQorCisKKy4uIGtlcm5lbC1yZW5kZXI6OiBET1QKKyAgIDphbHQ6IE1vZGUgT2Jq ZWN0cyBhbmQgUHJvcGVydGllcworICAgOmNhcHRpb246IE1vZGUgT2JqZWN0cyBhbmQgUHJvcGVy dGllcworCisgICBkaWdyYXBoIHsKKyAgICAgIG5vZGUgW3NoYXBlPWJveF0KKworICAgICAgc3Vi Z3JhcGggY2x1c3Rlcl9zdGF0ZSB7CisgICAgICAgICAgc3R5bGU9ZGFzaGVkCisgICAgICAgICAg bGFiZWw9IkZyZWUtc3RhbmRpbmcgc3RhdGUiCisKKyAgICAgICAgICAiZHJtX2F0b21pY19zdGF0 ZSIgLT4gImR1cGxpY2F0ZWQgZHJtX3BsYW5lX3N0YXRlIEEiCisgICAgICAgICAgImRybV9hdG9t aWNfc3RhdGUiIC0+ICJkdXBsaWNhdGVkIGRybV9wbGFuZV9zdGF0ZSBCIgorICAgICAgICAgICJk cm1fYXRvbWljX3N0YXRlIiAtPiAiZHVwbGljYXRlZCBkcm1fY3J0Y19zdGF0ZSIKKyAgICAgICAg ICAiZHJtX2F0b21pY19zdGF0ZSIgLT4gImR1cGxpY2F0ZWQgZHJtX2Nvbm5lY3Rvcl9zdGF0ZSIK KyAgICAgICAgICAiZHJtX2F0b21pY19zdGF0ZSIgLT4gImR1cGxpY2F0ZWQgZHJpdmVyIHByaXZh dGUgc3RhdGUiCisgICAgICB9CisKKyAgICAgIHN1YmdyYXBoIGNsdXN0ZXJfY3VycmVudCB7Cisg ICAgICAgICAgc3R5bGU9ZGFzaGVkCisgICAgICAgICAgbGFiZWw9IkN1cnJlbnQgc3RhdGUiCisK KyAgICAgICAgICAiZHJtX2RldmljZSIgLT4gImRybV9wbGFuZSBBIgorICAgICAgICAgICJkcm1f ZGV2aWNlIiAtPiAiZHJtX3BsYW5lIEIiCisgICAgICAgICAgImRybV9kZXZpY2UiIC0+ICJkcm1f Y3J0YyIKKyAgICAgICAgICAiZHJtX2RldmljZSIgLT4gImRybV9jb25uZWN0b3IiCisgICAgICAg ICAgImRybV9kZXZpY2UiIC0+ICJkcml2ZXIgcHJpdmF0ZSBvYmplY3QiCisKKyAgICAgICAgICAi ZHJtX3BsYW5lIEEiIC0+ICJkcm1fcGxhbmVfc3RhdGUgQSIKKyAgICAgICAgICAiZHJtX3BsYW5l IEIiIC0+ICJkcm1fcGxhbmVfc3RhdGUgQiIKKyAgICAgICAgICAiZHJtX2NydGMiIC0+ICJkcm1f Y3J0Y19zdGF0ZSIKKyAgICAgICAgICAiZHJtX2Nvbm5lY3RvciIgLT4gImRybV9jb25uZWN0b3Jf c3RhdGUiCisgICAgICAgICAgImRyaXZlciBwcml2YXRlIG9iamVjdCIgLT4gImRyaXZlciBwcml2 YXRlIHN0YXRlIgorICAgICAgfQorCisgICAgICAiZHJtX2F0b21pY19zdGF0ZSIgLT4gImRybV9k ZXZpY2UiIFtsYWJlbD0iYXRvbWljX2NvbW1pdCJdCisgICAgICAiZHVwbGljYXRlZCBkcm1fcGxh bmVfc3RhdGUgQSIgLT4gImRybV9kZXZpY2UiW3N0eWxlPWludmlzXQorICAgfQorCitBdG9taWMg cHJvdmlkZXMgdHJhbnNhY3Rpb25hbCBtb2Rlc2V0IChpbmNsdWRpbmcgcGxhbmVzKSB1cGRhdGVz LCBidXQgYQorYml0IGRpZmZlcmVudGx5IGZyb20gdGhlIHVzdWFsIHRyYW5zYWN0aW9uYWwgYXBw cm9hY2ggb2YgdHJ5LWNvbW1pdCBhbmQKK3JvbGxiYWNrOgorCistIEZpcnN0bHksIG5vIGhhcmR3 YXJlIGNoYW5nZXMgYXJlIGFsbG93ZWQgd2hlbiB0aGUgY29tbWl0IHdvdWxkIGZhaWwuIFRoaXMK KyAgYWxsb3dzIHVzIHRvIGltcGxlbWVudCB0aGUgRFJNX01PREVfQVRPTUlDX1RFU1RfT05MWSBt b2RlLCB3aGljaCBhbGxvd3MKKyAgdXNlcnNwYWNlIHRvIGV4cGxvcmUgd2hldGhlciBjZXJ0YWlu IGNvbmZpZ3VyYXRpb25zIHdvdWxkIHdvcmsgb3Igbm90LgorCistIFRoaXMgd291bGQgc3RpbGwg YWxsb3cgc2V0dGluZyBhbmQgcm9sbGJhY2sgb2YganVzdCB0aGUgc29mdHdhcmUgc3RhdGUsCisg IHNpbXBsaWZ5aW5nIGNvbnZlcnNpb24gb2YgZXhpc3RpbmcgZHJpdmVycy4gQnV0IGF1ZGl0aW5n IGRyaXZlcnMgZm9yCisgIGNvcnJlY3RuZXNzIG9mIHRoZSBhdG9taWNfY2hlY2sgY29kZSBiZWNv bWVzIHJlYWxseSBoYXJkIHdpdGggdGhhdDogUm9sbGluZworICBiYWNrIGNoYW5nZXMgaW4gZGF0 YSBzdHJ1Y3R1cmVzIGFsbCBvdmVyIHRoZSBwbGFjZSBpcyBoYXJkIHRvIGdldCByaWdodC4KKwor LSBMYXN0bHksIGZvciBiYWNrd2FyZHMgY29tcGF0aWJpbGl0eSBhbmQgdG8gc3VwcG9ydCBhbGwg dXNlLWNhc2VzLCBhdG9taWMKKyAgdXBkYXRlcyBuZWVkIHRvIGJlIGluY3JlbWVudGFsIGFuZCBi ZSBhYmxlIHRvIGV4ZWN1dGUgaW4gcGFyYWxsZWwuIEhhcmR3YXJlCisgIGRvZXNuJ3QgYWx3YXlz IGFsbG93IGl0LCBidXQgd2hlcmUgcG9zc2libGUgcGxhbmUgdXBkYXRlcyBvbiBkaWZmZXJlbnQg Q1JUQ3MKKyAgc2hvdWxkIG5vdCBpbnRlcmZlcmUsIGFuZCBub3QgZ2V0IHN0YWxsZWQgZHVlIHRv IG91dHB1dCByb3V0aW5nIGNoYW5naW5nIG9uCisgIGRpZmZlcmVudCBDUlRDcy4KKworVGFrZW4g YWxsIHRvZ2V0aGVyIHRoZXJlJ3MgdHdvIGNvbnNlcXVlbmNlcyBmb3IgdGhlIGF0b21pYyBkZXNp Z246CisKKy0gVGhlIG92ZXJhbGwgc3RhdGUgaXMgc3BsaXQgdXAgaW50byBwZXItb2JqZWN0IHN0 YXRlIHN0cnVjdHVyZXM6CisgIDpjOnR5cGU6YHN0cnVjdCBkcm1fcGxhbmVfc3RhdGUgPGRybV9w bGFuZV9zdGF0ZT5gIGZvciBwbGFuZXMsIDpjOnR5cGU6YHN0cnVjdAorICBkcm1fY3J0Y19zdGF0 ZSA8ZHJtX2NydGNfc3RhdGU+YCBmb3IgQ1JUQ3MgYW5kIDpjOnR5cGU6YHN0cnVjdAorICBkcm1f Y29ubmVjdG9yX3N0YXRlIDxkcm1fY29ubmVjdG9yX3N0YXRlYCBmb3IgY29ubmVjdG9ycy4gVGhl c2UgYXJlIHRoZSBvbmx5CisgIG9iamVjdHMgd2l0aCB1c2Vyc3BhY2UtdmlzaWJsZSBhbmQgc2V0 dGFibGUgc3RhdGUuIEZvciBpbnRlcm5hbCBzdGF0ZSBkcml2ZXJzCisgIGNhbiBzdWJjbGFzcyB0 aGVzZSBzdHJ1Y3R1cmVzIHRocm91Z2ggZW1iZWRkZWRpbmcsIG9yIGFkZCBlbnRpcmVseSBuZXcg c3RhdGUKKyAgc3RydWN0dXJlcyBmb3IgdGhlaXIgZ2xvYmFsbHkgc2hhcmVkIGhhcmR3YXJlIGZ1 bmN0aW9ucy4KKworLSBBbiBhdG9taWMgdXBkYXRlIGlzIGFzc2VtYmxlZCBhbmQgdmFsaWRhdGVk IGFzIGFuIGVudGVyaWx5IGZyZWUtc3RhbmRpbmcgcGlsZQorICBvZiBzdHJ1Y3R1cmVzIHdpdGhp biB0aGUgOmM6dHlwZTpgZHJtX2F0b21pY19zdGF0ZSA8ZHJtX2F0b21pY19zdGF0ZT5gCisgIGNv bnRhaW5lci4gQWdhaW4gZHJpdmVycyBjYW4gc3ViY2xhc3MgdGhhdCBjb250YWluZXIgZm9yIHRo ZWlyIG93biBzdGF0ZQorICBzdHJ1Y3R1cmUgdHJhY2tpbmcgbmVlZHMuIE9ubHkgd2hlbiBhIHN0 YXRlIGlzIGNvbW1pdHRlZCBpcyBpdCBhcHBsaWVkIHRvIHRoZQorICBkcml2ZXIgYW5kIG1vZGVz ZXQgb2JqZWN0cy4gVGhpcyB3YXkgcm9sbGluZyBiYWNrIGFuIHVwZGF0ZSBib2lscyBkb3duIHRv CisgIHJlbGVhc2luZyBtZW1vcnkgYW5kIHVucmVmZXJlbmNpbmcgb2JqZWN0cyBsaWtlIGZyYW1l YnVmZmVycy4KKworUmVhZCBvbiBpbiB0aGlzIGNoYXB0ZXIsIGFuZCBhbHNvIGluIDpyZWY6YGRy bV9hdG9taWNfaGVscGVyYCBmb3IgbW9yZSBkZXRhaWxlZAorY292ZXJhZ2Ugb2Ygc3BlY2lmaWMg dG9waWNzLgorCiBBdG9taWMgTW9kZSBTZXR0aW5nIEZ1bmN0aW9uIFJlZmVyZW5jZQotPT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0KKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tCiAKIC4uIGtlcm5lbC1kb2M6OiBpbmNsdWRlL2RybS9kcm1fYXRvbWlj LmgKICAgIDppbnRlcm5hbDoKLS0gCjIuMTEuMAoKX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxAbGlz dHMuZnJlZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4v bGlzdGluZm8vZHJpLWRldmVsCg==