From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: Re: [PATCH v2 1/1] drm: add kernel doc for exported gem dmabuf_ops Date: Tue, 30 Jan 2018 10:32:45 +0100 Message-ID: <20180130093245.GF25930@phenom.ffwll.local> References: <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: Content-Disposition: inline In-Reply-To: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: christian.koenig@amd.com Cc: dri-devel@lists.freedesktop.org, amd-gfx@lists.freedesktop.org, Samuel Li List-Id: amd-gfx.lists.freedesktop.org T24gRnJpLCBKYW4gMTksIDIwMTggYXQgMDk6NTE6MjBBTSArMDEwMCwgQ2hyaXN0aWFuIEvDtm5p ZyB3cm90ZToKPiBBbSAxOC4wMS4yMDE4IHVtIDIyOjQ0IHNjaHJpZWIgU2FtdWVsIExpOgo+ID4g U2lnbmVkLW9mZi1ieTogU2FtdWVsIExpIDxTYW11ZWwuTGlAYW1kLmNvbT4KPiA+IFJldmlld2Vk LWJ5OiBEYW5pZWwgVmV0dGVyIDxkYW5pZWwudmV0dGVyQGZmd2xsLmNoPgoKVGhhbmtzIGZvciB1 cGRhdGluZyB0aGUgZG9jcy4KPiAKPiBSZXZpZXdlZC1ieTogQ2hyaXN0aWFuIEvDtm5pZyA8Y2hy aXN0aWFuLmtvZW5pZ0BhbWQuY29tPgoKSSdtIGFzc3VtaW5nIHlvdSdsbCBhbHMgcHVzaCB0aGlz IG9uZS4KLURhbmllbAoKPiAKPiA+IC0tLQo+ID4gICBkcml2ZXJzL2dwdS9kcm0vZHJtX3ByaW1l LmMgfCA4OCArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysKPiA+ ICAgMSBmaWxlIGNoYW5nZWQsIDg4IGluc2VydGlvbnMoKykKPiA+IAo+ID4gZGlmZiAtLWdpdCBh L2RyaXZlcnMvZ3B1L2RybS9kcm1fcHJpbWUuYyBiL2RyaXZlcnMvZ3B1L2RybS9kcm1fcHJpbWUu Ywo+ID4gaW5kZXggY2EwOWNlNy4uZTgyYTk3NiAxMDA2NDQKPiA+IC0tLSBhL2RyaXZlcnMvZ3B1 L2RybS9kcm1fcHJpbWUuYwo+ID4gKysrIGIvZHJpdmVycy9ncHUvZHJtL2RybV9wcmltZS5jCj4g PiBAQCAtNzMsNiArNzMsOSBAQAo+ID4gICAgKiBEcml2ZXJzIHNob3VsZCBkZXRlY3QgdGhpcyBz aXR1YXRpb24gYW5kIHJldHVybiBiYWNrIHRoZSBnZW0gb2JqZWN0Cj4gPiAgICAqIGZyb20gdGhl IGRtYS1idWYgcHJpdmF0ZS4gIFByaW1lIHdpbGwgZG8gdGhpcyBhdXRvbWF0aWNhbGx5IGZvciBk cml2ZXJzIHRoYXQKPiA+ICAgICogdXNlIHRoZSBkcm1fZ2VtX3ByaW1lX3tpbXBvcnQsZXhwb3J0 fSBoZWxwZXJzLgo+ID4gKyAqCj4gPiArICogR0VNIHN0cnVjdCAmZG1hX2J1Zl9vcHMgc3ltYm9s cyBhcmUgbm93IGV4cG9ydGVkLiBUaGV5IGNhbiBiZSByZXN1ZWQgYnkKPiA+ICsgKiBkcml2ZXJz IHdoaWNoIGltcGxlbWVudCBHRU0gaW50ZXJmYWNlLgo+ID4gICAgKi8KPiA+ICAgc3RydWN0IGRy bV9wcmltZV9tZW1iZXIgewo+ID4gQEAgLTE4MCw2ICsxODMsMTggQEAgc3RhdGljIGludCBkcm1f cHJpbWVfbG9va3VwX2J1Zl9oYW5kbGUoc3RydWN0IGRybV9wcmltZV9maWxlX3ByaXZhdGUgKnBy aW1lX2ZwcmkKPiA+ICAgCXJldHVybiAtRU5PRU5UOwo+ID4gICB9Cj4gPiArLyoqCj4gPiArICog ZHJtX2dlbV9tYXBfYXR0YWNoIC0gZG1hX2J1ZiBhdHRhY2ggaW1wbGVtZW50YXRpb24gZm9yIEdF TQo+ID4gKyAqIEBkbWFfYnVmOiBidWZmZXIgdG8gYXR0YWNoIGRldmljZSB0bwo+ID4gKyAqIEB0 YXJnZXRfZGV2OiBub3QgdXNlZAo+ID4gKyAqIEBhdHRhY2g6IGJ1ZmZlciBhdHRhY2htZW50IGRh dGEKPiA+ICsgKgo+ID4gKyAqIEFsbG9jYXRlcyAmZHJtX3ByaW1lX2F0dGFjaG1lbnQgYW5kIGNh bGxzICZkcm1fZHJpdmVyLmdlbV9wcmltZV9waW4gZm9yCj4gPiArICogZGV2aWNlIHNwZWNpZmlj IGF0dGFjaG1lbnQuIFRoaXMgY2FuIGJlIHVzZWQgYXMgdGhlICZkbWFfYnVmX29wcy5hdHRhY2gK PiA+ICsgKiBjYWxsYmFjay4KPiA+ICsgKgo+ID4gKyAqIFJldHVybnMgMCBvbiBzdWNjZXNzLCBu ZWdhdGl2ZSBlcnJvciBjb2RlIG9uIGZhaWx1cmUuCj4gPiArICovCj4gPiAgIGludCBkcm1fZ2Vt X21hcF9hdHRhY2goc3RydWN0IGRtYV9idWYgKmRtYV9idWYsIHN0cnVjdCBkZXZpY2UgKnRhcmdl dF9kZXYsCj4gPiAgIAkJICAgICAgIHN0cnVjdCBkbWFfYnVmX2F0dGFjaG1lbnQgKmF0dGFjaCkK PiA+ICAgewo+ID4gQEAgLTIwMSw2ICsyMTYsMTQgQEAgaW50IGRybV9nZW1fbWFwX2F0dGFjaChz dHJ1Y3QgZG1hX2J1ZiAqZG1hX2J1Ziwgc3RydWN0IGRldmljZSAqdGFyZ2V0X2RldiwKPiA+ICAg fQo+ID4gICBFWFBPUlRfU1lNQk9MKGRybV9nZW1fbWFwX2F0dGFjaCk7Cj4gPiArLyoqCj4gPiAr ICogZHJtX2dlbV9tYXBfZGV0YWNoIC0gZG1hX2J1ZiBkZXRhY2ggaW1wbGVtZW50YXRpb24gZm9y IEdFTQo+ID4gKyAqIEBkbWFfYnVmOiBidWZmZXIgdG8gZGV0YWNoIGZyb20KPiA+ICsgKiBAYXR0 YWNoOiBhdHRhY2htZW50IHRvIGJlIGRldGFjaGVkCj4gPiArICoKPiA+ICsgKiBDbGVhbnMgdXAg JmRtYV9idWZfYXR0YWNobWVudC4gVGhpcyBjYW4gYmUgdXNlZCBhcyB0aGUgJmRtYV9idWZfb3Bz LmRldGFjaAo+ID4gKyAqIGNhbGxiYWNrLgo+ID4gKyAqLwo+ID4gICB2b2lkIGRybV9nZW1fbWFw X2RldGFjaChzdHJ1Y3QgZG1hX2J1ZiAqZG1hX2J1ZiwKPiA+ICAgCQkJc3RydWN0IGRtYV9idWZf YXR0YWNobWVudCAqYXR0YWNoKQo+ID4gICB7Cj4gPiBAQCAtMjU1LDYgKzI3OCwxOCBAQCB2b2lk IGRybV9wcmltZV9yZW1vdmVfYnVmX2hhbmRsZV9sb2NrZWQoc3RydWN0IGRybV9wcmltZV9maWxl X3ByaXZhdGUgKnByaW1lX2Zwcgo+ID4gICAJfQo+ID4gICB9Cj4gPiArLyoqCj4gPiArICogZHJt X2dlbV9tYXBfZG1hX2J1ZiAtIG1hcF9kbWFfYnVmIGltcGxlbWVudGF0aW9uIGZvciBHRU0KPiA+ ICsgKiBAYXR0YWNoOiBhdHRhY2htZW50IHdob3NlIHNjYXR0ZXJsaXN0IGlzIHRvIGJlIHJldHVy bmVkCj4gPiArICogQGRpcjogZGlyZWN0aW9uIG9mIERNQSB0cmFuc2Zlcgo+ID4gKyAqCj4gPiAr ICogQ2FsbHMgJmRybV9kcml2ZXIuZ2VtX3ByaW1lX2dldF9zZ190YWJsZSBhbmQgdGhlbiBtYXBz IHRoZSBzY2F0dGVybGlzdC4gVGhpcwo+ID4gKyAqIGNhbiBiZSB1c2VkIGFzIHRoZSAmZG1hX2J1 Zl9vcHMubWFwX2RtYV9idWYgY2FsbGJhY2suCj4gPiArICoKPiA+ICsgKiBSZXR1cm5zIHNnX3Rh YmxlIGNvbnRhaW5pbmcgdGhlIHNjYXR0ZXJsaXN0IHRvIGJlIHJldHVybmVkOyByZXR1cm5zIEVS Ul9QVFIKPiA+ICsgKiBvbiBlcnJvci4gTWF5IHJldHVybiAtRUlOVFIgaWYgaXQgaXMgaW50ZXJy dXB0ZWQgYnkgYSBzaWduYWwuCj4gPiArICovCj4gPiArCj4gPiAgIHN0cnVjdCBzZ190YWJsZSAq ZHJtX2dlbV9tYXBfZG1hX2J1ZihzdHJ1Y3QgZG1hX2J1Zl9hdHRhY2htZW50ICphdHRhY2gsCj4g PiAgIAkJCQkgICAgIGVudW0gZG1hX2RhdGFfZGlyZWN0aW9uIGRpcikKPiA+ICAgewo+ID4gQEAg LTI5NCw2ICszMjksMTIgQEAgc3RydWN0IHNnX3RhYmxlICpkcm1fZ2VtX21hcF9kbWFfYnVmKHN0 cnVjdCBkbWFfYnVmX2F0dGFjaG1lbnQgKmF0dGFjaCwKPiA+ICAgfQo+ID4gICBFWFBPUlRfU1lN Qk9MKGRybV9nZW1fbWFwX2RtYV9idWYpOwo+ID4gKy8qKgo+ID4gKyAqIGRybV9nZW1fdW5tYXBf ZG1hX2J1ZiAtIHVubWFwX2RtYV9idWYgaW1wbGVtZW50YXRpb24gZm9yIEdFTQo+ID4gKyAqCj4g PiArICogTm90IGltcGxlbWVudGVkLiBUaGUgdW5tYXAgaXMgZG9uZSBhdCBkcm1fZ2VtX21hcF9k ZXRhY2goKS4gIFRoaXMgY2FuIGJlCj4gPiArICogdXNlZCBhcyB0aGUgJmRtYV9idWZfb3BzLnVu bWFwX2RtYV9idWYgY2FsbGJhY2suCj4gPiArICovCj4gPiAgIHZvaWQgZHJtX2dlbV91bm1hcF9k bWFfYnVmKHN0cnVjdCBkbWFfYnVmX2F0dGFjaG1lbnQgKmF0dGFjaCwKPiA+ICAgCQkJICAgc3Ry dWN0IHNnX3RhYmxlICpzZ3QsCj4gPiAgIAkJCSAgIGVudW0gZG1hX2RhdGFfZGlyZWN0aW9uIGRp cikKPiA+IEBAIC0zNTEsNiArMzkyLDE1IEBAIHZvaWQgZHJtX2dlbV9kbWFidWZfcmVsZWFzZShz dHJ1Y3QgZG1hX2J1ZiAqZG1hX2J1ZikKPiA+ICAgfQo+ID4gICBFWFBPUlRfU1lNQk9MKGRybV9n ZW1fZG1hYnVmX3JlbGVhc2UpOwo+ID4gKy8qKgo+ID4gKyAqIGRybV9nZW1fZG1hYnVmX3ZtYXAg LSBkbWFfYnVmIHZtYXAgaW1wbGVtZW50YXRpb24gZm9yIEdFTQo+ID4gKyAqIEBkbWFfYnVmOiBi dWZmZXIgdG8gYmUgbWFwcGVkCj4gPiArICoKPiA+ICsgKiBTZXRzIHVwIGEga2VybmVsIHZpcnR1 YWwgbWFwcGluZy4gVGhpcyBjYW4gYmUgdXNlZCBhcyB0aGUgJmRtYV9idWZfb3BzLnZtYXAKPiA+ ICsgKiBjYWxsYmFjay4KPiA+ICsgKgo+ID4gKyAqIFJldHVybnMgdGhlIGtlcm5lbCB2aXJ0dWFs IGFkZHJlc3MuCj4gPiArICovCj4gPiAgIHZvaWQgKmRybV9nZW1fZG1hYnVmX3ZtYXAoc3RydWN0 IGRtYV9idWYgKmRtYV9idWYpCj4gPiAgIHsKPiA+ICAgCXN0cnVjdCBkcm1fZ2VtX29iamVjdCAq b2JqID0gZG1hX2J1Zi0+cHJpdjsKPiA+IEBAIC0zNjAsNiArNDEwLDE0IEBAIHZvaWQgKmRybV9n ZW1fZG1hYnVmX3ZtYXAoc3RydWN0IGRtYV9idWYgKmRtYV9idWYpCj4gPiAgIH0KPiA+ICAgRVhQ T1JUX1NZTUJPTChkcm1fZ2VtX2RtYWJ1Zl92bWFwKTsKPiA+ICsvKioKPiA+ICsgKiBkcm1fZ2Vt X2RtYWJ1Zl92dW5tYXAgLSBkbWFfYnVmIHZ1bm1hcCBpbXBsZW1lbnRhdGlvbiBmb3IgR0VNCj4g PiArICogQGRtYV9idWY6IGJ1ZmZlciB0byBiZSB1bm1hcHBlZAo+ID4gKyAqIEB2YWRkcjogdGhl IHZpcnR1YWwgYWRkcmVzcyBvZiB0aGUgYnVmZmVyCj4gPiArICoKPiA+ICsgKiBSZWxlYXNlcyBh IGtlcm5lbCB2aXJ0dWFsIG1hcHBpbmcuIFRoaXMgY2FuIGJlIHVzZWQgYXMgdGhlCj4gPiArICog JmRtYV9idWZfb3BzLnZ1bm1hcCBjYWxsYmFjay4KPiA+ICsgKi8KPiA+ICAgdm9pZCBkcm1fZ2Vt X2RtYWJ1Zl92dW5tYXAoc3RydWN0IGRtYV9idWYgKmRtYV9idWYsIHZvaWQgKnZhZGRyKQo+ID4g ICB7Cj4gPiAgIAlzdHJ1Y3QgZHJtX2dlbV9vYmplY3QgKm9iaiA9IGRtYV9idWYtPnByaXY7Cj4g PiBAQCAtMzY5LDYgKzQyNywxMSBAQCB2b2lkIGRybV9nZW1fZG1hYnVmX3Z1bm1hcChzdHJ1Y3Qg ZG1hX2J1ZiAqZG1hX2J1Ziwgdm9pZCAqdmFkZHIpCj4gPiAgIH0KPiA+ICAgRVhQT1JUX1NZTUJP TChkcm1fZ2VtX2RtYWJ1Zl92dW5tYXApOwo+ID4gKy8qKgo+ID4gKyAqIGRybV9nZW1fZG1hYnVm X2ttYXBfYXRvbWljIC0gbWFwX2F0b21pYyBpbXBsZW1lbnRhdGlvbiBmb3IgR0VNCj4gPiArICoK PiA+ICsgKiBOb3QgaW1wbGVtZW50ZWQuIFRoaXMgY2FuIGJlIHVzZWQgYXMgdGhlICZkbWFfYnVm X29wcy5tYXBfYXRvbWljIGNhbGxiYWNrLgo+ID4gKyAqLwo+ID4gICB2b2lkICpkcm1fZ2VtX2Rt YWJ1Zl9rbWFwX2F0b21pYyhzdHJ1Y3QgZG1hX2J1ZiAqZG1hX2J1ZiwKPiA+ICAgCQkJCSB1bnNp Z25lZCBsb25nIHBhZ2VfbnVtKQo+ID4gICB7Cj4gPiBAQCAtMzc2LDYgKzQzOSwxMSBAQCB2b2lk ICpkcm1fZ2VtX2RtYWJ1Zl9rbWFwX2F0b21pYyhzdHJ1Y3QgZG1hX2J1ZiAqZG1hX2J1ZiwKPiA+ ICAgfQo+ID4gICBFWFBPUlRfU1lNQk9MKGRybV9nZW1fZG1hYnVmX2ttYXBfYXRvbWljKTsKPiA+ ICsvKioKPiA+ICsgKiBkcm1fZ2VtX2RtYWJ1Zl9rdW5tYXBfYXRvbWljIC0gdW5tYXBfYXRvbWlj IGltcGxlbWVudGF0aW9uIGZvciBHRU0KPiA+ICsgKgo+ID4gKyAqIE5vdCBpbXBsZW1lbnRlZC4g VGhpcyBjYW4gYmUgdXNlZCBhcyB0aGUgJmRtYV9idWZfb3BzLnVubWFwX2F0b21pYyBjYWxsYmFj ay4KPiA+ICsgKi8KPiA+ICAgdm9pZCBkcm1fZ2VtX2RtYWJ1Zl9rdW5tYXBfYXRvbWljKHN0cnVj dCBkbWFfYnVmICpkbWFfYnVmLAo+ID4gICAJCQkJICB1bnNpZ25lZCBsb25nIHBhZ2VfbnVtLCB2 b2lkICphZGRyKQo+ID4gICB7Cj4gPiBAQCAtMzgzLDEyICs0NTEsMjIgQEAgdm9pZCBkcm1fZ2Vt X2RtYWJ1Zl9rdW5tYXBfYXRvbWljKHN0cnVjdCBkbWFfYnVmICpkbWFfYnVmLAo+ID4gICB9Cj4g PiAgIEVYUE9SVF9TWU1CT0woZHJtX2dlbV9kbWFidWZfa3VubWFwX2F0b21pYyk7Cj4gPiArLyoq Cj4gPiArICogZHJtX2dlbV9kbWFidWZfa21hcCAtIG1hcCBpbXBsZW1lbnRhdGlvbiBmb3IgR0VN Cj4gPiArICoKPiA+ICsgKiBOb3QgaW1wbGVtZW50ZWQuIFRoaXMgY2FuIGJlIHVzZWQgYXMgdGhl ICZkbWFfYnVmX29wcy5tYXAgY2FsbGJhY2suCj4gPiArICovCj4gPiAgIHZvaWQgKmRybV9nZW1f ZG1hYnVmX2ttYXAoc3RydWN0IGRtYV9idWYgKmRtYV9idWYsIHVuc2lnbmVkIGxvbmcgcGFnZV9u dW0pCj4gPiAgIHsKPiA+ICAgCXJldHVybiBOVUxMOwo+ID4gICB9Cj4gPiAgIEVYUE9SVF9TWU1C T0woZHJtX2dlbV9kbWFidWZfa21hcCk7Cj4gPiArLyoqCj4gPiArICogZHJtX2dlbV9kbWFidWZf a3VubWFwIC0gdW5tYXAgaW1wbGVtZW50YXRpb24gZm9yIEdFTQo+ID4gKyAqCj4gPiArICogTm90 IGltcGxlbWVudGVkLiBUaGlzIGNhbiBiZSB1c2VkIGFzIHRoZSAmZG1hX2J1Zl9vcHMudW5tYXAg Y2FsbGJhY2suCj4gPiArICovCj4gPiAgIHZvaWQgZHJtX2dlbV9kbWFidWZfa3VubWFwKHN0cnVj dCBkbWFfYnVmICpkbWFfYnVmLCB1bnNpZ25lZCBsb25nIHBhZ2VfbnVtLAo+ID4gICAJCQkgICB2 b2lkICphZGRyKQo+ID4gICB7Cj4gPiBAQCAtMzk2LDYgKzQ3NCwxNiBAQCB2b2lkIGRybV9nZW1f ZG1hYnVmX2t1bm1hcChzdHJ1Y3QgZG1hX2J1ZiAqZG1hX2J1ZiwgdW5zaWduZWQgbG9uZyBwYWdl X251bSwKPiA+ICAgfQo+ID4gICBFWFBPUlRfU1lNQk9MKGRybV9nZW1fZG1hYnVmX2t1bm1hcCk7 Cj4gPiArLyoqCj4gPiArICogZHJtX2dlbV9kbWFidWZfbW1hcCAtIGRtYV9idWYgbW1hcCBpbXBs ZW1lbnRhdGlvbiBmb3IgR0VNCj4gPiArICogQGRtYV9idWY6IGJ1ZmZlciB0byBiZSBtYXBwZWQK PiA+ICsgKiBAdm1hOiB2aXJ0dWFsIGFkZHJlc3MgcmFuZ2UKPiA+ICsgKgo+ID4gKyAqIFByb3Zp ZGVzIG1lbW9yeSBtYXBwaW5nIGZvciB0aGUgYnVmZmVyLiBUaGlzIGNhbiBiZSB1c2VkIGFzIHRo ZQo+ID4gKyAqICZkbWFfYnVmX29wcy5tbWFwIGNhbGxiYWNrLgo+ID4gKyAqCj4gPiArICogUmV0 dXJucyAwIG9uIHN1Y2Nlc3Mgb3IgYSBuZWdhdGl2ZSBlcnJvciBjb2RlIG9uIGZhaWx1cmUuCj4g PiArICovCj4gPiAgIGludCBkcm1fZ2VtX2RtYWJ1Zl9tbWFwKHN0cnVjdCBkbWFfYnVmICpkbWFf YnVmLCBzdHJ1Y3Qgdm1fYXJlYV9zdHJ1Y3QgKnZtYSkKPiA+ICAgewo+ID4gICAJc3RydWN0IGRy bV9nZW1fb2JqZWN0ICpvYmogPSBkbWFfYnVmLT5wcml2Owo+IAo+IF9fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCj4gZHJpLWRldmVsIG1haWxpbmcgbGlzdAo+ IGRyaS1kZXZlbEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKPiBodHRwczovL2xpc3RzLmZyZWVkZXNr dG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAoKLS0gCkRhbmllbCBWZXR0ZXIKU29m dHdhcmUgRW5naW5lZXIsIEludGVsIENvcnBvcmF0aW9uCmh0dHA6Ly9ibG9nLmZmd2xsLmNoCl9f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBt YWlsaW5nIGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3Rz LmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAo=