From mboxrd@z Thu Jan 1 00:00:00 1970 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: [v2,2/2] dmaengine: doc: Add sections for per descriptor metadata support From: Vinod Koul Message-Id: <20180911073627.GL2634@vkoul-mobl> Date: Tue, 11 Sep 2018 13:06:27 +0530 To: Peter Ujfalusi Cc: dan.j.williams@intel.com, dmaengine@vger.kernel.org, linux-kernel@vger.kernel.org, lars@metafoo.de, radheys@xilinx.com List-ID: T24gMzAtMDgtMTgsIDE1OjE5LCBQZXRlciBVamZhbHVzaSB3cm90ZToKPiBVcGRhdGUgdGhlIHBy b3ZpZGVyIGFuZCBjbGllbnQgZG9jdW1lbnRhdGlvbiB3aXRoIGRldGFpbHMgYWJvdXQgdGhlCj4g bWV0YWRhdGEgc3VwcG9ydC4KCkl0IHdvdWxkIG1ha2Ugc2Vuc2UgdG8gbWFrZSB0aGlzIHBhdGNo IDEgOikKCj4gCj4gU2lnbmVkLW9mZi1ieTogUGV0ZXIgVWpmYWx1c2kgPHBldGVyLnVqZmFsdXNp QHRpLmNvbT4KPiAtLS0KPiAgRG9jdW1lbnRhdGlvbi9kcml2ZXItYXBpL2RtYWVuZ2luZS9jbGll bnQucnN0IHwgNzAgKysrKysrKysrKysrKysrKysrKwo+ICAuLi4vZHJpdmVyLWFwaS9kbWFlbmdp bmUvcHJvdmlkZXIucnN0ICAgICAgICAgfCA0NiArKysrKysrKysrKysKPiAgMiBmaWxlcyBjaGFu Z2VkLCAxMTYgaW5zZXJ0aW9ucygrKQo+IAo+IGRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL2Ry aXZlci1hcGkvZG1hZW5naW5lL2NsaWVudC5yc3QgYi9Eb2N1bWVudGF0aW9uL2RyaXZlci1hcGkv ZG1hZW5naW5lL2NsaWVudC5yc3QKPiBpbmRleCBmYmJiMjgzMWYyOWYuLjU4NGEzOTM0N2NmZSAx MDA2NDQKPiAtLS0gYS9Eb2N1bWVudGF0aW9uL2RyaXZlci1hcGkvZG1hZW5naW5lL2NsaWVudC5y c3QKPiArKysgYi9Eb2N1bWVudGF0aW9uL2RyaXZlci1hcGkvZG1hZW5naW5lL2NsaWVudC5yc3QK PiBAQCAtMTUxLDYgKzE1MSw3NiBAQCBUaGUgZGV0YWlscyBvZiB0aGVzZSBvcGVyYXRpb25zIGFy ZToKPiAgICAgICBOb3RlIHRoYXQgY2FsbGJhY2tzIHdpbGwgYWx3YXlzIGJlIGludm9rZWQgZnJv bSB0aGUgRE1BCj4gICAgICAgZW5naW5lcyB0YXNrbGV0LCBuZXZlciBmcm9tIGludGVycnVwdCBj b250ZXh0Lgo+ICAKPiArICBPcHRpb25hbDogcGVyIGRlc2NyaXB0b3IgbWV0YWRhdGEKPiArICAt LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KPiArICBETUFlbmdpbmUgcHJvdmlkZXMg dHdvIHdheXMgZm9yIG1ldGFkYXRhIHN1cHBvcnQuCj4gKwo+ICsgIERFU0NfTUVUQURBVEFfQ0xJ RU5UCj4gKwo+ICsgICAgVGhlIG1ldGFkYXRhIGJ1ZmZlciBpcyBhbGxvY2F0ZWQvcHJvdmlkZWQg YnkgdGhlIGNsaWVudCBkcml2ZXIgYW5kIGl0IGlzCj4gKyAgICBhdHRhY2hlZCB0byB0aGUgZGVz Y3JpcHRvci4KPiArCj4gKyAgLi4gY29kZS1ibG9jazo6IGMKPiArCj4gKyAgICAgaW50IGRtYWVu Z2luZV9kZXNjX2F0dGFjaF9tZXRhZGF0YShzdHJ1Y3QgZG1hX2FzeW5jX3R4X2Rlc2NyaXB0b3Ig KmRlc2MsCj4gKwkJCQkgICB2b2lkICpkYXRhLCBzaXplX3QgbGVuKTsKPiArCj4gKyAgREVTQ19N RVRBREFUQV9FTkdJTkUKPiArCj4gKyAgICBUaGUgbWV0YWRhdGEgYnVmZmVyIGlzIGFsbG9jYXRl ZC9tYW5hZ2VkIGJ5IHRoZSBETUEgZHJpdmVyLiBUaGUgY2xpZW50Cj4gKyAgICBkcml2ZXIgY2Fu IGFzayBmb3IgdGhlIHBvaW50ZXIsIG1heGltdW0gc2l6ZSBhbmQgdGhlIGN1cnJlbnRseSB1c2Vk IHNpemUgb2YKPiArICAgIHRoZSBtZXRhZGF0YSBhbmQgY2FuIGRpcmVjdGx5IHVwZGF0ZSBvciBy ZWFkIGl0Lgo+ICsKPiArICAuLiBjb2RlLWJsb2NrOjogYwo+ICsKPiArICAgICB2b2lkICpkbWFl bmdpbmVfZGVzY19nZXRfbWV0YWRhdGFfcHRyKHN0cnVjdCBkbWFfYXN5bmNfdHhfZGVzY3JpcHRv ciAqZGVzYywKPiArCQlzaXplX3QgKnBheWxvYWRfbGVuLCBzaXplX3QgKm1heF9sZW4pOwo+ICsK PiArICAgICBpbnQgZG1hZW5naW5lX2Rlc2Nfc2V0X21ldGFkYXRhX2xlbihzdHJ1Y3QgZG1hX2Fz eW5jX3R4X2Rlc2NyaXB0b3IgKmRlc2MsCj4gKwkJc2l6ZV90IHBheWxvYWRfbGVuKTsKPiArCj4g KyAgQ2xpZW50IGRyaXZlcnMgY2FuIHF1ZXJ5IGlmIGEgZ2l2ZW4gbW9kZSBpcyBzdXBwb3J0ZWQg d2l0aDoKPiArCj4gKyAgLi4gY29kZS1ibG9jazo6IGMKPiArCj4gKyAgICAgYm9vbCBkbWFlbmdp bmVfaXNfbWV0YWRhdGFfbW9kZV9zdXBwb3J0ZWQoc3RydWN0IGRtYV9jaGFuICpjaGFuLAo+ICsJ CWVudW0gZG1hX2Rlc2NfbWV0YWRhdGFfbW9kZSBtb2RlKTsKPiArCj4gKyAgRGVwZW5kaW5nIG9u IHRoZSB1c2VkIG1vZGUgY2xpZW50IGRyaXZlcnMgbXVzdCBmb2xsb3cgZGlmZmVyZW50IGZsb3cu Cj4gKwo+ICsgIERFU0NfTUVUQURBVEFfQ0xJRU5UCj4gKwo+ICsgICAgLSBETUFfTUVNX1RPX0RF ViAvIERFVl9NRU1fVE9fTUVNOgo+ICsgICAgICAxLiBwcmVwYXJlIHRoZSBkZXNjcmlwdG9yIChk bWFlbmdpbmVfcHJlcF8qKQo+ICsgICAgICAgICBjb25zdHJ1Y3QgdGhlIG1ldGFkYXRhIGluIHRo ZSBjbGllbnQncyBidWZmZXIKPiArICAgICAgMi4gdXNlIGRtYWVuZ2luZV9kZXNjX2F0dGFjaF9t ZXRhZGF0YSgpIHRvIGF0dGFjaCB0aGUgYnVmZmVyIHRvIHRoZQo+ICsgICAgICAgICBkZXNjcmlw dG9yCj4gKyAgICAgIDMuIHN1Ym1pdCB0aGUgdHJhbnNmZXIKPiArICAgIC0gRE1BX0RFVl9UT19N RU06Cj4gKyAgICAgIDEuIHByZXBhcmUgdGhlIGRlc2NyaXB0b3IgKGRtYWVuZ2luZV9wcmVwXyop Cj4gKyAgICAgIDIuIHVzZSBkbWFlbmdpbmVfZGVzY19hdHRhY2hfbWV0YWRhdGEoKSB0byBhdHRh Y2ggdGhlIGJ1ZmZlciB0byB0aGUKPiArICAgICAgICAgZGVzY3JpcHRvcgo+ICsgICAgICAzLiBz dWJtaXQgdGhlIHRyYW5zZmVyCj4gKyAgICAgIDQuIHdoZW4gdGhlIHRyYW5zZmVyIGlzIGNvbXBs ZXRlZCwgdGhlIG1ldGFkYXRhIHNob3VsZCBiZSBhdmFpbGFibGUgaW4gdGhlCj4gKyAgICAgICAg IGF0dGFjaGVkIGJ1ZmZlcgo+ICsKPiArICBERVNDX01FVEFEQVRBX0VOR0lORQo+ICsKPiArICAg IC0gRE1BX01FTV9UT19ERVYgLyBERVZfTUVNX1RPX01FTToKPiArICAgICAgMS4gcHJlcGFyZSB0 aGUgZGVzY3JpcHRvciAoZG1hZW5naW5lX3ByZXBfKikKPiArICAgICAgMi4gdXNlIGRtYWVuZ2lu ZV9kZXNjX2dldF9tZXRhZGF0YV9wdHIoKSB0byBnZXQgdGhlIHBvaW50ZXIgdG8gdGhlCj4gKyAg ICAgICAgIGVuZ2luZSdzIG1ldGFkYXRhIGFyZWEKPiArICAgICAgMy4gdXBkYXRlIHRoZSBtZXRh ZGF0YSBhdCB0aGUgcG9pbnRlcgo+ICsgICAgICA0LiB1c2UgZG1hZW5naW5lX2Rlc2Nfc2V0X21l dGFkYXRhX2xlbigpICB0byB0ZWxsIHRoZSBETUEgZW5naW5lIHRoZQo+ICsgICAgICAgICBhbW91 bnQgb2YgZGF0YSB0aGUgY2xpZW50IGhhcyBwbGFjZWQgaW50byB0aGUgbWV0YWRhdGEgYnVmZmVy Cj4gKyAgICAgIDUuIHN1Ym1pdCB0aGUgdHJhbnNmZXIKPiArICAgIC0gRE1BX0RFVl9UT19NRU06 Cj4gKyAgICAgIDEuIHByZXBhcmUgdGhlIGRlc2NyaXB0b3IgKGRtYWVuZ2luZV9wcmVwXyopCj4g KyAgICAgIDIuIHN1Ym1pdCB0aGUgdHJhbnNmZXIKPiArICAgICAgMy4gb24gdHJhbnNmZXIgY29t cGxldGlvbiwgdXNlIGRtYWVuZ2luZV9kZXNjX2dldF9tZXRhZGF0YV9wdHIoKSB0byBnZXQgdGhl Cj4gKyAgICAgICAgIHBvaW50ZXIgdG8gdGhlIGVuZ2luZSdzIG1ldGFkYXRhIGFyZQo+ICsgICAg ICA0LiBSZWFkIG91dCB0aGUgbWV0YWRhdGUgZnJvbSB0aGUgcG9pbnRlcgoKTGV0cyBwdXQgYSBu b3RlIGhlcmUgdGhhdCBvbmx5IG9uZSBtZXRob2Qgc2hvdWxkIGJlIHVzZWQKCj4gKwo+ICA0LiBT dWJtaXQgdGhlIHRyYW5zYWN0aW9uCj4gIAo+ICAgICBPbmNlIHRoZSBkZXNjcmlwdG9yIGhhcyBi ZWVuIHByZXBhcmVkIGFuZCB0aGUgY2FsbGJhY2sgaW5mb3JtYXRpb24KPiBkaWZmIC0tZ2l0IGEv RG9jdW1lbnRhdGlvbi9kcml2ZXItYXBpL2RtYWVuZ2luZS9wcm92aWRlci5yc3QgYi9Eb2N1bWVu dGF0aW9uL2RyaXZlci1hcGkvZG1hZW5naW5lL3Byb3ZpZGVyLnJzdAo+IGluZGV4IGRmYzQ0ODZi NTc0My4uNTAyYzU5Zjc1MzAyIDEwMDY0NAo+IC0tLSBhL0RvY3VtZW50YXRpb24vZHJpdmVyLWFw aS9kbWFlbmdpbmUvcHJvdmlkZXIucnN0Cj4gKysrIGIvRG9jdW1lbnRhdGlvbi9kcml2ZXItYXBp L2RtYWVuZ2luZS9wcm92aWRlci5yc3QKPiBAQCAtMjQ3LDYgKzI0Nyw1MiBAQCBhZnRlciBlYWNo IHRyYW5zZmVyLiBJbiBjYXNlIG9mIGEgcmluZyBidWZmZXIsIHRoZXkgbWF5IGxvb3AKPiAgKERN QV9DWUNMSUMpLiBBZGRyZXNzZXMgcG9pbnRpbmcgdG8gYSBkZXZpY2UncyByZWdpc3RlciAoZS5n LiBhIEZJRk8pCj4gIGFyZSB0eXBpY2FsbHkgZml4ZWQuCj4gIAo+ICtQZXIgZGVzY3JpcHRvciBt ZXRhZGF0YSBzdXBwb3J0Cj4gKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KPiArU29t ZSBkYXRhIG1vdmVtZW50IGFyY2hpdGVjdXJlIChETUEgY29udHJvbGxlciBhbmQgcGVyaXBoZXJh bHMpIHVzZXMgbWV0YWRhdGEKCnR5cG8gYXJjaGl0ZWN1cmUKCj4gK2Fzc29jaWF0ZWQgd2l0aCBh IHRyYW5zYWN0aW9uLiBUaGUgRE1BIGNvbnRyb2xsZXIgcm9sZSBpcyB0byB0cmFuc2ZlciB0aGUK PiArcGF5bG9hZCBhbmQgdGhlIG1ldGFkYXRhIGFsb25nc2lkZS4KPiArVGhlIG1ldGFkYXRhIGl0 c2VsZiBpcyBub3QgdXNlZCBieSB0aGUgRE1BIGVuZ2luZSBpdHNlbGYsIGJ1dCBpdCBjb250YWlu cwo+ICtwYXJhbWV0ZXJzLCBrZXlzLCB2ZWN0b3JzLCBldGMgZm9yIHBlcmlwaGVyYWwgb3IgZnJv bSB0aGUgcGVyaXBoZXJhbC4KPiArCj4gK1RoZSBETUFlbmdpbmUgZnJhbWV3b3JrIHByb3ZpZGVz IGEgZ2VuZXJpYyB3YXlzIHRvIGZhY2lsaXRhdGUgdGhlIG1ldGFkYXRhIGZvcgo+ICtkZXNjcmlw dG9ycy4gRGVwZW5kaW5nIG9uIHRoZSBhcmNoaXRlY3R1cmUgdGhlIERNQSBkcml2ZXIgY2FuIGlt cGxtZW50IGVpdGhlcgoKaW1wbG1lbnQK