From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?UTF-8?B?SsO8cmdlbiBHcm/Dnw==?= Subject: Re: [PATCH DOCDAY] netif.h: describe request/response structures in terms of binary layout Date: Wed, 25 Feb 2015 13:48:26 +0100 Message-ID: <54EDC49A.2090003@suse.com> References: <1424866610-27163-1-git-send-email-ian.campbell@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1424866610-27163-1-git-send-email-ian.campbell@citrix.com> 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.xen.org Cc: keir@xen.org, ian.jackson@eu.citrix.com, tim@xen.org, jbeulich@suse.com, Wei Liu , =?UTF-8?B?Um9nZXIgUGF1?= =?UTF-8?B?IE1vbm7DqQ==?= List-Id: xen-devel@lists.xenproject.org T24gMDIvMjUvMjAxNSAwMToxNiBQTSwgSWFuIENhbXBiZWxsIHdyb3RlOgo+IEluIFJGQyBzdHls ZSwgcmF0aGVyIHRoYW4gcmVseWluZyBvbiB0aGUgaW1wbGljaXQgYXNzdW1wdGlvbnMgb2YgYQo+ IHBhcnRpY3VsYXIgQyBBQkkuCj4KPiBJIGhhdmUgYWxzbyBjb25maXJtZWQsIHVzaW5nIHRoZSBQ eXRob24gZ2RiIGV4dGVuc2lvbiB0ZWNobmlxdWUgaW4KPiBbMF0sIHRoYXQgdGhlIHN0cnVjdCBv ZmZzZXRzIChpbiBhIExpbnV4IGJpbmFyeSBhdCBsZWFzdCkgYXJlIHRoZSBzYW1lCj4gYXMgZGVz Y3JpYmVkIGhlcmUuCj4KPiBJIHRvb2sgdGhlIG9wcG9ydHVuaXR5IHRvIGFsc28gY29uZmlybSB0 aGF0IHg4Nl8zMiwgeDg2XzY0LCBhcm0zMiBhbmQKPiBhcm02NCBhcmUgYWxsIHRoZSBzYW1lLgo+ Cj4gVGhpcyBoaWdobGlnaHRlZCB0aGF0IHN0cnVjdCBuZXRpZl9yeF9yZXF1ZXN0IHdhcyBtaXNz aW5nIHNvbWUKPiBleHBsaWNpdCBwYWRkaW5nLCB3aGljaCBpcyBhZGRlZCBoZXJlLgo+Cj4gTGFz dGx5LCBmaXh1cCBzb21lIHN0cnVjdCBuYW1lcyB0byBhbGxvdyB0aGUgZ2VuZXJhdGVkIGRvY3Mg dG8KPiBwcm9wZXJseSBoeXBlcmxpbmssIG1haW5seSBieSBhZGRpbmcgdGhlIF90IHRvIHR5cGUg bmFtZXMgd2hlcmUKPiBhcHByb3ByaWF0ZSwgYnV0IGFsc28gcy9uZXRpZl90eF9leHRyYS9uZXRp Zl9leHRyYV9pbmZvX3QvLgo+Cj4gW10gaHR0cDovL3N0YWNrb3ZlcmZsb3cuY29tL3F1ZXN0aW9u cy85Nzg4Njc5L2hvdy10by1nZXQtdGhlLXJlbGF0aXZlLWFkcmVzcy1vZi1hLWZpZWxkLWluLWEt c3RydWN0dXJlLWR1bXAtYywKPgo+IFNpZ25lZC1vZmYtYnk6IElhbiBDYW1wYmVsbCA8aWFuLmNh bXBiZWxsQGNpdHJpeC5jb20+Cj4gQ2M6IFJvZ2VyIFBhdSBNb25uw6kgPHJvZ2VyLnBhdUBjaXRy aXguY29tPgo+IENjOiBXZWkgTGl1IDx3ZWkubGl1MkBjaXRyaXguY29tPgoKT25lIGdlbmVyYWwg cXVlc3Rpb246IHNob3VsZCB0aGUgUkZDLWxpa2UgZGVzY3JpcHRpb24gcmVhbGx5IGNvbnRhaW4K bWFjcm8gbmFtZXMgaW5zdGVhZCBvZiBleHBsaWNpdCB2YWx1ZXM/Cgo+IC0tLQo+ICAgeGVuL2lu Y2x1ZGUvcHVibGljL2lvL25ldGlmLmggfCAgMTM3ICsrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrLS0tCj4gICAxIGZpbGUgY2hhbmdlZCwgMTI3IGluc2VydGlvbnMoKyksIDEw IGRlbGV0aW9ucygtKQo+Cj4gZGlmZiAtLWdpdCBhL3hlbi9pbmNsdWRlL3B1YmxpYy9pby9uZXRp Zi5oIGIveGVuL2luY2x1ZGUvcHVibGljL2lvL25ldGlmLmgKPiBpbmRleCA2MWU5YWVhLi4wM2Ix NGZlIDEwMDY0NAo+IC0tLSBhL3hlbi9pbmNsdWRlL3B1YmxpYy9pby9uZXRpZi5oCj4gKysrIGIv eGVuL2luY2x1ZGUvcHVibGljL2lvL25ldGlmLmgKPiBAQCAtMTM3LDEzICsxMzcsMTI5IEBACj4K PiAgIC8qCj4gICAgKiBUaGlzIGlzIHRoZSAnd2lyZScgZm9ybWF0IGZvciBwYWNrZXRzOgo+IC0g KiAgUmVxdWVzdCAxOiBuZXRpZl90eF9yZXF1ZXN0IC0tIE5FVFRYRl8qIChhbnkgZmxhZ3MpCj4g LSAqIFtSZXF1ZXN0IDI6IG5ldGlmX3R4X2V4dHJhXSAgKG9ubHkgaWYgcmVxdWVzdCAxIGhhcyBO RVRUWEZfZXh0cmFfaW5mbykKPiAtICogW1JlcXVlc3QgMzogbmV0aWZfdHhfZXh0cmFdICAob25s eSBpZiByZXF1ZXN0IDIgaGFzIFhFTl9ORVRJRl9FWFRSQV9NT1JFKQo+IC0gKiAgUmVxdWVzdCA0 OiBuZXRpZl90eF9yZXF1ZXN0IC0tIE5FVFRYRl9tb3JlX2RhdGEKPiAtICogIFJlcXVlc3QgNTog bmV0aWZfdHhfcmVxdWVzdCAtLSBORVRUWEZfbW9yZV9kYXRhCj4gKyAqICBSZXF1ZXN0IDE6IG5l dGlmX3R4X3JlcXVlc3RfdCAtLSBORVRUWEZfKiAoYW55IGZsYWdzKQo+ICsgKiBbUmVxdWVzdCAy OiBuZXRpZl9leHRyYV9pbmZvX3RdIChvbmx5IGlmIHJlcXVlc3QgMSBoYXMgTkVUVFhGX2V4dHJh X2luZm8pCj4gKyAqIFtSZXF1ZXN0IDM6IG5ldGlmX2V4dHJhX2luZm9fdF0gKG9ubHkgaWYgcmVx dWVzdCAyIGhhcyBYRU5fTkVUSUZfRVhUUkFfTU9SRSkKPiArICogIFJlcXVlc3QgNDogbmV0aWZf dHhfcmVxdWVzdF90IC0tIE5FVFRYRl9tb3JlX2RhdGEKPiArICogIFJlcXVlc3QgNTogbmV0aWZf dHhfcmVxdWVzdF90IC0tIE5FVFRYRl9tb3JlX2RhdGEKPiAgICAqICAuLi4KPiAtICogIFJlcXVl c3QgTjogbmV0aWZfdHhfcmVxdWVzdCAtLSAwCj4gKyAqICBSZXF1ZXN0IE46IG5ldGlmX3R4X3Jl cXVlc3RfdCAtLSAwCj4gKyAqLwo+ICsKPiArLyoKPiArICogR3Vlc3QgdHJhbnNtaXQKPiArICog PT09PT09PT09PT09PT0KPiArICoKPiArICogUmluZyBzbG90IHNpemUgaXMgMTIgb2N0ZXRzLCBo b3dldmVyIG5vdCBhbGwgcmVxdWVzdC9yZXNwb25zZQo+ICsgKiBzdHJ1Y3RzIHVzZSB0aGUgZnVs bCBzaXplLgo+ICsgKgo+ICsgKiB0eCByZXF1ZXN0IGRhdGEgKG5ldGlmX3R4X3JlcXVlc3RfdCkK PiArICogLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCj4gKyAqCj4gKyAqICAg IDAgICAgIDEgICAgIDIgICAgIDMgICAgIDQgICAgIDUgICAgIDYgICAgIDcgIG9jdGV0Cj4gKyAq ICstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSsKPiArICog fCBncmFudCByZWYgICAgICAgICAgICAgfCBvZmZzZXQgICAgfCBmbGFncyAgICAgfAo+ICsgKiAr LS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rCj4gKyAqIHwg aWQgICAgICAgIHwgc2l6ZSAgICAgIHwKPiArICogKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKwo+ ICsgKgo+ICsgKiBncmFudCByZWY6IFJlZmVyZW5jZSB0byBidWZmZXIgcGFnZS4KPiArICogb2Zm c2V0OiBPZmZzZXQgd2l0aGluIGJ1ZmZlciBwYWdlLgo+ICsgKiBmbGFnczogTkVUVFhGXyouCj4g KyAqIGlkOiByZXF1ZXN0IGlkZW50aWZpZXIsIGVjaG9lZCBpbiByZXNwb25zZS4KPiArICogc2l6 ZTogcGFja2V0IHNpemUgaW4gYnl0ZXMuCj4gKyAqCj4gKyAqIHR4IHJlc3BvbnNlIChuZXRpZl90 eF9yZXNwb25zZV90KQo+ICsgKiAtLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KPiAr ICoKPiArICogICAgMCAgICAgMSAgICAgMiAgICAgMyAgICAgNCAgICAgNSAgICAgNiAgICAgNyAg b2N0ZXQKPiArICogKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0t LS0tKwo+ICsgKiB8IGlkICAgICAgICB8IHN0YXR1cyAgICB8IHVudXNlZCAgICAgICAgICAgICAg ICB8Cj4gKyAqICstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0t LSsKPiArICogfCB1bnVzZWQgICAgICAgICAgICAgICAgfAo+ICsgKiArLS0tLS0rLS0tLS0rLS0t LS0rLS0tLS0rCj4gKyAqCj4gKyAqIGlkOiByZWZsZWN0cyBpZCBpbiB0cmFuc21pdCByZXF1ZXN0 Cj4gKyAqIHN0YXR1czogTkVUSUZfUlNQXyoKPiArICoKPiArICogR3Vlc3QgcmVjZWl2ZQo+ICsg KiA9PT09PT09PT09PT09Cj4gKwoKRW1wdHkgbGluZSBpbnRlbmRlZD8KCj4gKyAqIFJpbmcgc2xv dCBzaXplIGlzIDggb2N0ZXRzLgo+ICsgKgo+ICsgKiByeCByZXF1ZXN0IChuZXRpZl9yeF9yZXF1 ZXN0X3QpCj4gKyAqIC0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KPiArICoKPiArICog ICAgMCAgICAgMSAgICAgMiAgICAgMyAgICAgNCAgICAgNSAgICAgNiAgICAgNyAgb2N0ZXQKPiAr ICogKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKwo+ICsg KiB8IGlkICAgICAgICB8IHBhZCAgICAgICB8IGdyZWYgICAgICAgICAgICAgICAgICB8Cj4gKyAq ICstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSsKPiArICoK PiArICogaWQ6IHJlcXVlc3QgaWRlbnRpZmllciwgZWNob2VkIGluIHJlc3BvbnNlLgo+ICsgKiBn cmVmOiByZWZlcmVuY2UgdG8gaW5jb21pbmcgZ3JhbnRlZCBmcmFtZS4KPiArICoKPiArICogcngg cmVzcG9uc2UgKG5ldGlmX3J4X3Jlc3BvbnNlX3QpCj4gKyAqIC0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLQo+ICsgKgo+ICsgKiAgICAwICAgICAxICAgICAyICAgICAzICAgICA0ICAg ICA1ICAgICA2ICAgICA3ICBvY3RldAo+ICsgKiArLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rLS0t LS0rLS0tLS0rLS0tLS0rLS0tLS0rCj4gKyAqIHwgaWQgICAgICAgIHwgb2Zmc2V0ICAgIHwgZmxh Z3MgICAgIHwgc3RhdHVzICAgIHwKPiArICogKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0t Ky0tLS0tKy0tLS0tKy0tLS0tKwo+ICsgKgo+ICsgKiBpZDogcmVmbGVjdHMgaWQgaW4gcmVjZWl2 ZSByZXF1ZXN0Cj4gKyAqIG9mZnNldDogb2Zmc2V0IGluIHBhZ2Ugb2Ygc3RhcnQgb2YgcmVjZWl2 ZWQgcGFja2V0Cj4gKyAqIGZsYWdzOiBORVRSWEZfKgo+ICsgKiBzdGF0dXM6IC12ZTogTkVUSUZf UlNQXyo7ICt2ZTogUngnZWQgcGt0IHNpemUuCgpXaGF0IGlzIC0vK3ZlPwoKPiArICoKPiArICog RXh0cmEgSW5mbwo+ICsgKiA9PT09PT09PT09Cj4gKyAqCj4gKyAqIENhbiBiZSBwcmVzZW50IGlm IGluaXRpYWwgcmVxdWVzdCBoYXMgTkVUe1QsUn1YRl9leHRyYV9pbmZvLCBvcgo+ICsgKiBwcmV2 aW91cyBleHRyYSByZXF1ZXN0IGhhcyBYRU5fTkVUSUZfRVhUUkFfTU9SRS4KPiArICoKPiArICog VGhlIHN0cnVjdCB0aGVyZWZvcmUgbmVlZHMgdG8gZml0IGludG8gZWl0aGVyIGEgdHggb3Igcngg c2xvdCBhbmQKPiArICogaXMgdGhlcmVmb3JlIGxpbWl0ZWQgdG8gOCBvY3RldHMuCj4gKyAqCj4g KyAqIGV4dHJhIGluZm8gKG5ldGlmX2V4dHJhX2luZm9fdCkKPiArICogLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLQo+ICsgKgo+ICsgKiBHZW5lcmFsIGZvcm1hdDoKPiArICoKPiArICog ICAgMCAgICAgMSAgICAgMiAgICAgMyAgICAgNCAgICAgNSAgICAgNiAgICAgNyAgb2N0ZXQKPiAr ICogKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKwo+ICsg KiB8dHlwZSB8ZmxhZ3N8IHR5cGUgc3BlY2ZpYyBkYXRhICAgICAgICAgICAgICAgICB8Cj4gKyAq ICstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSsKPiArICog fCBwYWRkaW5nIGZvciB0eCAgICAgICAgfAo+ICsgKiArLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0r Cj4gKyAqCj4gKyAqIHR5cGU6IFhFTl9ORVRJRl9FWFRSQV9UWVBFXyoKPiArICogZmxhZ3M6IFhF Tl9ORVRJRl9FWFRSQV9GTEFHXyoKPiArICogcGFkZGluZyBmb3IgdHg6IHByZXNlbnQgb25seSBp biB0aGUgdHggY2FzZSBkdWUgdG8gOCBvY3RldCBsaW1pdAo+ICsgKiAgICAgZnJvbSByeCBjYXNl LiBOb3Qgc2hvd24gaW4gdHlwZSBzcGVjaWZpYyBlbnRyaWVzIGJlbG93Lgo+ICsgKgo+ICsgKiBY RU5fTkVUSUZfRVhUUkFfVFlQRV9HU086Cj4gKyAqCj4gKyAqICAgIDAgICAgIDEgICAgIDIgICAg IDMgICAgIDQgICAgIDUgICAgIDYgICAgIDcgIG9jdGV0Cj4gKyAqICstLS0tLSstLS0tLSstLS0t LSstLS0tLSstLS0tLSstLS0tLSstLS0tLSstLS0tLSsKPiArICogfHR5cGUgfGZsYWdzfCBzaXpl ICAgICAgfHR5cGUgfCBwYWQgfCBmZWF0dXJlcyAgfAo+ICsgKiArLS0tLS0rLS0tLS0rLS0tLS0r LS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rCj4gKyAqCj4gKyAqIHR5cGU6IE11c3QgYmUg WEVOX05FVElGX0VYVFJBX1RZUEVfR1NPCj4gKyAqIGZsYWdzOiBYRU5fTkVUSUZfRVhUUkFfRkxB R18qCj4gKyAqIHNpemU6IE1heGltdW0gcGF5bG9hZCBzaXplIG9mIGVhY2ggc2VnbWVudC4KPiAr ICogdHlwZTogWEVOX05FVElGX0dTT19UWVBFXyoKPiArICogZmVhdHVyZXM6IEVOX05FVElGX0dT T19GRUFUXyoKPiArICoKPiArICogWEVOX05FVElGX0VYVFJBX1RZUEVfTUNBU1Rfe0FERCxERUx9 Ogo+ICsgKgo+ICsgKiAgICAwICAgICAxICAgICAyICAgICAzICAgICA0ICAgICA1ICAgICA2ICAg ICA3ICBvY3RldAo+ICsgKiArLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rLS0tLS0rLS0t LS0rLS0tLS0rCj4gKyAqIHx0eXBlIHxmbGFnc3wgYWRkciAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgIHwKPiArICogKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0tKy0tLS0t Ky0tLS0tKwo+ICsgKgo+ICsgKiB0eXBlOiBNdXN0IGJlIFhFTl9ORVRJRl9FWFRSQV9UWVBFX01D QVNUX3tBREQsREVMfQo+ICsgKiBmbGFnczogWEVOX05FVElGX0VYVFJBX0ZMQUdfKgo+ICsgKiBh ZGRyOiBhZGRyc3MgdG8gYWRkL3JlbW92ZQoKcy9hZGRyc3MvYWRkcmVzcy8KCkp1ZXJnZW4KCl9f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fClhlbi1kZXZlbCBt YWlsaW5nIGxpc3QKWGVuLWRldmVsQGxpc3RzLnhlbi5vcmcKaHR0cDovL2xpc3RzLnhlbi5vcmcv eGVuLWRldmVsCg==