From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR02-HE1-obe.outbound.protection.outlook.com (mail-eopbgr10070.outbound.protection.outlook.com [40.107.1.70]) by dpdk.org (Postfix) with ESMTP id 6787928FD for ; Wed, 5 Sep 2018 07:23:24 +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=9KKCv4GbDfF7VmroXxpD94FjBfEkcOUNwdnSeNjicY8=; b=DH8KMD0MFpsKPuVfYr5ykVBqUfrZ+6/NrZqkoqEhu6W2avg3zdraQ6AujEwvx7HaGhapD3cmESwcE2m/88LnCCWQ7yWRVHpT4AUHd0eGQkYFsFTnvhnWnnqlZElY121yL60CcnW+DEFzYUWvDRUlHKNyp5hXSEMGfYp8sPWkZeY= Received: from VI1PR08MB3167.eurprd08.prod.outlook.com (52.133.15.142) by VI1PR08MB0352.eurprd08.prod.outlook.com (10.162.12.147) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1101.17; Wed, 5 Sep 2018 05:23:21 +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; Wed, 5 Sep 2018 05:23:21 +0000 From: "Gavin Hu (Arm Technology China)" To: "Tone Zhang (Arm Technology China)" , "dev@dpdk.org" CC: "bruce.richardson@intel.com" , "bluca@debian.org" , "roszenrami@gmail.com" , nd Thread-Topic: [PATCH v3] doc: Clarify IOMMU usage with "uio_pci_generic" kernel module Thread-Index: AQHURNfH0lLTNoolG0m5jWhvOWK8saThJxsg Date: Wed, 5 Sep 2018 05:23:20 +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: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: spf=none (sender IP is ) smtp.mailfrom=Gavin.Hu@arm.com; x-originating-ip: [113.29.88.7] x-ms-publictraffictype: Email x-microsoft-exchange-diagnostics: 1; VI1PR08MB0352; 6:Zs011PQ+3THS6Uwnkaqd4HeOjhrzCuE1F9RGl9LCIHn3DaTNfvkhjeTdJdjgnwMa9yXb6qEY5AguQctYGqYTUG+u5mZLPfg6FiHOu6gchnJwmgErPYhVNM9eIeXWHKKksBHY5ldf1lt2r96lcb4RuK6OCdHyjN7rl88ljiXaSl4kdIqTOVyMiS87Ea9vx0ClYxumWTn+hEI0zK5M8vCUXJ+klwDFfX/IbK/grZ55aJ93/NEf42tU4jRDvvNFMYQcqAjXzPIP40J1qgMyUTqMSBJ0pE3K14LECEnSbQ8yndQ0tJsCj8JavQ76h8X0ZEzg/e5H4kFanUJ6+JaiN0cN/otHX1Dflv/Ak7OcG4DERpyhbW5KQ3T4fgTUt4HiCfVLCCx09n3vWTXL3UY7NjaBCkW5xMtJRW+1SNIfCyuycT/Vv7iEsjhCHiC2MgeWyb+kVdXWHV3L2u6fNRgFrD2fFg==; 5:UatQ39hQbiDo/vUSAX5EUTFewRRONEY9isqUTQFHMQBmAuCWxa2hboabQOHNdi7TGf58TAmx8vDlK+iwa6+MJ78B7qIFiwpXL/b17FC3QruuZ0f7V1wfQPOsVP+7iO0ACNNJdKVkAFYAefsSDEoqqHhBWLEt9azmG4Qn1tkSTc8=; 7:bYuxlHqlmslwHOS2kZnhtYjZTog4V0nb2//5T/+Q7fCZPmdataiVZGXAjiWbe8lF3jcB2UZpyVqLogWG68iWjLzkpPYptHpLmPK15XJi6xFFYtQKw8kdepRazwR0HpDBSxXnfSDW5vkWFgFMT2J4TPIsNpsMPAhUh6g6Us7w2uxI0X0LMDTsXbt1UAIGhp3HVaE5sRgccQNakH7zMcjDnPPXQDl35P+a6KU9FhaxkSX6NKjX46r8Rxs4ogncfToG x-ms-exchange-antispam-srfa-diagnostics: SOS;SOR; x-ms-office365-filtering-correlation-id: 5f0d753f-fcbd-44ba-0389-08d612efb1fc x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989137)(5600074)(711020)(4618075)(2017052603328)(7153060)(7193020); SRVR:VI1PR08MB0352; x-ms-traffictypediagnostic: VI1PR08MB0352: 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)(5005006)(8121501046)(823301075)(93006095)(93001095)(10201501046)(3231311)(944501410)(52105095)(3002001)(6055026)(149027)(150027)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123562045)(20161123558120)(20161123564045)(201708071742011)(7699016); SRVR:VI1PR08MB0352; BCL:0; PCL:0; RULEID:; SRVR:VI1PR08MB0352; x-forefront-prvs: 078693968A x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(346002)(136003)(396003)(366004)(39860400002)(376002)(13464003)(189003)(199004)(6436002)(54906003)(33656002)(81156014)(229853002)(11346002)(486006)(316002)(8676002)(74316002)(53936002)(476003)(14454004)(2900100001)(2501003)(478600001)(256004)(14444005)(9686003)(305945005)(97736004)(7736002)(55016002)(66066001)(99286004)(8936002)(3846002)(72206003)(6116002)(6246003)(53546011)(81166006)(110136005)(86362001)(5660300001)(7696005)(76176011)(102836004)(105586002)(4326008)(2906002)(106356001)(26005)(68736007)(39060400002)(5250100002)(6506007)(25786009)(446003)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR08MB0352; H:VI1PR08MB3167.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: 5Upf12GQbq2FasNAFvl6/l5B0okyShM0lng7kyIRv+cFe632eobRPSLwXhRm58RD+lmmFuVzUQcinGaIFqSrTamUGgxtHapE9mydFr26Kg60BGUl3ArIVkzlcnOuAtKXlOGYvY/kBWGwf3QA73IV+y5dC445t2erbbMoDr7PxbqE8Xb/4PH/xTUkbSaNFz2Ba6lIgE/BejOq4o/RJj5PO4D5/UR5D+ueYNU6S2q5+koMqIn/N/s6GCxqh5qUc1aeyIwFXehbAAjz8BTplAkqaJjUn9f/8EJOQUzjT4Rvi1c6NFa0kFwa2wZ2P1JjvL8dXr7MVI+3aKdBWV6R5VgYETHOi6q/3MDHB4AfKyI3qso= 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: 5f0d753f-fcbd-44ba-0389-08d612efb1fc X-MS-Exchange-CrossTenant-originalarrivaltime: 05 Sep 2018 05:23:21.0664 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB0352 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, 05 Sep 2018 05:23:24 -0000 > -----Original Message----- > From: tone.zhang > Sent: Wednesday, September 5, 2018 1:18 PM > To: dev@dpdk.org > Cc: Gavin Hu (Arm Technology China) ; > bruce.richardson@intel.com; bluca@debian.org; roszenrami@gmail.com; nd > > Subject: [PATCH v3] doc: Clarify IOMMU usage with "uio_pci_generic" kerne= l > module >=20 > If the devices used for DPDK are bound to the "uio_pci_generic" 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 configurations on both x86_64 and arm64 > systems. >=20 > Signed-off-by: tone.zhang Acked-by: Gavin Hu > --- > 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..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_gener= ic``. > 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`` ker= nel > 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 optio= nal > for platforms that support using VFIO. >=20 > -- > 2.7.4