From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM02-SN1-obe.outbound.protection.outlook.com (mail-sn1nam02on0056.outbound.protection.outlook.com [104.47.36.56]) by dpdk.org (Postfix) with ESMTP id 660542C27 for ; Sat, 1 Apr 2017 17:05:54 +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=72vlJ15TbpJAEp1t/Jy5GJgVG/4evjUUr/Ie/LTFPCc=; b=QhxDXAMQzZLc3lrpD0J5i/0NpZUNdVNBNmlfIoFmKTldtb23TRKj+J1lkDE6dlo4ex738jjJ7fRjHjg4zo765d4C3jC7g5SIRjV5NAwIy7ajMyuADMMNgpCFz1Iu+2MRrhTMpgwiCmJRwbwGvmlcAOGSkT5O2QWOOhh0wSXXkKs= Authentication-Results: dpdk.org; dkim=none (message not signed) header.d=none;dpdk.org; dmarc=none action=none header.from=caviumnetworks.com; Received: from lio357.in.caveonetworks.com (14.140.2.178) by BN4PR07MB2274.namprd07.prod.outlook.com (10.164.63.156) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1005.10; Sat, 1 Apr 2017 15:05:51 +0000 From: Shijith Thotton To: dev@dpdk.org Cc: Ferruh Yigit Date: Sat, 1 Apr 2017 20:34:00 +0530 Message-Id: <1491059040-20647-3-git-send-email-shijith.thotton@caviumnetworks.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1491059040-20647-1-git-send-email-shijith.thotton@caviumnetworks.com> References: <1491059040-20647-1-git-send-email-shijith.thotton@caviumnetworks.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Originating-IP: [14.140.2.178] X-ClientProxiedBy: BM1PR01CA0052.INDPRD01.PROD.OUTLOOK.COM (10.163.199.24) To BN4PR07MB2274.namprd07.prod.outlook.com (10.164.63.156) X-MS-Office365-Filtering-Correlation-Id: c17ab237-fa67-41ea-a3b1-08d479109701 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:BN4PR07MB2274; X-Microsoft-Exchange-Diagnostics: 1; BN4PR07MB2274; 3:B+hXPNT1n84Xa7spE22JBf/HVsvYB+MDsLPynskGhs7u7wmAeqT9qQKRNmEIceSmUcOsD8RtNC8nHoCh9ywZ4/qkO16rSj+JFi1fuevYjxmN+xlc7Sdai6+uyeV+xEWOC8DjkKjgIUYlIAg0/Ywy8NXX3oCvvtOZFQEt4aqS9Dpb+/WUFtr696TxzJNq2FZeQXSzrTpUOelTCdVFIl336iqd+eSLUlaRy8deCQCOJwSXLDv1A+IefiRo3aKW/JAvXxm8t99e1vYO9r2nn//gZC38IdCnIpvkMmXbiy1I+5HFyeYrifTUzuDWtz3dP1RyE+J/BApfppsSkkXgxAoAow==; 25:CDQ6UhUtdbvNCogrrC+2Ehlj38XRGdtSctBKYC0uPcHVjZSoUoO0iL7x13KEHdMgIXLJFVrc4vX+l+ja5HDxM5qY4xqi2Rwb7GX09AhdGHEK6GO6DVy6CZzZ3lxDzz3jpLCUHpHG7NvUwW9IzRaNJ3iM83mYsewB1p6N3hMGShcim4Wpl/szGfwk3rF7g+Cn/xvZsweND+zFzhlDkSNdmQG33m2SScnYCVRWFJ64OuYsEZWf8EtydWGkPLk9o8gnMukDWzZMtI9ZYDjISL2eUH6Hllmddb/xtSNVRTj9HZd9ML7NE1516LGs3aNgLB2VE60Lccs9gBHVX9jUk6SkhHHBwTxXo2R9UNDB4BG+U6mQ6GYqn0ono1dTc5nk08TEBUljlsZz3+vKsBjkjGXd0hpI6x0Gqb4FKngOYs7lH239JjVeIBk16cZKHzRexsgSh1gu3VA6+84S4N3ChWPG9A== X-Microsoft-Exchange-Diagnostics: 1; BN4PR07MB2274; 31:QRDWYGwiOqNrz35epHM7q2PwPigU70bwKEiZO9BxPOMi77VdWymuPD/KN232x59/hadAnOa2FMhqrW/jLf0EAFDRvSg0pZ43Lr+LD6fp8+K1ZE/U+dYfvkk8fR+qvudvfxuf4KKhVBzzXWgHCaP7g/K8q4BjFn7+b1vMEjmZdPE1HUiQl2HtwCIpdwUCe3mi9TKwQ0vYwNxEVME0Ta4mi7IkmOq4rBHNDaCBuzz0oSjSJqHPxJww738thovuJnF4; 20:fGqThqKxa4w412JEBR/mUZPYRpq8MWR5/RUA+R9WNz3DR+Vx2KUVwQskQdDUGJbczBVkmKzo2Ihp4L45ndg8Wo1GkYOIuLICl5dFNzdtTuGHtp+9UGtqeu4fF0HDiU1FuccUtrohBOqqu3aE1ILVGl3mkQdXHj2+1UMh+gzvgE2FWcEqN7dz4lUhGbufR7Z2g4ndU3jbGIMsPrGL9zHas0pfD2SgihiwDvOtPmlALn8tZDhfsHtBWrg203LwQXNlUXIoxJrsy0A2bjHMx1OHoxzRiLxmIlQifN/36RZ18u3svEuwM+zzq/F1eTqdXUzwa/s5kiAN6maAiHbgyWtFykZwmOf3Se/elx+Lc7mV/xkP9iuzfhmdn3LxtCjcnIj20VX9XDmiMWJt+Zu1Z5ndDgA9/YCj+kZ9xKYwpJeuQR382Ztn2uGl7M4APYRruEb3zk9/s5/p31fpvBwXicbCnnPA7wt7vKvy85aDzVqsuJGey82TKMzimKJbMEMX5+AHXUBHPVwwka2aU01WN9jGJESsj1kdtetBwDjv/trRWvABJ1QjtaAXir0Wm3rbuvb1mN5yDmprTf54kraNM3ZNU6oQLHX3uuJcFyewapEK6gQ= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(5005006)(8121501046)(3002001)(10201501046)(93006095)(6041248)(20161123562025)(20161123564025)(20161123560025)(201703131423075)(201702281528075)(201703061421075)(20161123555025)(6072148); SRVR:BN4PR07MB2274; BCL:0; PCL:0; RULEID:; SRVR:BN4PR07MB2274; X-Microsoft-Exchange-Diagnostics: 1; BN4PR07MB2274; 4:3NxYcKqkuabqIFEyqOhlja0/qP1ELCoEH12DkyCPC/c8yxGG7Xc8peBDmK/HHvF4RP2ZTUalcEFDp3B8Rvex4oOySWC9+G+cqzK3R4haXh4RWuffMIThheh0nSOnUdKKT9IVZwjhr6GMSvgWUxibSPLVfR+t4WD4fFuKmPpnhO0gkMwwZYbMerhl4DQsdkqZxnmVNQ8AT7+vzkcjfsCFhqvBk+9NoyEzHI9uG3jWHFRuw1inuGPyrYOffEA1U0ltR3mS/ptxH6E8Cc/qL47XVKSGcmU+602hfi3gqPCMMGHRKg53CorUt+OeyIzuwkuHSRyFjQVMvNJ+xCsd6YugXHsnSofZN/3qEu7fysqdznA0JBiWyxgdsQAnbLe7IDPYytkEUt7DvkSKDYw2Jz5reM/A2wer4bp+9ObhNMsRccn6m4v2fKLJ3fBlBvXO/VTy83DikrXTTraPpQow6MsckvNr5MMM6rCeLoAmOAL+dfftJGJIKxzfk1RdzpjrU074qN/o/f6z/uztvIZBulOVpzRzhtzC5shMC03G0ftl/P/3lT+8e8vjurs8qQwot05bNcJ89T1tlcjNjSCRo9KH10bubjjB+uthi+cstK5U6t+mOSpEbI0heDltqBj0OuKjjMI3zckK9+P9j7/PWGXILCe4+x/WA+8IDaQpVJo4te+bWRYSse+1KN300rk5VZSQ X-Forefront-PRVS: 0264FEA5C3 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39450400003)(39840400002)(39410400002)(39400400002)(39850400002)(5660300001)(7736002)(5009440100003)(33646002)(47776003)(50466002)(189998001)(4720700003)(6512007)(6666003)(50986999)(6486002)(76176999)(6916009)(42882006)(2870700001)(305945005)(36756003)(6506006)(2950100002)(23676002)(50226002)(2361001)(81166006)(66066001)(8676002)(2351001)(2906002)(38730400002)(110136004)(42186005)(4326008)(53936002)(6116002)(3846002)(25786009)(110426004); DIR:OUT; SFP:1101; SCL:1; SRVR:BN4PR07MB2274; H:lio357.in.caveonetworks.com; FPR:; SPF:None; MLV:nov; PTR:InfoNoRecords; LANG:en; X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtCTjRQUjA3TUIyMjc0OzIzOkd0QTJoVHhtS1BZNStBc0RydnVVK3c5bERB?= =?utf-8?B?OWxGM2k2K3pzM2tadTAzb1crWWU2NDZxNWVvNjl1SXVYM1ExTVcwdDhEayt6?= =?utf-8?B?cUpXS01jR1J3YmtnNHVTcWUybmNuYzlWdTRBaVNMYTdKWjR3OUZ0cG9Ydkc1?= =?utf-8?B?c2wwU1kxeXU2WkVoV29LUGZoUWJpNHk2YVYya0RDd09oaWxpOEgxU09OUVJO?= =?utf-8?B?RCtuaFZvV2t1NHdUeEFwT0trS0k4T1dPTnliS2l0VU92emhjRW5PWmlmMjQr?= =?utf-8?B?emw1Z2lSTHV0RmdQZklmWUxwM041Q01rYWQwaW4vbmd5SzlYbWlDaGlaYzZu?= =?utf-8?B?YWkzWmhnaGd2eHQxOW56NXNEamttMjAxNTMralB6SG1oa1JJck1VNjU1WWUw?= =?utf-8?B?OVN4dCtsbVRlc3RiTnhxRXBVWVROVGdTWkEwcFZKazYwZ0huc0ZWVTdmUlNt?= =?utf-8?B?SGhuaWVub0hjUW1oWU9lWHEvSjBNcUYyWjVMNG5pUmJ6c1NVSndqWnM3WE9Q?= =?utf-8?B?aFl2MFk4KzdjUXZqQlF1YXozd2J0MHIrdFhBMzJPVXYzRS9VT2JaZ3VyNUZy?= =?utf-8?B?bjkraHRNd0EzWWFmOGdINHRyRHMvclhId1RKTHBPcDc3T24wLzl4cTVWaHBn?= =?utf-8?B?eVBPaVF0bXY3enhZUm5qL3k3anNDOUtydFFWbG1reHJpTnh0YUo0Q011Tkk0?= =?utf-8?B?a01HMnVrSkhzTEhIcDkxRHBPcjJDRlEvelB2WU92U3lGU1Z5eXNSN3FCOFl3?= =?utf-8?B?N1M4TExwaXU1WDRMU3hnQ0lCdEVYUGhyb1NwektaOHcxbWtEN1ZhblZmNlRn?= =?utf-8?B?YTJaTHduNDRwSnY2L3IzMWxwSTRGRXd5Z0pjZ2NEL0FqWGVJbm5jTGZHRk5j?= =?utf-8?B?bXFzRkpwOVVaeUJ0dFpRNGNBVkJaWkJ0TFRDL2VjcCt1dDVzK1ZqMU9hNll5?= =?utf-8?B?clFFWmhQL3FyNFRZZ0JUVTFMejBGdzVUbFhGNk1OTWZLNnROeHp3d0pVS09M?= =?utf-8?B?U0ZSS0ljK0xTeUx4SEFwZWZDVXViMjNrdHNFWVVwVEU0UzVJUytEZElFbmV6?= =?utf-8?B?cmdPS1BNTGNtN1JZcG9rbTd1ZHVHYWU3SUZoMmZXQzBTMUdjZk9TK0Q5QjNv?= =?utf-8?B?UlJRTHlWSkpFZU5rRUdqSUNrSndVSGJrcE93dXoxS002eHErUk5DTGxvQzd1?= =?utf-8?B?OVBzM2RFRDhwcWdtb3h5RmFmTEx0N2tIUW50MWlVL3R2T05XcUhwdzdhWGEw?= =?utf-8?B?SERERjl5M3FuMS9QYStHVzM5WERqZFdvZWhhcEp2d2F2aFdTL1pJZkhpWXlo?= =?utf-8?B?VGRJS1JrTTJpZVpmcGdFNlhRSXNJWnVMcUVkRktvdHkrM2d3ZGhLZE8zRlN0?= =?utf-8?B?d09FeDRocEN0Wkw4NlE4elQ2SkU4SXg3b2c4a0dnOE12OGJjNCswYXZ3WHhk?= =?utf-8?B?TzM5b2NEenRZaWdQcUw3RUMzVmRaMEdOQlV0ZzVHVVd5OTZjdEV6c3lNa1J5?= =?utf-8?Q?FccCcvabF1kPbxWwrtCF0P2sE=3D?= X-Microsoft-Exchange-Diagnostics: 1; BN4PR07MB2274; 6:x2RnOBciOZS7xdz45oZa4yvMfyQaDCkYE/38lJtpsCBTOhpYLGz5UgN1rwhdQbHElIRVXy7AaZyysBI8J5RMBkZmSB6VZN+GUZYjvfnYXpNo5SOmfadQ8GyfTnp0kQ91eBib7NCwHc1vVSKAINfSqCyqRc5OLkKvylISgSBvwt+9uEYYVJ3x82d2D8v0VQtFvvVJyePF6jE3IC2qsSJTu0ebupI8gEVKDbIDixeH28pu2WLmcen9ZekbaxR3/xXm8UaCBroAxFAzadVVE1ZVOznYB6Y3HLCKU682BrjiDor+pgJXc6uy2/aDoLxbXmToWK8sF8gJ+ZH4HgDFquunizdMdiU+RWqPhp9I4skYLv6GYCrNBKwfVhSkebf7Zu3onfhfHnISXIVq4webIjXtUg==; 5:nSrSQQFfag7Ji6h29RKYQbBdqMEPNuHxrRSvnhAzA+umh6bggvAGTyQA6nvxuo08J6TgValsuozLll67XeKgtw7j+dDee1jmu5rIBqp8i4v4IYpvnnw6vgWFVrCJJUZ9veiT4X0E7Lomopvhxu2eLg==; 24:zJsbC8KB2QbvwfYG7+7aI8xRvpjT5YYIkgsXd+7Ine5G0uz4M6d98se0PvSrEFU45WJR1Nmwk86hlyf8u1fXMXtjjVAMABaHSv0xvPHbmtw= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BN4PR07MB2274; 7:AIAeMdzlUJ39gyv7lDLYzSPf/nFZ/pwm4+sl2u4w/bQX+bfVpIRU12qI9bS/oeeCLbU9OGBKyRJLk9fMmpuxV03ile6XpXeC58bVp/CzWU/OFiYNdZhdfGxlffhluAhaW4pruwg/FCzJc1YMnWuD/bIKn1QFvFvTPo2ypYZp0wE7F/CtzHMZ5ihlojWnraoFWqmrRK+rICGSdx72hQO/MYD1FGoVM5feyEOsLBJ2RaUPsXAbOhkRAEYPC9ZKFQjxWT1DtUG/lDj4aXENtYMcdZZ/OkffJmZNM/aDn3GR74Or9olVgtOyQsBrWkwVzPA7XU0CKH7I17M/vSeNxbb0Sw== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Apr 2017 15:05:51.6612 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN4PR07MB2274 Subject: [dpdk-dev] [RFC 2/2] doc: include PMD build and run file in liquidio 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: Sat, 01 Apr 2017 15:05:55 -0000 Include build_and_run.inc instead of instructions to build PMD and run testpmd in liquidio driver documentation. Signed-off-by: Shijith Thotton --- doc/guides/nics/liquidio.rst | 85 ++------------------------------------------ 1 file changed, 2 insertions(+), 83 deletions(-) diff --git a/doc/guides/nics/liquidio.rst b/doc/guides/nics/liquidio.rst index 9ffdc35..fa92cd7 100644 --- a/doc/guides/nics/liquidio.rst +++ b/doc/guides/nics/liquidio.rst @@ -80,88 +80,7 @@ Please note that enabling debugging options may affect system performance. Toggle display of register reads and writes. -.. _lio_driver-compilation: - -Driver Compilation ------------------- - -To compile LiquidIO PMD for Linux x86_64 gcc target, run the following "make" -command: - -.. code-block:: console - - cd - make install T=x86_64-native-linuxapp-gcc - - -Sample Application Notes ------------------------- - -This section demonstrates how to launch ``testpmd`` with LiquidIO® CN23XX -device managed by ``librte_pmd_lio`` in Linux operating system. - -#. Mount huge pages: - - .. code-block:: console - - mkdir /mnt/huge - mount -t hugetlbfs nodev /mnt/huge - -#. Request huge pages: - - .. code-block:: console - - echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages/nr_hugepages - -#. Load ``vfio-pci`` driver: - - .. code-block:: console - - modprobe vfio-pci - -#. Bind the LiquidIO VFs to ``vfio-pci`` loaded in previous step: - - 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:03:00.3 0000:03:08.3 - -#. Start ``testpmd`` with basic parameters: - - .. code-block:: console - - ./build/app/testpmd -c 0xf -n 4 -- -i - - Example output: - - .. code-block:: console - - [...] - EAL: PCI device 0000:03:00.3 on NUMA socket 0 - EAL: probe driver: 177d:9712 net_liovf - EAL: using IOMMU type 1 (Type 1) - PMD: net_liovf[03:00.3]INFO: DEVICE : CN23XX VF - EAL: PCI device 0000:03:08.3 on NUMA socket 0 - EAL: probe driver: 177d:9712 net_liovf - PMD: net_liovf[03:08.3]INFO: DEVICE : CN23XX VF - Interactive-mode selected - USER1: create a new mbuf pool : n=171456, size=2176, socket=0 - Configuring Port 0 (socket 0) - PMD: net_liovf[03:00.3]INFO: Starting port 0 - Port 0: F2:A8:1B:5E:B4:66 - Configuring Port 1 (socket 0) - PMD: net_liovf[03:08.3]INFO: Starting port 1 - Port 1: 32:76:CC:EE:56:D7 - Checking link statuses... - Port 0 Link Up - speed 10000 Mbps - full-duplex - Port 1 Link Up - speed 10000 Mbps - full-duplex - Done - testpmd> +.. include:: build_and_run.inc SR-IOV: Prerequisites and Sample Application Notes @@ -248,7 +167,7 @@ This section provides instructions to configure SR-IOV with Linux OS. #. Running testpmd - Refer :ref:`notes above ` + Refer :ref:`notes above ` to compile and run ``testpmd`` application. Use ``igb_uio`` instead of ``vfio-pci`` in VM. -- 1.8.3.1