From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM02-BL2-obe.outbound.protection.outlook.com (mail-bl2nam02on0059.outbound.protection.outlook.com [104.47.38.59]) by dpdk.org (Postfix) with ESMTP id CC5CC5323 for ; Tue, 11 Apr 2017 20:59:13 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=CAVIUMNETWORKS.onmicrosoft.com; s=selector1-cavium-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=LCjH2P7ynzytUCxI65Oyc6srDdnOZlAR61cNeEXn1PY=; b=koRSO4W7whGuaSFtFouorPa7BVM6Rwm0lxJ/KbJBqX3Vm+Qoov8wDgSh4lfbCVQVvDNSOAdRUWOAasvuRMw4943kydpTEbLZsnTTPBQDV8dqS5XxylfcYmq4e8B9zyqhzYHqzGmddc19mZl/PlqYyOcoDc3F1TO99vaO25yBYqg= Authentication-Results: intel.com; dkim=none (message not signed) header.d=none;intel.com; dmarc=none action=none header.from=caviumnetworks.com; Received: from lio357.in.caveonetworks.com (14.140.2.178) by DM3PR07MB2284.namprd07.prod.outlook.com (10.164.33.158) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1019.17; Tue, 11 Apr 2017 18:59:10 +0000 From: Shijith Thotton To: Ferruh Yigit , John McNamara , Harish Patil , Rasesh Mody Cc: dev@dpdk.org Date: Wed, 12 Apr 2017 00:26:43 +0530 Message-Id: <1491937010-16553-4-git-send-email-shijith.thotton@caviumnetworks.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1491937010-16553-1-git-send-email-shijith.thotton@caviumnetworks.com> References: <1491465117-11252-1-git-send-email-shijith.thotton@caviumnetworks.com> <1491937010-16553-1-git-send-email-shijith.thotton@caviumnetworks.com> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [14.140.2.178] X-ClientProxiedBy: MAXPR01CA0027.INDPRD01.PROD.OUTLOOK.COM (10.164.147.34) To DM3PR07MB2284.namprd07.prod.outlook.com (10.164.33.158) X-MS-Office365-Filtering-Correlation-Id: 874aba82-df1a-4dae-9d1f-08d4810cd79c X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 3:8az0heZs/LjrxuzPe7V3za60K70mWLRQKffMotZu2V7y9d4bhRs7ucwq3w94FIxNOtPw7Pf0YGMGuRzaQE5KIa8JslXwkEgnJ6uDyySK0OezktrBN1La9GOZjff4VEqjHUSejVK6Rmeb7nHmp3O3otqOTsNC/QPYtQgG+TiUjYNenZwYTb4/8OOlRQ8oOmHO12sWLtcqakApyT0n91a7ArX2L+bAf3jA2b9E/nRVRV61NkGOs6VvqlX8inf5CZ16AF+8vZqiFfBOmss+13ofSmA3QN9WYLApgVNd4cUYPjNroFKXMflmFAjgi7uHzLXbV6Re1CbpoI9nEgdZL1AbRA==; 25:VjzCOixsTxujw5uoecESg0+ipYwYyP/y0Ufs/uA6Uaoti+2bNLc3B/YVaiCg6FMT5Nidg+kpl63c/zDcE78hHN9ZZuFmnMXWUlUMky/RWVhnPBz4MznPUqTwD4irGyN1vwM5jITzPa1hnkHjYmAq5ftqMEhw6q38tsKg1aaL7i97pj5hE5w0Bk53JsUGCdfwSRLmuHiYbbpWGOVJZnYh4cqQ9RASpsL4G0V5REALhUlcaGwewGwnuhqeyCBvAWUlnK/bQHGX7BkOA+AkiAh+POJTkDgA1BTmjMyMTZvsp73emOwhr5bA79RYYYcC6BzwuxzFUc0uGMBQMzxNiexwGuB1sJqJrPMpvqPMTa3QNwTFNDEc8UA6wKeyHzVWY8JtIVQ2ZYGaKylnHnuY8vijKAACHtgyN7k7xnVAf7G2kZ0D0zqDpJPvaNo6cyClgfc+o5AIZ2g3pkLgt7MkrhOsow== X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 31:Ki8LzniYT27qnBIqEBjM8dirfKkFDBJsEQ3jU7pB0pcp8VTkGxxmaPOF8rx0GeaQRXmqDwsLNFIKyQlADjjd3VeMuj+l0zc5J/aWq+uqq/eU4JN7LE4rka1Nf6zvRHvQnCsoG6nfKvdtjY2JhCGKlTeCy40uF714EBJYM3oce3Oc8x+BvvGC+rfrNa9ahphtIFwMabQRHLuX4gcuvK80qDEgidiNKZgNUgQW2atdv+WeAX6tHNkNigXeG3gxKOns; 20:3qBikpgxFt9Pu13li7BK8AxIExYrFH+dgB6AB6mIoA1a/910f90yIpr0OcGHL+JUJKLvjhm6DCw0hVKKak2ozVjrGgwfJkzDvj3uNZ1yPoQd/BQz5XnN8DK6nsw/XGQTOH0nhwFLA4hf8sY/lVI9PXPILKa4BGZn4pHTAHwyCK37tvyA+wKtaaOJkwO2yK34RzuuHRV9idgj1MKPJ6c+kPugE2hoO4uknlHkLaQSM0Ia2P63vnqXpXuMD6ggAW2wv81T0QkI9RRkvBDY0QQp2tfTebOuOaLAfU0H9m1IvAVCPSVwDB98/oCqLEbid8oryG/E8gUB5C4U4NsPHch1Mpli++tXtX2nxtTG7xH7Wm8KvaMzArYyKqtB3iI+98F/0kOYQG+FSeb65093sudzlUcTyOXjD1kchL1ltG3a1iYbPTpkiKrZU99QvQUFpf6iVPI14Lbo3W8/+uVJBC2fF87LWhA5VvdAq7mjZR5TkzCuC4FCWDLw7PaRrawfumCDWt0NQzRKsro0axtJoupBh/Xavn/NXNadRhkqR56FBwF5U/IdcyokX/WKHKzUKLbMWe9imkCihdZNM5Z9kbEoGxEYYutMJd3hFIbnijWS9qA= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(228905959029699); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(8121501046)(5005006)(3002001)(10201501046)(93006095)(6041248)(20161123562025)(20161123560025)(201703131423075)(201702281528075)(201703061421075)(20161123555025)(20161123564025)(6072148); SRVR:DM3PR07MB2284; BCL:0; PCL:0; RULEID:; SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 4:hDeldIzwGFuWg7NBlQNi7yJ0Z1DoA0XexEcX44QMXDXB5ZJcjeubx0zZ7HfQ/rQF4OZYK6hrhVWdd6ta7fKxYK+gseQrk98Li3H73cgckNMKndyW+N5UWczBA+myvGk8j0G0vGnHvxj+aoHZeUxyLsvgmULk/pxkaaDliCzcvv0829lpjKwazjyf55Itb5F0P+N8PiNksiGdMre6SfDBCuPYNipyzbhBGGN+bbm5jNFhbC9R86nIi46GCzS2SlBkir+u/bWlc++5IglD872IGrZR6n9XySKS13qjT5f/T9mR9Wj7rQi9/U9yjcqGxGsWvgiLZA4c1YI0mOsWTkxAIck1OnMKEq/Ydg7r79sA2Rmlhx5TfxnAAn6BgsrfxZuF4BjBJxS8Unfuu4DxQIXTjc8puGSos/awAS9u7Kwu+21MUT4yeqBinpfx1FwgHJWWZYRVXg3Q6rJZTEaoKNdRgf10tsW88VWQAtfrNRlhyfu471ICTrEqy2LqL+1f0b8C3ysHXnESVORr3zWb/NtK/awbqduWkgNAZ1Li1bcinbcr2RGxrWy0EuNnCDZrzIo+qKR+7ujp5q7Tr8ZMlCeBFZFR9d8qFZGwwejn+BQdgsl2Gb6k+YOF+hn+HhSq8g28ipm6Z+IWUQEf5+fXqaqTf+M68kZWFcHQoIUHLAoNmsw1o+JQmCnaow0dDffJYjjtyw2wtNxxeqD+HFMkbPgxLag+gDX9M12HwQZSpqhC60s= X-Forefront-PRVS: 0274272F87 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39840400002)(39400400002)(39410400002)(39850400002)(39450400003)(2906002)(6512007)(36756003)(7736002)(53936002)(4326008)(305945005)(189998001)(33646002)(5009440100003)(50466002)(81166006)(8676002)(48376002)(50226002)(50986999)(76176999)(38730400002)(5660300001)(6486002)(47776003)(42882006)(6666003)(4720700003)(66066001)(2950100002)(6506006)(5003940100001)(3846002)(42186005)(6116002)(25786009)(110426004); DIR:OUT; SFP:1101; SCL:1; SRVR:DM3PR07MB2284; H:lio357.in.caveonetworks.com; FPR:; SPF:None; MLV:nov; PTR:InfoNoRecords; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM3PR07MB2284; 23:mWNu1XXgEP5vs8uAG7J8IUI4o2y1GkSmObtq67ek9?= =?us-ascii?Q?XExyioWqEMkdShgSkTa/ris/i0bXb7HRnZDVmA0cxqIfN+H+GxbLQa+XMPCM?= =?us-ascii?Q?1syrwywBOjEqRhxVsePtOJX1bCSJPM7WYVth2EBoHVGCTS1oCgBDB5p2H98s?= =?us-ascii?Q?wB0N97nTdjELoQIXtFuCR73pjCfRKzXfddSqneSmE3qxuHGDrcrPGaDnKLVx?= =?us-ascii?Q?wUd3AaylJ4pIkvuAzADnUiclPhwUDTCaw9cA7k5FwtrF3VUHNxNqhuIX1uGy?= =?us-ascii?Q?JEXHYC2/kOjJkPt07nZvBdCT4QOdUoEgJA/j8B0dSaiIAdHjy1sqvo80Ye3m?= =?us-ascii?Q?rrP0abb4seoVyFU1v53DzJ/z/QKOTzhK6BeuSP65r8z+51RrEpDSXD6L68d+?= =?us-ascii?Q?UtcTkJlGF5K79EwHrYQ5yG0508M5epBgRwabH9iACVuCQX9x2gDAAJw9c0Eb?= =?us-ascii?Q?fP3GQCBwTqsRwab5sQcBDAHDqyDcxARB9lUTBnShT5jSVRW0NyM4d+D6NE2i?= =?us-ascii?Q?dYLTlkR9pV489wGOJv4Qxx8CS5aa+nU8pCmdL//nsL9CnWDMY5UHM5mF6Wk5?= =?us-ascii?Q?8DvXVnBL9WtL6kFT8nTEi47RXPaNTGbgrYlpRSQoZJQjwtpAKZ9mOIP8RtcW?= =?us-ascii?Q?CAZHH2lIilVk1CoN04XFc9MQU5gX3gKs9EsxANClrwtXfWB+3DoI7Yy21E+P?= =?us-ascii?Q?OI2u7yY63e80g/FWCEeVssHZuguoGFS9y+/N8+oDaBZLTrMehpIyViY73Sbb?= =?us-ascii?Q?b9rsLqkkMPZ6lNt4iaLsOXMFjSs2Wtf0sn+882/lwiVPKsJa1ZLWKcd0nAh8?= =?us-ascii?Q?RuFKZ1rX8ZToR+q2ULRGphRH4Ghffjx4UTZOcOI04abh/LxkeuDpIf4We2OD?= =?us-ascii?Q?6Xor2tJlapS1xoTZWzkaHmQDcCIDxT6XaU21+4YfrNlda8qlK/XdWR2aKXJb?= =?us-ascii?Q?8DGp/4WsAtr/wekKpw1F0/V8c4cjaXwWdCZezJsrGbWPti5rCQB2+aV3ES0f?= =?us-ascii?Q?+gKv7fYebun1pZK8XRNtXqi/o9G0M2dWnnIMrC32b+MWSwYqd4VGexbi/Ois?= =?us-ascii?Q?M2R3ps=3D?= X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 6:TondDubnataNvOdBZ8m/7oJDgPU5dFOXsF/JEvvyf8jggO3EEm6tZDOKgoV/M9RqQwpvfC7dkxdseLZuTkrLs/POalMxFtQ8i+dtcZDpclhLLK/73DTsc1lxmlZGgkSXnmd+J9YG7uWkGqVQbU4GxfixAbiiHmKpydbxxrQww14EvDI3icXpGDU2My9CZmLeLqH2yvAqFZm4daa67JYFgFQgWKAdIdl56I/W6NbyScINCT7hv5f9jsg1X+PLTc3gNxOLh9k7G8HXFRWO0BRHXzidMhDDIKpd0EVfNaeKlcj9X5MExHYt3sSmOfd0zOFjInopLSDFwB8+LCaXqUxGz9obaipWndHPD1g2ZM3nNXwvG5QjX98KBesj9roylhYowDPLy7sOhmitIKBFvDPQgGHZBX3n5I15/JUmdK+ADF8cmbY1kFVDiEmwLPijQfk5XB/H7vziEnUCRKO1qwjw9Q==; 5:Jmy7DBywLJATiQiwXEBKUdGsLYPReZnNaQCqfKOVkZqIDYeghVZGSNZ0T7B0zN9t6ecEGo57jy82l7DTKbXhu1Jumpve+JGm33+xwQQbreJzhIq1P+KlsqpXbkDVhBHBnEDyR0qc9nGgdG1WgqZPPg==; 24:MylTFR5szsXvu5VQ/12vMEPPyp8uYVh624yE1gKBZJZkoKIfImC3mQIGMCG1og+uR6NlNu+KiJU3laooTQ3tqOSvXwh5vQzqiByvDpjBJS8= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 7:HkxDgMfVVI4F4GayouhXWRdNpj9buZtylCNEgAPWveIpmDLbi4S0kUBTMVCVLC0v3xr7Y1kPaMRvS2ax4o8bO/poZMiIyswTZtE3Yy7ggwPnmmJcRTp0g6BCbCeMjZe/xRI1Ug4bxvHkvRUjCFApinp58sBXYjGNdUZyFYahk6akjbR/Eez8MacmxLAUwNHjlDK7xILmnsZK0auQSGZHrsPKNUx7Nl4S9VrMzt+4kkh4s/lnTiAYdPDGwRM3dayS6LlD00HhL5KpTD2SosemWKGGbACZBVsn71zPegpU64PUvXtctrAEb8L6wWi5V21TQZVm8ky9e7PWUfycW2FYUA== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Apr 2017 18:59:10.4963 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR07MB2284 Subject: [dpdk-dev] [PATCH v2 03/10] doc: refer PMD compile and test section from bnx2x doc 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: Tue, 11 Apr 2017 18:59:14 -0000 Refer the section which explains driver compilation and running of testpmd in Linux, instead of describing it in driver documentation. Signed-off-by: Shijith Thotton Acked-by: John McNamara --- doc/guides/nics/bnx2x.rst | 178 +++++++++++----------------------------------- 1 file changed, 42 insertions(+), 136 deletions(-) diff --git a/doc/guides/nics/bnx2x.rst b/doc/guides/nics/bnx2x.rst index 17780ed..a3a0665 100644 --- a/doc/guides/nics/bnx2x.rst +++ b/doc/guides/nics/bnx2x.rst @@ -123,143 +123,14 @@ enabling debugging options may affect system performance. .. _bnx2x_driver-compilation: -Driver Compilation -~~~~~~~~~~~~~~~~~~ - -BNX2X PMD for Linux x86_64 gcc target, run the following "make" -command:: - - cd - make config T=x86_64-native-linuxapp-gcc install - -To compile BNX2X PMD for Linux x86_64 clang target, run the following "make" -command:: - - cd - make config T=x86_64-native-linuxapp-clang install - -To compile BNX2X PMD for Linux i686 gcc target, run the following "make" -command:: - - cd - make config T=i686-native-linuxapp-gcc install - -To compile BNX2X PMD for Linux i686 gcc target, run the following "make" -command: - -.. code-block:: console - - cd - make config T=i686-native-linuxapp-gcc install - -To compile BNX2X PMD for FreeBSD x86_64 clang target, run the following "gmake" -command:: - - cd - gmake config T=x86_64-native-bsdapp-clang install - -To compile BNX2X PMD for FreeBSD x86_64 gcc target, run the following "gmake" -command:: - - cd - gmake config T=x86_64-native-bsdapp-gcc install -Wl,-rpath=/usr/local/lib/gcc49 CC=gcc49 - -To compile BNX2X PMD for FreeBSD x86_64 gcc target, run the following "gmake" -command: - -.. code-block:: console - - cd - gmake config T=x86_64-native-bsdapp-gcc install -Wl,-rpath=/usr/local/lib/gcc49 CC=gcc49 - -Linux ------ - -.. _bnx2x_Linux-installation: - -Linux Installation -~~~~~~~~~~~~~~~~~~ - -Sample Application Notes -~~~~~~~~~~~~~~~~~~~~~~~~ - -This section demonstrates how to launch ``testpmd`` with QLogic 578xx -devices managed by ``librte_pmd_bnx2x`` in Linux operating system. - -#. Request huge pages: - - .. code-block:: console - - echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages/nr_hugepages - -#. Load ``igb_uio`` or ``vfio-pci`` driver: - - .. code-block:: console - - insmod ./x86_64-native-linuxapp-gcc/kmod/igb_uio.ko - - or - - .. code-block:: console - - modprobe vfio-pci - -#. Bind the QLogic adapters to ``igb_uio`` or ``vfio-pci`` loaded in the - previous step:: - - ./usertools/dpdk-devbind.py --bind igb_uio 0000:84:00.0 0000:84:00.1 - - or - - Setup VFIO permissions for regular users and then bind to ``vfio-pci``: - - .. code-block:: console - - sudo chmod a+x /dev/vfio - - sudo chmod 0666 /dev/vfio/* - - ./usertools/dpdk-devbind.py --bind vfio-pci 0000:84:00.0 0000:84:00.1 - -#. Start ``testpmd`` with basic parameters: - - .. code-block:: console - - ./x86_64-native-linuxapp-gcc/app/testpmd -l 0-3 -n 4 -- -i - - Example output: - - .. code-block:: console +Driver compilation and testing +------------------------------ - [...] - EAL: PCI device 0000:84:00.0 on NUMA socket 1 - EAL: probe driver: 14e4:168e rte_bnx2x_pmd - EAL: PCI memory mapped at 0x7f14f6fe5000 - EAL: PCI memory mapped at 0x7f14f67e5000 - EAL: PCI memory mapped at 0x7f15fbd9b000 - EAL: PCI device 0000:84:00.1 on NUMA socket 1 - EAL: probe driver: 14e4:168e rte_bnx2x_pmd - EAL: PCI memory mapped at 0x7f14f5fe5000 - EAL: PCI memory mapped at 0x7f14f57e5000 - EAL: PCI memory mapped at 0x7f15fbd4f000 - Interactive-mode selected - Configuring Port 0 (socket 0) - PMD: bnx2x_dev_tx_queue_setup(): fp[00] req_bd=512, thresh=512, - usable_bd=1020, total_bd=1024, - tx_pages=4 - PMD: bnx2x_dev_rx_queue_setup(): fp[00] req_bd=128, thresh=0, - usable_bd=510, total_bd=512, - rx_pages=1, cq_pages=8 - PMD: bnx2x_print_adapter_info(): - [...] - Checking link statuses... - Port 0 Link Up - speed 10000 Mbps - full-duplex - Port 1 Link Up - speed 10000 Mbps - full-duplex - Done - testpmd> +Refer to the document :ref:`compiling and testing a PMD for a NIC ` +for details. SR-IOV: Prerequisites and sample Application Notes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +-------------------------------------------------- This section provides instructions to configure SR-IOV with Linux OS. @@ -311,7 +182,6 @@ This section provides instructions to configure SR-IOV with Linux OS. echo 2 > /sys/devices/pci0000:00/0000:00:03.0/0000:81:00.0/sriov_numvfs - #. Assign VF MAC address: Assign MAC address to the VF using iproute2 utility. The syntax is: @@ -323,9 +193,45 @@ This section provides instructions to configure SR-IOV with Linux OS. ip link set ens5f0 vf 0 mac 52:54:00:2f:9d:e8 - #. PCI Passthrough: The VF devices may be passed through to the guest VM using virt-manager or virsh etc. bnx2x PMD should be used to bind the VF devices in the guest VM using the instructions outlined in the Application notes below. + +#. Running testpmd: + + Follow instructions available in the document + :ref:`compiling and testing a PMD for a NIC ` + to run testpmd. + + Example output: + + .. code-block:: console + + [...] + EAL: PCI device 0000:84:00.0 on NUMA socket 1 + EAL: probe driver: 14e4:168e rte_bnx2x_pmd + EAL: PCI memory mapped at 0x7f14f6fe5000 + EAL: PCI memory mapped at 0x7f14f67e5000 + EAL: PCI memory mapped at 0x7f15fbd9b000 + EAL: PCI device 0000:84:00.1 on NUMA socket 1 + EAL: probe driver: 14e4:168e rte_bnx2x_pmd + EAL: PCI memory mapped at 0x7f14f5fe5000 + EAL: PCI memory mapped at 0x7f14f57e5000 + EAL: PCI memory mapped at 0x7f15fbd4f000 + Interactive-mode selected + Configuring Port 0 (socket 0) + PMD: bnx2x_dev_tx_queue_setup(): fp[00] req_bd=512, thresh=512, + usable_bd=1020, total_bd=1024, + tx_pages=4 + PMD: bnx2x_dev_rx_queue_setup(): fp[00] req_bd=128, thresh=0, + usable_bd=510, total_bd=512, + rx_pages=1, cq_pages=8 + PMD: bnx2x_print_adapter_info(): + [...] + Checking link statuses... + Port 0 Link Up - speed 10000 Mbps - full-duplex + Port 1 Link Up - speed 10000 Mbps - full-duplex + Done + testpmd> -- 1.8.3.1