From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: [PATCH 07/11] drm/drm_ioctl.c: kerneldoc Date: Tue, 8 Sep 2015 13:56:27 +0200 Message-ID: <1441713391-24732-8-git-send-email-daniel.vetter@ffwll.ch> References: <1441713391-24732-1-git-send-email-daniel.vetter@ffwll.ch> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-wi0-f174.google.com (mail-wi0-f174.google.com [209.85.212.174]) by gabe.freedesktop.org (Postfix) with ESMTPS id D717B6E794 for ; Tue, 8 Sep 2015 04:53:59 -0700 (PDT) Received: by wicfx3 with SMTP id fx3so117100678wic.1 for ; Tue, 08 Sep 2015 04:53:58 -0700 (PDT) In-Reply-To: <1441713391-24732-1-git-send-email-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: DRI Development Cc: Daniel Vetter , Intel Graphics Development , Daniel Vetter List-Id: dri-devel@lists.freedesktop.org QXMgdXN1YWwgcHVsbCBpdCBpbnRvIHRoZSBkcm0gZG9jYm9vayB0ZW1wbGF0ZSwgdG9vLiBBbmQg YWdhaW4gYXMKdXN1YWwgSSd2ZSBkZWNpZGVkIHRvIG9ubHkgZG9jdW1lbnQgc3R1ZmYgZXhwb3J0 ZWQgdG8gZHJpdmVycywgc28gYWxsCnRoZSBvbGQgbGVmdG92ZXIgbWFya3VwIGZyb20gdGhlIHNo YXJlZCBkcm0gcmVwbyBkYXlzIGxvc3QgdGhlIG1hZ2ljCioqIHNpZ25hdHVyZS4KClNpZ25lZC1v ZmYtYnk6IERhbmllbCBWZXR0ZXIgPGRhbmllbC52ZXR0ZXJAaW50ZWwuY29tPgotLS0KIERvY3Vt ZW50YXRpb24vRG9jQm9vay9kcm0udG1wbCB8ICAxICsKIGRyaXZlcnMvZ3B1L2RybS9kcm1faW9j dGwuYyAgICB8IDc2ICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKy0tLS0tLS0tLS0tLQog MiBmaWxlcyBjaGFuZ2VkLCA1NSBpbnNlcnRpb25zKCspLCAyMiBkZWxldGlvbnMoLSkKCmRpZmYg LS1naXQgYS9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svZHJtLnRtcGwgYi9Eb2N1bWVudGF0aW9uL0Rv Y0Jvb2svZHJtLnRtcGwKaW5kZXggN2QxMGJlMmEyYmEwLi5jZmI0MzIwM2E2YTcgMTAwNjQ0Ci0t LSBhL0RvY3VtZW50YXRpb24vRG9jQm9vay9kcm0udG1wbAorKysgYi9Eb2N1bWVudGF0aW9uL0Rv Y0Jvb2svZHJtLnRtcGwKQEAgLTM3NTIsNiArMzc1Miw3IEBAIGludCBudW1faW9jdGxzOzwvc3lu b3BzaXM+CiAJICA8L2l0ZW1pemVkbGlzdD4KIAk8L3BhcmE+CiAgICAgICA8L3BhcmE+CishRWRy aXZlcnMvZ3B1L2RybS9kcm1faW9jdGwuYwogICAgIDwvc2VjdDI+CiAgIDwvc2VjdDE+CiAgIDxz ZWN0MT4KZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS9kcm1faW9jdGwuYyBiL2RyaXZlcnMv Z3B1L2RybS9kcm1faW9jdGwuYwppbmRleCBmMGI0ZjU4MWY2Y2UuLjc1ZGY4ZWE4N2NkNyAxMDA2 NDQKLS0tIGEvZHJpdmVycy9ncHUvZHJtL2RybV9pb2N0bC5jCisrKyBiL2RyaXZlcnMvZ3B1L2Ry bS9kcm1faW9jdGwuYwpAQCAtNDAsNyArNDAsNyBAQAogc3RhdGljIGludCBkcm1fdmVyc2lvbihz dHJ1Y3QgZHJtX2RldmljZSAqZGV2LCB2b2lkICpkYXRhLAogCQkgICAgICAgc3RydWN0IGRybV9m aWxlICpmaWxlX3ByaXYpOwogCi0vKioKKy8qCiAgKiBHZXQgdGhlIGJ1cyBpZC4KICAqCiAgKiBc cGFyYW0gaW5vZGUgZGV2aWNlIGlub2RlLgpAQCAtNzUsNyArNzUsNyBAQCBkcm1fdW5zZXRfYnVz aWQoc3RydWN0IGRybV9kZXZpY2UgKmRldiwKIAltYXN0ZXItPnVuaXF1ZV9sZW4gPSAwOwogfQog Ci0vKioKKy8qCiAgKiBTZXQgdGhlIGJ1cyBpZC4KICAqCiAgKiBccGFyYW0gaW5vZGUgZGV2aWNl IGlub2RlLgpAQCAtMTQ5LDcgKzE0OSw3IEBAIHN0YXRpYyBpbnQgZHJtX3NldF9idXNpZChzdHJ1 Y3QgZHJtX2RldmljZSAqZGV2LCBzdHJ1Y3QgZHJtX2ZpbGUgKmZpbGVfcHJpdikKIAlyZXR1cm4g MDsKIH0KIAotLyoqCisvKgogICogR2V0IGEgbWFwcGluZyBpbmZvcm1hdGlvbi4KICAqCiAgKiBc cGFyYW0gaW5vZGUgZGV2aWNlIGlub2RlLgpAQCAtMjAxLDcgKzIwMSw3IEBAIHN0YXRpYyBpbnQg ZHJtX2dldG1hcChzdHJ1Y3QgZHJtX2RldmljZSAqZGV2LCB2b2lkICpkYXRhLAogCXJldHVybiAw OwogfQogCi0vKioKKy8qCiAgKiBHZXQgY2xpZW50IGluZm9ybWF0aW9uLgogICoKICAqIFxwYXJh bSBpbm9kZSBkZXZpY2UgaW5vZGUuCkBAIC0yNDQsNyArMjQ0LDcgQEAgc3RhdGljIGludCBkcm1f Z2V0Y2xpZW50KHN0cnVjdCBkcm1fZGV2aWNlICpkZXYsIHZvaWQgKmRhdGEsCiAJfQogfQogCi0v KioKKy8qCiAgKiBHZXQgc3RhdGlzdGljcyBpbmZvcm1hdGlvbi4KICAqCiAgKiBccGFyYW0gaW5v ZGUgZGV2aWNlIGlub2RlLgpAQCAtMjY1LDcgKzI2NSw3IEBAIHN0YXRpYyBpbnQgZHJtX2dldHN0 YXRzKHN0cnVjdCBkcm1fZGV2aWNlICpkZXYsIHZvaWQgKmRhdGEsCiAJcmV0dXJuIDA7CiB9CiAK LS8qKgorLyoKICAqIEdldCBkZXZpY2UvZHJpdmVyIGNhcGFiaWxpdGllcwogICovCiBzdGF0aWMg aW50IGRybV9nZXRjYXAoc3RydWN0IGRybV9kZXZpY2UgKmRldiwgdm9pZCAqZGF0YSwgc3RydWN0 IGRybV9maWxlICpmaWxlX3ByaXYpCkBAIC0zMTgsNyArMzE4LDcgQEAgc3RhdGljIGludCBkcm1f Z2V0Y2FwKHN0cnVjdCBkcm1fZGV2aWNlICpkZXYsIHZvaWQgKmRhdGEsIHN0cnVjdCBkcm1fZmls ZSAqZmlsZV8KIAlyZXR1cm4gMDsKIH0KIAotLyoqCisvKgogICogU2V0IGRldmljZS9kcml2ZXIg Y2FwYWJpbGl0aWVzCiAgKi8KIHN0YXRpYyBpbnQKQEAgLTM1Miw3ICszNTIsNyBAQCBkcm1fc2V0 Y2xpZW50Y2FwKHN0cnVjdCBkcm1fZGV2aWNlICpkZXYsIHZvaWQgKmRhdGEsIHN0cnVjdCBkcm1f ZmlsZSAqZmlsZV9wcml2KQogCXJldHVybiAwOwogfQogCi0vKioKKy8qCiAgKiBTZXR2ZXJzaW9u IGlvY3RsLgogICoKICAqIFxwYXJhbSBpbm9kZSBkZXZpY2UgaW5vZGUuCkBAIC00MDYsNyArNDA2 LDE4IEBAIGRvbmU6CiAJcmV0dXJuIHJldGNvZGU7CiB9CiAKLS8qKiBOby1vcCBpb2N0bC4gKi8K Ky8qKgorICogZHJtX25vb3AgLSBEUk0gbm8tb3AgaW9jdGwgaW1wbGVtbnRhdGlvbgorICogQGRl djogRFJNIGRldmljZSBmb3IgdGhlIGlvY3RsCisgKiBAZGF0YTogZGF0YSBwb2ludGVyIGZvciB0 aGUgaW9jdGwKKyAqIEBmaWxlX3ByaXY6IERSTSBmaWxlIGZvciB0aGUgaW9jdGwgY2FsbAorICoK KyAqIFRoaXMgbm8tb3AgaW1wbGVtZW50YXRpb24gZm9yIGRybSBpb2N0bHMgaXMgdXNlZnVsIGZv ciBkZXByZWNhdGVkCisgKiBmdW5jdGlvbmFsaXR5IHdoZXJlIHdlIGNhbid0IHJldHVybiBhIGZh aWx1cmUgY29kZSBiZWNhdXNlIGV4aXN0aW5nIHVzZXJzcGFjZQorICogY2hlY2tzIHRoZSByZXN1 bHQgb2YgdGhlIGlvY3RsLCBidXQgZG9lc24ndCBjYXJlIGFib3V0IHRoZSBhY3Rpb24uCisgKgor ICogQWx3YXlzIHJldHVybnMgc3VjY2Vzc2Z1bGx5IHdpdGggMC4KKyAqLwogaW50IGRybV9ub29w KHN0cnVjdCBkcm1fZGV2aWNlICpkZXYsIHZvaWQgKmRhdGEsCiAJICAgICBzdHJ1Y3QgZHJtX2Zp bGUgKmZpbGVfcHJpdikKIHsKQEAgLTQxNSw2ICs0MjYsMjEgQEAgaW50IGRybV9ub29wKHN0cnVj dCBkcm1fZGV2aWNlICpkZXYsIHZvaWQgKmRhdGEsCiB9CiBFWFBPUlRfU1lNQk9MKGRybV9ub29w KTsKIAorLyoqCisgKiBkcm1faW52YWxpZF9vcCAtIERSTSBpbnZhbGlkIGlvY3RsIGltcGxlbW50 YXRpb24KKyAqIEBkZXY6IERSTSBkZXZpY2UgZm9yIHRoZSBpb2N0bAorICogQGRhdGE6IGRhdGEg cG9pbnRlciBmb3IgdGhlIGlvY3RsCisgKiBAZmlsZV9wcml2OiBEUk0gZmlsZSBmb3IgdGhlIGlv Y3RsIGNhbGwKKyAqCisgKiBUaGlzIG5vLW9wIGltcGxlbWVudGF0aW9uIGZvciBkcm0gaW9jdGxz IGlzIHVzZWZ1bCBmb3IgZGVwcmVjYXRlZAorICogZnVuY3Rpb25hbGl0eSB3aGVyZSB3ZSByZWFs bHkgZG9uJ3Qgd2FudCB0byBhbGxvdyB1c2Vyc3BhY2UgdG8gY2FsbCB0aGUgaW9jdGwKKyAqIGFu eSBtb3JlLiBUaGlzIGlzIHRoZSBjYXNlIGZvciBvbGQgdW1zIGludGVyZmFjZXMgZm9yIGRyaXZl cnMgdGhhdAorICogdHJhbnNpdGlvbmVkIHRvIGttcyBncmFkdWFsbHkgYW5kIHNvIGtlcHQgdGhl IG9sZCBsZWdhY3kgdGFibGVzIGFyb3VuZC4gVGhpcworICogb25seSBhcHBsaWVzIHRvIHJhZGVv biBhbmQgaTkxNSBrbXMgZHJpdmVycywgb3RoZXIgZHJpdmVycyBzaG91bGRuJ3QgbmVlZCB0bwor ICogdXNlIHRoaXMgZnVuY3Rpb24uCisgKgorICogQWx3YXlzIGZhaWxzIHdpdGggYSByZXR1cm4g dmFsdWUgb2YgLUVJTlZBTC4KKyAqLwogaW50IGRybV9pbnZhbGlkX29wKHN0cnVjdCBkcm1fZGV2 aWNlICpkZXYsIHZvaWQgKmRhdGEsCiAJCSAgIHN0cnVjdCBkcm1fZmlsZSAqZmlsZV9wcml2KQog ewpAQCAtNDIyLDcgKzQ0OCw3IEBAIGludCBkcm1faW52YWxpZF9vcChzdHJ1Y3QgZHJtX2Rldmlj ZSAqZGV2LCB2b2lkICpkYXRhLAogfQogRVhQT1JUX1NZTUJPTChkcm1faW52YWxpZF9vcCk7CiAK LS8qKgorLyoKICAqIENvcHkgYW5kIElPQ1RMIHJldHVybiBzdHJpbmcgdG8gdXNlciBzcGFjZQog ICovCiBzdGF0aWMgaW50IGRybV9jb3B5X2ZpZWxkKGNoYXIgX191c2VyICpidWYsIHNpemVfdCAq YnVmX2xlbiwgY29uc3QgY2hhciAqdmFsdWUpCkBAIC00NDUsNyArNDcxLDcgQEAgc3RhdGljIGlu dCBkcm1fY29weV9maWVsZChjaGFyIF9fdXNlciAqYnVmLCBzaXplX3QgKmJ1Zl9sZW4sIGNvbnN0 IGNoYXIgKnZhbHVlKQogCXJldHVybiAwOwogfQogCi0vKioKKy8qCiAgKiBHZXQgdmVyc2lvbiBp bmZvcm1hdGlvbgogICoKICAqIFxwYXJhbSBpbm9kZSBkZXZpY2UgaW5vZGUuCkBAIC00NzcsNyAr NTAzLDcgQEAgc3RhdGljIGludCBkcm1fdmVyc2lvbihzdHJ1Y3QgZHJtX2RldmljZSAqZGV2LCB2 b2lkICpkYXRhLAogCXJldHVybiBlcnI7CiB9CiAKLS8qKgorLyoKICAqIGRybV9pb2N0bF9wZXJt aXQgLSBDaGVjayBpb2N0bCBwZXJtaXNzaW9ucyBhZ2FpbnN0IGNhbGxlcgogICoKICAqIEBmbGFn czogaW9jdGwgcGVybWlzc2lvbiBmbGFncy4KQEAgLTUyNSw3ICs1NTEsNyBAQCBFWFBPUlRfU1lN Qk9MKGRybV9pb2N0bF9wZXJtaXQpOwogCQkubmFtZSA9ICNpb2N0bAkJCVwKIAl9CiAKLS8qKiBJ b2N0bCB0YWJsZSAqLworLyogSW9jdGwgdGFibGUgKi8KIHN0YXRpYyBjb25zdCBzdHJ1Y3QgZHJt X2lvY3RsX2Rlc2MgZHJtX2lvY3Rsc1tdID0gewogCURSTV9JT0NUTF9ERUYoRFJNX0lPQ1RMX1ZF UlNJT04sIGRybV92ZXJzaW9uLCBEUk1fVU5MT0NLRUR8RFJNX1JFTkRFUl9BTExPVyksCiAJRFJN X0lPQ1RMX0RFRihEUk1fSU9DVExfR0VUX1VOSVFVRSwgZHJtX2dldHVuaXF1ZSwgMCksCkBAIC02 NDEsMTYgKzY2NywxNiBAQCBzdGF0aWMgY29uc3Qgc3RydWN0IGRybV9pb2N0bF9kZXNjIGRybV9p b2N0bHNbXSA9IHsKICNkZWZpbmUgRFJNX0NPUkVfSU9DVExfQ09VTlQJQVJSQVlfU0laRSggZHJt X2lvY3RscyApCiAKIC8qKgotICogQ2FsbGVkIHdoZW5ldmVyIGEgcHJvY2VzcyBwZXJmb3JtcyBh biBpb2N0bCBvbiAvZGV2L2RybS4KLSAqCi0gKiBccGFyYW0gaW5vZGUgZGV2aWNlIGlub2RlLgot ICogXHBhcmFtIGZpbGVfcHJpdiBEUk0gZmlsZSBwcml2YXRlLgotICogXHBhcmFtIGNtZCBjb21t YW5kLgotICogXHBhcmFtIGFyZyB1c2VyIGFyZ3VtZW50LgotICogXHJldHVybiB6ZXJvIG9uIHN1 Y2Nlc3Mgb3IgbmVnYXRpdmUgbnVtYmVyIG9uIGZhaWx1cmUuCisgKiBkcm1faW9jdGwgLSBpb2N0 bCBjYWxsYmFjayBpbXBsZW1lbnRhdGlvbiBmb3IgRFJNIGRyaXZlcnMKKyAqIEBmaWxwOiBmaWxl IHRoaXMgaW9jdGwgaXMgY2FsbGVkIG9uCisgKiBAY21kOiBpb2N0bCBjbWQgbnVtYmVyCisgKiBA YXJnOiB1c2VyIGFyZ3VtZW50CiAgKgogICogTG9va3MgdXAgdGhlIGlvY3RsIGZ1bmN0aW9uIGlu IHRoZSA6OmlvY3RscyB0YWJsZSwgY2hlY2tpbmcgZm9yIHJvb3QKICAqIHByZXZpbGVnZXMgaWYg c28gcmVxdWlyZWQsIGFuZCBkaXNwYXRjaGVzIHRvIHRoZSByZXNwZWN0aXZlIGZ1bmN0aW9uLgor ICoKKyAqIFJldHVybnM6CisgKiBaZXJvIG9uIHN1Y2Nlc3MsIG5lZ2F0aXZlIGVycm9yIGNvZGUg b24gZmFpbHVyZS4KICAqLwogbG9uZyBkcm1faW9jdGwoc3RydWN0IGZpbGUgKmZpbHAsCiAJICAg ICAgdW5zaWduZWQgaW50IGNtZCwgdW5zaWduZWQgbG9uZyBhcmcpCkBAIC03NjAsOSArNzg2LDE1 IEBAIEVYUE9SVF9TWU1CT0woZHJtX2lvY3RsKTsKIAogLyoqCiAgKiBkcm1faW9jdGxfZmxhZ3Mg LSBDaGVjayBmb3IgY29yZSBpb2N0bCBhbmQgcmV0dXJuIGlvY3RsIHBlcm1pc3Npb24gZmxhZ3MK KyAqIEBucjogaW9jdGwgbnVtYmVyCisgKiBAZmxhZ3M6IHdoZXJlIHRvIHJldHVybiB0aGUgaW9j dGwgcGVybWlzc2lvbiBmbGFncworICoKKyAqIFRoaXMgaW9jdGwgaXMgb25seSB1c2VkIGJ5IHRo ZSB2bXdnZnggZHJpdmVyIHRvIGF1Z21lbnQgdGhlIGFjY2VzcyBjaGVja3MKKyAqIGRvbmUgYnkg dGhlIGRybSBjb3JlIGFuZCBpbnNvZmFyIGEgcHJldHR5IGRlY2VudCBsYXllcmluZyB2aW9sYXRp b24uIFRoaXMKKyAqIHNob3VsZG4ndCBiZSB1c2VkIGJ5IGFueSBkcml2ZXJzLgogICoKLSAqIEBu cjogSW9jdGwgbnVtYmVyLgotICogQGZsYWdzOiBXaGVyZSB0byByZXR1cm4gdGhlIGlvY3RsIHBl cm1pc3Npb24gZmxhZ3MKKyAqIFJldHVybnM6CisgKiBUcnVlIGlmIHRoZSBAbnIgY29ycmVzcG9u ZHMgdG8gYSBEUk0gY29yZSBpb2N0bCBudW1lciwgZmFsc2Ugb3RoZXJ3aXNlLgogICovCiBib29s IGRybV9pb2N0bF9mbGFncyh1bnNpZ25lZCBpbnQgbnIsIHVuc2lnbmVkIGludCAqZmxhZ3MpCiB7 Ci0tIAoyLjUuMQoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0b3Aub3Jn Cmh0dHA6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9kcmktZGV2ZWwK