From mboxrd@z Thu Jan  1 00:00:00 1970
From: Paul Durrant <Paul.Durrant@citrix.com>
Subject: Re: netif.h clarifications
Date: Fri, 20 May 2016 09:09:43 +0000
Message-ID: <3d18e0cafe0648bfa8f8cbd1673e1031@AMSPEX02CL03.citrite.net>
References: <20160519162750.qfdns6uzhcg5v3ts@mac>
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Return-path: <xen-devel-bounces@lists.xen.org>
Received: from mail6.bemta6.messagelabs.com ([85.158.143.247])
 by lists.xenproject.org with esmtp (Exim 4.84_2)
 (envelope-from <prvs=941b8b53e=Paul.Durrant@citrix.com>)
 id 1b3gWp-00068H-6N
 for xen-devel@lists.xenproject.org; Fri, 20 May 2016 09:15:31 +0000
In-Reply-To: <20160519162750.qfdns6uzhcg5v3ts@mac>
Content-Language: en-US
List-Unsubscribe: <http://lists.xen.org/cgi-bin/mailman/options/xen-devel>,
 <mailto:xen-devel-request@lists.xen.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xen.org>
List-Help: <mailto:xen-devel-request@lists.xen.org?subject=help>
List-Subscribe: <http://lists.xen.org/cgi-bin/mailman/listinfo/xen-devel>,
 <mailto:xen-devel-request@lists.xen.org?subject=subscribe>
Errors-To: xen-devel-bounces@lists.xen.org
Sender: "Xen-devel" <xen-devel-bounces@lists.xen.org>
To: Roger Pau Monne <roger.pau@citrix.com>, "xen-devel@lists.xenproject.org" <xen-devel@lists.xenproject.org>
Cc: Wei Liu <wei.liu2@citrix.com>, David Vrabel <david.vrabel@citrix.com>
List-Id: xen-devel@lists.xenproject.org

PiAtLS0tLU9yaWdpbmFsIE1lc3NhZ2UtLS0tLQo+IEZyb206IFJvZ2VyIFBhdSBNb25uw6kgW21h
aWx0bzpyb2dlci5wYXVAY2l0cml4LmNvbV0KPiBTZW50OiAxOSBNYXkgMjAxNiAxNzoyOAo+IFRv
OiB4ZW4tZGV2ZWxAbGlzdHMueGVucHJvamVjdC5vcmcKPiBDYzogV2VpIExpdTsgRGF2aWQgVnJh
YmVsOyBQYXVsIER1cnJhbnQKPiBTdWJqZWN0OiBuZXRpZi5oIGNsYXJpZmljYXRpb25zCj4gCj4g
SGVsbG8sCj4gCj4gV2hpbGUgdHJ5aW5nIHRvIHNvbHZlIGEgRnJlZUJTRCBuZXRmcm9udCBidWcg
WzBdIEkgY2FtZSBhY3Jvc3MgYSBjb3VwbGUKPiBvZiBuZXRpZi5oIGRhcmsgc3BvdHMgdGhhdCBJ
IHRoaW5rIHNob3VsZCBiZSBkb2N1bWVudGVkIGluIHRoZSBuZXRpZi5oCj4gaGVhZGVyLiBJJ20g
d2lsbGluZyB0byBtYWtlIHRob3NlIGNoYW5nZXMsIGJ1dCBJIHdhbnQgdG8gbWFrZSBzdXJlIG15
Cj4gdW5kZXJzdGFuZGluZyBpcyByaWdodC4KPiAKPiBSZWdhcmRpbmcgY2hlY2tzdW0gb2ZmbG9h
ZGluZywgSSBoYWQgYSBoYXJkIHRpbWUgZmlndXJpbmcgb3V0IHdoYXQgdGhlCj4gZGlmZmVyZW50
IGZsYWdzIGFjdHVhbGx5IG1lYW46Cj4gCj4gLyogUGFja2V0IGRhdGEgaGFzIGJlZW4gdmFsaWRh
dGVkIGFnYWluc3QgcHJvdG9jb2wgY2hlY2tzdW0uICovCj4gI2RlZmluZSBfTkVUUlhGX2RhdGFf
dmFsaWRhdGVkICgwKQo+ICNkZWZpbmUgIE5FVFJYRl9kYXRhX3ZhbGlkYXRlZCAoMVU8PF9ORVRS
WEZfZGF0YV92YWxpZGF0ZWQpCj4gCj4gLyogUHJvdG9jb2wgY2hlY2tzdW0gZmllbGQgaXMgYmxh
bmsgaW4gdGhlIHBhY2tldCAoaGFyZHdhcmUgb2ZmbG9hZCk/ICovCj4gI2RlZmluZSBfTkVUUlhG
X2NzdW1fYmxhbmsgICAgICgxKQo+ICNkZWZpbmUgIE5FVFJYRl9jc3VtX2JsYW5rICAgICAoMVU8
PF9ORVRSWEZfY3N1bV9ibGFuaykKPiAKPiAoU2FtZSBhcHBsaWVzIHRvIHRoZSBUWCBmbGFncywg
SSdtIG5vdCBjb3B5aW5nIHRoZW0gdGhlcmUgYmVjYXVzZSB0aGV5IGFyZQo+IHRoZSBzYW1lKQo+
IAo+IEZpcnN0IG9mIGFsbCwgSSBhc3N1bWUgInByb3RvY29sIiBoZXJlIHJlZmVycyB0byBMYXll
ciAzIGFuZCBMYXllciA0Cj4gcHJvdG9jb2wsIHNvIHRoYXQgd291bGQgYmUgSVAgYW5kIFRDUC9V
RFAvU0NUUCBjaGVja3N1bSBvZmZsb2FkaW5nPyBJbgo+IGFueQo+IGNhc2UgdGhpcyBuZWVkcyBj
bGFyaWZpY2F0aW9uIGFuZCBwcm9wZXIgd29yZGluZy4KPiAKPiBUaGVuLCBJIGhhdmUgc29tZSBx
dWVzdGlvbnMgcmVnYXJkaW5nIHRoZSBtZWFuaW5nIG9mIHRoZSBmbGFncyB0aGVtc2VsdmVzCj4g
YW5kIHRoZSBjb250ZW50IG9mIHRoZSBjaGVja3N1bSBmaWVsZCBpbiBhbGwgdGhlIHBvc3NpYmxl
IHNjZW5hcmlvcy4KPiAKPiBPbiBSWCBwYXRoOgo+IAo+ICAtIE5FVFJYRl9kYXRhX3ZhbGlkYXRl
ZCBvbmx5OiBkYXRhIGhhcyBiZWVuIHZhbGlkYXRlZCwgYnV0IHdoYXQncyB0aGUgc3RhdGUKPiAg
ICBvZiB0aGUgY2hlY2tzdW0gZmllbGQgaXRzZWxmPyBJZiB0aGUgZGF0YSBpcyB2YWxpZGF0ZWQg
YWdhaW4sIHdvdWxkIGl0Cj4gICAgbWF0Y2ggYWdhaW5zdCB0aGUgY2hlY2tzdW0/Cj4gIC0gTkVU
UlhGX2NzdW1fYmxhbmsgb25seTogSSBkb24ndCB0aGluayB0aGlzIG1ha2VzIG11Y2ggc2Vuc2Us
IGRhdGEgaXMgaW4KPiAgICB1bmtub3duIHN0YXRlIGFuZCBjaGVja3N1bSBpcyBub3QgcHJlc2Vu
dCwgc28gdGhlcmUncyBubyB3YXkgdG8gdmFsaWRhdGUKPiAgICBpdC4gUGFja2V0IHNob3VsZCBi
ZSBkcm9wcGVkPwoKWWVzLCBpbiBwcmFjdGljZSBpdCdzIG5vdCB1c2VkIG9uIGl0cyBvd24uIEFz
IHlvdSBzYXksIEkgZG9uJ3QgdGhpbmsgaXQgbWFrZXMgYW55IHNlbnNlLgoKPiAgLSBORVRSWEZf
ZGF0YV92YWxpZGF0ZWQgfCBORVRSWEZfY3N1bV9ibGFuazogdGhpcyBjb21iaW5hdGlvbiBzZWVt
cyB0bwo+IGJlCj4gICAgdGhlIG9uZSB0aGF0IG1ha2VzIG1vcmUgc2Vuc2UgdG8gbWUsIGRhdGEg
aXMgdmFsaWQsIGJ1dCBjaGVja3N1bSBpcyBub3QKPiAgICB0aGVyZS4gVGhpcyBtYXRjaGVzIHdo
YXQgc29tZSByZWFsIE5JQ3MgYWxyZWFkeSBkbywgdGhhdCBpcyB0byBwcm92aWRlCj4gICAgdGhl
IHJlc3VsdCBvZiB0aGUgY2hlY2tzdW0gY2hlY2sgX3dpdGhvdXRfIGFjdHVhbGx5IHByb3ZpZGlu
ZyB0aGUKPiAgICBjaGVja3N1bSBpdHNlbGYgb24gdGhlIFJYIHBhdGguCj4gCgpJbiBMaW51eCBu
ZXRiYWNrIHRoaXMgaXMgc2V0IGlmIHRoZSBjaGVja3N1bSBpbmZvIGlzIHBhcnRpYWwsIHdoaWNo
IEkgdGFrZSB0byBtZWFuIHRoYXQgdGhlIHBhY2tldCBoYXMgYSB2YWxpZCBwc2V1ZG8taGVhZGVy
IGNoZWNrc3VtLiBJIHRoaW5rIHBhY2tldHMgY29taW5nIGZyb20gTklDcyBhcmUgbW9yZSBsaWtl
bHkgdG8gYmUgJ2NoZWNrc3VtIHVubmVjZXNzYXJ5JyB3aGljaCByZXN1bHRzIGluIE5FVFJYRl9k
YXRhX3ZhbGlkYXRlZCBvbmx5LCB3aGljaCBJIHRha2UgdG8gbWVhbiB0aGF0IHRoZSBjaGVja3N1
bSBoYXMgYmVlbiB2ZXJpZmllZCBidXQgbWF5IGhhdmUgYmVlbiB0cmFzaGVkIGluIHRoZSBwcm9j
ZXNzLgoKPiBPbiBUWCBwYXRoOgo+IAo+ICAtIE5FVFRYRl9kYXRhX3ZhbGlkYXRlZCBvbmx5OiBJ
IGRvbid0IHRoaW5rIHRoaXMgbWFrZXMgYW55IHNlbnNlLCBkYXRhIGlzCj4gICAgYWx3YXlzIHZh
bGlkIGZyb20gdGhlIHNlbmRlcnMgcG9pbnQgb2Ygdmlldy4KPiAgLSBORVRUWEZfY3N1bV9ibGFu
ayBvbmx5OiBjaGVja3N1bSBjYWxjdWxhdGlvbiBvZmZsb2FkLCBpdCBzaG91bGQgYmUKPiAgICBw
ZXJmb3JtZWQgYnkgdGhlIG90aGVyIGVuZC4KPiAgLSBORVRUWEZfZGF0YV92YWxpZGF0ZWQgfCBO
RVRUWEZfY3N1bV9ibGFuazogYWdhaW4sIEkgZG9uJ3QgdGhpbmsgaXQgbWFrZXMKPiAgICBtdWNo
IHNlbnNlLCBkYXRhIGlzIGFsd2F5cyB2YWxpZCBmcm9tIHRoZSBzZW5kZXJzIHBvaW50IG9mIHZp
ZXcsIG9yIGVsc2UKPiAgICB3aHkgYm90aGVyIHNlbmRpbmcgaXQ/Cj4gCgpJbiBMaW51eCBuZXRi
YWNrLCB0aGUgY29kZSBnb2VzOgoKCQlpZiAodHhwLT5mbGFncyAmIFhFTl9ORVRUWEZfY3N1bV9i
bGFuaykKCQkJc2tiLT5pcF9zdW1tZWQgPSBDSEVDS1NVTV9QQVJUSUFMOwoJCWVsc2UgaWYgKHR4
cC0+ZmxhZ3MgJiBYRU5fTkVUVFhGX2RhdGFfdmFsaWRhdGVkKQoJCQlza2ItPmlwX3N1bW1lZCA9
IENIRUNLU1VNX1VOTkVDRVNTQVJZOwoKU28sIGNzdW1fYmxhbmsgd2l0aCBvciB3aXRob3V0IGRh
dGFfdmFsaWRhdGVkIG1lYW5zIHRoYXQgaXQncyBhc3N1bWVkIHRoYXQgdGhlIHBhY2tldCBjb250
YWlucyBhIHZhbGlkIHBzZXVkby1oZWFkZXIgY2hlY2tzdW0sIGJ1dCBpZiBjc3VtX2JsYW5rIGlz
IG5vdCBzZXQgdGhlbiBkYXRhX3ZhbGlkYXRlZCBtZWFucyB0aGF0IHRoZSBkYXRhIGlzIGdvb2Qg
YnV0IHRoZSBjaGVja3N1bSBpcyBpbiBhbiB1bmtub3duIHN0YXRlIHdoaWNoIGlzIG9rIGlmIHRo
ZSBwYWNrZXQgaXMgdGhlbiBmb3J3YXJkZWQgdG8gYW5vdGhlciB2aWYsIGFuZCBJIGFzc3VtZSAn
dW5uZWNlc3NhcnknIGlzIGlnbm9yZWQgYnkgTklDIGRyaXZlcnMgb24gdGhlaXIgVFggc2lkZSAo
SSBndWVzcyB0aGV5IHdvdWxkIG9ubHkgYmUgaW50ZXJlc3RpbmcgaW4gJ3BhcnRpYWwnKS4KCj4g
U28gaXQgbG9va3MgdG8gbWUgbGlrZSB3ZSBjb3VsZCBnZXQgYXdheSB3aXRoIGp1c3QgdHdvIGZs
YWdzLCBvbmUgb24gdGhlIFJYCj4gc2lkZSB0aGF0IHNpZ25hbHMgdGhhdCB0aGUgcGFja2V0IGRv
ZXNuJ3QgaGF2ZSBhIGNoZWNrc3VtIGJ1dCB0aGF0IHRoZQo+IGNoZWNrc3VtIHZhbGlkYXRpb24g
aGFzIGFscmVhZHkgYmVlbiBwZXJmb3JtZWQsIGFuZCBhbm90aGVyIG9uZSBvbiB0aGUgVFgKPiBz
aWRlIHRvIHNpZ25hbCB0aGF0IHRoZSBwYWNrZXQgZG9lc24ndCBoYXZlIGEgY2FsY3VsYXRlZCBj
aGVja3N1bQo+ICh0eXBpY2FsIGNoZWNrc3VtIG9mZmxvYWQpLgo+IAoKT24gdGhlIFRYIHNpZGUg
aXQgd291bGQgYmUgdXNlZnVsIHRvIGhhdmUgZmxhZ3Mgd2hpY2ggaW5kaWNhdGU6CgotIEZ1bGwg
Y2hlY2tzdW0gcHJlc2VudAotIFBzZXVkby1oZWFkZXIgY2hlY2tzdW0gcHJlc2VudAotIFN0YXRl
IG9mIGNoZWNrc3VtIGlzIHVua25vd24KCk9uIHRoZSBSWCBzaWRlIGl0IHdvdWxkIGJlIHVzZWZ1
bCB0byBoYXZlCgotIERhdGEgdmFsaWRhdGVkLCBjaGVja3N1bSBzdGF0ZSB1bmtub3duCi0gRGF0
YSB2YWxpZGF0ZWQsIGNoZWNrc3VtIGNvcnJlY3QKLSBEYXRhIG5vdCB2YWxpZGF0ZWQKCj4gQW5k
IHRoZW4gSSd2ZSBhbHNvIHNlZW4gc29tZSBpc3N1ZXMgd2l0aCBUU08vTFJPIChHU08gaW4gTGlu
dXgKPiB0ZXJtaW5vbG9neSkKPiB3aGVuIHVzaW5nIHBhY2tldCBmb3J3YXJkaW5nIGluc2lkZSBv
ZiBhIEZyZWVCU0QgRG9tVS4gRm9yIGV4YW1wbGUgaW4gdGhlCj4gZm9sbG93aW5nIHNjZW5hcmlv
Ogo+IAo+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgKwo+ICAgICAgICAgICAg
ICAgICAgICAgICAgICAgICAgICAgICAgfAo+ICAgICstLS0tLS0tLS0rICAgICAgICAgICArLS0t
LS0tLS0tLS0tLS0tLS0tLS0rICAgICAgICAgICArLS0tLS0tLS0tLSsKPiAgICB8ICAgICAgICAg
fEEgICAgICAgICBCfCAgICAgICByb3V0ZXIgICAgICAgfEMgICAgICAgICBEfCAgICAgICAgICB8
Cj4gICAgfCBHdWVzdCAxICstLS0tLS0tLS0tLSsgICAgICAgICArICAgICAgICAgICstLS0tLS0t
LS0tLSsgR3Vlc3QgMiAgfAo+ICAgIHwgICAgICAgICB8ICBicmlkZ2UwICB8ICAgICAgICAgfCAg
ICAgICAgICB8ICBicmlkZ2UxICB8ICAgICAgICAgIHwKPiAgICArLS0tLS0tLS0tKyAgICAgICAg
ICAgKy0tLS0tLS0tLS0tLS0tLS0tLS0tKyAgICAgICAgICAgKy0tLS0tLS0tLS0rCj4gICAgMTcy
LjE2LjEuNjcgICAgICAgICAgMTcyLjE2LjEuNjZ8ICAgMTAuMC4xLjEgICAgICAgICAgIDEwLjAu
MS4yCj4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB8Cj4gICAgICAgICAgICAg
ICstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0+Cj4gICAgICAg
ICAgICAgICBzc2ggMTAuMC4xLjIgICAgICAgICB8Cj4gICAgICAgICAgICAgICAgICAgICAgICAg
ICAgICAgICAgICB8Cj4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB8Cj4gICAg
ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB8Cj4gICAgICAgICAgICAgICAgICAgICAg
ICAgICAgICAgICAgICArCj4gCj4gQWxsIHRob3NlIFZNcyBhcmUgaW5zaWRlIG9mIHRoZSBzYW1l
IGhvc3QsIGFuZCBvbmUgb2YgdGhlbSBhY3RzIGFzIGEgZ2F0ZXdheQo+IGJldHdlZW4gdGhlbSBi
ZWNhdXNlIHRoZXkgYXJlIG9uIHR3byBkaWZmZXJlbnQgc3VibmV0cy4gSW4gdGhpcyBjYXNlIEkn
bQo+IHNlZWluZyBpc3N1ZXMgYmVjYXVzZSBldmVuIHRob3VnaCBJIGRpc2FibGUgVFNPL0xSTyBv
biB0aGUgInJvdXRlciIgYXQKPiBydW50aW1lLCB0aGUgYmFja2VuZCBkb2Vzbid0IHdhdGNoIHRo
ZSB4ZW5zdG9yZSBmZWF0dXJlIGZsYWcsIGFuZCBuZXZlcgo+IGRpc2FibGVzIGl0IGZyb20gdGhl
IHZpZiBvbiB0aGUgRG9tMCBicmlkZ2UuIFRoaXMgY2F1c2VzIExSTyBwYWNrZXRzCj4gKG5vbi1m
cmFnbWVudGVkKSB0byBiZSByZWNlaXZlZCBhdCBwb2ludCAnQycsIGFuZCB0aGVuIHdoZW4gdGhl
IGdhdGV3YXkKPiB0cmllcyB0byBpbmplY3QgdGhlbSBpbnRvIHRoZSBvdGhlciBOSUMgaXQgZmFp
bHMgYmVjYXVzZSB0aGUgc2l6ZSBpcyBncmVhdGVyCj4gdGhhbiB0aGUgTVRVLCBhbmQgdGhlICJu
byBmcmFnbWVudCIgYml0IGlzIHNldC4KPiAKClllcywgR1NPIGNhbm5vdCBiZSBkaXNhYmxlZC9l
bmFibGVkIGR5bmFtaWNhbGx5IG9uIHRoZSBuZXRiYWNrIHR4IHNpZGUgKGkuZS4gZ3Vlc3Qgcngg
c2lkZSkgc28geW91IGNhbid0IHR1cm4gaXQgb2ZmLiBUaGUgV2luZG93cyBQViBkcml2ZXIgbGVh
dmUgc2l0IG9uIGFsbCB0aGUgdGltZSBhbmQgZG9lcyB0aGUgZnJhZ21lbnRhdGlvbiBpdHNlbGYg
aWYgdGhlIHN0YWNrIGRvZXNuJ3Qgd2FudCBHUk8uIERvaW5nIHRoZSBmcmFnbWVudGF0aW9uIGlu
IHRoZSBmcm9udGVuZCBtYWtlcyBtb3JlIHNlbnNlIGFueXdheSBzaW5jZSB0aGUgY3B1IGN5Y2xl
cyBhcmUgYnVybmVkIGJ5IHRoZSBWTSByYXRoZXIgdGhhbiBkb20wIGFuZCBzbyBpdCBzY2FsZXMg
YmV0dGVyLgoKPiBIb3cgZG9lcyBMaW51eCBkZWFsIHdpdGggdGhpcyBzaXR1YXRpb24/IERvZXMg
aXQgc2ltcGx5IGlnbm9yZSB0aGUgbm8KPiBmcmFnbWVudCBmbGFnIGFuZCBmcmFnbWVudHMgdGhl
IHBhY2tldD8gRG9lcyBpdCBzaW1wbHkgaW5qZWN0IHRoZSBwYWNrZXQgdG8KPiB0aGUgb3RoZXIg
ZW5kIGlnbm9yaW5nIHRoZSBNVFUgYW5kIHByb3BhZ2F0aW5nIHRoZSBHU08gZmxhZz8KPiAKCkkn
dmUgbm90IGxvb2tlZCBhdCB0aGUgbmV0ZnJvbnQgcnggY29kZSBidXQgSSBhc3N1bWUgdGhhdCB0
aGUgbGFyZ2UgcGFja2V0IHRoYXQgaXMgcGFzc2VkIGZyb20gbmV0YmFjayBpcyBqdXN0IG1hcmtl
ZCBhcyBHU08gYW5kIG1ha2VzIGl0cyB3YXkgdG8gd2hlcmV2ZXIgaXQncyBnb2luZyAoYmVpbmcg
ZnJhZ21lbnRlZCBieSB0aGUgc3RhY2sgaWYgaXQncyBmb3J3YXJkZWQgdG8gYW4gaW50ZXJmYWNl
IHRoYXQgZG9lc24ndCBoYXZlIHRoZSBUU08gZmxhZyBzZXQpLgoKICBQYXVsCgo+IFJvZ2VyLgo+
IAo+IFswXSBodHRwczovL2J1Z3MuZnJlZWJzZC5vcmcvYnVnemlsbGEvc2hvd19idWcuY2dpP2lk
PTE4ODI2MQoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18K
WGVuLWRldmVsIG1haWxpbmcgbGlzdApYZW4tZGV2ZWxAbGlzdHMueGVuLm9yZwpodHRwOi8vbGlz
dHMueGVuLm9yZy94ZW4tZGV2ZWwK