From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from bgl-iport-1.cisco.com (bgl-iport-1.cisco.com [72.163.197.25]) by dpdk.org (Postfix) with ESMTP id 59A467F4C for ; Fri, 7 Nov 2014 11:27:45 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=7551; q=dns/txt; s=iport; t=1415356637; x=1416566237; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=/Krdzsa2LHtVVbm6YqX6qSQu9Ar96rPAgiCnabUzuWU=; b=PRCPQQWjs8/rscPdmaX0/kbXuuhDcmh4Qb2S8avCvbOoZ64MzN/iuiiy SqWaHoKXquzeXdWx4eyZcFhQbPcqmT7Lr4ANMyBljxkAQmN3/pKLAhQ8X xEZXDJPGk+DuOmQ5UjHU3OmMdV41tlvT8f0gxqCwoyRjDjOOptGJ+eICf E=; X-IronPort-AV: E=Sophos;i="5.07,331,1413244800"; d="scan'208";a="47242412" Received: from vla196-nat.cisco.com (HELO bgl-core-3.cisco.com) ([72.163.197.24]) by bgl-iport-1.cisco.com with ESMTP; 07 Nov 2014 10:37:16 +0000 Received: from localhost ([10.106.186.117]) (authenticated bits=0) by bgl-core-3.cisco.com (8.14.5/8.14.5) with ESMTP id sA7AbDS1015330 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Fri, 7 Nov 2014 10:37:16 GMT From: Sujith Sankar To: dev@dpdk.org Date: Sat, 8 Nov 2014 01:35:47 +0530 Message-Id: <1415390747-9532-8-git-send-email-ssujith@cisco.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1415390747-9532-1-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: 8bit X-Authenticated-User: ssujith@cisco.com Subject: [dpdk-dev] [PATCH 7/7] Release notes for ENIC PMD 1.0.0.3 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 07 Nov 2014 10:27:46 -0000 --- 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/ReleaseNotes.txt new file mode 100644 index 0000000..9d9ef3b --- /dev/null +++ b/lib/librte_pmd_enic/ReleaseNotes.txt @@ -0,0 +1,196 @@ +================================================================================ + DPDK Poll-mode Driver for Cisco Systems Inc. VIC Ethernet NIC + Release Notes + Version 1.0.0.3 +================================================================================ + ENIC PMD is the poll-mode driver for the Cisco System Inc. VIC Ethernet NIC + to be used with DPDK suite. + + If you are running/would like to run your applications on Intel DPDK software + suite on Cisco UCS servers that use Cisco VIC adapters, please read the + information provided in this document. + +How to obtain ENIC PMD integrated DPDK? +--------------------------------------- + The source tarball of the whole DPDK suite, dpdk-.tar.gz could be + downloaded from www.dpdk.org + + Alternatively, the same could be downloaded from www.cisco.com. + + +Software License +---------------- + Please read the file LICENSE in lib/librte_pmd_enic/ directory in DPDK + 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 scripts, + ensure that CONFIG_RTE_LIBRTE_ENIC_PMD=y is there in the following file in + DPDK suite. + + - config/common_linuxapp + + If CONFIG_RTE_EAL_VFIO is y in config/common/linuxapp in the DPDK source + 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 service + profile, only one interrupt per vNIC interface needs to be configured. + ENIC PMD uses this interrupt to get information about errors in the fast 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 suite + - tar -xzf dpdk-.tar.gz + - cd dpdk- + - make install T=x86_64-native-linuxapp-gcc + + +Version Information +------------------- + The version of ENIC driver will be printed by ENIC PMD during the + 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 + should have support for Linux VFIO. Linux kernels post 3.6.0 supports 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 + /usr/include/linux/ + + In the case of Ubuntu, if the file is not present, install the + 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 with + DPDK suite + + +Supported Cisco VIC adapters +---------------------------- + - ENIC PMD could be used with all the generations of Cisco VIC adapters. + - Flow director feature is not supported on generation 1 Cisco VIC adapters + (M81KR and P81E) + + +Supported Operating Systems +--------------------------- +Any Linux distribution fulfilling the conditions described in Dependencies +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 + + +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 environment + variables, hugepages configuration, tool-chains and configuration + - Insert vfio-pci kernel module using the command 'modprobe vfio-pci' if 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 VFIO 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 + 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. + 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). + This would help in bringing down the time taken for building the + libraries and the initialization time of the application. + +Additional Reference +-------------------- + - www.dpdk.org + - Intel® Data Plane Development Kit: Release Notes + - Intel® Data Plane Development Kit: Programmer's Guide + - Intel® Data Plane Development Kit Testpmd Application: Guide + + +Contact Information +------------------- + Any questions or bugs should be reported to DPDK community or to the following + email addresses. + + Sujith Sankar + Prasad Rao + -- 1.9.1