From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by dpdk.org (Postfix) with ESMTP id C0F227D01 for ; Wed, 9 May 2018 17:57:45 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga008.fm.intel.com ([10.253.24.58]) by orsmga104.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 09 May 2018 08:57:44 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.49,382,1520924400"; d="scan'208";a="38629103" Received: from irsmsx108.ger.corp.intel.com ([163.33.3.3]) by fmsmga008.fm.intel.com with ESMTP; 09 May 2018 08:57:43 -0700 Received: from irsmsx104.ger.corp.intel.com ([169.254.5.251]) by IRSMSX108.ger.corp.intel.com ([169.254.11.150]) with mapi id 14.03.0319.002; Wed, 9 May 2018 16:57:42 +0100 From: "Kovacevic, Marko" To: Stephen Hemminger , "dev@dpdk.org" CC: Stephen Hemminger , "Mcnamara, John" Thread-Topic: [dpdk-dev] [PATCH v6 3/4] net/netvsc: add documentation Thread-Index: AQHT5yxrG6TJ3AzP2EOPymtslMjFbaQnjYtQ Date: Wed, 9 May 2018 15:57:40 +0000 Message-ID: <6DC05C7C5F25994B81B3F2F214251F66389131@IRSMSX104.ger.corp.intel.com> References: <20180509002605.30996-1-stephen@networkplumber.org> <20180509002605.30996-4-stephen@networkplumber.org> In-Reply-To: <20180509002605.30996-4-stephen@networkplumber.org> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-version: 11.0.200.100 dlp-reaction: no-action x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiMGMyZGIyOTQtYWUyNi00NWM3LWE2N2ItNDIxY2UzNjJhNzhkIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE2LjUuOS4zIiwiVHJ1c3RlZExhYmVsSGFzaCI6IkFtRzlzN2hpUSt5MFlqekJGTFpTcXN5ZUpmUUFMOU9cL001cjRDN0ZIYlJnPSJ9 x-ctpclassification: CTP_NT x-originating-ip: [163.33.239.181] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH v6 3/4] net/netvsc: add documentation X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 09 May 2018 15:57:46 -0000 > From: Stephen Hemminger >=20 > Matching documentation for new netvsc device. >=20 > Signed-off-by: Stephen Hemminger > --- > doc/guides/nics/features/netvsc.ini | 23 ++++++ > doc/guides/nics/index.rst | 1 + > doc/guides/nics/netvsc.rst | 98 ++++++++++++++++++++++++++ > doc/guides/rel_notes/release_18_05.rst | 5 ++ > 4 files changed, 127 insertions(+) > create mode 100644 doc/guides/nics/features/netvsc.ini > create mode 100644 doc/guides/nics/netvsc.rst >=20 > diff --git a/doc/guides/nics/features/netvsc.ini > b/doc/guides/nics/features/netvsc.ini > new file mode 100644 > index 000000000000..2ff6042bf47b > --- /dev/null > +++ b/doc/guides/nics/features/netvsc.ini <...> > +++ b/doc/guides/nics/netvsc.rst > @@ -0,0 +1,98 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) Microsoft Corporation. > + > +Netvsc (Hyper-V) poll mode driver > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +Hyper-V is a hypervisor integrated into Window Server 2008, Windows 10 > +and later versions. It supports a para-virtualized network interface > +called netvsc that is visible on the virtual machine bus (VMBUS). In > +the Data Plane Development Kit (DPDK), we provide a Network Virtual > +Service Client (NetVSC) Poll Mode Driver (PMD). The NetVSC PMD supports > +Windows Server 2016 and Microsoft Azure cloud. > + > +NetVSC Implementation in DPDK > +----------------------------- > + > +The Netvsc PMD is a standalone driver. VMBus network devices that are > +being used by DPDK must be unbound from the Linux kernel driver > +(hv_netvsc) and bound to the Userspace IO driver for Hyper-V > +(uio_hv_generic). > + > +This is most conveniently done with the .. _`driverctl`: > +https://gitlab.com/driverctl/driverctl > +script. The way you set up the link here is wrong=20 .. _`driverctl`: https://gitlab.com/driverctl/driverctl ---> `driverctl `_ <...> > +++ b/doc/guides/rel_notes/release_18_05.rst > @@ -183,6 +183,11 @@ New Features > stats/xstats on shared memory from secondary process, and also pdump > packets on > those virtual devices. >=20 > +* **Added experimental support for Hyper-V netvsc PMD.** > + > + The new experimntal ``netvsc`` poll mode driver provides native > + support for networking on Hyper-V. See the :doc:`../nics/netvsc` nic d= river > guide Spelling above=20 experimntal / experimental > + for more details on this new driver. >=20 > API Changes > -----------