From mboxrd@z Thu Jan  1 00:00:00 1970
From: "Jorgen S. Hansen" <jhansen@vmware.com>
Subject: Re: [PATCH v2] vsock.7: document VSOCK socket address family
Date: Wed, 6 Dec 2017 14:06:46 +0000
Message-ID: <19A05993-CB7C-4A7F-8ECF-CE55B1EE9619@vmware.com>
References: <20171205105618.30049-1-stefanha@redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Cc: "linux-man@vger.kernel.org" <linux-man@vger.kernel.org>,
        "netdev@vger.kernel.org" <netdev@vger.kernel.org>,
        "G. Branden Robinson" <g.branden.robinson@gmail.com>,
        Dexuan Cui <decui@microsoft.com>
To: Stefan Hajnoczi <stefanha@redhat.com>
Return-path: <netdev-owner@vger.kernel.org>
Received: from mail-by2nam01on0074.outbound.protection.outlook.com ([104.47.34.74]:18880
        "EHLO NAM01-BY2-obe.outbound.protection.outlook.com"
        rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP
        id S1751208AbdLFOGs (ORCPT <rfc822;netdev@vger.kernel.org>);
        Wed, 6 Dec 2017 09:06:48 -0500
In-Reply-To: <20171205105618.30049-1-stefanha@redhat.com>
Content-Language: en-US
Content-ID: <DB7B51E5B21D314F9AC8A106190E6200@namprd05.prod.outlook.com>
Sender: netdev-owner@vger.kernel.org
List-ID: <netdev.vger.kernel.org>

DQo+IE9uIERlYyA1LCAyMDE3LCBhdCAxMTo1NiBBTSwgU3RlZmFuIEhham5vY3ppIDxzdGVmYW5o
YUByZWRoYXQuY29tPiB3cm90ZToNCj4gDQo+IFRoZSBBRl9WU09DSyBhZGRyZXNzIGZhbWlseSBo
YXMgYmVlbiBhdmFpbGFibGUgc2luY2UgTGludXggMy45IHdpdGhvdXQgYQ0KPiBjb3JyZXNwb25k
aW5nIG1hbiBwYWdlLg0KPiANCj4gVGhpcyBwYXRjaCBhZGRzIHZzb2NrLjcgYW5kIGRlc2NyaWJl
cyBpdHMgdXNlIGFsb25nIHRoZSBzYW1lIGxpbmVzIGFzDQo+IGV4aXN0aW5nIGlwLjcsIHVuaXgu
NywgYW5kIG5ldGxpbmsuNyBtYW4gcGFnZXMuDQo+IA0KPiBDQzogSm9yZ2VuIEhhbnNlbiA8amhh
bnNlbkB2bXdhcmUuY29tPg0KPiBDQzogRGV4dWFuIEN1aSA8ZGVjdWlAbWljcm9zb2Z0LmNvbT4N
Cj4gU2lnbmVkLW9mZi1ieTogU3RlZmFuIEhham5vY3ppIDxzdGVmYW5oYUByZWRoYXQuY29tPg0K
PiAtLS0NCj4gbWFuNy92c29jay43IHwgMTgwICsrKysrKysrKysrKysrKysrKysrKysrKysrKysr
KysrKysrKysrKysrKysrKysrKysrKysrKysrKysrDQo+IDEgZmlsZSBjaGFuZ2VkLCAxODAgaW5z
ZXJ0aW9ucygrKQ0KPiBjcmVhdGUgbW9kZSAxMDA2NDQgbWFuNy92c29jay43DQo+IA0KPiBkaWZm
IC0tZ2l0IGEvbWFuNy92c29jay43IGIvbWFuNy92c29jay43DQo+IG5ldyBmaWxlIG1vZGUgMTAw
NjQ0DQo+IGluZGV4IDAwMDAwMDAwMC4uNDZkYzU2MWY1DQo+IC0tLSAvZGV2L251bGwNCj4gKysr
IGIvbWFuNy92c29jay43DQo+IEBAIC0wLDAgKzEsMTgwIEBADQo+ICsuVEggVlNPQ0sgNyAyMDE3
LTExLTMwICJMaW51eCIgIkxpbnV4IFByb2dyYW1tZXIncyBNYW51YWwiDQo+ICsuU0ggTkFNRQ0K
PiArdnNvY2sgXC0gTGludXggVlNPQ0sgYWRkcmVzcyBmYW1pbHkNCj4gKy5TSCBTWU5PUFNJUw0K
PiArLkIgI2luY2x1ZGUgPHN5cy9zb2NrZXQuaD4NCj4gKy5icg0KPiArLkIgI2luY2x1ZGUgPGxp
bnV4L3ZtX3NvY2tldHMuaD4NCj4gKy5QUA0KPiArLklCIHN0cmVhbV9zb2NrZXQgIiA9IHNvY2tl
dChBRl9WU09DSywgU09DS19TVFJFQU0sIDApOyINCj4gKy5icg0KPiArLklCIGRhdGFncmFtX3Nv
Y2tldCAiID0gc29ja2V0KEFGX1ZTT0NLLCBTT0NLX0RHUkFNLCAwKTsiDQo+ICsuU0ggREVTQ1JJ
UFRJT04NCj4gK1RoZSBWU09DSyBhZGRyZXNzIGZhbWlseSBmYWNpbGl0YXRlcyBjb21tdW5pY2F0
aW9uIGJldHdlZW4gdmlydHVhbCBtYWNoaW5lcyBhbmQNCj4gK3RoZSBob3N0IHRoZXkgYXJlIHJ1
bm5pbmcgb24uICBUaGlzIGFkZHJlc3MgZmFtaWx5IGlzIHVzZWQgYnkgZ3Vlc3QgYWdlbnRzIGFu
ZA0KPiAraHlwZXJ2aXNvciBzZXJ2aWNlcyB0aGF0IG5lZWQgYSBjb21tdW5pY2F0aW9ucyBjaGFu
bmVsIHRoYXQgaXMgaW5kZXBlbmRlbnQgb2YNCj4gK3ZpcnR1YWwgbWFjaGluZSBuZXR3b3JrIGNv
bmZpZ3VyYXRpb24uDQo+ICsuUFANCj4gK1ZhbGlkIHNvY2tldCB0eXBlcyBhcmUNCj4gKy5CIFNP
Q0tfU1RSRUFNDQo+ICthbmQNCj4gKy5CUiBTT0NLX0RHUkFNIC4NCj4gKy5CIFNPQ0tfU1RSRUFN
DQo+ICtwcm92aWRlcyBjb25uZWN0aW9uLW9yaWVudGVkIGJ5dGUgc3RyZWFtcyB3aXRoIGd1YXJh
bnRlZWQsIGluLW9yZGVyIGRlbGl2ZXJ5Lg0KPiArLkIgU09DS19ER1JBTQ0KPiArcHJvdmlkZXMg
YSBjb25uZWN0aW9ubGVzcyBkYXRhZ3JhbSBwYWNrZXQgc2VydmljZSB3aXRoIGJlc3QtZWZmb3J0
IGRlbGl2ZXJ5IGFuZA0KPiArYmVzdC1lZmZvcnQgb3JkZXJpbmcuICBBdmFpbGFiaWxpdHkgb2Yg
dGhlc2Ugc29ja2V0IHR5cGVzIGlzIGRlcGVuZGVudCBvbiB0aGUNCj4gK3VuZGVybHlpbmcgaHlw
ZXJ2aXNvci4NCj4gKy5QUA0KPiArQSBuZXcgc29ja2V0IGlzIGNyZWF0ZWQgd2l0aA0KPiArLlBQ
DQo+ICsgICAgc29ja2V0KEFGX1ZTT0NLLCBzb2NrZXRfdHlwZSwgMCk7DQo+ICsuUFANCj4gK1do
ZW4gYSBwcm9jZXNzIHdhbnRzIHRvIGVzdGFibGlzaCBhIGNvbm5lY3Rpb24gaXQgY2FsbHMNCj4g
Ky5CUiBjb25uZWN0ICgyKQ0KPiArd2l0aCBhIGdpdmVuIGRlc3RpbmF0aW9uIHNvY2tldCBhZGRy
ZXNzLiAgVGhlIHNvY2tldCBpcyBhdXRvbWF0aWNhbGx5IGJvdW5kIHRvDQo+ICthIGZyZWUgcG9y
dCBpZiB1bmJvdW5kLg0KPiArLlBQDQo+ICtBIHByb2Nlc3MgY2FuIGxpc3RlbiBmb3IgaW5jb21p
bmcgY29ubmVjdGlvbnMgYnkgZmlyc3QgYmluZGluZyB0byBhIHNvY2tldA0KPiArYWRkcmVzcyB1
c2luZw0KPiArLkJSIGJpbmQgKDIpDQo+ICthbmQgdGhlbiBjYWxsaW5nDQo+ICsuQlIgbGlzdGVu
ICgyKS4NCj4gKy5QUA0KPiArRGF0YSBpcyB0cmFuc2ZlcnJlZCB1c2luZyB0aGUgdXN1YWwNCj4g
Ky5CUiBzZW5kICgyKQ0KPiArYW5kDQo+ICsuQlIgcmVjdiAoMikNCj4gK2ZhbWlseSBvZiBzb2Nr
ZXQgc3lzdGVtIGNhbGxzLg0KPiArLlNTIEFkZHJlc3MgZm9ybWF0DQo+ICtBIHNvY2tldCBhZGRy
ZXNzIGlzIGRlZmluZWQgYXMgYSBjb21iaW5hdGlvbiBvZiBhIDMyLWJpdCBDb250ZXh0IElkZW50
aWZpZXINCj4gKyhDSUQpIGFuZCBhIDMyLWJpdCBwb3J0IG51bWJlci4gIFRoZSBDSUQgaWRlbnRp
ZmllcyB0aGUgc291cmNlIG9yIGRlc3RpbmF0aW9uLA0KPiArd2hpY2ggaXMgZWl0aGVyIGEgdmly
dHVhbCBtYWNoaW5lIG9yIHRoZSBob3N0LiAgVGhlIHBvcnQgbnVtYmVyIGRpZmZlcmVudGlhdGVz
DQo+ICtiZXR3ZWVuIG11bHRpcGxlIHNlcnZpY2VzIHJ1bm5pbmcgb24gYSBzaW5nbGUgbWFjaGlu
ZS4NCj4gKy5QUA0KPiArLmluICs0bg0KPiArLkVYDQo+ICtzdHJ1Y3Qgc29ja2FkZHJfdm0gew0K
PiArICAgIHNhX2ZhbWlseV90ICAgICBzdm1fZmFtaWx5OyAgICAgLyogYWRkcmVzcyBmYW1pbHk6
IEFGX1ZTT0NLICovDQo+ICsgICAgdW5zaWduZWQgc2hvcnQgIHN2bV9yZXNlcnZlZDE7DQo+ICsg
ICAgdW5zaWduZWQgaW50ICAgIHN2bV9wb3J0OyAgICAgICAvKiBwb3J0IGluIG5hdGl2ZSBieXRl
IG9yZGVyICovDQo+ICsgICAgdW5zaWduZWQgaW50ICAgIHN2bV9jaWQ7ICAgICAgICAvKiBhZGRy
ZXNzIGluIG5hdGl2ZSBieXRlIG9yZGVyICovDQo+ICt9Ow0KPiArLkVFDQo+ICsuaW4NCj4gKy5Q
UA0KPiArLkkgc3ZtX2ZhbWlseQ0KPiAraXMgYWx3YXlzIHNldCB0bw0KPiArLkJSIEFGX1ZTT0NL
IC4NCj4gKy5JIHN2bV9yZXNlcnZlZDENCj4gK2lzIGFsd2F5cyBzZXQgdG8gMC4NCj4gKy5JIHN2
bV9wb3J0DQo+ICtjb250YWlucyB0aGUgcG9ydCBpbiBuYXRpdmUgYnl0ZSBvcmRlci4NCj4gK1Ro
ZSBwb3J0IG51bWJlcnMgYmVsb3cgMTAyNCBhcmUgY2FsbGVkDQo+ICsuSVIgInByaXZpbGVnZWQg
cG9ydHMiIC4NCj4gK09ubHkgYSBwcm9jZXNzIHdpdGgNCj4gKy5CIENBUF9ORVRfQklORF9TRVJW
RVINCj4gK2NhcGFiaWxpdHkgbWF5DQo+ICsuQlIgYmluZCAoMikNCj4gK3RvIHRoZXNlIHBvcnQg
bnVtYmVycy4NCj4gKy5QUA0KPiArVGhlcmUgYXJlIHNldmVyYWwgc3BlY2lhbCBhZGRyZXNzZXM6
DQo+ICsuQiBWTUFERFJfQ0lEX0FOWQ0KPiArKC0xVSkNCj4gK21lYW5zIGFueSBhZGRyZXNzIGZv
ciBiaW5kaW5nOw0KPiArLkIgVk1BRERSX0NJRF9IWVBFUlZJU09SDQo+ICsoMCkgaXMgcmVzZXJ2
ZWQgZm9yIHNlcnZpY2VzIGJ1aWx0IGludG8gdGhlIGh5cGVydmlzb3I7DQo+ICsuQiBWTUFERFJf
Q0lEX1JFU0VSVkVEDQo+ICsoMSkgbXVzdCBub3QgYmUgdXNlZDsNCj4gKy5CIFZNQUREUl9DSURf
SE9TVA0KPiArKDIpDQo+ICtpcyB0aGUgd2VsbC1rbm93biBhZGRyZXNzIG9mIHRoZSBob3N0Lg0K
PiArLlBQDQo+ICtUaGUgc3BlY2lhbCBjb25zdGFudA0KPiArLkIgVk1BRERSX1BPUlRfQU5ZDQo+
ICsoLTFVKQ0KPiArbWVhbnMgYW55IHBvcnQgbnVtYmVyIGZvciBiaW5kaW5nLg0KPiArLlNTIExp
dmUgbWlncmF0aW9uDQo+ICtTb2NrZXRzIGFyZSBhZmZlY3RlZCBieSBsaXZlIG1pZ3JhdGlvbiBv
ZiB2aXJ0dWFsIG1hY2hpbmVzLiAgQ29ubmVjdGVkDQo+ICsuQiBTT0NLX1NUUkVBTQ0KPiArc29j
a2V0cyBiZWNvbWUgZGlzY29ubmVjdGVkIHdoZW4gdGhlIHZpcnR1YWwgbWFjaGluZSBtaWdyYXRl
cyB0byBhIG5ldyBob3N0Lg0KPiArQXBwbGljYXRpb25zIG11c3QgcmVjb25uZWN0IHdoZW4gdGhp
cyBoYXBwZW5zLg0KPiArLlBQDQo+ICtUaGUgbG9jYWwgQ0lEIG1heSBjaGFuZ2UgYWNyb3NzIGxp
dmUgbWlncmF0aW9uIGlmIHRoZSBvbGQgQ0lEIGlzIG5vdCBhdmFpbGFibGUNCj4gK29uIHRoZSBu
ZXcgaG9zdC4gIEJvdW5kIHNvY2tldHMgYXJlIGF1dG9tYXRpY2FsbHkgdXBkYXRlZCB0byB0aGUg
bmV3IENJRC4NCj4gKy5TUyBJb2N0bHMNCj4gKy5UUA0KPiArLkIgSU9DVExfVk1fU09DS0VUU19H
RVRfTE9DQUxfQ0lEDQo+ICtHZXQgdGhlIENJRCBvZiB0aGUgbG9jYWwgbWFjaGluZS4gIFRoZSBh
cmd1bWVudCBpcyBhIHBvaW50ZXIgdG8gYW4gdW5zaWduZWQgaW50Lg0KPiArLklQDQo+ICsuaW4g
KzRuDQo+ICsuRVgNCj4gKy5JQiBlcnJvciAiID0gaW9jdGwoIiBzb2NrZXQgIiwgIiBJT0NUTF9W
TV9TT0NLRVRTX0dFVF9MT0NBTF9DSUQgIiwgIiAmY2lkICIpOyINCj4gKy5FRQ0KPiArLmluDQo+
ICsuSVANCj4gK0NvbnNpZGVyIHVzaW5nDQo+ICsuQiBWTUFERFJfQ0lEX0FOWQ0KPiArd2hlbiBi
aW5kaW5nIGluc3RlYWQgb2YgZ2V0dGluZyB0aGUgbG9jYWwgQ0lEIHdpdGgNCj4gKy5CUiBJT0NU
TF9WTV9TT0NLRVRTX0dFVF9MT0NBTF9DSUQgLg0KPiArLlNIIEVSUk9SUw0KPiArLlRQDQo+ICsu
QiBFQUNDRVMNCj4gK1VuYWJsZSB0byBiaW5kIHRvIGEgcHJpdmlsZWdlZCBwb3J0IHdpdGhvdXQg
dGhlDQo+ICsuQiBDQVBfTkVUX0JJTkRfU0VSVklDRQ0KPiArY2FwYWJpbGl0eS4NCj4gKy5UUA0K
PiArLkIgRUlOVkFMDQo+ICtJbnZhbGlkIHBhcmFtZXRlcnMuICBUaGlzIGluY2x1ZGVzOg0KPiAr
YXR0ZW1wdGluZyB0byBiaW5kIGEgc29ja2V0IHRoYXQgaXMgYWxyZWFkeSBib3VuZCwgcHJvdmlk
aW5nIGFuIGludmFsaWQgc3RydWN0DQo+ICsuQlIgc29ja2FkZHJfdm0gLA0KPiArYW5kIG90aGVy
IGlucHV0IHZhbGlkYXRpb24gZXJyb3JzLg0KPiArLlRQDQo+ICsuQiBFT1BOT1RTVVBQDQo+ICtP
cGVyYXRpb24gbm90IHN1cHBvcnRlZC4gIFRoaXMgaW5jbHVkZXM6DQo+ICt0aGUNCj4gKy5CIE1T
R19PT0INCj4gK2ZsYWcgdGhhdCBpcyBub3QgaW1wbGVtZW50ZWQgZm9yDQo+ICsuQlIgc2VuZG1z
ZyAoMikNCj4gK2FuZA0KPiArLkIgTVNHX1BFRUsNCj4gK2Zvcg0KPiArLkJSIHJlY3Ztc2cgKDIp
Lg0KPiArLlRQDQo+ICsuQiBFQUREUklOVVNFDQo+ICtVbmFibGUgdG8gYmluZCB0byBhIHBvcnQg
dGhhdCBpcyBhbHJlYWR5IGluIHVzZS4NCj4gKy5UUA0KPiArLkIgRUFERFJOT1RBVkFJTA0KPiAr
VW5hYmxlIHRvIGZpbmQgYSBmcmVlIHBvcnQgZm9yIGJpbmRpbmcgb3IgdW5hYmxlIHRvIGJpbmQg
dG8gYSBub24tbG9jYWwgQ0lELg0KPiArLlRQDQo+ICsuQiBFTk9UQ09OTg0KPiArVW5hYmxlIHRv
IHBlcmZvcm0gb3BlcmF0aW9uIG9uIGFuIHVuY29ubmVjdGVkIHNvY2tldC4NCj4gKy5UUA0KPiAr
LkIgRU5PUFJPVE9PUFQNCj4gK0ludmFsaWQgc29ja2V0IG9wdGlvbiBpbg0KPiArLkJSIHNldHNv
Y2tvcHQgKDIpDQo+ICtvcg0KPiArLkJSIGdldHNvY2tvcHQgKDIpLg0KPiArLlRQDQo+ICsuQiBF
UFJPVE9OT1NVUFBPUlQNCj4gK0ludmFsaWQgc29ja2V0IHByb3RvY29sIG51bWJlci4gIFByb3Rv
Y29sIHNob3VsZCBhbHdheXMgYmUgMC4NCj4gKy5UUA0KPiArLkIgRVNPQ0tUTk9TVVBQT1JUDQo+
ICtVbnN1cHBvcnRlZCBzb2NrZXQgdHlwZSBpbg0KPiArLkJSIHNvY2tldCAoMikuDQo+ICtPbmx5
DQo+ICsuQiBTT0NLX1NUUkVBTQ0KPiArYW5kDQo+ICsuQiBTT0NLX0RHUkFNDQo+ICthcmUgdmFs
aWQuDQo+ICsuU0ggVkVSU0lPTlMNCj4gK1N1cHBvcnQgZm9yIFZNd2FyZSAoVk1DSSkgaGFzIGJl
ZW4gYXZhaWxhYmxlIHNpbmNlIExpbnV4IDMuOS4gIEtWTSAodmlydGlvKSBpcw0KPiArc3VwcG9y
dGVkIHNpbmNlIExpbnV4IDQuOC4gIEh5cGVyLVYgaXMgc3VwcG9ydGVkIHNpbmNlIDQuMTQuDQo+
ICsuU0ggU0VFIEFMU08NCj4gKy5CUiBzb2NrZXQgKDIpLA0KPiArLkJSIGJpbmQgKDIpLA0KPiAr
LkJSIGNvbm5lY3QgKDIpLA0KPiArLkJSIGxpc3RlbiAoMiksDQo+ICsuQlIgc2VuZCAoMiksDQo+
ICsuQlIgcmVjdiAoMiksDQo+ICsuQlIgY2FwYWJpbGl0aWVzICg3KQ0KPiAtLSANCj4gMi4xNC4z
DQo+IA0KDQpMb29rcyBncmVhdCB0byBtZS4gVGhhbmtzIGZvciBkb2luZyB0aGlzLiBJIGRvbuKA
mXQgaGF2ZSBhbnl0aGluZyB0byBhZGQuDQoNClJldmlld2VkLWJ5OiBKb3JnZW4gSGFuc2VuIDxq
aGFuc2VuQHZtd2FyZS5jb20+DQoNCg==