From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail1.windriver.com (mail1.windriver.com [147.11.146.13]) by dpdk.org (Postfix) with ESMTP id 416CB2B9D for ; Wed, 1 Mar 2017 18:43:14 +0100 (CET) Received: from ALA-HCB.corp.ad.wrs.com (ala-hcb.corp.ad.wrs.com [147.11.189.41]) by mail1.windriver.com (8.15.2/8.15.1) with ESMTPS id v21HhAgS011766 (version=TLSv1 cipher=AES128-SHA bits=128 verify=FAIL); Wed, 1 Mar 2017 09:43:10 -0800 (PST) Received: from ALA-MBC.corp.ad.wrs.com ([fe80::fcbe:9b7:1141:89a1]) by ALA-HCB.corp.ad.wrs.com ([147.11.189.41]) with mapi id 14.03.0294.000; Wed, 1 Mar 2017 09:43:10 -0800 From: "Legacy, Allain" To: "Legacy, Allain" , "thomas.monjalon@6wind.com" CC: "dev@dpdk.org" Thread-Topic: [dpdk-dev] [PATCH] doc: adds information related to the AVP PMD Thread-Index: AQHSkrMwYc0XDXc0q0GhXzksJm9Ve6GAQRpQ Date: Wed, 1 Mar 2017 17:43:09 +0000 Message-ID: <70A7408C6E1BFB41B192A929744D85238A7597BF@ALA-MBC.corp.ad.wrs.com> References: <1488390112-134046-1-git-send-email-allain.legacy@windriver.com> In-Reply-To: <1488390112-134046-1-git-send-email-allain.legacy@windriver.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [128.224.140.166] Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH] doc: adds information related to the AVP PMD 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, 01 Mar 2017 17:43:14 -0000 Please ignore. Allain Legacy, Software Developer direct 613.270.2279=A0=A0fax 613.492.7870 skype allain.legacy =A0 > -----Original Message----- > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Allain Legacy > Sent: Wednesday, March 01, 2017 12:42 PM > To: thomas.monjalon@6wind.com > Cc: dev@dpdk.org > Subject: [dpdk-dev] [PATCH] doc: adds information related to the AVP PMD >=20 > Updates the documentation and feature lists for the AVP PMD device. >=20 > Signed-off-by: Allain Legacy > Signed-off-by: Matt Peters > Acked-by: John McNamara > --- > MAINTAINERS | 1 + > doc/guides/nics/avp.rst | 112 > +++++++++++++++++++++++++++++++++ > doc/guides/nics/features/avp.ini | 17 +++++ > doc/guides/nics/index.rst | 1 + > doc/guides/rel_notes/release_17_05.rst | 5 ++ > 5 files changed, 136 insertions(+) > create mode 100644 doc/guides/nics/avp.rst > create mode 100644 doc/guides/nics/features/avp.ini >=20 > diff --git a/MAINTAINERS b/MAINTAINERS > index fef23a0..4a14945 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -427,6 +427,7 @@ Wind River AVP PMD > M: Allain Legacy > M: Matt Peters > F: drivers/net/avp > +F: doc/guides/nics/avp.rst >=20 >=20 > Crypto Drivers > diff --git a/doc/guides/nics/avp.rst b/doc/guides/nics/avp.rst > new file mode 100644 > index 0000000..af6d04d > --- /dev/null > +++ b/doc/guides/nics/avp.rst > @@ -0,0 +1,112 @@ > +.. BSD LICENSE > + Copyright(c) 2017 Wind River Systems, Inc. rights reserved. > + All rights reserved. > + > + Redistribution and use in source and binary forms, with or without > + modification, are permitted provided that the following conditions > + are met: > + > + * Redistributions of source code must retain the above copyright > + notice, this list of conditions and the following disclaimer. > + * Redistributions in binary form must reproduce the above copyright > + notice, this list of conditions and the following disclaimer in > + the documentation and/or other materials provided with the > + distribution. > + * Neither the name of Intel Corporation nor the names of its > + contributors may be used to endorse or promote products derived > + from this software without specific prior written permission. > + > + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND > CONTRIBUTORS > + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT > NOT > + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND > FITNESS FOR > + A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE > COPYRIGHT > + OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, > INCIDENTAL, > + SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT > NOT > + LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS > OF USE, > + DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED > AND ON ANY > + THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT > + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF > THE USE > + OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH > DAMAGE. > + > +AVP 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=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 > + > +The Accelerated Virtual Port (AVP) device is a shared memory based devic= e > +available on the `virtualization platforms > `_ > +from Wind River Systems. It is based on an earlier implementation of th= e > DPDK > +KNI device and made available to VM instances via a mechanism based on > an early > +implementation of qemu-kvm ivshmem. > + > +It enables optimized packet throughput without requiring any packet > processing > +in qemu. This provides our customers with a significant performance > increase > +for DPDK applications in the VM. Since our AVP implementation supports > VM > +live-migration it is viewed as a better alternative to PCI passthrough o= r PCI > +SRIOV since neither of those support VM live-migration without manual > +intervention or significant performance penalties. > + > +Since the initial implementation of AVP devices, vhost-user has become > +part of the qemu offering with a significant performance increase over > +the original virtio implementation. However, vhost-user still does > +not achieve the level of performance that the AVP device can provide > +to our customers for DPDK based VM instances. > + > +The driver binds to PCI devices that are exported by the hypervisor DPDK > +application via the ivshmem-like mechanism. The definition of the devic= e > +structure and configuration options are defined in rte_avp_common.h and > +rte_avp_fifo.h. These two header files are made available as part of th= e > PMD > +implementation in order to share the device definitions between the gues= t > +implementation (i.e., the PMD) and the host implementation (i.e., the > +hypervisor DPDK vswitch application). > + > + > +Features and Limitations of the AVP PMD > +--------------------------------------- > + > +The AVP PMD driver provides the following functionality. > + > +* Receive and transmit of both simple and chained mbuf packets, > + > +* Chained mbufs may include up to 5 chained segments, > + > +* Up to 8 receive and transmit queues per device, > + > +* Only a single MAC address is supported, > + > +* The MAC address cannot be modified, > + > +* The maximum receive packet length is 9238 bytes, > + > +* VLAN header stripping and inserting, > + > +* Promiscuous mode > + > +* VM live-migration > + > +* PCI hotplug insertion and removal > + > + > +Prerequisites > +------------- > + > +The following prerequisites apply: > + > +* A virtual machine running in a Wind River Systems virtualization > + environment and configured with at least one neutron port defined wi= th > a > + vif-model set to "avp". > + > + > +Launching a VM with an AVP type network attachment > +-------------------------------------------------- > + > +The following example will launch a VM with three network attachments. > The > +first attachment will have a default vif-model of "virtio". The next tw= o > +network attachments will have a vif-model of "avp" and may be used with = a > DPDK > +application which is built to include the AVP PMD driver. > + > +.. code-block:: console > + > + nova boot --flavor small --image my-image \ > + --nic net-id=3D${NETWORK1_UUID} \ > + --nic net-id=3D${NETWORK2_UUID},vif-model=3Davp \ > + --nic net-id=3D${NETWORK3_UUID},vif-model=3Davp \ > + --security-group default my-instance1 > diff --git a/doc/guides/nics/features/avp.ini > b/doc/guides/nics/features/avp.ini > new file mode 100644 > index 0000000..64bf42e > --- /dev/null > +++ b/doc/guides/nics/features/avp.ini > @@ -0,0 +1,17 @@ > +; > +; Supported features of the 'AVP' network poll mode driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > +Link status =3D Y > +Queue start/stop =3D Y > +Jumbo frame =3D Y > +Scattered Rx =3D Y > +Promiscuous mode =3D Y > +Unicast MAC filter =3D Y > +VLAN offload =3D Y > +Basic stats =3D Y > +Stats per queue =3D Y > +Linux UIO =3D Y > +x86-64 =3D Y > diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst > index 87f9334..0ddcea5 100644 > --- a/doc/guides/nics/index.rst > +++ b/doc/guides/nics/index.rst > @@ -36,6 +36,7 @@ Network Interface Controller Drivers > :numbered: >=20 > overview > + avp > bnx2x > bnxt > cxgbe > diff --git a/doc/guides/rel_notes/release_17_05.rst > b/doc/guides/rel_notes/release_17_05.rst > index e25ea9f..3accbac 100644 > --- a/doc/guides/rel_notes/release_17_05.rst > +++ b/doc/guides/rel_notes/release_17_05.rst > @@ -41,6 +41,11 @@ New Features > Also, make sure to start the actual text at the margin. >=20 > =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=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D >=20 > +* **Added support for the Wind River Systems AVP PMD.** > + > + Added a new networking driver for the AVP device type. Theses devices > are > + specific to the Wind River Systems virtualization platforms. > + >=20 > Resolved Issues > --------------- > -- > 1.8.3.1