From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR03-AM5-obe.outbound.protection.outlook.com (mail-eopbgr30089.outbound.protection.outlook.com [40.107.3.89]) by dpdk.org (Postfix) with ESMTP id 9E680F04 for ; Wed, 19 Sep 2018 09:44:38 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector1-arm-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=U5bTOsBYFDNBjR0gsnjv6TUvuu5yFJ3BGfZjTLu5XQI=; b=OQeCMH0wSoWvY8X9lBzq9qEnUKLo2n/7HlXrgqEqdok8LyXYzb+c2AjLglacoJ9ZTu1opD6haBLmovcB64jJ3lNqax4BHJchbIATcolLD8Zm4HGbYgU1gP5856IJmUp+xedoVNEySyf+hE2YSfTl3MFnMuMP+RYaTYa6LDHTiFo= Received: from AM0PR08MB3409.eurprd08.prod.outlook.com (20.177.109.139) by AM0PR08MB3140.eurprd08.prod.outlook.com (52.134.93.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1143.17; Wed, 19 Sep 2018 07:44:37 +0000 Received: from AM0PR08MB3409.eurprd08.prod.outlook.com ([fe80::6cd9:ddb2:1c60:d5e]) by AM0PR08MB3409.eurprd08.prod.outlook.com ([fe80::6cd9:ddb2:1c60:d5e%2]) with mapi id 15.20.1143.017; Wed, 19 Sep 2018 07:44:37 +0000 From: "Tone Zhang (Arm Technology China)" To: "dev@dpdk.org" CC: "Gavin Hu (Arm Technology China)" , "bruce.richardson@intel.com" , "bluca@debian.org" , "roszenrami@gmail.com" , Stephen Hemminger , nd Thread-Topic: [dpdk-dev] [PATCH v3] doc: Clarify IOMMU usage with "uio_pci_generic" kernel module Thread-Index: AQHURNfJwoNOzrJUtE+ns05Q4LnHz6T3TjGQ Date: Wed, 19 Sep 2018 07:44:36 +0000 Message-ID: References: <1536122382-26525-1-git-send-email-tone.zhang@arm.com> <1536124655-27163-1-git-send-email-tone.zhang@arm.com> In-Reply-To: <1536124655-27163-1-git-send-email-tone.zhang@arm.com> Accept-Language: zh-CN, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: spf=none (sender IP is ) smtp.mailfrom=Tone.Zhang@arm.com; x-originating-ip: [113.29.88.7] x-ms-publictraffictype: Email x-microsoft-exchange-diagnostics: 1; AM0PR08MB3140; 6:PwXtfDOudyKlq58wO2tFH/VslsSs/IgnsF6GB611wZEBPk3viiaFb0rDCsxijg3cRtaB7naYfeFMnYGm3yrTJELqSXWtqbIlNCq6WMXT/PU5i5TZTH4CWBlfijhTIM1ahYVixiiR3BjM/MePIgF6O3DmM2irwmrOElbxUGwqXSqK2b0ZhN0EBCurhVf/kgf0C1ShhY2SC2Ve71FfJs4tWjecbaEd291jbQFlcd1zMMP9qbN5ob480oQl9ycXzwoCT8qsO3JdpNutwuNjHPKiQdhzMcBBnRYovJLY3EvbuKwzXGzlhtHaPhgaW/+5lgHnIvL0ch+podWFQ3Xhw4DnJLLJ9WYhEbZvNnI5GUvcMRAS+NIkbrMbEUzCPLyRc4a7nsnFG4D64Ai4+J//4/GqXF2rHMBVu8cjr4k92e3QIG9rr5uuJvJNSEu0TN2mRODV44F1GrISxXtO07g1v0itAg==; 5:aoLupvwQWCduJo1cAaJ0wuWPV5ckkakDMwIZks+wtr9sl5HH/eouMhvRfKKiwp4w+QMt8Ny7w/VKV5rCPj4mrn8fCjG4VgUdfV4u1Rh/CZ0kbmxwKafQhrtKKWuIBD3fnREpgWEkl75wFsQsG4/FtgbVON21WWQTwIhxjrYySKs=; 7:rzkLQnhKqUwre1xJ2nrVUl8vM0q72vRxUw0Q+1ZTPm+paU9kRY4di54ZsCXB40X1m+kU42wDkvF9Tm89XcgW8IbTCd7q18sAEqgHIWe8BBo9gy7Ub8JpYrWh8kgHzKWxpFhaVCRn8Gzz3JoKGHUn3bFIcGf/VlkXC4DhwcGRLYT2/2V0iniWnbPjSbt6GWFxJimveGk5tjtYeQe7u45A1PxegSNGoR2gOyKOP+aE50PTLi6tZEr2+JTn4V1Gc3Rq x-ms-exchange-antispam-srfa-diagnostics: SOS;SOR; x-ms-office365-filtering-correlation-id: 32699719-d7e8-44cb-0e3e-08d61e03bfc4 x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989299)(4534165)(4627221)(201703031133081)(201702281549075)(8990200)(5600074)(711020)(4618075)(2017052603328)(7153060)(7193020); SRVR:AM0PR08MB3140; x-ms-traffictypediagnostic: AM0PR08MB3140: nodisclaimer: True x-microsoft-antispam-prvs: x-exchange-antispam-report-test: UriScan:(180628864354917)(85827821059158)(228905959029699); x-ms-exchange-senderadcheck: 1 x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(3002001)(10201501046)(93006095)(93001095)(3231355)(944501410)(52105095)(6055026)(149027)(150027)(6041310)(20161123562045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123558120)(20161123564045)(20161123560045)(201708071742011)(7699050); SRVR:AM0PR08MB3140; BCL:0; PCL:0; RULEID:; SRVR:AM0PR08MB3140; x-forefront-prvs: 0800C0C167 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(376002)(366004)(39860400002)(396003)(346002)(136003)(13464003)(189003)(199004)(106356001)(105586002)(66066001)(53936002)(5640700003)(2351001)(9686003)(5660300001)(26005)(54906003)(68736007)(33656002)(55016002)(7696005)(6916009)(99286004)(6436002)(316002)(6506007)(2501003)(8936002)(53546011)(81166006)(1730700003)(11346002)(76176011)(2900100001)(305945005)(14454004)(102836004)(72206003)(14444005)(3846002)(6116002)(256004)(81156014)(86362001)(7736002)(2906002)(4326008)(446003)(25786009)(476003)(478600001)(229853002)(74316002)(97736004)(5250100002)(186003)(486006)(6246003)(39060400002)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:AM0PR08MB3140; H:AM0PR08MB3409.eurprd08.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; received-spf: None (protection.outlook.com: arm.com does not designate permitted sender hosts) x-microsoft-antispam-message-info: SToneiceYwBXOud70/7pPK51EQiJcPQHXVXRUOykXes+FpKvQvk+Rz95+Mdo09l+BaI8hfAymF3FjxizcKdiuhQzyzpEwGzPzwX1iFsnV//HpBuVGgP4Coj4PgzyWPtMS0w56VmldoyCmVwN1z/yeO94zVeqYqqtWqkNytFA+10lTjAV0TK5KRXJoyLqBJV2TcxiTBz0cHXDaV1061JbKlGzzTYHJD4TIhbm6MO/p1qIFTgrKTD0EcjViVxCGNOioOArbAJyG1OlLhSKDlAXnjRVwpiq6uNDWUG2MiVmLWoO9hLYf9f/765+Qfbra1RkUdlGExCnCoZ8Lu3+3AAcFV+NSQCg3Ug53fn0vNZv6o8= spamdiagnosticoutput: 1:99 spamdiagnosticmetadata: NSPM Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-Network-Message-Id: 32699719-d7e8-44cb-0e3e-08d61e03bfc4 X-MS-Exchange-CrossTenant-originalarrivaltime: 19 Sep 2018 07:44:36.9598 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR08MB3140 Subject: Re: [dpdk-dev] [PATCH v3] doc: Clarify IOMMU usage with "uio_pci_generic" kernel module 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: Wed, 19 Sep 2018 07:44:38 -0000 Hello Bruce, Luca, Rami and Stephen, Could you please help to review the change?=20 Any comments are welcome. Thanks a lot! Br, Tone -----Original Message----- From: dev On Behalf Of tone.zhang Sent: Wednesday, September 5, 2018 1:18 PM To: dev@dpdk.org Cc: Gavin Hu (Arm Technology China) ; bruce.richardson@in= tel.com; bluca@debian.org; roszenrami@gmail.com; nd Subject: [dpdk-dev] [PATCH v3] doc: Clarify IOMMU usage with "uio_pci_gener= ic" kernel module If the devices used for DPDK are bound to the "uio_pci_generic" kernel modu= le, the IOMMU should be disabled in order not to break the IO transmission = because of the virtual / physical address mapping. The patch clarifies the IOMMU configurations on both x86_64 and arm64 syste= ms. Signed-off-by: tone.zhang --- doc/guides/linux_gsg/linux_drivers.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/guides/linux_gsg/linux_drivers.rst b/doc/guides/linux_gsg/= linux_drivers.rst index 371a817..b46fc6a 100644 --- a/doc/guides/linux_gsg/linux_drivers.rst +++ b/doc/guides/linux_gsg/linux_drivers.rst @@ -48,6 +48,13 @@ be loaded as shown below: ``vfio-pci`` kernel module rather than ``igb_uio`` or ``uio_pci_generic= ``. For more details see :ref:`linux_gsg_binding_kernel` below. =20 +.. note:: + + If the devices used for DPDK are bound to the ``uio_pci_generic`` kerne= l module, + please make sure that the IOMMU is disabled. One can add ``intel_iommu= =3Doff`` or + ``intel_iommu=3Dpt`` or ``amd_iommu=3Doff`` in GRUB command line on x86= _64 systems, + or add ``iommu.passthrough=3D1`` on arm64 system. + Since DPDK release 1.7 onward provides VFIO support, use of UIO is optiona= l for platforms that support using VFIO. =20 -- 2.7.4