From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: [PATCH 3/5] drm/syncobj: some kerneldoc polish Date: Thu, 14 Dec 2017 21:30:52 +0100 Message-ID: <20171214203054.20141-4-daniel.vetter@ffwll.ch> References: <20171214203054.20141-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-x242.google.com (mail-wm0-x242.google.com [IPv6:2a00:1450:400c:c09::242]) by gabe.freedesktop.org (Postfix) with ESMTPS id 5524B6E71D for ; Thu, 14 Dec 2017 20:31:04 +0000 (UTC) Received: by mail-wm0-x242.google.com with SMTP id 64so13771565wme.3 for ; Thu, 14 Dec 2017 12:31:04 -0800 (PST) In-Reply-To: <20171214203054.20141-1-daniel.vetter@ffwll.ch> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: DRI Development Cc: Daniel Vetter , Intel Graphics Development , Daniel Vetter List-Id: intel-gfx@lists.freedesktop.org Q29tcGxldGUgYSBmZXcgbWlzc2luZyBiaXRzLCBmaXggdXAgdGhlIGV4aXN0aW5nIHhjcm9zcy1y ZWZlcmVuY2VzIGFuZAphZGQgYSBidW5jaCBtb3JlLgoKQ2M6IERhdmUgQWlybGllIDxhaXJsaWVk QGdtYWlsLmNvbT4gdmlhIGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpTaWduZWQtb2ZmLWJ5OiBEYW5p ZWwgVmV0dGVyIDxkYW5pZWwudmV0dGVyQGludGVsLmNvbT4KLS0tCiBkcml2ZXJzL2dwdS9kcm0v ZHJtX3N5bmNvYmouYyB8IDQ1ICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr Ky0tLS0KIGluY2x1ZGUvZHJtL2RybV9zeW5jb2JqLmggICAgIHwgMzIgKysrKysrKysrKysrKysr KystLS0tLS0tLS0tLS0tCiAyIGZpbGVzIGNoYW5nZWQsIDYwIGluc2VydGlvbnMoKyksIDE3IGRl bGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS9kcm1fc3luY29iai5jIGIv ZHJpdmVycy9ncHUvZHJtL2RybV9zeW5jb2JqLmMKaW5kZXggOWI3MzNjNTEwY2JmLi5iNmQwYzJj NDAwZWMgMTAwNjQ0Ci0tLSBhL2RyaXZlcnMvZ3B1L2RybS9kcm1fc3luY29iai5jCisrKyBiL2Ry aXZlcnMvZ3B1L2RybS9kcm1fc3luY29iai5jCkBAIC0yOSw5ICsyOSw5IEBACiAvKioKICAqIERP QzogT3ZlcnZpZXcKICAqCi0gKiBEUk0gc3luY2hyb25pc2F0aW9uIG9iamVjdHMgKHN5bmNvYmop IGFyZSBhIHBlcnNpc3RlbnQgb2JqZWN0cywKLSAqIHRoYXQgY29udGFpbiBhbiBvcHRpb25hbCBm ZW5jZS4gVGhlIGZlbmNlIGNhbiBiZSB1cGRhdGVkIHdpdGggYSBuZXcKLSAqIGZlbmNlLCBvciBi ZSBOVUxMLgorICogRFJNIHN5bmNocm9uaXNhdGlvbiBvYmplY3RzIChzeW5jb2JqLCBzZWUgc3Ry dWN0ICZkcm1fc3luY29iaikgYXJlIGEKKyAqIHBlcnNpc3RlbnQgb2JqZWN0cywgdGhhdCBjb250 YWluIGFuIG9wdGlvbmFsIGZlbmNlLiBUaGUgZmVuY2UgY2FuIGJlIHVwZGF0ZWQKKyAqIHdpdGgg YSBuZXcgZmVuY2UsIG9yIGJlIE5VTEwuCiAgKgogICogc3luY29iaidzIGNhbiBiZSB3YWl0ZWQg dXBvbiwgd2hlcmUgaXQgd2lsbCB3YWl0IGZvciB0aGUgdW5kZXJseWluZwogICogZmVuY2UuCkBA IC02MSw3ICs2MSw4IEBACiAgKiBAZmlsZV9wcml2YXRlOiBkcm0gZmlsZSBwcml2YXRlIHBvaW50 ZXIKICAqIEBoYW5kbGU6IHN5bmMgb2JqZWN0IGhhbmRsZSB0byBsb29rdXAuCiAgKgotICogUmV0 dXJucyBhIHJlZmVyZW5jZSB0byB0aGUgc3luY29iaiBwb2ludGVkIHRvIGJ5IGhhbmRsZSBvciBO VUxMLgorICogUmV0dXJucyBhIHJlZmVyZW5jZSB0byB0aGUgc3luY29iaiBwb2ludGVkIHRvIGJ5 IGhhbmRsZSBvciBOVUxMLiBUaGUKKyAqIHJlZmVyZW5jZSBtdXN0IGJlIHJlbGVhc2VkIGJ5IGNh bGxpbmcgZHJtX3N5bmNvYmpfcHV0KCkuCiAgKi8KIHN0cnVjdCBkcm1fc3luY29iaiAqZHJtX3N5 bmNvYmpfZmluZChzdHJ1Y3QgZHJtX2ZpbGUgKmZpbGVfcHJpdmF0ZSwKIAkJCQkgICAgIHUzMiBo YW5kbGUpCkBAIC0yMjksNiArMjMwLDE5IEBAIHN0YXRpYyBpbnQgZHJtX3N5bmNvYmpfYXNzaWdu X251bGxfaGFuZGxlKHN0cnVjdCBkcm1fc3luY29iaiAqc3luY29iaikKIAlyZXR1cm4gMDsKIH0K IAorLyoqCisgKiBkcm1fc3luY29ial9maW5kX2ZlbmNlIC0gbG9va3VwIGFuZCByZWZlcmVuY2Ug dGhlIGZlbmNlIGluIGEgc3luYyBvYmplY3QKKyAqIEBmaWxlX3ByaXZhdGU6IGRybSBmaWxlIHBy aXZhdGUgcG9pbnRlcgorICogQGhhbmRsZTogc3luYyBvYmplY3QgaGFuZGxlIHRvIGxvb2t1cC4K KyAqIEBmZW5jZTogb3V0IHBhcmFtZXRlciBmb3IgdGhlIGZlbmNlCisgKgorICogVGhpcyBpcyBq dXN0IGEgY29udmVuaWVuY2UgZnVuY3Rpb24gdGhhdCBjb21iaW5lcyBkcm1fc3luY29ial9maW5k KCkgYW5kCisgKiBkcm1fc3luY29ial9mZW5jZV9nZXQoKS4KKyAqCisgKiBSZXR1cm5zIDAgb24g c3VjY2VzcyBvciBhIG5lZ2F0aXZlIGVycm9yIHZhbHVlIG9uIGZhaWx1cmUuIE9uIHN1Y2Nlc3Mg QGZlbmNlCisgKiBjb250YWlucyBhIHJlZmVyZW5jZSB0byB0aGUgZmVuY2UsIHdoaWNoIG11cyBi ZSByZWxlYXNlZCBieSBjYWxsaW5nCisgKiBkbWFfZmVuY2VfcHV0KCkuCisgKi8KIGludCBkcm1f c3luY29ial9maW5kX2ZlbmNlKHN0cnVjdCBkcm1fZmlsZSAqZmlsZV9wcml2YXRlLAogCQkJICAg dTMyIGhhbmRsZSwKIAkJCSAgIHN0cnVjdCBkbWFfZmVuY2UgKipmZW5jZSkKQEAgLTI2OSw2ICsy ODMsMTIgQEAgRVhQT1JUX1NZTUJPTChkcm1fc3luY29ial9mcmVlKTsKICAqIEBvdXRfc3luY29i ajogcmV0dXJuZWQgc3luY29iagogICogQGZsYWdzOiBEUk1fU1lOQ09CSl8qIGZsYWdzCiAgKiBA ZmVuY2U6IGlmIG5vbi1OVUxMLCB0aGUgc3luY29iaiB3aWxsIHJlcHJlc2VudCB0aGlzIGZlbmNl CisgKgorICogVGhpcyBpcyB0aGUgZmlyc3QgZnVuY3Rpb24gdG8gY3JlYXRlIGEgc3luYyBvYmpl Y3QuIEFmdGVyIGNyZWF0aW5nIGRyaXZlcnMKKyAqIHByb2JhYmx5IHdhbnQgdG8gbWFrZSBpdCBh dmFpbGFibGUgdG8gdXNlcnNwYWNlLCBlaXRoZXIgdGhyb3VnaAorICogZHJtX3N5bmNvYmpfZ2V0 X2hhbmRsZSgpIG9yIGRybV9zeW5jb2JqX2dldF9mZCgpLgorICoKKyAqIFJldHVybnMgMCBvbiBz dWNjZXNzIG9yIGEgbmVnYXRpdmUgZXJyb3IgdmFsdWUgb24gZmFpbHVyZS4KICAqLwogaW50IGRy bV9zeW5jb2JqX2NyZWF0ZShzdHJ1Y3QgZHJtX3N5bmNvYmogKipvdXRfc3luY29iaiwgdWludDMy X3QgZmxhZ3MsCiAJCSAgICAgICBzdHJ1Y3QgZG1hX2ZlbmNlICpmZW5jZSkKQEAgLTMwMiw2ICsz MjIsMTQgQEAgRVhQT1JUX1NZTUJPTChkcm1fc3luY29ial9jcmVhdGUpOwogCiAvKioKICAqIGRy bV9zeW5jb2JqX2dldF9oYW5kbGUgLSBnZXQgYSBoYW5kbGUgZnJvbSBhIHN5bmNvYmoKKyAqIEBm aWxlX3ByaXZhdGU6IGRybSBmaWxlIHByaXZhdGUgcG9pbnRlcgorICogQHN5bmNvYmo6IFN5bmMg b2JqZWN0IHRvIGV4cG9ydAorICogQGhhbmRsZTogb3V0IHBhcmFtZXRlciB3aXRoIHRoZSBuZXcg aGFuZGxlCisgKgorICogRXhwb3J0cyBhIHN5bmMgb2JqZWN0IGNyZWF0ZWQgd2l0aCBkcm1fc3lu Y29ial9jcmVhdGUoKSBhcyBhIGhhbmRsZSBvbgorICogQGZpbGVfcHJpdmF0ZSB0byB1c2Vyc3Bh Y2UuCisgKgorICogUmV0dXJucyAwIG9uIHN1Y2Nlc3Mgb3IgYSBuZWdhdGl2ZSBlcnJvciB2YWx1 ZSBvbiBmYWlsdXJlLgogICovCiBpbnQgZHJtX3N5bmNvYmpfZ2V0X2hhbmRsZShzdHJ1Y3QgZHJt X2ZpbGUgKmZpbGVfcHJpdmF0ZSwKIAkJCSAgIHN0cnVjdCBkcm1fc3luY29iaiAqc3luY29iaiwg dTMyICpoYW5kbGUpCkBAIC0zODgsNiArNDE2LDE1IEBAIHN0YXRpYyBpbnQgZHJtX3N5bmNvYmpf YWxsb2NfZmlsZShzdHJ1Y3QgZHJtX3N5bmNvYmogKnN5bmNvYmopCiAJcmV0dXJuIDA7CiB9CiAK Ky8qKgorICogZHJtX3N5bmNvYmpfZ2V0X2ZkIC0gZ2V0IGEgZmlsZSBkZXNjcmlwdG9yIGZyb20g YSBzeW5jb2JqCisgKiBAc3luY29iajogU3luYyBvYmplY3QgdG8gZXhwb3J0CisgKiBAcF9mZDog b3V0IHBhcmFtZXRlciB3aXRoIHRoZSBuZXcgZmlsZSBkZXNjcmlwdG9yCisgKgorICogRXhwb3J0 cyBhIHN5bmMgb2JqZWN0IGNyZWF0ZWQgd2l0aCBkcm1fc3luY29ial9jcmVhdGUoKSBhcyBhIGZp bGUgZGVzY3JpcHRvci4KKyAqCisgKiBSZXR1cm5zIDAgb24gc3VjY2VzcyBvciBhIG5lZ2F0aXZl IGVycm9yIHZhbHVlIG9uIGZhaWx1cmUuCisgKi8KIGludCBkcm1fc3luY29ial9nZXRfZmQoc3Ry dWN0IGRybV9zeW5jb2JqICpzeW5jb2JqLCBpbnQgKnBfZmQpCiB7CiAJaW50IHJldDsKZGlmZiAt LWdpdCBhL2luY2x1ZGUvZHJtL2RybV9zeW5jb2JqLmggYi9pbmNsdWRlL2RybS9kcm1fc3luY29i ai5oCmluZGV4IDllOGJhOTBjNjc4NC4uODc4NjU3NzRiZGFhIDEwMDY0NAotLS0gYS9pbmNsdWRl L2RybS9kcm1fc3luY29iai5oCisrKyBiL2luY2x1ZGUvZHJtL2RybV9zeW5jb2JqLmgKQEAgLTMz LDM2ICszMywzMSBAQCBzdHJ1Y3QgZHJtX3N5bmNvYmpfY2I7CiAvKioKICAqIHN0cnVjdCBkcm1f c3luY29iaiAtIHN5bmMgb2JqZWN0LgogICoKLSAqIFRoaXMgc3RydWN0dXJlIGRlZmluZXMgYSBn ZW5lcmljIHN5bmMgb2JqZWN0IHdoaWNoIHdyYXBzIGEgZG1hIGZlbmNlLgorICogVGhpcyBzdHJ1 Y3R1cmUgZGVmaW5lcyBhIGdlbmVyaWMgc3luYyBvYmplY3Qgd2hpY2ggd3JhcHMgYSAmZG1hX2Zl bmNlLgogICovCiBzdHJ1Y3QgZHJtX3N5bmNvYmogewogCS8qKgotCSAqIEByZWZjb3VudDoKLQkg KgotCSAqIFJlZmVyZW5jZSBjb3VudCBvZiB0aGlzIG9iamVjdC4KKwkgKiBAcmVmY291bnQ6IFJl ZmVyZW5jZSBjb3VudCBvZiB0aGlzIG9iamVjdC4KIAkgKi8KIAlzdHJ1Y3Qga3JlZiByZWZjb3Vu dDsKIAkvKioKIAkgKiBAZmVuY2U6CiAJICogTlVMTCBvciBhIHBvaW50ZXIgdG8gdGhlIGZlbmNl IGJvdW5kIHRvIHRoaXMgb2JqZWN0LgogCSAqCi0JICogVGhpcyBmaWVsZCBzaG91bGQgbm90IGJl IHVzZWQgZGlyZWN0bHkuICBVc2UgZHJtX3N5bmNvYmpfZmVuY2VfZ2V0Ci0JICogYW5kIGRybV9z eW5jb2JqX3JlcGxhY2VfZmVuY2UgaW5zdGVhZC4KKwkgKiBUaGlzIGZpZWxkIHNob3VsZCBub3Qg YmUgdXNlZCBkaXJlY3RseS4gVXNlIGRybV9zeW5jb2JqX2ZlbmNlX2dldCgpCisJICogYW5kIGRy bV9zeW5jb2JqX3JlcGxhY2VfZmVuY2UoKSBpbnN0ZWFkLgogCSAqLwogCXN0cnVjdCBkbWFfZmVu Y2UgX19yY3UgKmZlbmNlOwogCS8qKgotCSAqIEBjYl9saXN0OgotCSAqIExpc3Qgb2YgY2FsbGJh Y2tzIHRvIGNhbGwgd2hlbiB0aGUgZmVuY2UgZ2V0cyByZXBsYWNlZAorCSAqIEBjYl9saXN0OiBM aXN0IG9mIGNhbGxiYWNrcyB0byBjYWxsIHdoZW4gdGhlICZmZW5jZSBnZXRzIHJlcGxhY2VkLgog CSAqLwogCXN0cnVjdCBsaXN0X2hlYWQgY2JfbGlzdDsKIAkvKioKLQkgKiBAbG9jazoKLQkgKiBs b2NrcyBjYl9saXN0IGFuZCB3cml0ZS1sb2NrcyBmZW5jZS4KKwkgKiBAbG9jazogUHJvdGVjdHMg JmNiX2xpc3QgYW5kIHdyaXRlLWxvY2tzICZmZW5jZS4KIAkgKi8KIAlzcGlubG9ja190IGxvY2s7 CiAJLyoqCi0JICogQGZpbGU6Ci0JICogYSBmaWxlIGJhY2tpbmcgZm9yIHRoaXMgc3luY29iai4K KwkgKiBAZmlsZTogQSBmaWxlIGJhY2tpbmcgZm9yIHRoaXMgc3luY29iai4KIAkgKi8KIAlzdHJ1 Y3QgZmlsZSAqZmlsZTsKIH07CkBAIC03Myw3ICs2OCw3IEBAIHR5cGVkZWYgdm9pZCAoKmRybV9z eW5jb2JqX2Z1bmNfdCkoc3RydWN0IGRybV9zeW5jb2JqICpzeW5jb2JqLAogLyoqCiAgKiBzdHJ1 Y3QgZHJtX3N5bmNvYmpfY2IgLSBjYWxsYmFjayBmb3IgZHJtX3N5bmNvYmpfYWRkX2NhbGxiYWNr CiAgKiBAbm9kZTogdXNlZCBieSBkcm1fc3luY29iX2FkZF9jYWxsYmFjayB0byBhcHBlbmQgdGhp cyBzdHJ1Y3QgdG8KLSAqCSAgc3luY29iajo6Y2JfbGlzdAorICoJICAmZHJtX3N5bmNvYmouY2Jf bGlzdAogICogQGZ1bmM6IGRybV9zeW5jb2JqX2Z1bmNfdCB0byBjYWxsCiAgKgogICogVGhpcyBz dHJ1Y3Qgd2lsbCBiZSBpbml0aWFsaXplZCBieSBkcm1fc3luY29ial9hZGRfY2FsbGJhY2ssIGFk ZGl0aW9uYWwKQEAgLTExMSw2ICsxMDYsMTcgQEAgZHJtX3N5bmNvYmpfcHV0KHN0cnVjdCBkcm1f c3luY29iaiAqb2JqKQogCWtyZWZfcHV0KCZvYmotPnJlZmNvdW50LCBkcm1fc3luY29ial9mcmVl KTsKIH0KIAorLyoqCisgKiBkcm1fc3luY29ial9mZW5jZV9nZXQgLSBnZXQgYSByZWZlcmVuY2Ug dG8gYSBmZW5jZSBpbiBhIHN5bmMgb2JqZWN0CisgKiBAc3luY29iajogc3luYyBvYmplY3QuCisg KgorICogVGhpcyBhY3F1aXJlcyBhZGRpdGlvbmFsIHJlZmVyZW5jZSB0byAmZHJtX3N5bmNvYmou ZmVuY2UgY29udGFpbmVkIGluIEBvYmosCisgKiBpZiBub3QgTlVMTC4gSXQgaXMgaWxsZWdhbCB0 byBjYWxsIHRoaXMgd2l0aG91dCBhbHJlYWR5IGhvbGRpbmcgYSByZWZlcmVuY2UuCisgKiBObyBs b2NrcyByZXF1aXJlZC4KKyAqCisgKiBSZXR1cm5zOgorICogRWl0aGVyIHRoZSBmZW5jZSBvZiBA b2JqIG9yIE5VTEwgaWYgdGhlcmUncyBub25lLgorICovCiBzdGF0aWMgaW5saW5lIHN0cnVjdCBk bWFfZmVuY2UgKgogZHJtX3N5bmNvYmpfZmVuY2VfZ2V0KHN0cnVjdCBkcm1fc3luY29iaiAqc3lu Y29iaikKIHsKLS0gCjIuMTUuMQoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX18KSW50ZWwtZ2Z4IG1haWxpbmcgbGlzdApJbnRlbC1nZnhAbGlzdHMuZnJlZWRl c2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8v aW50ZWwtZ2Z4Cg==