From mboxrd@z Thu Jan 1 00:00:00 1970 From: Sujith Sankar Subject: [PATCH 7/7] Release notes for ENIC PMD 1.0.0.3 Date: Sat, 8 Nov 2014 01:35:47 +0530 Message-ID: <1415390747-9532-8-git-send-email-ssujith@cisco.com> References: <1415390747-9532-1-git-send-email-ssujith@cisco.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable To: dev-VfR2kkLFssw@public.gmane.org Return-path: In-Reply-To: <1415390747-9532-1-git-send-email-ssujith-FYB4Gu1CFyUAvxtiuMwx3w@public.gmane.org> List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces-VfR2kkLFssw@public.gmane.org Sender: "dev" --- lib/librte_pmd_enic/ReleaseNotes.txt | 196 +++++++++++++++++++++++++++++= ++++++ 1 file changed, 196 insertions(+) create mode 100644 lib/librte_pmd_enic/ReleaseNotes.txt diff --git a/lib/librte_pmd_enic/ReleaseNotes.txt b/lib/librte_pmd_enic/R= eleaseNotes.txt new file mode 100644 index 0000000..9d9ef3b --- /dev/null +++ b/lib/librte_pmd_enic/ReleaseNotes.txt @@ -0,0 +1,196 @@ +=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=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D + DPDK Poll-mode Driver for Cisco Systems Inc. VIC Ethernet NIC + Release Notes + Version 1.0.0.3 +=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=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D + ENIC PMD is the poll-mode driver for the Cisco System Inc. VIC Etherne= t NIC + to be used with DPDK suite. + + If you are running/would like to run your applications on Intel DPDK s= oftware=20 + suite on Cisco UCS servers that use Cisco VIC adapters, please read th= e=20 + information provided in this document. + +How to obtain ENIC PMD integrated DPDK? +--------------------------------------- + The source tarball of the whole DPDK suite, dpdk-.tar.gz coul= d be=20 + downloaded from www.dpdk.org + + Alternatively, the same could be downloaded from www.cisco.com. =20 + + +Software License +---------------- + Please read the file LICENSE in lib/librte_pmd_enic/ directory in DPDK= =20 + source tree. + + The License terms are also present at the top of the source files. + + +Configuration information +------------------------- + In order to ensure that ENIC PMD will also be built by DPDK build scri= pts,=20 + ensure that CONFIG_RTE_LIBRTE_ENIC_PMD=3Dy is there in the following f= ile in=20 + DPDK suite. + + - config/common_linuxapp + + If CONFIG_RTE_EAL_VFIO is y in config/common/linuxapp in the DPDK sour= ce + tree, ENIC PMD will try to get initialized using VFIO. If + CONFIG_RTE_EAL_VFIO is n, it will try to use UIO framework. + + No matter how many receive/transmit queues are configured in the servi= ce + profile, only one interrupt per vNIC interface needs to be configured. + ENIC PMD uses this interrupt to get information about errors in the fa= st path. + + +How to build the suite? +----------------------- + The build instruction of DPDK suite should be followed and that would = build + ENIC PMD library as well. + + Typically, a user would execute the following commands to build the su= ite + - tar -xzf dpdk-.tar.gz + - cd dpdk- + - make install T=3Dx86_64-native-linuxapp-gcc + + +Version Information +------------------- + The version of ENIC driver will be printed by ENIC PMD during the=20 + intialization. + + This release notes is a part of version number 1.0.0.3 + +Directory Structure +------------------- +librte_pmd_enic +|-- LICENSE +| License terms +| +|-- Makefile +| Makefile to build ENIC PMD as a part of building DPDK +| +|-- scripts +| |-- bind_to_vfio +| | Script which binds a vNIC to VFIO +| | +| `-- unbind_from_vfio +| Script which unbinds a vNIC from VFIO +| +`-- src + Source code of ENIC PMD + + +Dependencies +------------ + - If the user wants to use DPDK with VFIO, the Linux kernel used=20 + should have support for Linux VFIO. Linux kernels post 3.6.0 support= s VFIO + + The header file vfio.h should be present in /usr/include/linux/ + + For kernels post 3.6.0, this file should be present in=20 + /usr/include/linux/ + + In the case of Ubuntu, if the file is not present, install the=20 + package linux_libc_dev + + - This version of ENIC PMD has been tested with DPDK suite version 1.7.= 1 + + - For using UIO framework, please refer the documentation that comes wi= th + DPDK suite + + +Supported Cisco VIC adapters=20 +---------------------------- + - ENIC PMD could be used with all the generations of Cisco VIC adapters= . + - Flow director feature is not supported on generation 1 Cisco VIC adap= ters + (M81KR and P81E) + + +Supported Operating Systems +--------------------------- +Any Linux distribution fulfilling the conditions described in Dependenci= es=20 +section of this document. + +Supported features in this release +------------------------------------ + - Unicast, multicast and broadcast transmission and reception + - Receive queue polling + - Statistics + - Hardware VLAN acceleration + - IP checksum offload + - Receive side header-split + - Receive side VLAN stripping + - Multiple receive and transmit queues + - Perfect filters for flow direction (supported on all adapters except = M81KR + and P81E) + - Promiscuous mode + - Setting RX VLAN (supported via UCSM/CIMC only) + - VLAN filtering (supported via UCSM/CIMC only) + - Execution of application by unprivileged system users +=20 + +Known bugs and Unsupported features in this release +--------------------------------------------------- + - Signature filters + - Drop feature of perfect filters + - VLAN based flow direction + - Flexbytes based flow direction + - Setting of extended VLAN + + +Prerequisites +------------- + - Prepare the system as recommended by DPDK suite. This includes envir= onment + variables, hugepages configuration, tool-chains and configuration + - Insert vfio-pci kernel module using the command 'modprobe vfio-pci' i= f the + user wants to use VFIO framework + - Insert uio kernel module using the command 'modprobe uio' if the user= wants + to use UIO framework + - DPDK suite should be configured based on the user's decision to use V= FIO or + UIO framework + - Bind the intended vNIC to vfio-pci using librte_pmd_enic/scripts/bind= _to_vfio + in case the user wants ENIC PMD to use VFIO framework + - Bind the intended vNIC to igb_uio in case the user wants ENIC PMD to = use + UIO framework + + Now, the system is ready to run the application. Once the application = runs to=20 + completion, if it is required, the vNIC could be detached from vfio-pci= or igb_uio. + vNICs could be detached from vfio-pci using the script + librte_pmd_enic/scripts/unbind_from_vfio + + Root privilege is required to bind and unbind vNICs to/from VFIO/UIO. + + VFIO framework helps an unprivileged user to run the applications. + + For an unprivileged user to run the applications on DPDK and ENIC PMD, + it might be required to increase the maximum locked memory of the user. + The following command could be used to do this. + + sudo sh -c "ulimit -l " + + The value depends on the memory configuration of the application, DPDK = and + PMD. Typically, the limit has to be raised to higher than 2GB.=20 + e.g., 2621440 + + The compilation of any unused drivers could be turned off using the + configuration file in config/ directory (e.g., config/common_linuxapp).= =20 + This would help in bringing down the time taken for building the=20 + libraries and the initialization time of the application. =20 + +Additional Reference +-------------------- + - www.dpdk.org + - Intel=C2=AE Data Plane Development Kit: Release Notes + - Intel=C2=AE Data Plane Development Kit: Programmer's Guide + - Intel=C2=AE Data Plane Development Kit Testpmd Application: Guide + + +Contact Information +------------------- + Any questions or bugs should be reported to DPDK community or to the f= ollowing + email addresses. + + Sujith Sankar + Prasad Rao + --=20 1.9.1