From mboxrd@z Thu Jan 1 00:00:00 1970 From: Paul Durrant Subject: Re: [PATCH v4 2/3] public/io/netif.h: document control ring and toeplitz hashing Date: Fri, 8 Jan 2016 17:35:33 +0000 Message-ID: <1eca22bf069b4c759782ed3d643494e9@AMSPEX02CL03.citrite.net> References: <1452171912-29857-1-git-send-email-paul.durrant@citrix.com> <1452171912-29857-3-git-send-email-paul.durrant@citrix.com> <1452268426.26438.26.camel@citrix.com> <8738d051636f4c7f85181322699e1084@AMSPEX02CL03.citrite.net> <1452271578.26438.56.camel@citrix.com> <0cd226b878ab46ac8d432f3cd7bafa2d@AMSPEX02CL03.citrite.net> <1452273738.26438.70.camel@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail6.bemta14.messagelabs.com ([193.109.254.103]) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1aHazS-0004Gw-AJ for xen-devel@lists.xenproject.org; Fri, 08 Jan 2016 17:38:18 +0000 In-Reply-To: <1452273738.26438.70.camel@citrix.com> Content-Language: en-US List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: Ian Campbell , "xen-devel@lists.xenproject.org" Cc: Ian Jackson , "Keir (Xen.org)" , Jan Beulich , "Tim (Xen.org)" List-Id: xen-devel@lists.xenproject.org PiAtLS0tLU9yaWdpbmFsIE1lc3NhZ2UtLS0tLQ0KPiBGcm9tOiBJYW4gQ2FtcGJlbGwgW21haWx0 bzppYW4uY2FtcGJlbGxAY2l0cml4LmNvbV0NCj4gU2VudDogMDggSmFudWFyeSAyMDE2IDE3OjIy DQo+IFRvOiBQYXVsIER1cnJhbnQ7IHhlbi1kZXZlbEBsaXN0cy54ZW5wcm9qZWN0Lm9yZw0KPiBD YzogSWFuIEphY2tzb247IEphbiBCZXVsaWNoOyBLZWlyIChYZW4ub3JnKTsgVGltIChYZW4ub3Jn KQ0KPiBTdWJqZWN0OiBSZTogW1BBVENIIHY0IDIvM10gcHVibGljL2lvL25ldGlmLmg6IGRvY3Vt ZW50IGNvbnRyb2wgcmluZyBhbmQNCj4gdG9lcGxpdHogaGFzaGluZw0KPiANCj4gT24gRnJpLCAy MDE2LTAxLTA4IGF0IDE3OjA3ICswMDAwLCBQYXVsIER1cnJhbnQgd3JvdGU6DQo+ID4gPiArLyoN Cj4gPiA+ID4gPiA+ICsgKiBDb250cm9sIHJlc3BvbnNlcyAobmV0aWZfY3RybF9yZXNwb25zZV90 KQ0KPiA+ID4gPiA+ID4gKyAqID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09DQo+ID4gPiA+ID4gPiArICoNCj4gPiA+ID4gPiA+ICsgKiBBbGwgcmVzcG9uc2VzIGhhdmUg dGhlIGZvbGxvd2luZyBmb3JtYXQ6DQo+ID4gPiA+ID4gPiArICoNCj4gPiA+ID4gPiA+ICsgKsKg wqDCoMKgMMKgwqDCoMKgwqAxwqDCoMKgwqDCoDLCoMKgwqDCoMKgM8KgwqDCoMKgwqA0wqDCoMKg wqDCoDXCoMKgwqDCoMKgNsKgwqDCoMKgwqA3wqDCoG9jdGV0DQo+ID4gPiA+ID4gPiArICogKy0t LS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKw0KPiA+ID4gPiA+ ID4gKyAqIHzCoMKgwqDCoGlkwqDCoMKgwqDCoHzCoMKgwqBwYWTCoMKgwqDCoMKgfMKgwqDCoMKg wqDCoMKgwqDCoHN0YXR1c8KgwqDCoMKgwqDCoMKgwqB8DQo+ID4gPiA+ID4gPiArICogKy0tLS0t Ky0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKw0KPiA+ID4gPiA+ID4g KyAqIHzCoMKgwqDCoMKgwqDCoMKgwqBkYXRhwqDCoMKgwqDCoMKgwqDCoMKgwqB8DQo+ID4gPiA+ ID4gPiArICogKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKw0KPiA+ID4gPiA+ID4gKyAqDQo+ID4g PiA+ID4gPiArICogaWQ6IHRoZSBjb3JyZXNwb25kaW5nIHJlcXVlc3QgaWRlbnRpZmllcg0KPiA+ ID4gPiA+ID4gKyAqIHBhZDogc2V0IHRvIDANCj4gPiA+ID4gPiA+ICsgKiBzdGF0dXM6IHRoZSBz dGF0dXMgb2YgcmVxdWVzdCBwcm9jZXNzaW5nDQo+ID4gPiA+ID4gPiArICogZGF0YTogYW55IGRh dGEgYXNzb2NpYXRlZCB3aXRoIHRoZSByZXNwb25zZSAoZGV0ZXJtaW5lZCBieQ0KPiA+ID4gPiA+ ID4gdHlwZQ0KPiA+ID4gPiA+ID4gYW5kDQo+ID4gPiA+ID4gPiArICrCoMKgwqDCoMKgwqDCoHN0 YXR1cykNCj4gPiA+ID4gPg0KPiA+ID4gPiA+IHR5cGUgbmVlZHMgdG8gYmUgcmVtZW1iZXJlZCB2 aWEgdGhlIGlkPyBXaHkgbm90IGVjaG8gaXQgaW4gdGhlIHBhZA0KPiA+ID4gPiA+IGZpZWxkDQo+ ID4gPiA+ID4gZm9yIGNvbnZlbmllbmNlPw0KPiA+ID4gPiA+DQo+ID4gPiA+DQo+ID4gPiA+IEkg b3JpZ2luYWxseSBoYWQgdGhhdCBidXQgdGhvdWdodCBpdCB3b3VsZCBiZSBzdXBlcmZsdW91cyBn aXZlbiB0aGF0DQo+ID4gPiA+IHRoZQ0KPiA+ID4gPiBpZCBpcyBlY2hvZWQuIEkgY2FuIGFkZCBp dCBiYWNrIGlmIHlvdSB0aGluayB0aGF0IGl0IHdvdWxkIGJlIGEgZ29vZA0KPiA+ID4gPiBpZGVh LiBBbGwgbXkgaW1wbGVtZW50YXRpb24gZGlkIHdpdGggaXQgdGhvdWdoIHdhcyBBU1NFUlQgdGhh dCBpdA0KPiA+ID4gPiBtYXRjaGVkDQo+ID4gPiA+IHRoZSByZXEuDQo+ID4gPg0KPiA+ID4gV2Fz IGl0IGEgY29pbmNpZGVuY2UgdGhhdCB5b3UgaGFkIHRoZSByZXEgaW4gaGFuZCBnaXZlbiB0aGUg aWQsIG9yIGlzDQo+ID4gPiBpdCBhDQo+ID4gPiBmdW5kYW1lbnRhbCBwcm9wZXJ0eSBvZiBhbnkg aW1wbGVtZW50YXRpb24gb2YgdGhpcyBwcm90b2NvbCB0aGF0IHlvdQ0KPiA+ID4gd291bGQNCj4g PiA+IGhhdmUgaXQgaGFuZHk/DQo+ID4NCj4gPiBJdCdzIHByZXR0eSBmdW5kYW1lbnRhbC4gWW91 IG5lZWQgdG8gZ2V0IGJhY2sgYXQgdGhlIGdyZWZzIHVzZWQgZm9yIHRoZQ0KPiA+IGtleSBhbmQg dGhlIG1hcHBpbmcgc28gYW55IGltcGxlbWVudGF0aW9uIGlzIHByZXR0eSBjZXJ0YWluIHRvIGhh dmUgdGhlDQo+ID4gcmVxIGluIGhhbmQuDQo+IA0KPiBOb3QgYWxsIGNvbW1hbmRzIHVzZSBhIGdy ZWYgdGhvdWdoLCBhbmQgZnV0dXJlIG9uZXMgbWF5IG5vdC4NCj4gDQo+IEdpdmVuIHdlIGFyZSBv dGhlcndpc2UganVzdCB3YXN0aW5nIHRob3NlIDE2IGJpdHMgd2UgbWF5IGFzIHdlbGwgc3RpY2sg dGhlDQo+IHR5cGUgaW50byB0aGVtLg0KPiANCg0KT2suIFdpbGwgcmV2ZXJ0IHRvIGRvaW5nIHRo YXQuDQoNCj4gPg0KPiA+ID4gPiA+ID4gKyAqDQo+ID4gPiA+ID4gPiArICogdHlwZSA9IE5FVElG X0NUUkxfTVNHX1NFVF9UT0VQTElUWl9GTEFHUzoNCj4gPiA+ID4gPiA+ICsgKg0KPiA+ID4gPiA+ ID4gKyAqIElmIHRoZSBkYXRhWzBdIGZpZWxkIGluIHRoZSByZXF1ZXN0IGlzIGludmFsaWQgKGku ZS4gY29udGFpbnMNCj4gPiA+ID4gPiA+IHVuc3VwcG9ydGVkDQo+ID4gPiA+ID4gPiArICogaGFz aCB0eXBlcykgdGhlbiB0aGUgc3RhdHVzIGZpZWxkIGlzIHNldCB0bw0KPiA+ID4gPiA+ID4gKyAq IE5FVElGX0NUUkxfU1RBVFVTX0lOVkFMSURfUEFSQU1FVEVSLiBPdGhlcndpc2UgdGhlDQo+ID4g PiByZXF1c2V0DQo+ID4gPiA+ID4gc2hvdWxkDQo+ID4gPiA+ID4NCj4gPiA+ID4gPiAicmVxdWVz dCINCj4gPiA+ID4gPg0KPiA+ID4gPiA+ID4gc3VjY2VlZA0KPiA+ID4gPiA+ID4gKyAqIGFuZCBo ZW5jZSB0aGUgc3RhdHVzIGZpZWxkIGlzIHNldCB0bw0KPiA+ID4gPiA+ID4gTkVUSUZfQ1RSTF9T VEFUVVNfU1VDQ0VTUy4NCj4gPiA+ID4gPiA+ICsgKiBUaGUgZGF0YSBmaWVsZCBzaG91bGQgYmUg c2V0IHRvIDAuDQo+ID4gPiA+ID4gPiArICoNCj4gPiA+ID4gPiA+ICsgKiB0eXBlID0gTkVUSUZf Q1RSTF9NU0dfU0VUX1RPRVBMSVRaX0tFWToNCj4gPiA+ID4gPiA+ICsgKg0KPiA+ID4gPiA+ID4g KyAqIElmIHRoZSBkYXRhWzBdIGZpZWxkIGluIHRoZSByZXF1ZXN0IGlzIGFuIGludmFsaWQga2V5 IGxlbmd0aA0KPiA+ID4gPiA+ID4gKHRvbw0KPiA+ID4gPiA+ID4gYmlnKQ0KPiA+ID4gPiA+DQo+ ID4gPiA+ID4gQ2FuIGl0IG5vdCBiZSB0b28gc21hbGwgYXMgd2VsbD8gV2hhdCBpcyB0aGUgYmVo YXZpb3VyIGlmIGl0IGlzPw0KPiA+ID4gPiA+DQo+ID4gPiA+DQo+ID4gPiA+IEkgZ3Vlc3MgdGhl IHdheSB0aGUgYWxnb3JpdGhtIGlzIGRlZmluZWQsIGEga2V5IG9mIGxlc3MgdGhhbiAzMiBiaXRz DQo+ID4gPiA+IGRvZXNuJ3QgbWFrZSBtdWNoIHNlbnNlLg0KPiA+ID4NCj4gPiA+IFdoYXQgaWYg SSB0aHJvdyBjYXV0aW9uIHRvIHRoZSB3aW5kIGFuZCBzZXQgb25lIGJ5dGUgYW55d2F5Pw0KPiA+ ID4NCj4gPg0KPiA+IEF0IHRoZSBtb21lbnQsIGl0IGdvZXMgaW50byB0aGUgJ2xlZnQgbW9zdCcg KGluIE1pY3Jvc29mdCdzIHRlcm1pbm9sb2d5KQ0KPiA+IGJ5dGUgYW5kIGFueSByZW1haW5pbmcg Ynl0ZXMgYXJlIHplcm8gZmlsbGVkLiBGcm9tIHRoZSBzcGVjIGl0J3Mgbm90DQo+ID4gY2xlYXIg aWYgemVyby1maWxsaW5nIGlzIHRoZSByaWdodCB0aGluZyB0byBkbyBidXQgc2luY2UgV2luZG93 cyBhbHdheXMNCj4gPiBzZXRzIGEgNDAgYnl0ZSBrZXkgaXQncyBuZXZlciBiZWVuIGFuIGlzc3Vl Lg0KPiANCj4gSSB0aGluayB3ZSBzaG91bGQgZWl0aGVyIGNsZWFybHkgZGVmaW5lIHRoZSBiZWhh dmlvdXIsIG9yIHNldCBhIG1pbmltdW0NCj4gc2l6ZS4NCg0KT2suIEkgbWF5IGFzIHdlbGwgc2V0 IHRoZSBtaW5pbXVtIHNpemUgYXQgNDAgdGhlbi4NCg0KPiANCj4gRG9lcyB0aGlzIHplcm8gZXh0 ZW5kaW5nIGFwcGx5IHRvIGFueSBtdWx0aXBsZSBvZiBzb21ldGhpbmcgb3RoZXIgdGhhbiAzMg0K PiBiaXRzPyBMaWtlIGlmIEkgZ2l2ZSA5IG9jdGV0cyBkb2VzIGl0IGVmZmVjdGl2ZWx5IGdldCBw YWRkZWQgdG8gMTIgd2l0aA0KPiB6ZXJvZXM/DQo+IA0KDQpObywgdGhlIGtleSBpcyBlc3NlbnRp YWxseSB0cmVhdGVkIGFzIGEgc2hpZnQgcmVnaXN0ZXIgc28gaXQncyBqdXN0IGltcGxlbWVudGVk IGFzIGEgYnl0ZSBhcnJheS4NCg0KPiA+DQo+ID4gPiA+DQo+ID4gPiA+ID4gPiArICogdGhlbiB0 aGUgc3RhdHVzIGZpZWxkIGlzIHNldCB0bw0KPiA+ID4gPiA+IE5FVElGX0NUUkxfU1RBVFVTX0JV RkZFUl9PVkVSRkxPVywgSWYgdGhlDQo+ID4gPiA+ID4gPiArICogZGF0YVsxXSBmaWVsZCBpcyBh biBpbnZhbGlkIGdyYW50IHJlZmVyZW5jZSB0aGVuIHRoZSBzdGF0dXMNCj4gPiA+ID4gPiA+IGZp ZWxkDQo+ID4gPiA+ID4gPiBpcyBzZXQNCj4gPiA+ID4gPiA+ICsgKiB0byBORVRJRl9DVFJMX1NU QVRVU19JTlZBTElEX1BBUkFNRVRFUi4gT3RoZXJ3aXNlIHRoZQ0KPiA+ID4gcmVxdWVzdA0KPiA+ ID4gPiA+IHNob3VsZA0KPiA+ID4gPiA+ID4gKyAqIHN1Y2NlZWQgYW5kIGhlbmNlIHRoZSBzdGF0 dXMgZmllbGQgaXMgc2V0IHRvDQo+ID4gPiA+ID4gTkVUSUZfQ1RSTF9TVEFUVVNfU1VDQ0VTUy4N Cj4gPiA+ID4gPiA+ICsgKiBUaGUgZGF0YSBmaWVsZCBzaG91bGQgYmUgc2V0IHRvIDAuDQo+ID4g PiA+ID4gPiArICoNCj4gPiA+ID4gPiA+ICsgKiB0eXBlID0gTkVUSUZfQ1RSTF9NU0dfU0VUX1RP RVBMSVRaX01BUFBJTkc6DQo+ID4gPiA+ID4gPiArICoNCj4gPiA+ID4gPiA+ICsgKiBJZiB0aGUg ZGF0YVswXSBmaWVsZCBpbiB0aGUgcmVxdWVzdCBpcyBhbiBpbnZhbGlkIG1hcHBpbmcNCj4gPiA+ ID4gPiA+IG9yZGVyDQo+ID4gPiA+ID4gPiAodG9vIGJpZykNCj4gPiA+ID4gPg0KPiA+ID4gPiA+ IG9yIHRvbyBzbWFsbD8NCj4gPiA+ID4NCj4gPiA+ID4gQW4gb3JkZXIgMCBtYXBwaW5nIHdvdWxk IHN0aWxsIGNvbnRhaW4gYSBzaW5nbGUgZW50cnkgYW5kIHlvdSBjYW4ndA0KPiA+ID4gPiBnZXQN Cj4gPiA+ID4gYW55IHNtYWxsZXIgdGhhbiB0aGF0IDotKQ0KPiA+ID4NCj4gPiA+IEkgbWlzc2Vk IHRoZSBvcmRlciwgYXNzdW1lZCBpdCB3YXMgc2l6ZSwgYnV0IHN0aWxsLCB3aGF0IGlmIHRoZXJl IGFyZQ0KPiA+ID4gMTYNCj4gPiA+IHF1ZXVlcyBhbmQgSSBwYXNzIG9yZGVyIDAsIHRoZSBiZWhh dmlvdXIgb2YgcXVldWVzIDIuLjE2IG5lZWRzIHRvIGJlDQo+ID4gPiB3ZWxsDQo+ID4gPiBkZWZp bmVkLg0KPiA+DQo+ID4gVGhlIGhhc2ggaXMgc2ltcGx5IHVzZWQgYXMgYW4gaW5kZXggbW9kdWxv IG1hcHBpbmcgc2l6ZSAoSSdsbCBtYWtlIHRoYXQNCj4gPiBjbGVhciBzb21ld2hlcmUpDQo+IA0K PiB0aGFua3MuDQo+IA0KPiA+ICBzbyBhIG1hcHBpbmcgc2l6ZSBsZXNzIHRoYW4gdGhlIG51bWJl ciBvZiBxdWV1ZXMgeW91IGhhdmUgaXMgb2sgYnV0DQo+ID4gY2xlYXJseSBzdWJvcHRpbWFsLg0K PiA+DQo+ID4gPg0KPiA+ID4gU2luY2UgdGhpcyBpcyBhIHNpbmdsZSBwYWdlLCB3aGF0IGhhcHBl bnMgd2l0aCA+PTUxMiBxdWV1ZXM/IChhbmQgaG93DQo+ID4gPiBmYXINCj4gPiA+IGF3YXkgaXMg dGhhdCBwb3NzaWJpbGl0eSkuDQo+ID4gPg0KPiA+DQo+ID4gR29vZCBxdWVzdGlvbi4gQW4gOCBi eXRlIHF1ZXVlIG51bWJlcg0KPiANCj4gOCBieXRlcyBpcyB0aGUgaGFzaCBtYXRjaCBpc24ndCBp dCBhbmQgUSBudW1iZXIgaXMgdGhlIG9mZnNldCBpbnRvIHRoZQ0KPiBwYWdlLCBpc24ndCBpdD8g T3IgaGF2ZSBJIG1pc3VuZGVyc3Rvb2QgaG93IHNvbWV0aGluZyBmaXRzIHRvZ2V0aGVyPw0KDQpO by4gT3RoZXIgd2F5IHJvdW5kIDotKSBUaGUgaGFzaCBpcyB0cmVhdGVkIGFzIGFuIGluZGV4IGlu dG8gdGhlIHRhYmxlLCBtb2R1bG8gdGFibGUgc2l6ZSBhbmQgdGhlIHZhbHVlcyBpbiB0aGUgdGFi bGUgYXJlIHRoZSBhY3R1YWwgcXVldWUgbnVtYmVycy4NCg0KPiANCj4gPiBpcyBjbGVhcmx5IG92 ZXJraWxsIGlmIHdlIGNhbiBvbmx5IHN0ZWVyIHRvIDUxMiBvZiB0aGVtLiBJIGNvdWxkIGRlZmlu ZSBhDQo+ID4gbGltaXQgb24gdGhlIG51bWJlciBvZiBxdWV1ZXMgYXQgMjU2IGFuZCB1c2UgYnl0 ZSBhcnJheSBpbnN0ZWFkLg0KPiA+IFJlYWxpc3RpY2FsbHksIGl0J3MgZ29pbmcgdG8gYmUgYSB3 aGlsZSBiZWZvcmUgd2UgZ2V0IHRvIDI1NiBjcHVzIGluIGENCj4gPiBXaW5kb3dzIFZNLg0KPiAN Cj4gVGhlbSdzIGJyYXZlIHdvcmRzIDstKQ0KPiANCg0KR2V0dGluZyB0byAzMiBoYXMgYmVlbiBo YXJkIGVub3VnaC4gQnJlYWtpbmcgdGhyb3VnaCB0aGUgNjQgY3B1IGxpbWl0IGlzIGdvaW5nIHRv IGJlICdpbnRlcmVzdGluZycgdG9vLCBJIHN1c3BlY3QuIChBIGxvdCBvZiBjb3JlIFdpbmRvd3Mg c3R1ZmYgdXNlcyBuYXRpdmUgd29yZCBzaXplIGJpdCBtYXNrcyBmb3IgY3B1IGFmZmluaXR5IHNv IHlvdSBoYXZlIHRvIHN0YXJ0IHVzaW5nICdwcm9jZXNzb3IgZ3JvdXBzJyBhbmQgaXQgYWxsIGdl dHMgYSBiaXQgZnVua3kpLg0KDQo+IFdlIHNob3VsZCBtYXliZSBjb25zaWRlciB0aGF0IGEgZi9l IE9TIG90aGVyIHRoYW4gV2luZG93cyBtaWdodCwgZm9yDQo+IHNvbWUNCj4gcmVhc29uLCBpbXBs ZW1lbnQgVG9lcGxpdHogYW5kIGhhdmUgYSBoaWdoZXIgcHJvYmFiaWxpdHkgb2Ygc3VwcG9ydGlu Zw0KPiBsYXJnZSAjcyBvZiB2Y3B1cyBzb29uZXI/DQo+IA0KPiBTcGxpdCBkYXRhWzBdIGludG8g KHRvdGFsKSBzaXplIGFuZCBvZmZzZXQgKHRvIHNldCBibG9ja3Mgb2YgdmFsdWVzKT8NCg0KT2su IElmIEkgZ28gZm9yIGEgMTYtYml0IHF1ZXVlIG51bWJlciwgdGhhdCdzIHByb2JhYmx5IGVub3Vn aCwgYW5kIG1lYW5zIHRoYXQgYSA0ayBwYWdlIGNhbiBob2xkIDJrIG1hcHBpbmdzLiBUaGVuIEkn bGwgZG8gYXMgeW91IHN1Z2dlc3QgYW5kIHVzZSBhIHNpemUsIG9mZnNldCBwYWlyIGluIHBsYWNl IG9mIHRoZSBvcmRlciBmaWVsZC4NCg0KICBQYXVsDQoNCj4gDQo+ID4gwqAgUGF1bA0KPiA+DQo+ ID4gPiBJYW4uDQo+ID4NCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fClhlbi1kZXZlbCBtYWlsaW5nIGxpc3QKWGVuLWRldmVsQGxpc3RzLnhlbi5vcmcKaHR0 cDovL2xpc3RzLnhlbi5vcmcveGVuLWRldmVsCg==