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: [1/2] usb: gadget: udc: core: update usb_ep_queue() documentation From: Felipe Balbi Message-Id: <87muysmyre.fsf@linux.intel.com> Date: Wed, 28 Mar 2018 10:43:01 +0300 To: Alan Stern Cc: Greg Kroah-Hartman , Linux USB , Tuba Yavuz List-ID: SGksCgpBbGFuIFN0ZXJuIDxzdGVybkByb3dsYW5kLmhhcnZhcmQuZWR1PiB3cml0ZXM6Cj4+IEFs YW4gU3Rlcm4gPHN0ZXJuQHJvd2xhbmQuaGFydmFyZC5lZHU+IHdyaXRlczoKPj4gPiBPbiBNb24s IDI2IE1hciAyMDE4LCBGZWxpcGUgQmFsYmkgd3JvdGU6Cj4+ID4KPj4gPj4gTWVudGlvbiB0aGF0 IC0+Y29tcGxldGUoKSBzaG91bGQgbmV2ZXIgYmUgY2FsbGVkIGZyb20gd2l0aGluCj4+ID4+IHVz Yl9lcF9xdWV1ZSgpLgo+PiA+PiAKPj4gPj4gU2lnbmVkLW9mZi1ieTogRmVsaXBlIEJhbGJpIDxm ZWxpcGUuYmFsYmlAbGludXguaW50ZWwuY29tPgo+PiA+PiAtLS0KPj4gPj4gIGRyaXZlcnMvdXNi L2dhZGdldC91ZGMvY29yZS5jIHwgMyArKysKPj4gPj4gIDEgZmlsZSBjaGFuZ2VkLCAzIGluc2Vy dGlvbnMoKykKPj4gPj4gCj4+ID4+IGRpZmYgLS1naXQgYS9kcml2ZXJzL3VzYi9nYWRnZXQvdWRj L2NvcmUuYyBiL2RyaXZlcnMvdXNiL2dhZGdldC91ZGMvY29yZS5jCj4+ID4+IGluZGV4IDUwOTg4 YjIxYTIxYi4uODQyODE0YmMwZTRmIDEwMDY0NAo+PiA+PiAtLS0gYS9kcml2ZXJzL3VzYi9nYWRn ZXQvdWRjL2NvcmUuYwo+PiA+PiArKysgYi9kcml2ZXJzL3VzYi9nYWRnZXQvdWRjL2NvcmUuYwo+ PiA+PiBAQCAtMjM4LDYgKzIzOCw5IEBAIEVYUE9SVF9TWU1CT0xfR1BMKHVzYl9lcF9mcmVlX3Jl cXVlc3QpOwo+PiA+PiAgICogYXJyYW5nZXMgdG8gcG9sbCBvbmNlIHBlciBpbnRlcnZhbCwgYW5k IHRoZSBnYWRnZXQgZHJpdmVyIHVzdWFsbHkgd2lsbAo+PiA+PiAgICogaGF2ZSBxdWV1ZWQgc29t ZSBkYXRhIHRvIHRyYW5zZmVyIGF0IHRoYXQgdGltZS4KPj4gPj4gICAqCj4+ID4+ICsgKiBOb3Rl IHRoYXQgQHJlcSdzIC0+Y29tcGxldGUoKSBjYWxsYmFjayBtdXN0IG5ldmVyIGJlIGNhbGxlZCBm cm9tCj4+ID4+ICsgKiB3aXRoaW4gdXNiX2VwX3F1ZXVlKCkgYXMgdGhhdCBjYW4gY3JlYXRlIGRl YWRsb2NrIHNpdHVhdGlvbnMuCj4+ID4+ICsgKgo+PiA+Cj4+ID4gSSB0aGluayB0aGlzIGlzIGhp Z2hseSBxdWVzdGlvbmFibGUuICBDZXJ0YWlubHkgaXQgd2FzIG5vdCBEYXZpZCAKPj4gPiBCcm93 bmVsbCdzIG9yaWdpbmFsIGludGVudGlvbjsgaGlzIGR1bW15LWhjZCBkcml2ZXIgd2lsbCBzb21l dGltZXMgCj4+ID4gZ2l2ZSBiYWNrIGEgcmVxdWVzdCBmcm9tIHdpdGhpbiB1c2JfZXBfcXVldWUo KSAtLSBhbmQgSSBiZWxpZXZlIGhlIAo+PiA+IHdyb3RlIGl0IHRoYXQgd2F5IGluIG9yZGVyIHRv IGVtdWxhdGUgYSBmZWF0dXJlIG9mIGhpcyBuZXQyMjgwIGRyaXZlci4KPj4gPgo+PiA+IEluIHRo aXMgcGFydGljdWxhciBjYXNlLCB0aGUgcHJvYmxlbSBpcyB0aGF0IGEgZHJpdmVyIGFjcXVpcmVz IGEgCj4+ID4gc3BpbmxvY2sgaW4gaXRzIGNvbXBsZXRlKCkgcm91dGluZSwgYnV0IHRoZW4gaXQg aG9sZHMgdGhhdCBzYW1lIAo+PiA+IHNwaW5sb2NrIHdoaWxlIHN1Ym1pdHRpbmcgYSByZXF1ZXN0 LiAgVGhpcyBpcyBhIGJ1ZzsgaXQgc2hvdWxkIGJlIGZpeGVkIAo+PiA+IGluIHRoZSBkcml2ZXIu ICBUaGUgc3BpbmxvY2sgc2hvdWxkIGJlIGRyb3BwZWQgd2hpbGUgdGhlIHJlcXVlc3QgaXMgCj4+ ID4gc3VibWl0dGVkLiAgSSdtIHN1cmUgdGhlcmUgYXJlIGV4YW1wbGVzIHdoZXRoZXIgb3RoZXIg ZHJpdmVycyBkbyB0aGlzLgo+PiAKPj4gdXNiX2VwX3F1ZXVlKCkgY2FuIGJlIGNhbGxlZCBmcm9t IGF0b21pYywgdGhlcmUncyBubyBleHBsaWNpdAo+PiByZXF1aXJlbWVudCB0aGF0IGxvY2tzIHNo b3VsZCBiZSByZWxlYXNlZC4gRWl0aGVyIG9uZSBjYXNlIG9yIHRoZSBvdGhlcgo+PiBzaG91bGQg YmUgbWFkZSBleHBsaWNpdC4KPgo+IEFncmVlZC4gIFRoZSByZXF1aXJlbWVudCBzaG91bGQgYmUg dGhhdCBhIHJvdXRpbmUgY2FsbGluZwo+IHVzYl9lcF9xdWV1ZSgpIHNob3VsZCBub3QgaG9sZCBh bnkgbG9ja3Mgd2hpY2ggY2FuIGJlIGFjcXVpcmVkIGJ5IHRoZQo+IHJlcXVlc3QncyBjb21wbGV0 aW9uIGhhbmRsZXIuICBUaGlzIGlzIGluZGVwZW5kZW50IG9mIHdoZXRoZXIgdGhlIGNhbGwKPiBp cyBtYWRlIGluIHByb2Nlc3MgY29udGV4dCBvciBpbnRlcnJ1cHQvYXRvbWljIGNvbnRleHQuCgpm YWlyIGVub3VnaC4gSW4gdGhhdCBjYXNlLCBmX2hpZC5jIHN0aWxsIG5lZWRzIHRvIHJlbGVhc2Ug aXRzIG93biBsb2NrCmJlZm9yZSBjYWxsaW5nIHVzYl9lcF9xdWV1ZSgpLiBTb21ldGhpbmcgYWxv bmcgdGhlIGxpbmVzIG9mOgoKbW9kaWZpZWQgICBkcml2ZXJzL3VzYi9nYWRnZXQvZnVuY3Rpb24v Zl9oaWQuYwpAQCAtMzkxLDE1ICszOTEsMTYgQEAgc3RhdGljIHNzaXplX3QgZl9oaWRnX3dyaXRl KHN0cnVjdCBmaWxlICpmaWxlLCBjb25zdCBjaGFyIF9fdXNlciAqYnVmZmVyLAogCXJlcS0+Y29t cGxldGUgPSBmX2hpZGdfcmVxX2NvbXBsZXRlOwogCXJlcS0+Y29udGV4dCAgPSBoaWRnOwogCisJ c3Bpbl91bmxvY2tfaXJxcmVzdG9yZSgmaGlkZy0+d3JpdGVfc3BpbmxvY2ssIGZsYWdzKTsKKwog CXN0YXR1cyA9IHVzYl9lcF9xdWV1ZShoaWRnLT5pbl9lcCwgcmVxLCBHRlBfQVRPTUlDKTsKIAlp ZiAoc3RhdHVzIDwgMCkgewogCQlFUlJPUihoaWRnLT5mdW5jLmNvbmZpZy0+Y2RldiwKIAkJCSJ1 c2JfZXBfcXVldWUgZXJyb3Igb24gaW50IGVuZHBvaW50ICV6ZFxuIiwgc3RhdHVzKTsKLQkJZ290 byByZWxlYXNlX3dyaXRlX3BlbmRpbmdfdW5sb2NrZWQ7CisJCWdvdG8gcmVsZWFzZV93cml0ZV9w ZW5kaW5nOwogCX0gZWxzZSB7CiAJCXN0YXR1cyA9IGNvdW50OwogCX0KLQlzcGluX3VubG9ja19p cnFyZXN0b3JlKCZoaWRnLT53cml0ZV9zcGlubG9jaywgZmxhZ3MpOwogCiAJcmV0dXJuIHN0YXR1 czsKIHJlbGVhc2Vfd3JpdGVfcGVuZGluZzoKCgpwczogbG9ja2luZyBpbiB0aGF0IGRyaXZlciBp cyBob3JyaWJsZSA6LSggSSBzaG91bGQgdHJ5IHRvIHNwZW5kIHNvbWUKdGltZSBjbGVhbmluZyB0 aGF0IHVwLgo=