From mboxrd@z Thu Jan 1 00:00:00 1970 From: Thierry Reding Subject: [PATCH libdrm 3/3] tests/util: Add some API documentation Date: Mon, 30 Jan 2017 11:29:23 +0100 Message-ID: <20170130102923.1991-3-thierry.reding@gmail.com> References: <20170130102923.1991-1-thierry.reding@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-wm0-x243.google.com (mail-wm0-x243.google.com [IPv6:2a00:1450:400c:c09::243]) by gabe.freedesktop.org (Postfix) with ESMTPS id 7A48E6E3CB for ; Mon, 30 Jan 2017 10:29:30 +0000 (UTC) Received: by mail-wm0-x243.google.com with SMTP id r18so4947651wmd.3 for ; Mon, 30 Jan 2017 02:29:30 -0800 (PST) Received: from localhost (port-6519.pppoe.wtnet.de. [84.46.25.144]) by smtp.gmail.com with ESMTPSA id t123sm18021041wmt.8.2017.01.30.02.29.27 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 30 Jan 2017 02:29:27 -0800 (PST) In-Reply-To: <20170130102923.1991-1-thierry.reding@gmail.com> 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 List-Id: dri-devel@lists.freedesktop.org RnJvbTogVGhpZXJyeSBSZWRpbmcgPHRyZWRpbmdAbnZpZGlhLmNvbT4KCk5vbmUgb2YgdGhlIGhl bHBlcnMgY3VycmVudGx5IGhhdmUgYW55IGRvY3VtZW50YXRpb24uIEFkZCBzb21lIHRvIG1ha2UK aXQgbW9yZSBvYnZpb3VzIGhvdyB0aGVzZSBzaG91bGQgYmUgdXNlZC4KClNpZ25lZC1vZmYtYnk6 IFRoaWVycnkgUmVkaW5nIDx0cmVkaW5nQG52aWRpYS5jb20+Ci0tLQogdGVzdHMvdXRpbC9rbXMu YyB8IDUxICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KwogMSBmaWxlIGNoYW5nZWQsIDUxIGluc2VydGlvbnMoKykKCmRpZmYgLS1naXQgYS90ZXN0cy91 dGlsL2ttcy5jIGIvdGVzdHMvdXRpbC9rbXMuYwppbmRleCBjNWQzNWFiNjE2ZDEuLjIyNjM4NjUx OWQ0OSAxMDA2NDQKLS0tIGEvdGVzdHMvdXRpbC9rbXMuYworKysgYi90ZXN0cy91dGlsL2ttcy5j CkBAIC0xMjgsNiArMTI4LDEzIEBAIGNvbnN0IGNoYXIgKnV0aWxfbG9va3VwX2Nvbm5lY3Rvcl90 eXBlX25hbWUodW5zaWduZWQgaW50IHR5cGUpCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICBBUlJBWV9TSVpFKGNvbm5lY3Rvcl90eXBlX25hbWVzKSk7CiB9CiAKKy8qKgorICogUmV0 cmlldmUgdGhlIG5hbWUgb2YgdGhlIGtlcm5lbCBkcml2ZXIgZm9yIGEgRFJNIGRldmljZS4KKyAq CisgKiBccGFyYW0gZmQgdGhlIGZpbGUgZGVzY3JpcHRvciBvZiB0aGUgRFJNIGRldmljZQorICoK KyAqIFxyZXR1cm4gT24gc3VjY2VzcywgcmV0dXJucyB0aGUgbmFtZSBvZiB0aGUga2VybmVsIGRy aXZlci4KKyAqLwogY2hhciAqdXRpbF9nZXRfZHJpdmVyKGludCBmZCkKIHsKICAgICBkcm1WZXJz aW9uUHRyIHZlcnNpb247CkBAIC0xNDQsNiArMTUxLDE2IEBAIGNoYXIgKnV0aWxfZ2V0X2RyaXZl cihpbnQgZmQpCiAgICAgcmV0dXJuIGRyaXZlcjsKIH0KIAorLyoqCisgKiBSZXRyaWV2ZSBhIGxp c3Qgb2YgYXZhaWxhYmxlIERSTSBkZXZpY2VzLgorICoKKyAqIFxwYXJhbSBkZXZpY2VzcCByZXR1 cm4gbG9jYXRpb24gZm9yIHRoZSBsaXN0IG9mIERSTSBkZXZpY2VzCisgKiBccGFyYW0gZmxhZ3Mg Yml0bWFzayBvZiBmbGFncyBjb250cm9sbGluZyBvcGVyYXRpb24KKyAqCisgKiBccmV0dXJuIE9u IHN1Y2Nlc3MsIHJldHVybnMgdGhlIG51bWJlciBvZiBkZXZpY2VzIGZvdW5kLiBUaGUgbGlzdCBv ZiBEUk0KKyAqIGRldmljZXMgaXMgZHluYW1pY2FsbHkgYWxsb2NhdGVkIGFuZCBuZWVkcyB0byBi ZSBmcmVlZCBieSBhIGNhbGwgdG8gdGhlCisgKiB1dGlsX2ZyZWVfZGV2aWNlcygpIGZ1bmN0aW9u LgorICovCiBpbnQgdXRpbF9nZXRfZGV2aWNlcyhkcm1EZXZpY2VQdHIgKipkZXZpY2VzcCwgdWlu dDMyX3QgZmxhZ3MpCiB7CiAgICAgZHJtRGV2aWNlUHRyICpkZXZpY2VzOwpAQCAtMTgyLDEyICsx OTksMzIgQEAgaW50IHV0aWxfZ2V0X2RldmljZXMoZHJtRGV2aWNlUHRyICoqZGV2aWNlc3AsIHVp bnQzMl90IGZsYWdzKQogICAgIHJldHVybiBjb3VudDsKIH0KIAorLyoqCisgKiBGcmVlIGEgbGlz dCBvZiBEUk0gZGV2aWNlcy4KKyAqCisgKiBccGFyYW0gZGV2aWNlcyBhIGxpc3Qgb2YgRFJNIGRl dmljZXMsIGFsbG9jYXRlZCBieSB1dGlsX2dldF9kZXZpY2VzKCkKKyAqIFxwYXJhbSBjb3VudCB0 aGUgbnVtYmVyIG9mIERSTSBkZXZpY2VzIGluIFxwIGRldmljZXMKKyAqLwogdm9pZCB1dGlsX2Zy ZWVfZGV2aWNlcyhkcm1EZXZpY2VQdHIgKmRldmljZXMsIHVuc2lnbmVkIGludCBjb3VudCkKIHsK ICAgICBkcm1GcmVlRGV2aWNlcyhkZXZpY2VzLCBjb3VudCk7CiAgICAgZnJlZShkZXZpY2VzKTsK IH0KIAorLyoqCisgKiBPcGVucyBhIERSTSBkZXZpY2UsIG9wdGlvbmFsbHkgY2hlY2tpbmcgYWdh aW5zdCBpdHMga2VybmVsIGRyaXZlci4KKyAqCisgKiBccGFyYW0gZGV2aWNlIHBhdGggdG8gRFJN IGRldmljZQorICogXHBhcmFtIG1vZHVsZSBvcHRpb25hbCBuYW1lIG9mIGtlcm5lbCBkcml2ZXIK KyAqCisgKiBccmV0dXJuIE9uIHN1Y2Nlc3MsIGEgZmlsZSBkZXNjcmlwdG9yIHRvIFxwIGRldmlj ZSwgb3IgYSBuZWdhdGl2ZSBlcnJvcgorICogY29kZSBvbiBmYWlsdXJlLgorICoKKyAqIElmIHRo ZSBjYWxsZXIgZG9lc24ndCBjYXJlIGFib3V0IHRoZSBrZXJuZWwgZHJpdmVyIGFzc29jaWF0ZWQg d2l0aCB0aGUgRFJNCisgKiBkZXZpY2UsIHRoZW4gdGhlIFxwIG1vZHVsZSBwYXJhbWV0ZXIgY2Fu IGJlIE5VTEwuIElmIFxwIG1vZHVsZSBpcyBub3QgTlVMTAorICogdGhpcyBmdW5jdGlvbiB3aWxs IHJldHJpZXZlIHRoZSBuYW1lIG9mIHRoZSBrZXJuZWwgZHJpdmVyIGFuZCBjb21wYXJlIGl0Cisg KiB0byB0aGUgXHAgbW9kdWxlIHBhcmFtZXRlci4gSWYgdGhlIG5hbWVzIGRvbid0IG1hdGNoLCB0 aGUgY2FsbCB3aWxsIGZhaWwuCisgKi8KIGludCB1dGlsX29wZW5fd2l0aF9tb2R1bGUoY29uc3Qg Y2hhciAqZGV2aWNlLCBjb25zdCBjaGFyICptb2R1bGUpCiB7CiAgICAgaW50IGZkLCBlcnIgPSAw OwpAQCAtMjI5LDYgKzI2NiwyMCBAQCBvdXQ6CiAgICAgcmV0dXJuIGVycjsKIH0KIAorLyoqCisg KiBPcGVucyBhIERSTSBkZXZpY2UsIG9wdGlvbmFsbHkgY2hlY2tpbmcgYWdhaW5zdCBpdHMga2Vy bmVsIGRyaXZlci4KKyAqCisgKiBccGFyYW0gZGV2aWNlCisgKiBccGFyYW0gbW9kdWxlCisgKgor ICogXHJldHVybiBPbiBzdWNjZXNzLCBhIGZpbGUgZGVzY3JpcHRvciB0byBccCBkZXZpY2UsIG9y IGEgbmVnYXRpdmUgZXJyb3IKKyAqIGNvZGUgb24gZmFpbHVyZS4KKyAqCisgKiBUaGlzIGlzIHNp bWlsYXIgdG8gdXRpbF9vcGVuX3dpdGhfbW9kdWxlKCksIGV4Y2VwdCB0aGF0IFxwIGRldmljZSBj YW4gYmUKKyAqIE5VTEwsIGluIHdoaWNoIGNhc2UgYWxsIGF2YWlsYWJsZSBkZXZpY2VzIHdpbGwg YmUgdHJpZWQuIElmIFxwIG1vZHVsZSBpcworICogc3BlY2lmaWVkIGl0IHdpbGwgYWN0IGFzIGEg ZmlsdGVyLiBPdGhlcndpc2UgdGhlIGZpcnN0IGF2YWlsYWJsZSBkZXZpY2UKKyAqIHRoYXQgY2Fu IGJlIG9wZW5lZCB3aWxsIGJlIHVzZWQuCisgKi8KIGludCB1dGlsX29wZW4oY29uc3QgY2hhciAq ZGV2aWNlLCBjb25zdCBjaGFyICptb2R1bGUpCiB7CiAgICAgaW50IGZkLCBlcnI7Ci0tIAoyLjEx LjAKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1k ZXZlbCBtYWlsaW5nIGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczov L2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAo=