From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-CO1-obe.outbound.protection.outlook.com (mail-co1nam03on0078.outbound.protection.outlook.com [104.47.40.78]) by dpdk.org (Postfix) with ESMTP id 94BD96932 for ; Tue, 11 Apr 2017 20:59:42 +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=ihLVEnx78IcchSJP6Tncu1URvpxSvmli3VAgXewhUyE=; b=jXRlfGYIjXnOJwtPp8NT8rJlHWofhJonupwY+UNgpReAf9Bu/5yNnAwnuPRENRx7+FGREwfJAm1VWmbOCbLbVkjD9px7zTD4jc/zuVz0KbJ+PeHK43oVTt6XwsM7XfVwVln6AAA2PNF8PZ9gGyUglpZ2ZBQGMvDDyd4wlLYcscw= 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:39 +0000 From: Shijith Thotton To: Ferruh Yigit , John McNamara Cc: dev@dpdk.org Date: Wed, 12 Apr 2017 00:26:47 +0530 Message-Id: <1491937010-16553-8-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; charset=UTF-8 Content-Transfer-Encoding: 8bit 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: 9bf79b07-37e0-4113-c32c-08d4810ce8ce X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 3:iFsXUe3iVbd+MukB7Pr4l27NQTTx3lAVzn/xZorjn4uql4QTwHF9j5FihD2woANyT/Yt9N5cPlSDtS6zz/2m8a4ijByRqxy7Cinb8kxbP+WYGUVfeFr7l2EOuV4M93cp2edCwNR9phjbAh2ZQ6HeH5W3RoUfbcx/7Y6+chytrjzaFb2K5TI6fpzBgon2HIBcnL1+mdCCczDmw0T8wEfPVW3VoZFVKEJH1Gj+Lo9f8j99HW/byo80bIHBxF3mtHI82WBCkJUxi5TXP1i4/5ehGWMQPWUNQx7ET9TaAh8EZXIIkd6pbwaBwJ07ZhOt5AoR9WMz/TtTC+vs2U5CQyc0cw==; 25:8TWUNd7HhrYk03uE1fkj+6gYcJe++mBaRRxcAXooUNM5fS9RRcP3z72SKHw45QoaASFTHuYE7mQIlOdgkjq/MaLnyU89fjJOblsOGRw94OFvjs+70jeD4R3WkTBsAfiasQ1Fl56xfpiPo45pdgsaq1rCD8Drf1H4+Gv0s74GWKNNSuq4LDuy5uikikYqOb1l1Y8fWNTrImj6AI88Duj13Wh66QV/hmySDrur/+0wCpgX/1XCB4+MmAPojelh9FBPqPudVTnigCNglFDj1pWMxxUB9/zcBM29VECPSD7ehxrSVvx7ViIpWbL79ulQyLuMOgOYAGAMJ4cCo+liNQHfVcW2nrGYoy/PK3JZMFg1ebu7X8GFRSmJ1cuJ8SitnUwFMwp+pG0RnVaa2rzfHyV3czGXTY3pAFmSGtisJujXbWQDOhRxMdUK5pEuUcjHrkmFSs0nd6qzZ0VSkNH+hXuO6A== X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 31:s5a+q3K0pAYSMsO43i/BQe1+YxRqnF1qif5SAHLIlKzHtZjk1OBxZvvrzjrkZUf7EAFxmpNUuWSUzu1brapkfdolh1+6uma2fLW/L2TPuNJlBxA1T87BxPUbJ1cEuLNfyfDh3+hMxA1WtlVMQOF3L67SUL7t/TndoRsGh5xRYxliP8TvoUQMh0Yg+ySWSlH2vbPKLtwPo1v7oVe4SjnTfe00+FPQC8Gc1CNJIC/Rv0j/5sImVk2WTZr14UZ4cUCSygUKuj+makQwkLryjqa6lA==; 20:uV5zXt4RVcx4Mep3Tx7wE1Gc3U+yxoyzLNMhtpan8HnK9OkyLf0dGwLNCf1Qvxbg5ZM/Hb1fC2quLdIbifALGthRR2KM9w3QQVG80zoTvk+pxM8uvdzssZUfzChLcoKhS22yu4uzasfZOJ8XEImQ8xY6EQ6RYckWqCm868zH3z473cwrqVGU3UhbRdGnqKJ0QdmcMIKdvYl6do/sUhJZevoGh1zQoBjcLKvGJgrYETpuTUKWDzvLPEVju8OCOjjdoayWsuRxKVz1vrTnqGsQ5KQtgP/RfXV2o/6XFN1XlUQQSrq+9ci3BqGO4ivBTddz8cbDS/jBXl3SEr1Z5cfwwEYpaGWu8933y0vIt4hHVS9VJS+USu++FjyAi3E1wuP1cFZe9UKwaId+gJpbHEA+pyEIJezmKaJiWEas9dmyUS7VpMNDcctNDzXwjHUTp+h2YfHA014kOjVWyw3nK4WMBawXPO4zMugpCwHNhZhlxhZ4dxZTcr0cls+GIQsjXAGobJjTeRHEsvz8BMmIal2j9Yu2ednm/B13rYU5uFVXcDqx2oUMyTBjoO9McQoLcKrEZmW1EVvi2+lupvXydp0FHB6ojd6lnV7eSWX1JNulSU4= 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:9nQ599XrBd5q0KKLnEy9QYfzhiN5wK3HBsGhJuVNvoNGMKdPwebt/jIEVaUnATJ1cAl+jvizNkvFBHJFDqdXjBjo+KNQLLglQmJ5ho5Ca9yhpgPqjz0R/tdTMpCjwOu9FdNCD/8YlEc7tMjImUXowbKrsegLCWmRFmrzQcGWlc7wDZjnpGGwfe6D0nE2S3YCoqzf4AxOK/WZPVK3S5WLBTl3WzC9XAHqaivWVxqMfuN/G6rIyYq6o4id31de8Ls6FR/LlKPhpQ/gqLcF1DhME2gZF6UP4VswszOMAcriMW/23D1PrIwlBG8QguKEoUcyJn2IsAZNQ0QHlrUCquNHvHYhUKYjrxH3YmqRk5oxheSpeF61DQ8Mr8mZil8cf+wI7AbjQvo9OC10u0zpBaK7RlBuupHmsa5gboLLpcGxRofZRImBq+49RZZxoxcPsGVXscJ6fDwLNZ8weZ87NR2+/5AWD1i/z7lrrkkP7ppiQa1/HzetTj1Jh7RnQLGEVWTyZ+cXXCD/vKu01tfj/V0Ix/wnW1KAXiAQOAVExQEnNGUwqeNJoL6IzyswYRKH5prpLfuNY2OXzU/nr9iAFuy9p/B9i/G119+Zr+EjDrlJD2TXQXz00Jmy+rcDDgpxiXm7s43B+aWXPD8v8+E2NcDxtJlmBZxrXIlKaqb5YulhgcWoIg0Ia5ANcYKLnKCZ9E+fB4b8pW2VeBpfy4mBMKb02YY0VmbKJxE27ihPpKYSnB6FaruJoYOMsmFe0CwWiWas X-Forefront-PRVS: 0274272F87 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39450400003)(39840400002)(39410400002)(39850400002)(39400400002)(5660300001)(6506006)(66066001)(2950100002)(25786009)(42186005)(3846002)(6116002)(47776003)(6486002)(4720700003)(42882006)(6666003)(33646002)(5009440100003)(2870700001)(189998001)(305945005)(50466002)(81166006)(8676002)(36756003)(2906002)(6512007)(53936002)(4326008)(7736002)(38730400002)(23676002)(50226002)(76176999)(50986999)(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: =?utf-8?B?MTtETTNQUjA3TUIyMjg0OzIzOnllMmRDK0xrY0M5b25rVW1VYmc2V3IycmFS?= =?utf-8?B?TFJTWlBNNHNJdXpwSnlqK0ZTK0xzSlMxL0tWZU9uZldwcTE4Rjg4emxUSlhw?= =?utf-8?B?NGRZenc3UWxSMlZBbkMyNStSaGxRT0h3TlhNQ3ZBdDdQSEhkKzhYaFJ5cGlQ?= =?utf-8?B?a2E2SnRvK0VKZEZRY3YrZytac3FlQkdaaFBJZWhwd1hKcXRsYm5ZNk1MSXlS?= =?utf-8?B?TEtpdTY1d05QdDZSUWpLS2tzdmhRYkxud1VQNGJJQXVQek5iSFJrOHlKVkg2?= =?utf-8?B?N2loRUtybUxKWDZaa2c4ZitFRE1QdHBjZC9HeC9Ec3l5eDVqYmc5aTIvM3FQ?= =?utf-8?B?U1YrZldjb2J4SkJIK1MzNHM3cDd4YUdRTUdicUZxVk1KRTNWL0JLR09ZU1FB?= =?utf-8?B?Qk1DajVsdkdHZS9lUnMyWUFyMmhUL2R4SGl3NS9PMnJrdmFJOVhJTFRhR1gx?= =?utf-8?B?dDcxUHVGcTRQZlRjQ2hOZmgrRVhJOVozZTNWT0dvUGZjdm54OEtTcVBFWlZx?= =?utf-8?B?TGx5SVlCWXEvWDRuUklMT01XZnlQcEZab3pvem1kZGQwNU9iL0tRQjdOT2Nj?= =?utf-8?B?QWhmQWluWVZ2T2pHT1FrdXBRWEF1NDBORVBSYms3U2NtM0ZCU1dpVHlLNWZq?= =?utf-8?B?MVI3Zk1QWHJZM2t4anc1NDVZbnNOaEg4VTFaNnpreEx0UndzemdOZ1dhbU16?= =?utf-8?B?ZEFRZjZmYzlBb0E0aUFVN2lhVWw2ZnN5d3pEU290NGQ4Q3hDamVPb2lBMC85?= =?utf-8?B?cTEvSUFmQjhPbTEyZEFITlQ0Ui9XTnZGaG5PUkNMSWhuVXZ4MTJpYjk0Qk5S?= =?utf-8?B?dTlpRzZFay9SbWNTaXE4TFNYL0xsR1pSdTRyTG5GZ3h2OU1wTXBMZHdDK01R?= =?utf-8?B?emtCR0FJK3VsQTc1L2FvYmlCelZsQXQ5ejF2WjNLVUdFVlZkNHVFTHdGYkp6?= =?utf-8?B?QUJNWFo4RURMZUltb0NQTzh4SlBnaWhKY0kxMnBQRUJ6cXRWckVUdW9YcG1T?= =?utf-8?B?TENlNGZYVkYyQmdJWWRJc3NlbjJSWWJOc3J1YzkxUkNPOWx0R1RUVHBsMzh3?= =?utf-8?B?YUIrVm1Cb3Z5VlN5Vk5UKzFMUHR5TWFXYk11UkVCbHYxb2FJbHJ6UzNxelVP?= =?utf-8?B?MndBd2NFOW1Oak9NSXRucGVFUlhhNHhadFM4WlNmNDVUcHF1L0hra2FZVld2?= =?utf-8?B?Z3E2eU11VS8vcndVcWpBMWsxaWlKOEFBZkM5NmhRcWJWaE9VeERQaVhmZnhT?= =?utf-8?B?SmMvVmY1cXVQRUFxK0JEM2s0OW53bGQ1eWxxbEdBSXhMMHk4SU93YWFIY0Uy?= =?utf-8?B?UmVCQ3ZyUldQdE1WVG5vZm1aK3N4L0JReEJ1UFFUVG1iaXV0dU1JSmFsWmRh?= =?utf-8?B?TFdaSmd1VzNUWmRxWTRuYnlldUE4SmZQeDdlb3ZRPT0=?= X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 6:QpDzO8Vy0NjFRhnu9AmZJ77p8G6y7aJ8XbLkbXwREYsMVZvCnueEz0R3BH0wZ7bLtZWd+HnLcfRqTqrto/rylu5cI7lI3GGMDbGkxC76RUk3ro6Xjxu0jX9iZt3omwptuIThxKMRlq/BsjwdxhpSFR7dlMUlt9YSxIblE5UjxVgMrz6X65wS85mN6jPie22Kv3RxvOATpzRwsS39xsPoHVBG+4k5+QbQZLA6QPlz37OmVCjjzwof5gSqL2G+6xWjhQdEqzKB/mRPF/XZmxSU/Y/hmreriqIV8wgKdkplOFN0zH9yx9eQZf49PlUizY0NanvPeDhF1vv9xClsJyy1n+WbK6LznSmR77fooLfAKaKnzoajfOYNIIWJIbElApgV4zB2YOUzH0rinKXZ4kCXzgdkKyjzmxyaVvGarjO5eoIcujiP72lJsNZ5Ct5SV8MNriwvYkLEHWJHp0wJMXBfcA==; 5:Mji+bSq3TY0LAsQ50x/dAKGP1OKKeJGy2gLeOtiZj+f/k39YolYKmFXrIVe6Rxx/fVPu4LtadjTj7dIPD5mr37yW4wUp3P97RjwlImB1nBFSbdXTtlH7yyXa4VRUNknOLHB3Y9X2S1NLs1XzIijAYQ==; 24:EuDnJUgV6WqtHGY5b8mBPSfCC682+oxuGKqM24UcVKTAyG3PPtVekv7qOJlIMpDDt8BoWXJWAZiSIrIXqPp2lWU3k7Gk771sYCevLij1Ro8= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 7:mpE5jYiA5w0Ed7iNmLqMANtn+mXTSrGldu/gAkJ5D9dusM6pT+jZYcRiA45Cr+A3ebwEmUXNFoAtwoDjLHkwst+vqCLq3Jh59BJG0x7ZCW32SJKa84zLEuP/+V6F3I8fb+OTanN+yerF2l5vazqo7Mo+Ah/H2bO6N38XEiTRqMPy6cvUq4TxKQ9vrZZcSsZ+vqbm3GoRxf8nIfVmxti2w/rEQ6IcrVJUY+vRFJ/QXKhriYXTUPXFst8dJmAMQE1pv2E4eWDcLCvKEd5gd5aVFxvmLNTzaZI3FhlwDWCc2ziDKmFPPZhyyXdpA/CKR58jgBt3gBReN3T+NYNMWL4xmQ== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Apr 2017 18:59:39.8717 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR07MB2284 Subject: [dpdk-dev] [PATCH v2 07/10] doc: refer PMD compile and test section from 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: Tue, 11 Apr 2017 18:59:43 -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/liquidio.rst | 123 ++++++++++++------------------------------- 1 file changed, 33 insertions(+), 90 deletions(-) diff --git a/doc/guides/nics/liquidio.rst b/doc/guides/nics/liquidio.rst index 9ffdc35..b7c80c5 100644 --- a/doc/guides/nics/liquidio.rst +++ b/doc/guides/nics/liquidio.rst @@ -80,90 +80,6 @@ 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> - - SR-IOV: Prerequisites and Sample Application Notes -------------------------------------------------- @@ -216,7 +132,6 @@ This section provides instructions to configure SR-IOV with Linux OS. echo 1 > /sys/bus/pci/devices/0000:03:00.0/sriov_numvfs echo 1 > /sys/bus/pci/devices/0000:03:00.1/sriov_numvfs - #. Assign VF MAC address: Assign MAC address to the VF using iproute2 utility. The syntax is:: @@ -229,7 +144,6 @@ This section provides instructions to configure SR-IOV with Linux OS. ip link set p4p1 vf 0 mac F2:A8:1B:5E:B4:66 - #. Assign VF(s) to VM. The VF devices may be passed through to the guest VM using qemu or @@ -245,12 +159,41 @@ This section provides instructions to configure SR-IOV with Linux OS. -device virtio-blk-pci,scsi=off,drive=disk1,id=virtio-disk1,bootindex=1 \ -device vfio-pci,host=03:00.3 -device vfio-pci,host=03:08.3 - #. Running testpmd - Refer :ref:`notes above ` - to compile and run ``testpmd`` application. - Use ``igb_uio`` instead of ``vfio-pci`` in VM. + Refer to the document + :ref:`compiling and testing a PMD for a NIC ` to run + ``testpmd`` application. + + .. note:: + + Use ``igb_uio`` instead of ``vfio-pci`` in VM. + + 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> Limitations -- 1.8.3.1