From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <Gavin.Hu@arm.com>
Received: from EUR04-HE1-obe.outbound.protection.outlook.com
 (mail-eopbgr70054.outbound.protection.outlook.com [40.107.7.54])
 by dpdk.org (Postfix) with ESMTP id C95B2F11
 for <dev@dpdk.org>; Tue,  4 Sep 2018 11:16:42 +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=kQoAqMd7tIMuQOIcfxE3M+2S0VEQtWnehAOKDi0YUyA=;
 b=YGAWY94aJPLOXA6lRvCUUcFnfnPMxp+ZIaINmjv8YeUKHD6eIISm3VeHRXkUoykTCvrviDt87+t2DeJZuMpPNJlAuB6oYNBkSKfOfIi0ccZ+i9xdq5An+JwB7DSYAGdRuVUrKQqU7oci9pJvB0/g1Ay/PXg1+TePT4wssjbne7Q=
Received: from VI1PR08MB3167.eurprd08.prod.outlook.com (52.133.15.142) by
 VI1PR08MB3328.eurprd08.prod.outlook.com (52.134.31.139) with Microsoft SMTP
 Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id
 15.20.1101.15; Tue, 4 Sep 2018 09:16:41 +0000
Received: from VI1PR08MB3167.eurprd08.prod.outlook.com
 ([fe80::b91d:e285:4647:f3e8]) by VI1PR08MB3167.eurprd08.prod.outlook.com
 ([fe80::b91d:e285:4647:f3e8%2]) with mapi id 15.20.1101.016; Tue, 4 Sep 2018
 09:16:41 +0000
From: "Gavin Hu (Arm Technology China)" <Gavin.Hu@arm.com>
To: "Tone Zhang (Arm Technology China)" <Tone.Zhang@arm.com>, "dev@dpdk.org"
 <dev@dpdk.org>
CC: nd <nd@arm.com>
Thread-Topic: [dpdk-dev] [PATCH] doc: Clarify IOMMU usage with "uio-pci"
 kernel	module
Thread-Index: AQHURC2Xjdp0ujIyPkarsLV1Sd2bRKTf128w
Date: Tue, 4 Sep 2018 09:16:41 +0000
Message-ID: <VI1PR08MB31672A372851F17BEB0498748F030@VI1PR08MB3167.eurprd08.prod.outlook.com>
References: <1536051547-8797-1-git-send-email-tone.zhang@arm.com>
In-Reply-To: <1536051547-8797-1-git-send-email-tone.zhang@arm.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
x-originating-ip: [113.29.88.7]
x-ms-publictraffictype: Email
x-microsoft-exchange-diagnostics: 1; VI1PR08MB3328;
 6:VGUh9jILJZGY+R22R1b1U+8ALp37HpMdAxO8D8w1xQl2LhTRm+fkPElKvOfmOndsUdiHS5PL9s74VL33njIJL4SMWhH6Z7bx0iIn96Do0ITALgf+VQKLKP/CSLmaiLO8H+Hq//5MkTcarGZq3AxHUbGuGzZXk8D2xTzmrg9fMIKotS12wlIsM1vC7t5A3/KcBf/qNldngiT0ikmvQVPznW7ynNwlGa31rw/xynXVRDt/PAD8oyTBN2zvFFTSY1yI5t5E6+CELXKq6fZovhk2Eqpz8LzyRGMRBFS8clwaqr1gyZnQyHJV+uGYK5N84P4jwpmGZojre4VmCDktPgLzg094HhgPME1SIdwIipIHC3MXOhf2mnGjrF8EAR7GSToMZzt6Vtw40cSEh/OyKdF2Agc7/HA8rGD4qhVpOH87bFuiB33OP/q29k17DImUPyluj9pCBVZz5XXzghy9czRDPQ==;
 5:dvX6UtRWtJwdtadvXazB4ceQ+X8O3kllkMnvdSOMJuw0D2LEOFN/gg0i8u1Bg4z5Y7ySBBQnVLmYtwW0AMDZCPOSF8e2QkCLV+RjAZvxRtRzcVbD4sqDiDxbMP+R14Fm8x/WoXrAshgBL0AJLaXiyp81LzmJROKvOj/7LASuSnQ=;
 7:aioKHB/M/jFdbtoSASn3TQF3PM0dJ8fC9D8nMkPWmp8TT4jvomjvqgqa7kpJkiAnbds0XD+C6ymAKq34OYNI0ZHR8BJmCQRNA7ikExb7kyjsI2tpB+j4n6QZxcHz8dVVMeT0ROW4j1Dn21XnXY0XtK3AZpxcTtCYTyFL6XCPxEWwCfDHjlAlAPFZ0fd8+2hebpdhh1NzhMCTSG2ee0DhaSOH07vgsjhG3+OW+nL8/P5aIWonXBwiBsio3cUGnoPe
x-ms-exchange-antispam-srfa-diagnostics: SOS;SOR;
x-ms-office365-filtering-correlation-id: 8aeaf3c3-5974-4a78-00e9-08d61247206f
x-ms-office365-filtering-ht: Tenant
x-microsoft-antispam: BCL:0; PCL:0;
 RULEID:(7020095)(4652040)(8989137)(5600074)(711020)(4618075)(2017052603328)(7153060)(7193020);
 SRVR:VI1PR08MB3328; 
x-ms-traffictypediagnostic: VI1PR08MB3328:
nodisclaimer: True
x-microsoft-antispam-prvs: <VI1PR08MB3328721B0C9A33A03535CDFC8F030@VI1PR08MB3328.eurprd08.prod.outlook.com>
x-exchange-antispam-report-test: UriScan:(180628864354917);
x-ms-exchange-senderadcheck: 1
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0;
 RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(823301075)(10201501046)(3002001)(93006095)(93001095)(3231311)(944501410)(52105095)(6055026)(149027)(150027)(6041310)(20161123558120)(20161123560045)(20161123562045)(20161123564045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(201708071742011)(7699016);
 SRVR:VI1PR08MB3328; BCL:0; PCL:0; RULEID:; SRVR:VI1PR08MB3328; 
x-forefront-prvs: 0785459C39
x-forefront-antispam-report: SFV:NSPM;
 SFS:(10009020)(346002)(136003)(39860400002)(396003)(376002)(366004)(13464003)(199004)(189003)(76176011)(316002)(110136005)(99286004)(97736004)(33656002)(5660300001)(53936002)(478600001)(5250100002)(7696005)(2501003)(3846002)(72206003)(6116002)(106356001)(105586002)(2900100001)(14454004)(9686003)(6436002)(55016002)(66066001)(476003)(8936002)(53546011)(229853002)(11346002)(305945005)(81156014)(81166006)(74316002)(7736002)(446003)(6246003)(256004)(26005)(486006)(4326008)(68736007)(86362001)(6346003)(14444005)(25786009)(102836004)(2906002)(6506007);
 DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR08MB3328;
 H:VI1PR08MB3167.eurprd08.prod.outlook.com; FPR:; SPF:None; LANG:en;
 PTR:InfoNoRecords; A:1; MX:1; 
received-spf: None (protection.outlook.com: arm.com does not designate
 permitted sender hosts)
authentication-results: spf=none (sender IP is )
 smtp.mailfrom=Gavin.Hu@arm.com; 
x-microsoft-antispam-message-info: Sk0X6maz/Fmj1LXDlfPKPiKeZeCfkzTUV3MosP+KAtX51NgeQ09yrs8y1vBKXZyuPQOzcEkN/IxqV2lHeyQNeRpEe1Y19x6eWgcDpGIMp4bpc1wicbv+IAoFMN0kf5raN7prQ6nxwaGxJJF/eB97DoGDum9ZwKw6ZVLT7EncXlOYx44LBQvCXPzcVgdlu5cPxnNjSlGfImI10MMZcO4sADktbF6fCNyQZObSbok/dBeuz+DOoy9rZMgZNbd2fZqyf058YSpchsONyJefFzcdK+WjNLVLlVMhcs3EIJBbheD91DbDYJF7g31qACGSUYQK4dRU36lvxhobyAZ6/yuvzVqpYdAA7ro08EHpgP/8MbI=
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: 8aeaf3c3-5974-4a78-00e9-08d61247206f
X-MS-Exchange-CrossTenant-originalarrivaltime: 04 Sep 2018 09:16:41.4533 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: f34e5979-57d9-4aaa-ad4d-b122a662184d
X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB3328
Subject: Re: [dpdk-dev] [PATCH] doc: Clarify IOMMU usage with "uio-pci"
	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: Tue, 04 Sep 2018 09:16:43 -0000



> -----Original Message-----
> From: dev <dev-bounces@dpdk.org> On Behalf Of tone.zhang
> Sent: Tuesday, September 4, 2018 4:59 PM
> To: dev@dpdk.org
> Cc: nd <nd@arm.com>
> Subject: [dpdk-dev] [PATCH] doc: Clarify IOMMU usage with "uio-pci" kerne=
l
> module
>=20
> When binding the devices used by DPDK to the "uio-pci" kernel module, the
> IOMMU should be disabled in order not to break the IO transmission
> because of the virtual / physical address mapping.
>=20
> The patch clarifies the IOMMU configuration on both x86_64 and arm64
> systems.
>=20
> Signed-off-by: tone.zhang <tone.zhang@arm.com>
Acked-by: Gavin Hu <gavin.hu@arm.com>
> ---
>  doc/guides/linux_gsg/linux_drivers.rst | 7 +++++++
>  1 file changed, 7 insertions(+)
>=20
> diff --git a/doc/guides/linux_gsg/linux_drivers.rst
> b/doc/guides/linux_gsg/linux_drivers.rst
> index 371a817..8f9ec8f 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_gener=
ic``.
>     For more details see :ref:`linux_gsg_binding_kernel` below.
>=20
> +.. note::
> +
> +   If the devices for used DPDK bound to the ``uio-pci`` kernel module, =
please
> make
> +   sure that the IOMMU is disabled. We can add ``intel_iommu=3Doff`` or
> ``amd_iommu=3Doff``
> +   in ``GRUB_CMDLINE_LINUX`` in grub 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 optio=
nal
> for platforms that support using VFIO.
>=20
> --
> 2.7.4