From: "Legacy, Allain" <Allain.Legacy@windriver.com>
To: "Legacy, Allain" <Allain.Legacy@windriver.com>,
"thomas.monjalon@6wind.com" <thomas.monjalon@6wind.com>
Cc: "dev@dpdk.org" <dev@dpdk.org>
Subject: Re: [dpdk-dev] [PATCH] doc: adds information related to the AVP PMD
Date: Wed, 1 Mar 2017 17:43:09 +0000 [thread overview]
Message-ID: <70A7408C6E1BFB41B192A929744D85238A7597BF@ALA-MBC.corp.ad.wrs.com> (raw)
In-Reply-To: <1488390112-134046-1-git-send-email-allain.legacy@windriver.com>
Please ignore.
Allain Legacy, Software Developer
direct 613.270.2279 fax 613.492.7870 skype allain.legacy
> -----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
>
> Updates the documentation and feature lists for the AVP PMD device.
>
> Signed-off-by: Allain Legacy <allain.legacy@windriver.com>
> Signed-off-by: Matt Peters <matt.peters@windriver.com>
> Acked-by: John McNamara <john.mcnamara@intel.com>
> ---
> 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
>
> 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 <allain.legacy@windriver.com>
> M: Matt Peters <matt.peters@windriver.com>
> F: drivers/net/avp
> +F: doc/guides/nics/avp.rst
>
>
> 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
> +=========================================================
> ========
> +
> +The Accelerated Virtual Port (AVP) device is a shared memory based device
> +available on the `virtualization platforms
> <http://www.windriver.com/products/titanium-cloud/>`_
> +from Wind River Systems. It is based on an earlier implementation of the
> 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 or 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 device
> +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 the
> PMD
> +implementation in order to share the device definitions between the guest
> +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 with
> 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 two
> +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=${NETWORK1_UUID} \
> + --nic net-id=${NETWORK2_UUID},vif-model=avp \
> + --nic net-id=${NETWORK3_UUID},vif-model=avp \
> + --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 = Y
> +Queue start/stop = Y
> +Jumbo frame = Y
> +Scattered Rx = Y
> +Promiscuous mode = Y
> +Unicast MAC filter = Y
> +VLAN offload = Y
> +Basic stats = Y
> +Stats per queue = Y
> +Linux UIO = Y
> +x86-64 = 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:
>
> 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.
>
> =========================================================
>
> +* **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.
> +
>
> Resolved Issues
> ---------------
> --
> 1.8.3.1
prev parent reply other threads:[~2017-03-01 17:43 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-03-01 17:41 Allain Legacy
2017-03-01 17:43 ` Legacy, Allain [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=70A7408C6E1BFB41B192A929744D85238A7597BF@ALA-MBC.corp.ad.wrs.com \
--to=allain.legacy@windriver.com \
--cc=dev@dpdk.org \
--cc=thomas.monjalon@6wind.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).