From patchwork Wed Sep 20 14:18:46 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ric Li X-Patchwork-Id: 131743 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 18975425EF; Wed, 20 Sep 2023 16:19:42 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 447164111C; Wed, 20 Sep 2023 16:19:40 +0200 (CEST) Received: from JPN01-TYC-obe.outbound.protection.outlook.com (mail-tycjpn01olkn2073.outbound.protection.outlook.com [40.92.99.73]) by mails.dpdk.org (Postfix) with ESMTP id D00AF40ED8 for ; Wed, 20 Sep 2023 16:19:37 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cXwrVFQs9Pc4jCWo1iSPZeg9mbPjYGNR6D9UvNmtWNBoRxkFfXCMNcPnzfHeWxsV+I5odqvE4bKzva90//JqPVIaEupjoCJXN/dt7PD1v8f9d4K99HE8mvEcTGG/7PY3ez+b0YHdxENilmDOknEGQBt6kl+roihhwpVZBif7RfdhnzsYgFLCXX7XgEBy2WFbbL4dECufRSl7TKGe3p+VBHcQDMfYeHSLzDmRAsFwGghDs19IMQ3jAMlS3bruj45EO3K2xCiuHCj5ZkvjgQDu7ZoVJmNYxn16eWdPe9EP/4KYvfr/0R3xDi6PPOYCthLaCRjHyXMX0DBDgrvePcJTKw== 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=plG/4rxnehdKscV4B6aiTA+HfXwZlJQLkhhKHGxq084=; b=LncwCS4++NbLtDW1il4aNL2h9kVMrcS+pWQk94z8TtuJ8J+IercGA5YRtRRb1orQLn+TfT9QqJajzIzoI3kmYHFcM4B3o2DhVX+EuJ+Yt0LzayjOhBnbOgCURbWQ46mQHW0k5Xns5kOApvN2YqRTwXjx1LOoa5Mn+Fljuwif9OHWPdjQZMZIsgdU0YRT3QNXjgqU4bmpzFDxkHxWoFLz1CRp8sPVEUlIfedMYMy32wnluiQEZDWTMFhRsvI1gGH3MYBXYFC+rBlCtfH6tU28yPDDRNBRQ9viKzBm7AtYWqlqhMPS8Xom/EtcpABS4z2ipTpJEsxvazWTkcRF82hCog== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=plG/4rxnehdKscV4B6aiTA+HfXwZlJQLkhhKHGxq084=; b=FtOzKBpahEim8ieUJEI2aA3UVg2puff3IRcMORJ3pWV/GeH0bi6qDr2N8tdzrc0SwQGz9RPain4uAFrXI82vaIR4yXpB4YoyJitiHbdfCChRiT/KPrUOnvkLNvbcXeI5jO6piZpB4g95actwzeZAxiZ3AxkadeUAa5Aw/PPpvDXTfDJS8jfmb/Ki5swXG47LsaFAGVzYM4qKfF7gO8BajMCkM8JNFgjH/SuhBBMD4zizmdf0hC9hZktlCZ0hI/dkbfAY6UOqbL29k01cZsX15lmqdEic48ptUcoYGo6ZBJ0AEAX3YYezQHMZcI31pKH2KrZS9M7geraIVGIQxh1Zpg== Received: from TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM (2603:1096:404:8039::14) by OSZP286MB1872.JPNP286.PROD.OUTLOOK.COM (2603:1096:604:165::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6838.9; Wed, 20 Sep 2023 14:19:35 +0000 Received: from TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM ([fe80::3898:d1b2:e70:4b5e]) by TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM ([fe80::3898:d1b2:e70:4b5e%6]) with mapi id 15.20.6813.018; Wed, 20 Sep 2023 14:19:35 +0000 From: Ric Li To: dev@dpdk.org Cc: bruce.richardson@intel.com, Dmitry Kozlyuk , Narcisa Ana Maria Vasile , Dmitry Malloy , Pallavi Kadam Subject: [PATCH v2 2/2] doc: add MSYS2 building guide Date: Wed, 20 Sep 2023 22:18:46 +0800 Message-ID: X-Mailer: git-send-email 2.42.0 In-Reply-To: <20230920141846.2187-1-ricmli@outlook.com> References: <20230920141846.2187-1-ricmli@outlook.com> X-TMN: [1532IlV953n8oTUgqHcO21QLpcUPhvlH] X-ClientProxiedBy: SG2PR02CA0133.apcprd02.prod.outlook.com (2603:1096:4:188::18) To TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM (2603:1096:404:8039::14) X-Microsoft-Original-Message-ID: <20230920141846.2187-2-ricmli@outlook.com> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: TYAP286MB0300:EE_|OSZP286MB1872:EE_ X-MS-Office365-Filtering-Correlation-Id: 0990e0df-8c94-47ae-55f1-08dbb9e49d76 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 37nNkJnhkG04XAtzXF/UIfVWjjgUsGl23iJ47cOrwBPgvASK4p87ItE9KsVhUh+A0VmiyprMwSuVY46B/TJqfidWQ0zzmAReun/xiDcCdZt+vwpSp9iGW1Q0A2Ds/AK3/KV1nQYvD44n3HsMP80OBLSORUBP2HlY6NzSfUKyADWbQb6FcBp1Uc0yb2xjHQ8KXFDmHX/BQTyq72+7yxEv3pYsA4FnPWh0Usw7HyCH7j5wbE7CRJciQVAZwaVUPdne/cU6aLpVkvqDWoAMDnunv6YTNNdIWa8Ncz271PPcgJOeQb8h03ljDtswFQatThSGluOcVVTNjs6/GJuRlkgyjeGvngDFXXwnVWJtYikBr/j8YwcQDkSxgz1pYkTm+/f6SOOf3DRKqgqt6MNpGX392giqjLvCXN87BT7BFk6pKULs5k/0txZ76aINIJrmUP7KQmN9Tv042ulnqTFceogqM7lZzS/JLmetp1XYuhLrOaH2+cNdouAMScyBCxW/SQFeBX8OK8ws8ftBnWR5zanTM7DWsBXojt37xNCc9us6pak= X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: M2NKEBzpEe7/JpOm1BOaFJ+cYqtBpREjoG19g2mmCukI2szbHIm13E+F6ROf8gx/AaAjBNUbJDZqHtBFezzWPtCm/BUj27PA/VDN2lKGPu+GBSqwA7V42Niw9Gn/sMnWJE+zLLiawsEYTOPRkGgKb6veXLFIVQtGzrB7n3lQuyR2AIMu92fiGFginIEpHwv+Hx83EqTKcGPR/pLFVDBqr0rra8TUDtTCWfzxy2uigspPRNuz6lvrJmqgf+GS/vT9eSL2u4tr+ASsywPCUZ+H1bW1NahN5drj3vkyxOW68GGqc+0YdRba102CIdtIo3m0+cuNOVxNU2wD8zwCdyRl6ku0pdWn4GdAI7kMgVNoH49ZBWkDB16xiz/er43JJkEkhlZ5BPM3d31Z4EwVXQyW1BRzlh/2SUeAB+6kY5F4+X6orqD9fyGh35UooiDrKZSvCC9T8RHa9w3wMnHPYmUokinmp1Db9QSyb/kHkcrVlRwlyXsjpsCDQokxOO0LyVn05MIJTozMz7FN8LzqLvZ9mdsUm8uLoMEyTHk71Q96oIsP5AT6I1a8N73NXn0TQZPU+h7TI7qi7j4xkvPljxXAauMQ82bd7oQjAhGc++hNwmLOepuup0uHluWyiJn2lVCho8mAMiaLafwGcsUuVfpo+4Dzbvv11CTScCkJBWTS47KoWNtUW9hPHgheoWdrL6In4LCHDXNdZUpvT+RnZUMJ6iFtYK6Zb4WukfT0XebhRmJ5O7An9Z5oZ9WNeqTqHZwnTEnWYwEH/0VJWSLDerPaJqv0WdeveKx7mNfCQ17uhDkNe/ZbAPR5+3RHyfN8Ud+9bPYKIN4bu2c38iqvpmL1ZZNlt+fO6g8yr0vRB2RmPfB51+iz15pMObyf95xm+IJxsU+3U/2w97cCs5aCKTTMPx3AskHwJy4oMnzHlYKbMMmStGKxiTVPBiCnlCy9NS7tHLaXLqPcZNIl5aAbNda1hjFQXFh0n3HPd/2FOYK+LOjNz19KSTTxAcVqQq4xKmHvRrLi/duVlQDjphi7kGQt8FOhVwwLmmQnATabYfFxk2YELNk2NASpDgZkHKELRSIqXOUrE93rjFhB8o29objuAxndV140Rz4f5CexxWyZkSaTVaICOXQiLFx5XvutcPWgS3C17ezWZychhVSCPnMCDN2QIUZBLXLYSBXKhYHWrzCpZR0liiE3nPKtSmPXSLulxBxVfcYFvr0n5cPfAiyRvQ== X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 0990e0df-8c94-47ae-55f1-08dbb9e49d76 X-MS-Exchange-CrossTenant-AuthSource: TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Sep 2023 14:19:35.7195 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: OSZP286MB1872 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 Introduce guide for using MSYS2 to build DPDK on Windows. MSYS2 provides a Unix-like environment on Windows and its package manager simplifies tool and dependency installation, aiding Linux program migration. Signed-off-by: Ric Li --- doc/guides/windows_gsg/build_dpdk.rst | 36 +++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/doc/guides/windows_gsg/build_dpdk.rst b/doc/guides/windows_gsg/build_dpdk.rst index 29f2b38feb..27dff76efe 100644 --- a/doc/guides/windows_gsg/build_dpdk.rst +++ b/doc/guides/windows_gsg/build_dpdk.rst @@ -12,6 +12,7 @@ environments: * The Clang-LLVM C compiler and Microsoft MSVC linker. * The MinGW-w64 toolchain (either native or cross). +* MSYS2 with the MINGW64/UCRT64 environment. The Meson Build system is used to prepare the sources for compilation with the Ninja backend. @@ -55,6 +56,39 @@ Install to a folder without spaces in its name, like ``C:\MinGW``. This path is assumed for the rest of this guide. +Option 3. MSYS2 with the MINGW64/UCRT64 Environment +--------------------------------------------------- + +Install MSYS2 +~~~~~~~~~~~~~ + +Download and install MSYS2 from +`MSYS2 website `_. + +Follow the installation instructions provided on the MSYS2 website +to set up the base system. +Make sure to update the package database using the +following commands in the MSYS2 terminal: + +.. code-block:: console + + pacman -Syu + +Install Build Dependencies +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Open the MSYS2 MINGW64/UCRT64 terminal and use the package manager +to install the required build tools and dependencies: + +.. code-block:: console + + pacman -S git pactoys + pacboy -S meson:p gcc:p pkg-config:p + +Meson and Ninja are already installed via the package manager, +so you can proceed with building the code. + + Install the Build System ------------------------ @@ -99,6 +133,8 @@ When using MinGW-w64, it is sufficient to have toolchain executables in PATH: set PATH=C:\MinGW\mingw64\bin;%PATH% +When using MSYS2, perform in the MSYS2 MINGW64/UCRT64 terminal. + To compile the examples, the flag ``-Dexamples`` is required. .. code-block:: console