From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ian Campbell Subject: Re: [PATCH v4 2/3] public/io/netif.h: document control ring and toeplitz hashing Date: Fri, 8 Jan 2016 16:46:18 +0000 Message-ID: <1452271578.26438.56.camel@citrix.com> 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> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail6.bemta3.messagelabs.com ([195.245.230.39]) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1aHaBE-0000ng-CO for xen-devel@lists.xenproject.org; Fri, 08 Jan 2016 16:46:24 +0000 In-Reply-To: <8738d051636f4c7f85181322699e1084@AMSPEX02CL03.citrite.net> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: Paul Durrant , "xen-devel@lists.xenproject.org" Cc: Ian Jackson , "Keir (Xen.org)" , Jan Beulich , "Tim (Xen.org)" List-Id: xen-devel@lists.xenproject.org T24gRnJpLCAyMDE2LTAxLTA4IGF0IDE2OjE5ICswMDAwLCBQYXVsIER1cnJhbnQgd3JvdGU6Cj4g PiA+ICsgKiBUaGUgY29udHJvbCByaW5nIHVzZXMgYSBmaXhlZCByZXF1ZXN0L3Jlc3BvbnNlIG1l c3NhZ2Ugc2l6ZSBhbmQKPiA+ID4gaXMKPiA+ID4gKyAqIGJhbGFuY2VkIChpLmUuIG9uZSByZXF1 ZXN0IHRvIG9uZSByZXNwb25zZSksIHNvIG9wZXJhdGlvbmFsbHkgaXQKPiA+ID4gaXMgbXVjaAo+ ID4gPiArICogdGhlIHNhbWUgYXMgYSB0cmFtc21pdCBvciByZWNlaXZlIHJpbmcuCj4gPiAKPiA+ ICJ0cmFuc21pdCIuCj4gPiAKPiA+IElzIGl0IGludGVuZGVkIHRvIHN1cHBvcnQgb3V0IG9mIG9y ZGVyIHJlc3BvbnNlcz8KPiAKPiBJIGRpZG4ndCB3YW50IHRvIHByZWNsdWRlIGl0IGluIGNhc2Ug c29tZW9uZSB3YW50cyB0byBhZGQgYSBwb3RlbnRpYWxseQo+IGxvbmcgcnVubmluZyBjb250cm9s IG9wZXJhdGlvbiBpbiBmdXR1cmUuCgpQcm9iYWJseSBiZXN0IHRvIGV4cGxpY2l0bHkgZmxhZyB0 aGlzIHBvc3NpYmlsaXR5LgoKCj4gCj4gPiAKPiA+ID4gKyAqLwo+ID4gPiArCj4gPiA+ICsvKgo+ ID4gPiArICogVG9lcGxpdHogaGFzaCB0eXBlcwo+ID4gPiArICogPT09PT09PT09PT09PT09PT09 PQo+ID4gPiArICoKPiA+ID4gKyAqIEZvciB0aGUgcHVycG9zZXMgb2YgdGhlIGRlZmluaXRpb25z IGJlbG93LCAnUGFja2V0W10nIGlzIGFuIGFycmF5Cj4gPiA+IG9mCj4gPiA+ICsgKiBvY3RldHMg Y29udGFpbmluZyBhbiBJUCBwYWNrZXQgd2l0aG91dCBvcHRpb25zLCAnQXJyYXlbWC4uWV0nCj4g PiA+IG1lYW5zIGEKPiA+ID4gKyAqIHN1Yi1hcnJheSBvZiAnQXJyYXknIGNvbnRhaW5pbmcgYnl0 ZXMgWCB0aHJ1IFkgaW5jbHVzaXZlLCBhbmQgJysnCj4gPiA+IGlzCj4gPiA+ICsgKiB1c2VkIHRv IGluZGljYXRlIGNvbmNhdGVuYXRpb24gb2YgYXJyYXlzLgo+ID4gPiArICovCj4gPiA+ICsKPiA+ ID4gKy8qCj4gPiA+ICsgKiBBIGhhc2ggY2FsY3VsYXRlZCBvdmVyIGFuIElQIHZlcnNpb24gNCBo ZWFkZXIgYXMgZm9sbG93czoKPiA+ID4gKyAqCj4gPiA+ICsgKiBCdWZmZXJbMC4uOF0gPSBQYWNr ZXRbMTIuLjE1XSArIFBhY2tldFsxNi4uMTldCj4gPiAKPiA+IElzIHRoZXJlIGEgcmVhc29uIHRv IHdyaXRlIGl0IGxpa2UgdGhpcyByYXRoZXIgdGhhbjoKPiA+ICsgKiBCdWZmZXJbMC4uOF0gPSBQ YWNrZXRbMTIuLjE5XQo+ID4gPwo+ID4gCj4gPiBNYXliZSBzb21ldGhpbmcgd2hpY2ggaXMgb2J2 aW91cyBpZiB5b3Uga25vdyBhYm91dCBUb2VwbGl0eiBpbiBtb3JlCj4gPiB0aGFuCj4gPiBqdXN0 IGEgcGFzc2luZyBmYXNoaW9uPwo+IAo+IFRoZSByZWFzb24gaXMgYWN0dWFsbHkgc28gaXQgbW9y ZSByZXNlbWJsZXMgdGhlIE1pY3Jvc29mdCBkb2N1bWVudGF0aW9uCj4gYXQgaHR0cHM6Ly9tc2Ru Lm1pY3Jvc29mdC5jb20vZW4tCj4gdXMvbGlicmFyeS93aW5kb3dzL2hhcmR3YXJlL2ZmNTcwNzI1 JTI4dj12cy44NSUyOS5hc3B4LgoKQWgsIHRoYXQncyBub3QgdW5yZWFzb25hYmxlLgoKPiAgUGVy aGFwcyBpdCB3b3VsZCBtYWtlIG1vcmUgc2Vuc2UgaWYgSSBwb2ludGVkIG91dCB0aGF0IFBhY2tl dFsxMi4uMTVdIGlzCj4gdGhlIHNvdXJjZSBhZGRyZXNzIGFuZCBQYWNrZXRbMTYuLjE5XSBpcyB0 aGUgZGVzdCBhZGRyZXNzIChhbmQgZG8gdGhlCj4gc2FtZSBpbiB0aGUgc3Vic2VxdWVudCBjb21t ZW50cyk/CgpBc3N1bWluZyBpdCBkb2Vzbid0IG5lZ2F0aXZlbHkgaW1wYWN0IHRoZSByZWFkYWJp bGl0eSwgc3VyZS4KCj4gPiBJIGtub3cgdGhlIFRvZXBsaXR6IHN0dWZmIGRvZXNuJ3QgbmVlZCBp dCwgYnV0IHdlIHNob3VsZCBjb25zaWRlcgo+ID4gZGVzaWduaW5nCj4gPiBpbiBhIHNjaGVtZSB0 byBoYW5kbGUgY29udHJvbCBjb21tYW5kcyB3aGljaCBuZWVkID44IG9jdGV0cyBvZiBkYXRhLCBv cgo+ID4gZWxzZSB3ZSByaXNrIGVuZGluZyB1cCB3aXRoIHNvbWV0aGluZyBhcyBjb25mdXNpbmcg YXMgdGhlIGRhdGEgcGF0aC4uLgo+ID4gCj4gCj4gSSdtIG9rIHdpdGggdGhhdCwgYnV0IHlvdSBj YW4gYWx3YXlzIHVzZSBhIGdyZWYgKGFzIGlzIGRvbmUgZm9yIHRoZSBrZXkKPiBhbmQgbWFwcGlu ZyB0YWJsZSkuIElmIDggc2VlbXMgdG8gc21hbGwsIHdoYXQgZG8geW91IGZlZWwgd291bGQgYmUg dGhlCj4gcmlnaHQgbnVtYmVyIHRvIGNob29zZT8KCkknbSBoYXBweSB3aXRoIGluZGlyZWN0IHZp YSBhIGdyZWYgYXMgYSBzY2hlbWUgaWYgdGhhdCBzZWVtcyBzdWZmaWNpZW50LgoKKyAqCj4gPiA+ ICsgKiB0eXBlID0gTkVUSUZfQ1RSTF9UWVBFX1NFVF9UT0VQTElUWl9GTEFHUzoKPiA+ID4gKyAq Cj4gPiA+ICsgKiBUaGlzIGlzIHNlbnQgYnkgdGhlIGZyb250ZW5kIHRvIHNldCB0aGUgdHlwZXMg b2YgdG9lcGxpdHogaGFzaAo+ID4gPiB0aGF0Cj4gPiA+ICsgKiB0aGUgYmFja2VuZCBzaG91bGQg Y2FsY3VsYXRlLiBOb3RlIHRoYXQgdGhlICdtYXhpbWFsJyB0eXBlIG9mCj4gPiA+IGhhc2gKPiA+ ID4gKyAqIHNob3VsZCBhbHdheXMgYmUgY2hvc2VuLiBGb3IgZXhhbXBsZSwgaWYgdGhlIGZyb250 ZW5kIHNldHMgYm90aAo+ID4gPiBJUFY0Cj4gPiA+ICsgKiBhbmQgSVBWNF9UQ1AgaGFzaCB0eXBl cyB0aGVuIHRoZSBsYXR0ZXIgaGFzaCB0eXBlIHNob3VsZCBiZQo+ID4gPiBjYWxjdWxhdGVkCj4g PiA+ICsgKiBmb3IgYW55IFRDUCBwYWNrZXQgYW5kIHRoZSBmb3JtZXIgb25seSBjYWxjdWxhdGVk IGZvciBub24tVENQCj4gPiA+IHBhY2tldHMuCj4gPiA+ICsgKiBUaGUgZGF0YVswXSBmaWVsZCBp cyBhIGJpdHdpc2UgT1Igb2YgTkVUSUZfQ1RSTF9UT0VQTElUWl9GTEFHXyoKPiA+IHZhbHVlcwo+ ID4gPiArICogZGVmaW5lZCBhYm92ZS4gVGhlIGRhdGFbMV0gZmllbGQgaXMgc2V0IHRvIDAuCj4g PiA+ICsgKgo+ID4gPiArICogTk9URTogU2V0dGluZyBkYXRhWzBdIHRvIDAgZGlzYWJsZXMgdG9l cGxpdHogaGFzaGluZyBhbmQgdGhlCj4gPiA+IGJhY2tlbmQKPiA+ID4gKyAqwqDCoMKgwqDCoMKg wqBpcyBmcmVlIHRvIGNob29zZSBob3cgaXQgc3RlZXJzIHBhY2tldHMgdG8gcXVldWVzICh3aGlj aCBpcwo+ID4gPiB0aGUKPiA+ID4gKyAqwqDCoMKgwqDCoMKgwqBkZWZhdWx0IHN0YXRlKS4KPiA+ ID4gKyAqCj4gPiA+ICsgKiB0eXBlID0gTkVUSUZfQ1RSTF9UWVBFX1NFVF9gVE9FUExJVFpfS0VZ Ogo+ID4gCj4gPiBDYW4gdGhpcyBiZSBzZW50IGJlZm9yZSBGTEFHUz8KPiA+IAo+ID4gSXMgaXQg cGVybWlzc2libGUgdG8gc2VuZCB0aGlzIGZvciBhIGhhc2ggc2NoZW1lIG5vdCBpbmNsdWRlZCBp biBmbGFncz8KPiA+IAo+IAo+IFllcywgaXQgY2FuIGJ1dCB0aGUgaWRlYSBpcyB0aGF0IG5vdGhp bmcgaGFzIGFueSBlZmZlY3QgdW50aWwgYSB2YWxpZCBzZXQKPiBvZiBmbGFncyBpcyBzcGVjaWZp ZWQuCgpTbyB0aGUgYi9lIGlzIHJlcXVpcmVkIHRvIHJlbWVtYmVyIGtleXMgY29ycmVzcG9uZGlu ZyB0byBkaXNhYmxlZCBoYXNoZXMKYW5kIGltbWVkaWF0ZWx5IHVzZSB0aGVtIHdoZW4gdGhlIGhh c2ggaXMgZW5hYmxlZCwgaXQgaXMgbm90IGFsbG93ZWQgdG8KaWdub3JlIHRoaXMgbWVzc2FnZSBh bmQgZXhwZWN0IGFub3RoZXIga2V5IG9uY2UgdGhlIGhhc2ggaXMgZW5hYmxlZC4KCklmIHlvdSBl bmFibGUgYSBoYXNoIHdpdGhvdXQgc2V0dGluZyBhIGtleSB0aGVuIHdoYXQgZG9lcyB0aGUga2V5 IGRlZmF1bHQKdG8/IFRyYWZmaWMgY291bGQgYmUgZmxvd2luZyB3aGlsZSB0aGlzIGlzIGdvaW5n IG9uLCByaWdodCAoc2luY2UgdGhpbmdzCmFyZSBDb25uZWN0ZWQpPwoKPiA+ID4gKy8qCj4gPiA+ ICsgKiBDb250cm9sIHJlc3BvbnNlcyAobmV0aWZfY3RybF9yZXNwb25zZV90KQo+ID4gPiArICog PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0KPiA+ID4gKyAqCj4gPiA+ ICsgKiBBbGwgcmVzcG9uc2VzIGhhdmUgdGhlIGZvbGxvd2luZyBmb3JtYXQ6Cj4gPiA+ICsgKgo+ ID4gPiArICrCoMKgwqDCoDDCoMKgwqDCoMKgMcKgwqDCoMKgwqAywqDCoMKgwqDCoDPCoMKgwqDC oMKgNMKgwqDCoMKgwqA1wqDCoMKgwqDCoDbCoMKgwqDCoMKgN8KgwqBvY3RldAo+ID4gPiArICog Ky0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKwo+ID4gPiAr ICogfMKgwqDCoMKgaWTCoMKgwqDCoMKgfMKgwqDCoHBhZMKgwqDCoMKgwqB8wqDCoMKgwqDCoMKg wqDCoMKgc3RhdHVzwqDCoMKgwqDCoMKgwqDCoHwKPiA+ID4gKyAqICstLS0tLSstLS0tLSstLS0t LSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSsKPiA+ID4gKyAqIHzCoMKgwqDCoMKgwqDC oMKgwqBkYXRhwqDCoMKgwqDCoMKgwqDCoMKgwqB8Cj4gPiA+ICsgKiArLS0tLS0rLS0tLS0rLS0t LS0rLS0tLS0rCj4gPiA+ICsgKgo+ID4gPiArICogaWQ6IHRoZSBjb3JyZXNwb25kaW5nIHJlcXVl c3QgaWRlbnRpZmllcgo+ID4gPiArICogcGFkOiBzZXQgdG8gMAo+ID4gPiArICogc3RhdHVzOiB0 aGUgc3RhdHVzIG9mIHJlcXVlc3QgcHJvY2Vzc2luZwo+ID4gPiArICogZGF0YTogYW55IGRhdGEg YXNzb2NpYXRlZCB3aXRoIHRoZSByZXNwb25zZSAoZGV0ZXJtaW5lZCBieSB0eXBlCj4gPiA+IGFu ZAo+ID4gPiArICrCoMKgwqDCoMKgwqDCoHN0YXR1cykKPiA+IAo+ID4gdHlwZSBuZWVkcyB0byBi ZSByZW1lbWJlcmVkIHZpYSB0aGUgaWQ/IFdoeSBub3QgZWNobyBpdCBpbiB0aGUgcGFkCj4gPiBm aWVsZAo+ID4gZm9yIGNvbnZlbmllbmNlPwo+ID4gCj4gCj4gSSBvcmlnaW5hbGx5IGhhZCB0aGF0 IGJ1dCB0aG91Z2h0IGl0IHdvdWxkIGJlIHN1cGVyZmx1b3VzIGdpdmVuIHRoYXQgdGhlCj4gaWQg aXMgZWNob2VkLiBJIGNhbiBhZGQgaXQgYmFjayBpZiB5b3UgdGhpbmsgdGhhdCBpdCB3b3VsZCBi ZSBhIGdvb2QKPiBpZGVhLiBBbGwgbXkgaW1wbGVtZW50YXRpb24gZGlkIHdpdGggaXQgdGhvdWdo IHdhcyBBU1NFUlQgdGhhdCBpdCBtYXRjaGVkCj4gdGhlIHJlcS4KCldhcyBpdCBhIGNvaW5jaWRl bmNlIHRoYXQgeW91IGhhZCB0aGUgcmVxIGluIGhhbmQgZ2l2ZW4gdGhlIGlkLCBvciBpcyBpdCBh CmZ1bmRhbWVudGFsIHByb3BlcnR5IG9mIGFueSBpbXBsZW1lbnRhdGlvbiBvZiB0aGlzIHByb3Rv Y29sIHRoYXQgeW91IHdvdWxkCmhhdmUgaXQgaGFuZHk/Cj7CoAo+ID4gPiArICoKPiA+ID4gKyAq IHR5cGUgPSBORVRJRl9DVFJMX01TR19TRVRfVE9FUExJVFpfRkxBR1M6Cj4gPiA+ICsgKgo+ID4g PiArICogSWYgdGhlIGRhdGFbMF0gZmllbGQgaW4gdGhlIHJlcXVlc3QgaXMgaW52YWxpZCAoaS5l LiBjb250YWlucwo+ID4gPiB1bnN1cHBvcnRlZAo+ID4gPiArICogaGFzaCB0eXBlcykgdGhlbiB0 aGUgc3RhdHVzIGZpZWxkIGlzIHNldCB0bwo+ID4gPiArICogTkVUSUZfQ1RSTF9TVEFUVVNfSU5W QUxJRF9QQVJBTUVURVIuIE90aGVyd2lzZSB0aGUgcmVxdXNldAo+ID4gc2hvdWxkCj4gPiAKPiA+ ICJyZXF1ZXN0Igo+ID4gCj4gPiA+IHN1Y2NlZWQKPiA+ID4gKyAqIGFuZCBoZW5jZSB0aGUgc3Rh dHVzIGZpZWxkIGlzIHNldCB0byBORVRJRl9DVFJMX1NUQVRVU19TVUNDRVNTLgo+ID4gPiArICog VGhlIGRhdGEgZmllbGQgc2hvdWxkIGJlIHNldCB0byAwLgo+ID4gPiArICoKPiA+ID4gKyAqIHR5 cGUgPSBORVRJRl9DVFJMX01TR19TRVRfVE9FUExJVFpfS0VZOgo+ID4gPiArICoKPiA+ID4gKyAq IElmIHRoZSBkYXRhWzBdIGZpZWxkIGluIHRoZSByZXF1ZXN0IGlzIGFuIGludmFsaWQga2V5IGxl bmd0aCAodG9vCj4gPiA+IGJpZykKPiA+IAo+ID4gQ2FuIGl0IG5vdCBiZSB0b28gc21hbGwgYXMg d2VsbD8gV2hhdCBpcyB0aGUgYmVoYXZpb3VyIGlmIGl0IGlzPwo+ID4gCj4gCj4gSSBndWVzcyB0 aGUgd2F5IHRoZSBhbGdvcml0aG0gaXMgZGVmaW5lZCwgYSBrZXkgb2YgbGVzcyB0aGFuIDMyIGJp dHMKPiBkb2Vzbid0IG1ha2UgbXVjaCBzZW5zZS4KCldoYXQgaWYgSSB0aHJvdyBjYXV0aW9uIHRv IHRoZSB3aW5kIGFuZCBzZXQgb25lIGJ5dGUgYW55d2F5PwoKPiAKPiA+ID4gKyAqIHRoZW4gdGhl IHN0YXR1cyBmaWVsZCBpcyBzZXQgdG8KPiA+IE5FVElGX0NUUkxfU1RBVFVTX0JVRkZFUl9PVkVS RkxPVywgSWYgdGhlCj4gPiA+ICsgKiBkYXRhWzFdIGZpZWxkIGlzIGFuIGludmFsaWQgZ3JhbnQg cmVmZXJlbmNlIHRoZW4gdGhlIHN0YXR1cyBmaWVsZAo+ID4gPiBpcyBzZXQKPiA+ID4gKyAqIHRv IE5FVElGX0NUUkxfU1RBVFVTX0lOVkFMSURfUEFSQU1FVEVSLiBPdGhlcndpc2UgdGhlIHJlcXVl c3QKPiA+IHNob3VsZAo+ID4gPiArICogc3VjY2VlZCBhbmQgaGVuY2UgdGhlIHN0YXR1cyBmaWVs ZCBpcyBzZXQgdG8KPiA+IE5FVElGX0NUUkxfU1RBVFVTX1NVQ0NFU1MuCj4gPiA+ICsgKiBUaGUg ZGF0YSBmaWVsZCBzaG91bGQgYmUgc2V0IHRvIDAuCj4gPiA+ICsgKgo+ID4gPiArICogdHlwZSA9 IE5FVElGX0NUUkxfTVNHX1NFVF9UT0VQTElUWl9NQVBQSU5HOgo+ID4gPiArICoKPiA+ID4gKyAq IElmIHRoZSBkYXRhWzBdIGZpZWxkIGluIHRoZSByZXF1ZXN0IGlzIGFuIGludmFsaWQgbWFwcGlu ZyBvcmRlcgo+ID4gPiAodG9vIGJpZykKPiA+IAo+ID4gb3IgdG9vIHNtYWxsPwo+IAo+IEFuIG9y ZGVyIDAgbWFwcGluZyB3b3VsZCBzdGlsbCBjb250YWluIGEgc2luZ2xlIGVudHJ5IGFuZCB5b3Ug Y2FuJ3QgZ2V0Cj4gYW55IHNtYWxsZXIgdGhhbiB0aGF0IDotKQoKSSBtaXNzZWQgdGhlIG9yZGVy LCBhc3N1bWVkIGl0IHdhcyBzaXplLCBidXQgc3RpbGwsIHdoYXQgaWYgdGhlcmUgYXJlIDE2CnF1 ZXVlcyBhbmQgSSBwYXNzIG9yZGVyIDAsIHRoZSBiZWhhdmlvdXIgb2YgcXVldWVzIDIuLjE2IG5l ZWRzIHRvIGJlIHdlbGwKZGVmaW5lZC4KClNpbmNlIHRoaXMgaXMgYSBzaW5nbGUgcGFnZSwgd2hh dCBoYXBwZW5zIHdpdGggPj01MTIgcXVldWVzPyAoYW5kIGhvdyBmYXIKYXdheSBpcyB0aGF0IHBv c3NpYmlsaXR5KS4KCklhbi4KCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54ZW4ub3Jn Cmh0dHA6Ly9saXN0cy54ZW4ub3JnL3hlbi1kZXZlbAo=