From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id AA4E542DD8; Wed, 5 Jul 2023 15:39:17 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 344E0406B5; Wed, 5 Jul 2023 15:39:17 +0200 (CEST) Received: from NAM04-DM6-obe.outbound.protection.outlook.com (mail-dm6nam04on2046.outbound.protection.outlook.com [40.107.102.46]) by mails.dpdk.org (Postfix) with ESMTP id CD7B54021F for ; Wed, 5 Jul 2023 15:39:15 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=G/Ql70eIjwwrafO1cxAqTB8g/wYnLSAaw0GC0UldhJ4Kd6rIkHsI4jgbt1f+lAmkcEbono/FOzg68rV8kufnKnZrXhCdVAFoEq/iulIr+ebnw1LCz7DUZD4zwNfOoQ+7zJFf8KfYZ5MvQLgdoDe3Nidtkon8C3Ka7u+KZoWkqjDjUtF2Zqp+vNHG9ZJVwJAfFz1fFnMO0Xcbv+APhefAtsYFDn9hRyF3Hlhur5DBo/TFmTAtFHER6gGEk0rsZn/3mV0sTj7Wv7/qZ4P56um//Uut/5eS4yIOwbS25UvXika6jdGsRWMCsxfwtPLys2IQlLwgy4U1Nnno0TWxOYQLgQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=VUX3zRFo/NoLoIyyVLysKHlr3JGYliLlUHEG829uMGU=; b=QHpH2Rl27K1OhNosQr9ylbgsPbSqsroSSFxUjrKKH/GspV3syHAnTePabVDi6qAhUffbHKaXc3Ac1E9HMVzt/BeZ6/zlc8RKY4w5WeMaZtA/rgw/Absv+DHfzsDGPwjBN2P8twItOIxU07H1ft+QCEtcG8p50Txg1lLKQFt4sJf3p3mh4zKfN9kWPlRQC5UquUvMaZXNeqE/1bHOZ5ORkOU0Lm30PKGyHhOm31IpXfttefZeo8sd5rpYRU9XG8aFg+HwP998krF3CwO8ijbbfYUO3MI9XjjcltKafSHPf3RX554KlS5CG+5wAcKWg5YOn81wJWCA2ioIi0f+rkPiWA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=dpdk.org smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=VUX3zRFo/NoLoIyyVLysKHlr3JGYliLlUHEG829uMGU=; b=3+BwnLZSexzjsrhmrslfUT9dWaTy2klhAVO5mQwZX1gpmIZG+GIt8uGDEFGRVA6CFRdnOJy7bFLU+7e3R0QyFy52wugk8TxW5sZxmw8c0m4VT8H6DpY789raeVJnlx/lWlHTuH4tYpkFvosB9iMu+/lK3dwUu9J7kMwWQvsVHU4= Received: from MW4PR03CA0044.namprd03.prod.outlook.com (2603:10b6:303:8e::19) by CY8PR12MB7436.namprd12.prod.outlook.com (2603:10b6:930:50::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6565.17; Wed, 5 Jul 2023 13:39:13 +0000 Received: from CO1NAM11FT003.eop-nam11.prod.protection.outlook.com (2603:10b6:303:8e:cafe::a0) by MW4PR03CA0044.outlook.office365.com (2603:10b6:303:8e::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6565.18 via Frontend Transport; Wed, 5 Jul 2023 13:39:13 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB03.amd.com; pr=C Received: from SATLEXMB03.amd.com (165.204.84.17) by CO1NAM11FT003.mail.protection.outlook.com (10.13.175.93) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6521.45 via Frontend Transport; Wed, 5 Jul 2023 13:39:13 +0000 Received: from SATLEXMB08.amd.com (10.181.40.132) by SATLEXMB03.amd.com (10.181.40.144) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Wed, 5 Jul 2023 08:39:12 -0500 Received: from SATLEXMB04.amd.com (10.181.40.145) by SATLEXMB08.amd.com (10.181.40.132) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Wed, 5 Jul 2023 06:39:12 -0700 Received: from xhdipdslab41.xilinx.com (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server id 15.1.2507.23 via Frontend Transport; Wed, 5 Jul 2023 08:39:10 -0500 From: Nipun Gupta To: CC: , , , , , , , Nipun Gupta Subject: [PATCH v2] doc: add information to update dma entry limit Date: Wed, 5 Jul 2023 19:09:07 +0530 Message-ID: <20230705133907.7735-1-nipun.gupta@amd.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20230705105307.5495-1-nipun.gupta@amd.com> References: <20230705105307.5495-1-nipun.gupta@amd.com> MIME-Version: 1.0 Content-Type: text/plain X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1NAM11FT003:EE_|CY8PR12MB7436:EE_ X-MS-Office365-Filtering-Correlation-Id: 875e099f-6c66-43b8-b8ee-08db7d5d389c X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: YEIb8lj/gCnh5XDunsS3uyY6H7myVa77d+WKTl7YJenJ2RvjrndwcXfBzqfV6dRTHZKPthHQXGxi6bapFz3KxTmyHbFyJwfEAX0YfzT8eoliMLyiE01y1hCc5w8Okn9tXLcnB890IV5DYmb6yaONyVR9i06qfQnHWYG2lOzdE4crUQ0CQsfpt0tW3NXBGpwJltEU2e6fYT5GmKe29HGhmAKWcI04Pxt9EkM8UlJz2kJdQC4vq1uY7rUhExVnwLgNEInETiL9spwTwx2ldlY1ZgeoRamC+QJTxThWlZd+Iwsk8GzSG25jjuSK4dXXw1E1cgT8ZgWNMnBznVm5KhGAQIxWdhwM4hk42SMOhlY3WzutOhkZPdZv2HBxvsrR9wYAH0OVJna2stj/azWXbzPn0orxnMNpj/2sgSZEfAOwsceBPsn6dmlnz3SJZvCPBspJ12nYlUaODZ9IKmlQo1OL17ZYyvkjwyobUAJVaKZYKTOhoLKr91DuPVp1wWEHUH2e2U+T/K0Xw5n6s8EHstxemQwe+S386IYfDXUqnBHhdHdLKkhfmjKtv/AVf9NxPynyEvj66P+3xZH/Kx7LXoubKHpDdmH/n8GEmWZwe8alR8+Izkq5iXaxFJeTATCaeb2Yc4fBTwZrh+c7RRfZgGqqwbQYKrT7EnuUwrnJn6sExFqfTHbvBW7o2pOpQDDN9Tcf37gOlPUibNX2Aidq4zQlyjeOmMHjIUcPKl2Qb8LSOmozSHAPbMONLvapZZGjXGc/8sFavgD/SOhmoXjG5NGpUA== X-Forefront-Antispam-Report: CIP:165.204.84.17; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:SATLEXMB03.amd.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230028)(4636009)(39860400002)(136003)(346002)(396003)(376002)(451199021)(36840700001)(46966006)(40470700004)(6666004)(478600001)(70586007)(54906003)(36860700001)(83380400001)(47076005)(2616005)(426003)(336012)(36756003)(86362001)(40480700001)(15650500001)(82310400005)(2906002)(186003)(70206006)(1076003)(26005)(81166007)(356005)(40460700003)(82740400003)(6916009)(4326008)(316002)(41300700001)(8936002)(5660300002)(8676002)(44832011)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Jul 2023 13:39:13.6720 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 875e099f-6c66-43b8-b8ee-08db7d5d389c X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d; Ip=[165.204.84.17]; Helo=[SATLEXMB03.amd.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT003.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY8PR12MB7436 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org VFIO module provides configurable dma_entry_limit parameter to store the DMA entries. By default this is 64K and if we are using --no-huge, we shall need to increase the value of dma_entry_limit. Add commands in linux_gsg document to change the dma_entry_limit. Signed-off-by: Nipun Gupta --- Changes v1->v2: - updated param 'no-huge' to '--no-huge' in documentation doc/guides/linux_gsg/linux_drivers.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/guides/linux_gsg/linux_drivers.rst b/doc/guides/linux_gsg/linux_drivers.rst index 2cec1ebede..b729bb38a8 100644 --- a/doc/guides/linux_gsg/linux_drivers.rst +++ b/doc/guides/linux_gsg/linux_drivers.rst @@ -180,6 +180,21 @@ VFIO module parameter ``dma_entry_limit`` with a default value of 64K. When application is out of DMA entries, these limits need to be adjusted to increase the allowed limit. +When ``--no-huge`` parameter is used, the page size used is of smaller size of +``4K`` or ``64K`` and we shall need to increase ``dma_entry_limit``. +To update the ``dma_entry_limit``, ``vfio_iommu_type1`` has to be loaded with +additional module parameter: + +.. code-block:: console + + modprobe vfio_iommu_type1 dma_entry_limit=512000 + +Alternatively, one can also change this value in an already loaded kernel module: + +.. code-block:: console + + echo 512000 > /sys/module/vfio_iommu_type1/parameters/dma_entry_limit + Creating Virtual Functions using vfio-pci ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 2.17.1