From mboxrd@z Thu Jan 1 00:00:00 1970 From: Samuel Li Subject: [PATCH v2 1/1] drm: add kernel doc for exported gem dmabuf_ops Date: Thu, 18 Jan 2018 16:44:20 -0500 Message-ID: <1516311860-24949-1-git-send-email-Samuel.Li@amd.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: amd-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org Cc: Samuel Li List-Id: amd-gfx.lists.freedesktop.org U2lnbmVkLW9mZi1ieTogU2FtdWVsIExpIDxTYW11ZWwuTGlAYW1kLmNvbT4KUmV2aWV3ZWQtYnk6 IERhbmllbCBWZXR0ZXIgPGRhbmllbC52ZXR0ZXJAZmZ3bGwuY2g+Ci0tLQogZHJpdmVycy9ncHUv ZHJtL2RybV9wcmltZS5jIHwgODggKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrCiAxIGZpbGUgY2hhbmdlZCwgODggaW5zZXJ0aW9ucygrKQoKZGlmZiAtLWdpdCBh L2RyaXZlcnMvZ3B1L2RybS9kcm1fcHJpbWUuYyBiL2RyaXZlcnMvZ3B1L2RybS9kcm1fcHJpbWUu YwppbmRleCBjYTA5Y2U3Li5lODJhOTc2IDEwMDY0NAotLS0gYS9kcml2ZXJzL2dwdS9kcm0vZHJt X3ByaW1lLmMKKysrIGIvZHJpdmVycy9ncHUvZHJtL2RybV9wcmltZS5jCkBAIC03Myw2ICs3Myw5 IEBACiAgKiBEcml2ZXJzIHNob3VsZCBkZXRlY3QgdGhpcyBzaXR1YXRpb24gYW5kIHJldHVybiBi YWNrIHRoZSBnZW0gb2JqZWN0CiAgKiBmcm9tIHRoZSBkbWEtYnVmIHByaXZhdGUuICBQcmltZSB3 aWxsIGRvIHRoaXMgYXV0b21hdGljYWxseSBmb3IgZHJpdmVycyB0aGF0CiAgKiB1c2UgdGhlIGRy bV9nZW1fcHJpbWVfe2ltcG9ydCxleHBvcnR9IGhlbHBlcnMuCisgKgorICogR0VNIHN0cnVjdCAm ZG1hX2J1Zl9vcHMgc3ltYm9scyBhcmUgbm93IGV4cG9ydGVkLiBUaGV5IGNhbiBiZSByZXN1ZWQg YnkKKyAqIGRyaXZlcnMgd2hpY2ggaW1wbGVtZW50IEdFTSBpbnRlcmZhY2UuCiAgKi8KIAogc3Ry dWN0IGRybV9wcmltZV9tZW1iZXIgewpAQCAtMTgwLDYgKzE4MywxOCBAQCBzdGF0aWMgaW50IGRy bV9wcmltZV9sb29rdXBfYnVmX2hhbmRsZShzdHJ1Y3QgZHJtX3ByaW1lX2ZpbGVfcHJpdmF0ZSAq cHJpbWVfZnByaQogCXJldHVybiAtRU5PRU5UOwogfQogCisvKioKKyAqIGRybV9nZW1fbWFwX2F0 dGFjaCAtIGRtYV9idWYgYXR0YWNoIGltcGxlbWVudGF0aW9uIGZvciBHRU0KKyAqIEBkbWFfYnVm OiBidWZmZXIgdG8gYXR0YWNoIGRldmljZSB0bworICogQHRhcmdldF9kZXY6IG5vdCB1c2VkCisg KiBAYXR0YWNoOiBidWZmZXIgYXR0YWNobWVudCBkYXRhCisgKgorICogQWxsb2NhdGVzICZkcm1f cHJpbWVfYXR0YWNobWVudCBhbmQgY2FsbHMgJmRybV9kcml2ZXIuZ2VtX3ByaW1lX3BpbiBmb3IK KyAqIGRldmljZSBzcGVjaWZpYyBhdHRhY2htZW50LiBUaGlzIGNhbiBiZSB1c2VkIGFzIHRoZSAm ZG1hX2J1Zl9vcHMuYXR0YWNoCisgKiBjYWxsYmFjay4KKyAqCisgKiBSZXR1cm5zIDAgb24gc3Vj Y2VzcywgbmVnYXRpdmUgZXJyb3IgY29kZSBvbiBmYWlsdXJlLgorICovCiBpbnQgZHJtX2dlbV9t YXBfYXR0YWNoKHN0cnVjdCBkbWFfYnVmICpkbWFfYnVmLCBzdHJ1Y3QgZGV2aWNlICp0YXJnZXRf ZGV2LAogCQkgICAgICAgc3RydWN0IGRtYV9idWZfYXR0YWNobWVudCAqYXR0YWNoKQogewpAQCAt MjAxLDYgKzIxNiwxNCBAQCBpbnQgZHJtX2dlbV9tYXBfYXR0YWNoKHN0cnVjdCBkbWFfYnVmICpk bWFfYnVmLCBzdHJ1Y3QgZGV2aWNlICp0YXJnZXRfZGV2LAogfQogRVhQT1JUX1NZTUJPTChkcm1f Z2VtX21hcF9hdHRhY2gpOwogCisvKioKKyAqIGRybV9nZW1fbWFwX2RldGFjaCAtIGRtYV9idWYg ZGV0YWNoIGltcGxlbWVudGF0aW9uIGZvciBHRU0KKyAqIEBkbWFfYnVmOiBidWZmZXIgdG8gZGV0 YWNoIGZyb20KKyAqIEBhdHRhY2g6IGF0dGFjaG1lbnQgdG8gYmUgZGV0YWNoZWQKKyAqCisgKiBD bGVhbnMgdXAgJmRtYV9idWZfYXR0YWNobWVudC4gVGhpcyBjYW4gYmUgdXNlZCBhcyB0aGUgJmRt YV9idWZfb3BzLmRldGFjaAorICogY2FsbGJhY2suCisgKi8KIHZvaWQgZHJtX2dlbV9tYXBfZGV0 YWNoKHN0cnVjdCBkbWFfYnVmICpkbWFfYnVmLAogCQkJc3RydWN0IGRtYV9idWZfYXR0YWNobWVu dCAqYXR0YWNoKQogewpAQCAtMjU1LDYgKzI3OCwxOCBAQCB2b2lkIGRybV9wcmltZV9yZW1vdmVf YnVmX2hhbmRsZV9sb2NrZWQoc3RydWN0IGRybV9wcmltZV9maWxlX3ByaXZhdGUgKnByaW1lX2Zw cgogCX0KIH0KIAorLyoqCisgKiBkcm1fZ2VtX21hcF9kbWFfYnVmIC0gbWFwX2RtYV9idWYgaW1w bGVtZW50YXRpb24gZm9yIEdFTQorICogQGF0dGFjaDogYXR0YWNobWVudCB3aG9zZSBzY2F0dGVy bGlzdCBpcyB0byBiZSByZXR1cm5lZAorICogQGRpcjogZGlyZWN0aW9uIG9mIERNQSB0cmFuc2Zl cgorICoKKyAqIENhbGxzICZkcm1fZHJpdmVyLmdlbV9wcmltZV9nZXRfc2dfdGFibGUgYW5kIHRo ZW4gbWFwcyB0aGUgc2NhdHRlcmxpc3QuIFRoaXMKKyAqIGNhbiBiZSB1c2VkIGFzIHRoZSAmZG1h X2J1Zl9vcHMubWFwX2RtYV9idWYgY2FsbGJhY2suCisgKgorICogUmV0dXJucyBzZ190YWJsZSBj b250YWluaW5nIHRoZSBzY2F0dGVybGlzdCB0byBiZSByZXR1cm5lZDsgcmV0dXJucyBFUlJfUFRS CisgKiBvbiBlcnJvci4gTWF5IHJldHVybiAtRUlOVFIgaWYgaXQgaXMgaW50ZXJydXB0ZWQgYnkg YSBzaWduYWwuCisgKi8KKwogc3RydWN0IHNnX3RhYmxlICpkcm1fZ2VtX21hcF9kbWFfYnVmKHN0 cnVjdCBkbWFfYnVmX2F0dGFjaG1lbnQgKmF0dGFjaCwKIAkJCQkgICAgIGVudW0gZG1hX2RhdGFf ZGlyZWN0aW9uIGRpcikKIHsKQEAgLTI5NCw2ICszMjksMTIgQEAgc3RydWN0IHNnX3RhYmxlICpk cm1fZ2VtX21hcF9kbWFfYnVmKHN0cnVjdCBkbWFfYnVmX2F0dGFjaG1lbnQgKmF0dGFjaCwKIH0K IEVYUE9SVF9TWU1CT0woZHJtX2dlbV9tYXBfZG1hX2J1Zik7CiAKKy8qKgorICogZHJtX2dlbV91 bm1hcF9kbWFfYnVmIC0gdW5tYXBfZG1hX2J1ZiBpbXBsZW1lbnRhdGlvbiBmb3IgR0VNCisgKgor ICogTm90IGltcGxlbWVudGVkLiBUaGUgdW5tYXAgaXMgZG9uZSBhdCBkcm1fZ2VtX21hcF9kZXRh Y2goKS4gIFRoaXMgY2FuIGJlCisgKiB1c2VkIGFzIHRoZSAmZG1hX2J1Zl9vcHMudW5tYXBfZG1h X2J1ZiBjYWxsYmFjay4KKyAqLwogdm9pZCBkcm1fZ2VtX3VubWFwX2RtYV9idWYoc3RydWN0IGRt YV9idWZfYXR0YWNobWVudCAqYXR0YWNoLAogCQkJICAgc3RydWN0IHNnX3RhYmxlICpzZ3QsCiAJ CQkgICBlbnVtIGRtYV9kYXRhX2RpcmVjdGlvbiBkaXIpCkBAIC0zNTEsNiArMzkyLDE1IEBAIHZv aWQgZHJtX2dlbV9kbWFidWZfcmVsZWFzZShzdHJ1Y3QgZG1hX2J1ZiAqZG1hX2J1ZikKIH0KIEVY UE9SVF9TWU1CT0woZHJtX2dlbV9kbWFidWZfcmVsZWFzZSk7CiAKKy8qKgorICogZHJtX2dlbV9k bWFidWZfdm1hcCAtIGRtYV9idWYgdm1hcCBpbXBsZW1lbnRhdGlvbiBmb3IgR0VNCisgKiBAZG1h X2J1ZjogYnVmZmVyIHRvIGJlIG1hcHBlZAorICoKKyAqIFNldHMgdXAgYSBrZXJuZWwgdmlydHVh bCBtYXBwaW5nLiBUaGlzIGNhbiBiZSB1c2VkIGFzIHRoZSAmZG1hX2J1Zl9vcHMudm1hcAorICog Y2FsbGJhY2suCisgKgorICogUmV0dXJucyB0aGUga2VybmVsIHZpcnR1YWwgYWRkcmVzcy4KKyAq Lwogdm9pZCAqZHJtX2dlbV9kbWFidWZfdm1hcChzdHJ1Y3QgZG1hX2J1ZiAqZG1hX2J1ZikKIHsK IAlzdHJ1Y3QgZHJtX2dlbV9vYmplY3QgKm9iaiA9IGRtYV9idWYtPnByaXY7CkBAIC0zNjAsNiAr NDEwLDE0IEBAIHZvaWQgKmRybV9nZW1fZG1hYnVmX3ZtYXAoc3RydWN0IGRtYV9idWYgKmRtYV9i dWYpCiB9CiBFWFBPUlRfU1lNQk9MKGRybV9nZW1fZG1hYnVmX3ZtYXApOwogCisvKioKKyAqIGRy bV9nZW1fZG1hYnVmX3Z1bm1hcCAtIGRtYV9idWYgdnVubWFwIGltcGxlbWVudGF0aW9uIGZvciBH RU0KKyAqIEBkbWFfYnVmOiBidWZmZXIgdG8gYmUgdW5tYXBwZWQKKyAqIEB2YWRkcjogdGhlIHZp cnR1YWwgYWRkcmVzcyBvZiB0aGUgYnVmZmVyCisgKgorICogUmVsZWFzZXMgYSBrZXJuZWwgdmly dHVhbCBtYXBwaW5nLiBUaGlzIGNhbiBiZSB1c2VkIGFzIHRoZQorICogJmRtYV9idWZfb3BzLnZ1 bm1hcCBjYWxsYmFjay4KKyAqLwogdm9pZCBkcm1fZ2VtX2RtYWJ1Zl92dW5tYXAoc3RydWN0IGRt YV9idWYgKmRtYV9idWYsIHZvaWQgKnZhZGRyKQogewogCXN0cnVjdCBkcm1fZ2VtX29iamVjdCAq b2JqID0gZG1hX2J1Zi0+cHJpdjsKQEAgLTM2OSw2ICs0MjcsMTEgQEAgdm9pZCBkcm1fZ2VtX2Rt YWJ1Zl92dW5tYXAoc3RydWN0IGRtYV9idWYgKmRtYV9idWYsIHZvaWQgKnZhZGRyKQogfQogRVhQ T1JUX1NZTUJPTChkcm1fZ2VtX2RtYWJ1Zl92dW5tYXApOwogCisvKioKKyAqIGRybV9nZW1fZG1h YnVmX2ttYXBfYXRvbWljIC0gbWFwX2F0b21pYyBpbXBsZW1lbnRhdGlvbiBmb3IgR0VNCisgKgor ICogTm90IGltcGxlbWVudGVkLiBUaGlzIGNhbiBiZSB1c2VkIGFzIHRoZSAmZG1hX2J1Zl9vcHMu bWFwX2F0b21pYyBjYWxsYmFjay4KKyAqLwogdm9pZCAqZHJtX2dlbV9kbWFidWZfa21hcF9hdG9t aWMoc3RydWN0IGRtYV9idWYgKmRtYV9idWYsCiAJCQkJIHVuc2lnbmVkIGxvbmcgcGFnZV9udW0p CiB7CkBAIC0zNzYsNiArNDM5LDExIEBAIHZvaWQgKmRybV9nZW1fZG1hYnVmX2ttYXBfYXRvbWlj KHN0cnVjdCBkbWFfYnVmICpkbWFfYnVmLAogfQogRVhQT1JUX1NZTUJPTChkcm1fZ2VtX2RtYWJ1 Zl9rbWFwX2F0b21pYyk7CiAKKy8qKgorICogZHJtX2dlbV9kbWFidWZfa3VubWFwX2F0b21pYyAt IHVubWFwX2F0b21pYyBpbXBsZW1lbnRhdGlvbiBmb3IgR0VNCisgKgorICogTm90IGltcGxlbWVu dGVkLiBUaGlzIGNhbiBiZSB1c2VkIGFzIHRoZSAmZG1hX2J1Zl9vcHMudW5tYXBfYXRvbWljIGNh bGxiYWNrLgorICovCiB2b2lkIGRybV9nZW1fZG1hYnVmX2t1bm1hcF9hdG9taWMoc3RydWN0IGRt YV9idWYgKmRtYV9idWYsCiAJCQkJICB1bnNpZ25lZCBsb25nIHBhZ2VfbnVtLCB2b2lkICphZGRy KQogewpAQCAtMzgzLDEyICs0NTEsMjIgQEAgdm9pZCBkcm1fZ2VtX2RtYWJ1Zl9rdW5tYXBfYXRv bWljKHN0cnVjdCBkbWFfYnVmICpkbWFfYnVmLAogfQogRVhQT1JUX1NZTUJPTChkcm1fZ2VtX2Rt YWJ1Zl9rdW5tYXBfYXRvbWljKTsKIAorLyoqCisgKiBkcm1fZ2VtX2RtYWJ1Zl9rbWFwIC0gbWFw IGltcGxlbWVudGF0aW9uIGZvciBHRU0KKyAqCisgKiBOb3QgaW1wbGVtZW50ZWQuIFRoaXMgY2Fu IGJlIHVzZWQgYXMgdGhlICZkbWFfYnVmX29wcy5tYXAgY2FsbGJhY2suCisgKi8KIHZvaWQgKmRy bV9nZW1fZG1hYnVmX2ttYXAoc3RydWN0IGRtYV9idWYgKmRtYV9idWYsIHVuc2lnbmVkIGxvbmcg cGFnZV9udW0pCiB7CiAJcmV0dXJuIE5VTEw7CiB9CiBFWFBPUlRfU1lNQk9MKGRybV9nZW1fZG1h YnVmX2ttYXApOwogCisvKioKKyAqIGRybV9nZW1fZG1hYnVmX2t1bm1hcCAtIHVubWFwIGltcGxl bWVudGF0aW9uIGZvciBHRU0KKyAqCisgKiBOb3QgaW1wbGVtZW50ZWQuIFRoaXMgY2FuIGJlIHVz ZWQgYXMgdGhlICZkbWFfYnVmX29wcy51bm1hcCBjYWxsYmFjay4KKyAqLwogdm9pZCBkcm1fZ2Vt X2RtYWJ1Zl9rdW5tYXAoc3RydWN0IGRtYV9idWYgKmRtYV9idWYsIHVuc2lnbmVkIGxvbmcgcGFn ZV9udW0sCiAJCQkgICB2b2lkICphZGRyKQogewpAQCAtMzk2LDYgKzQ3NCwxNiBAQCB2b2lkIGRy bV9nZW1fZG1hYnVmX2t1bm1hcChzdHJ1Y3QgZG1hX2J1ZiAqZG1hX2J1ZiwgdW5zaWduZWQgbG9u ZyBwYWdlX251bSwKIH0KIEVYUE9SVF9TWU1CT0woZHJtX2dlbV9kbWFidWZfa3VubWFwKTsKIAor LyoqCisgKiBkcm1fZ2VtX2RtYWJ1Zl9tbWFwIC0gZG1hX2J1ZiBtbWFwIGltcGxlbWVudGF0aW9u IGZvciBHRU0KKyAqIEBkbWFfYnVmOiBidWZmZXIgdG8gYmUgbWFwcGVkCisgKiBAdm1hOiB2aXJ0 dWFsIGFkZHJlc3MgcmFuZ2UKKyAqCisgKiBQcm92aWRlcyBtZW1vcnkgbWFwcGluZyBmb3IgdGhl IGJ1ZmZlci4gVGhpcyBjYW4gYmUgdXNlZCBhcyB0aGUKKyAqICZkbWFfYnVmX29wcy5tbWFwIGNh bGxiYWNrLgorICoKKyAqIFJldHVybnMgMCBvbiBzdWNjZXNzIG9yIGEgbmVnYXRpdmUgZXJyb3Ig Y29kZSBvbiBmYWlsdXJlLgorICovCiBpbnQgZHJtX2dlbV9kbWFidWZfbW1hcChzdHJ1Y3QgZG1h X2J1ZiAqZG1hX2J1Ziwgc3RydWN0IHZtX2FyZWFfc3RydWN0ICp2bWEpCiB7CiAJc3RydWN0IGRy bV9nZW1fb2JqZWN0ICpvYmogPSBkbWFfYnVmLT5wcml2OwotLSAKMi43LjQKCl9fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBtYWlsaW5nIGxp c3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZyZWVkZXNr dG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAo=