From mboxrd@z Thu Jan 1 00:00:00 1970 From: Archit Taneja Subject: [PATCH v4 2/2] drm/DocBook: Add more drm_bridge documentation Date: Thu, 21 May 2015 11:03:17 +0530 Message-ID: <1432186397-27666-2-git-send-email-architt@codeaurora.org> References: <1432186397-27666-1-git-send-email-architt@codeaurora.org> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from smtp.codeaurora.org (smtp.codeaurora.org [198.145.29.96]) by gabe.freedesktop.org (Postfix) with ESMTP id 4185B6E15F for ; Wed, 20 May 2015 22:33:30 -0700 (PDT) In-Reply-To: <1432186397-27666-1-git-send-email-architt@codeaurora.org> 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, daniel.vetter@ffwll.ch Cc: airlied@redhat.com, andy.yan@rock-chips.com, ajaykumar.rs@samsung.com List-Id: dri-devel@lists.freedesktop.org QWRkIERPQyBzZWN0aW9ucyBnaXZpbmcgYW4gb3ZlcnZpZXcgb2YgZHJtX2JyaWRnZSBhbmQgaG93 IHRvIGZpbGwgdXAgdGhlCmRybV9icmlkZ2VfZnVuY3Mgb3BzLiBBZGQgdGhlc2UgdG8gZHJtLnRw bWwgaW4gRG9jQm9vay4KCkFkZCBoZWFkZXJkb2NzIGZvciBmdW5jcyBpbiBkcm1fYnJpZGdlLmMg dGhhdCBkb24ndCBoYXZlIHRoZW0geWV0LgoKU2lnbmVkLW9mZi1ieTogQXJjaGl0IFRhbmVqYSA8 YXJjaGl0dEBjb2RlYXVyb3JhLm9yZz4KLS0tCiBEb2N1bWVudGF0aW9uL0RvY0Jvb2svZHJtLnRt cGwgfCAxMiArKysrKysKIGRyaXZlcnMvZ3B1L2RybS9kcm1fYnJpZGdlLmMgICB8IDk0ICsrKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKwogMiBmaWxlcyBjaGFuZ2VkLCAx MDYgaW5zZXJ0aW9ucygrKQoKZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vRG9jQm9vay9kcm0u dG1wbCBiL0RvY3VtZW50YXRpb24vRG9jQm9vay9kcm0udG1wbAppbmRleCA5NzY1YTRjLi4xZGMw ZjQ1IDEwMDY0NAotLS0gYS9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svZHJtLnRtcGwKKysrIGIvRG9j dW1lbnRhdGlvbi9Eb2NCb29rL2RybS50bXBsCkBAIC0yNDM5LDYgKzI0MzksMTggQEAgdm9pZCBp bnRlbF9jcnRfaW5pdChzdHJ1Y3QgZHJtX2RldmljZSAqZGV2KQogCSAgPHRpdGxlPlRpbGUgZ3Jv dXA8L3RpdGxlPgogIVBkcml2ZXJzL2dwdS9kcm0vZHJtX2NydGMuYyBUaWxlIGdyb3VwCiAgICAg PC9zZWN0Mj4KKyAgICA8c2VjdDI+CisJPHRpdGxlPkJyaWRnZXM8L3RpdGxlPgorICAgICAgPHNl Y3QzPgorCSA8dGl0bGU+T3ZlcnZpZXc8L3RpdGxlPgorIVBkcml2ZXJzL2dwdS9kcm0vZHJtX2Jy aWRnZS5jIG92ZXJ2aWV3CisgICAgICA8L3NlY3QzPgorICAgICAgPHNlY3QzPgorCSA8dGl0bGU+ RGVmYXVsdCBicmlkZ2UgY2FsbGJhY2sgc2VxdWVuY2U8L3RpdGxlPgorIVBkcml2ZXJzL2dwdS9k cm0vZHJtX2JyaWRnZS5jIGJyaWRnZSBjYWxsYmFja3MKKyAgICAgIDwvc2VjdDM+CishRWRyaXZl cnMvZ3B1L2RybS9kcm1fYnJpZGdlLmMKKyAgICA8L3NlY3QyPgogICA8L3NlY3QxPgogCiAgIDwh LS0gSW50ZXJuYWxzOiBrbXMgcHJvcGVydGllcyAtLT4KZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1 L2RybS9kcm1fYnJpZGdlLmMgYi9kcml2ZXJzL2dwdS9kcm0vZHJtX2JyaWRnZS5jCmluZGV4IGMz YTg1Y2UuLmE3YzRlMTAgMTAwNjQ0Ci0tLSBhL2RyaXZlcnMvZ3B1L2RybS9kcm1fYnJpZGdlLmMK KysrIGIvZHJpdmVycy9ncHUvZHJtL2RybV9icmlkZ2UuYwpAQCAtMjgsOSArMjgsNDIgQEAKIAog I2luY2x1ZGUgImRybS9kcm1QLmgiCiAKKy8qKgorICogRE9DOiBvdmVydmlldworICoKKyAqIGRy bV9icmlkZ2UgcmVwcmVzZW50cyBhIGRldmljZSB0aGF0IGhhbmdzIG9uIHRvIGFuIGVuY29kZXIu IFRoZXNlIGFyZSBoYW5keQorICogd2hlbiBhIHJlZ3VsYXIgZHJtX2VuY29kZXIgZW50aXR5IGlz bid0IGVub3VnaCB0byByZXByZXNlbnQgdGhlIGVudGlyZQorICogZW5jb2RlciBjaGFpbi4KKyAq CisgKiBBIGJyaWRnZSBpcyBhbHdheXMgYXNzb2NpYXRlZCB0byBhIHNpbmdsZSBkcm1fZW5jb2Rl ciBhdCBhIHRpbWUsIGJ1dCBjYW4gYmUKKyAqIGVpdGhlciBjb25uZWN0ZWQgdG8gaXQgZGlyZWN0 bHksIG9yIHRocm91Z2ggYW4gaW50ZXJtZWRpYXRlIGJyaWRnZToKKyAqCisgKiBlbmNvZGVyIC0t LT4gYnJpZGdlIEIgLS0tPiBicmlkZ2UgQQorICoKKyAqIEhlcmUsIHRoZSBvdXRwdXQgb2YgdGhl IGVuY29kZXIgZmVlZHMgdG8gYnJpZGdlIEIsIGFuZCB0aGF0IGZ1cnRoZXJzIGZlZWRzIHRvCisg KiBicmlkZ2UgQS4KKyAqCisgKiBUaGUgZHJpdmVyIHVzaW5nIHRoZSBicmlkZ2UgaXMgcmVzcG9u c2libGUgdG8gbWFrZSB0aGUgYXNzb2NpYXRpb25zIGJldHdlZW4KKyAqIHRoZSBlbmNvZGVyIGFu ZCBicmlkZ2VzLiBPbmNlIHRoZXNlIGxpbmtzIGFyZSBtYWRlLCB0aGUgYnJpZGdlcyB3aWxsCisg KiBwYXJ0aWNpcGF0ZSBhbG9uZyB3aXRoIGVuY29kZXIgZnVuY3Rpb25zIHRvIHBlcmZvcm0gbW9k ZV9zZXQvZW5hYmxlL2Rpc2FibGUKKyAqIHRocm91Z2ggdGhlIG9wcyBwcm92aWRlZCBpbiBkcm1f YnJpZGdlX2Z1bmNzLgorICoKKyAqIGRybV9icmlkZ2UsIGxpa2UgZHJtX3BhbmVsLCBhcmVuJ3Qg ZHJtX21vZGVfb2JqZWN0IGVudGl0aWVzIGxpa2UgcGxhbmVzLAorICogY3J0Y3MsIGVuY29kZXJz IG9yIGNvbm5lY3RvcnMuIFRoZXkganVzdCBwcm92aWRlIGFkZGl0aW9uYWwgaG9va3MgdG8gZ2V0 IHRoZQorICogZGVzaXJlZCBvdXRwdXQgYXQgdGhlIGVuZCBvZiB0aGUgZW5jb2RlciBjaGFpbi4K KyAqLworCiBzdGF0aWMgREVGSU5FX01VVEVYKGJyaWRnZV9sb2NrKTsKIHN0YXRpYyBMSVNUX0hF QUQoYnJpZGdlX2xpc3QpOwogCisvKioKKyAqIGRybV9icmlkZ2VfYWRkIC0gYWRkIHRoZSBnaXZl biBicmlkZ2UgdG8gdGhlIGdsb2JhbCBicmlkZ2UgbGlzdAorICoKKyAqIEBicmlkZ2U6IGJyaWRn ZSBjb250cm9sIHN0cnVjdHVyZQorICoKKyAqIFJFVFVSTlM6CisgKiBVbmNvbmRpdGlvbmFsbHkg cmV0dXJucyBaZXJvLgorICovCiBpbnQgZHJtX2JyaWRnZV9hZGQoc3RydWN0IGRybV9icmlkZ2Ug KmJyaWRnZSkKIHsKIAltdXRleF9sb2NrKCZicmlkZ2VfbG9jayk7CkBAIC00MSw2ICs3NCwxMSBA QCBpbnQgZHJtX2JyaWRnZV9hZGQoc3RydWN0IGRybV9icmlkZ2UgKmJyaWRnZSkKIH0KIEVYUE9S VF9TWU1CT0woZHJtX2JyaWRnZV9hZGQpOwogCisvKioKKyAqIGRybV9icmlkZ2VfcmVtb3ZlIC0g cmVtb3ZlIHRoZSBnaXZlbiBicmlkZ2UgZnJvbSB0aGUgZ2xvYmFsIGJyaWRnZSBsaXN0CisgKgor ICogQGJyaWRnZTogYnJpZGdlIGNvbnRyb2wgc3RydWN0dXJlCisgKi8KIHZvaWQgZHJtX2JyaWRn ZV9yZW1vdmUoc3RydWN0IGRybV9icmlkZ2UgKmJyaWRnZSkKIHsKIAltdXRleF9sb2NrKCZicmlk Z2VfbG9jayk7CkBAIC00OSw2ICs4NywyMSBAQCB2b2lkIGRybV9icmlkZ2VfcmVtb3ZlKHN0cnVj dCBkcm1fYnJpZGdlICpicmlkZ2UpCiB9CiBFWFBPUlRfU1lNQk9MKGRybV9icmlkZ2VfcmVtb3Zl KTsKIAorLyoqCisgKiBkcm1fYnJpZGdlX2F0dGFjaCAtIGFzc29jaWF0ZSBnaXZlbiBicmlkZ2Ug dG8gb3VyIERSTSBkZXZpY2UKKyAqCisgKiBAZGV2OiBEUk0gZGV2aWNlCisgKiBAYnJpZGdlOiBi cmlkZ2UgY29udHJvbCBzdHJ1Y3R1cmUKKyAqCisgKiBjYWxsZWQgYnkgYSBrbXMgZHJpdmVyIHRv IGxpbmsgb25lIG9mIG91ciBlbmNvZGVyL2JyaWRnZSB0byB0aGUgZ2l2ZW4KKyAqIGJyaWRnZS4K KyAqCisgKiBOb3RlIHRoYXQgc2V0dGluZyB1cCBsaW5rcyBiZXR3ZWVuIHRoZSBicmlkZ2UgYW5k IG91ciBlbmNvZGVyL2JyaWRnZQorICogb2JqZWN0cyBuZWVkcyB0byBiZSBoYW5kbGVkIGJ5IHRo ZSBrbXMgZHJpdmVyIGl0c2VsZgorICoKKyAqIFJFVFVSTlM6CisgKiBaZXJvIG9uIHN1Y2Nlc3Ms IGVycm9yIGNvZGUgb24gZmFpbHVyZQorICovCiBpbnQgZHJtX2JyaWRnZV9hdHRhY2goc3RydWN0 IGRybV9kZXZpY2UgKmRldiwgc3RydWN0IGRybV9icmlkZ2UgKmJyaWRnZSkKIHsKIAlpZiAoIWRl diB8fCAhYnJpZGdlKQpAQCAtNjcsNiArMTIwLDM4IEBAIGludCBkcm1fYnJpZGdlX2F0dGFjaChz dHJ1Y3QgZHJtX2RldmljZSAqZGV2LCBzdHJ1Y3QgZHJtX2JyaWRnZSAqYnJpZGdlKQogRVhQT1JU X1NZTUJPTChkcm1fYnJpZGdlX2F0dGFjaCk7CiAKIC8qKgorICogRE9DOiBicmlkZ2UgY2FsbGJh Y2tzCisgKgorICogVGhlIGRybV9icmlkZ2VfZnVuY3Mgb3BzIGFyZSBwb3B1bGF0ZWQgYnkgdGhl IGJyaWRnZSBkcml2ZXIuIFRoZSBkcm0KKyAqIGludGVybmFscyhhdG9taWMgYW5kIGNydGMgaGVs cGVycykgdXNlIHRoZSBoZWxwZXJzIGRlZmluZWQgaW4gZHJtX2JyaWRnZS5jCisgKiBUaGVzZSBo ZWxwZXJzIGNhbGwgYSBzcGVjaWZpYyBkcm1fYnJpZGdlX2Z1bmNzIG9wIGZvciBhbGwgdGhlIGJy aWRnZXMKKyAqIGR1cmluZyBlbmNvZGVyIGNvbmZpZ3VyYXRpb24uCisgKgorICogV2hlbiBjcmVh dGluZyBhIGJyaWRnZSBkcml2ZXIsIG9uZSBjYW4gaW1wbGVtZW50IGRybV9icmlkZ2VfZnVuY3Mg b3Agd2l0aAorICogdGhlIGhlbHAgb2YgdGhlc2Ugcm91Z2ggcnVsZXM6CisgKgorICogcHJlX2Vu YWJsZTogdGhpcyBjb250YWlucyB0aGluZ3MgbmVlZGVkIHRvIGJlIGRvbmUgZm9yIHRoZSBicmlk Z2UgYmVmb3JlCisgKiBpdHMgY2xvY2sgYW5kIHRpbWluZ3MgYXJlIGVuYWJsZWQgYnkgaXRzIHNv dXJjZS4gRm9yIGEgYnJpZGdlLCBpdHMgc291cmNlCisgKiBpcyBnZW5lcmFsbHkgdGhlIGVuY29k ZXIgb3IgYnJpZGdlIGp1c3QgYmVmb3JlIGl0IGluIHRoZSBlbmNvZGVyIGNoYWluLgorICoKKyAq IGVuYWJsZTogdGhpcyBjb250YWlucyB0aGluZ3MgbmVlZHMgdG8gYmUgZG9uZSBmb3IgdGhlIGJy aWRnZSBvbmNlIGl0cworICogc291cmNlIGlzIGVuYWJsZWQuIEluIG90aGVyIHdvcmRzLCBlbmFi bGUgaXMgY2FsbGVkIG9uY2UgdGhlIHNvdXJjZSBpcworICogcmVhZHkgd2l0aCBjbG9jayBhbmQg dGltaW5nIG5lZWRlZCBieSB0aGUgYnJpZGdlLgorICoKKyAqIGRpc2FibGU6IHRoaXMgY29udGFp bnMgdGhpbmdzIG5lZWRlZCB0byBiZSBkb25lIGZvciB0aGUgYnJpZGdlIGFzc3VtaW5nCisgKiB0 aGF0IGl0cyBzb3VyY2UgaXMgc3RpbGwgZW5hYmxlZCwgaS5lLiBjbG9jayBhbmQgdGltaW5ncyBh cmUgc3RpbGwgb24uCisgKgorICogcG9zdF9kaXNhYmxlOiB0aGlzIGNvbnRhaW5zIHRoaW5ncyBu ZWVkZWQgdG8gYmUgZG9uZSBmb3IgdGhlIGJyaWRnZSBvbmNlCisgKiBpdHMgc291cmNlIGlzIGRp c2FibGVkLCBpLmUuIG9uY2UgY2xvY2tzIGFuZCB0aW1pbmdzIGFyZSBvZmYuCisgKgorICogbW9k ZV9maXh1cDogdGhpcyBzaG91bGQgZml4dXAgdGhlIGdpdmVuIG1vZGUgZm9yIHRoZSBicmlkZ2Uu IEl0IGlzIGNhbGxlZAorICogYWZ0ZXIgdGhlIGVuY29kZXIncyBtb2RlIGZpeHVwLgorICoKKyAq IG1vZGVfc2V0OiB0aGlzIHNldHMgdXAgdGhlIG1vZGUgZm9yIHRoZSBicmlkZ2UuIEl0IGFzc3Vt ZXMgdGhhdCBpdHMgc291cmNlCisgKiAoYW4gZW5jb2RlciBvciBhIGJyaWRnZSkgaGFzIHNldCB0 aGUgbW9kZSB0b28uCisgKi8KKworLyoqCiAgKiBkcm1fYnJpZGdlX21vZGVfZml4dXAgLSBmaXh1 cCBwcm9wb3NlZCBtb2RlIGZvciBhbGwgYnJpZGdlcyBpbiB0aGUKICAqCQkJICAgZW5jb2RlciBj aGFpbgogICogQGJyaWRnZTogYnJpZGdlIGNvbnRyb2wgc3RydWN0dXJlCkBAIC0yMTQsNiArMjk5 LDE1IEBAIHZvaWQgZHJtX2JyaWRnZV9lbmFibGUoc3RydWN0IGRybV9icmlkZ2UgKmJyaWRnZSkK IEVYUE9SVF9TWU1CT0woZHJtX2JyaWRnZV9lbmFibGUpOwogCiAjaWZkZWYgQ09ORklHX09GCisv KioKKyAqIG9mX2RybV9maW5kX2JyaWRnZSAtIGZpbmQgdGhlIGJyaWRnZSBjb3JyZXNwb25kaW5n IHRvIHRoZSBkZXZpY2Ugbm9kZSBpbgorICoJCQl0aGUgZ2xvYmFsIGJyaWRnZSBsaXN0CisgKgor ICogQG5wOiBkZXZpY2Ugbm9kZQorICoKKyAqIFJFVFVSTlM6CisgKiBkcm1fYnJpZGdlIGNvbnRy b2wgc3RydWN0IG9uIHN1Y2Nlc3MsIE5VTEwgb24gZmFpbHVyZQorICovCiBzdHJ1Y3QgZHJtX2Jy aWRnZSAqb2ZfZHJtX2ZpbmRfYnJpZGdlKHN0cnVjdCBkZXZpY2Vfbm9kZSAqbnApCiB7CiAJc3Ry dWN0IGRybV9icmlkZ2UgKmJyaWRnZTsKLS0gClRoZSBRdWFsY29tbSBJbm5vdmF0aW9uIENlbnRl ciwgSW5jLiBpcyBhIG1lbWJlciBvZiB0aGUgQ29kZSBBdXJvcmEgRm9ydW0sCmhvc3RlZCBieSBU aGUgTGludXggRm91bmRhdGlvbgoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxAbGlzdHMuZnJlZWRl c2t0b3Aub3JnCmh0dHA6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9k cmktZGV2ZWwK