From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <Tone.Zhang@arm.com>
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 <dev@dpdk.org>; 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)" <Tone.Zhang@arm.com>
To: "dev@dpdk.org" <dev@dpdk.org>
CC: "Gavin Hu (Arm Technology China)" <Gavin.Hu@arm.com>,
 "bruce.richardson@intel.com" <bruce.richardson@intel.com>, "bluca@debian.org"
 <bluca@debian.org>, "roszenrami@gmail.com" <roszenrami@gmail.com>, Stephen
 Hemminger <stephen@networkplumber.org>, nd <nd@arm.com>
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: <AM0PR08MB34090608EC6C16BF08071F0B8F1C0@AM0PR08MB3409.eurprd08.prod.outlook.com>
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: <AM0PR08MB31403EEBF852554A1D7FD4328F1C0@AM0PR08MB3140.eurprd08.prod.outlook.com>
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 <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=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 <dev-bounces@dpdk.org> On Behalf Of tone.zhang
Sent: Wednesday, September 5, 2018 1:18 PM
To: dev@dpdk.org
Cc: Gavin Hu (Arm Technology China) <Gavin.Hu@arm.com>; bruce.richardson@in=
tel.com; bluca@debian.org; roszenrami@gmail.com; nd <nd@arm.com>
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 <tone.zhang@arm.com>
---
 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