From patchwork Sat Sep 16 13:15:20 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ric Li X-Patchwork-Id: 131510 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 A1602425B3; Sat, 16 Sep 2023 15:15:58 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 2D8B240299; Sat, 16 Sep 2023 15:15:54 +0200 (CEST) Received: from JPN01-TYC-obe.outbound.protection.outlook.com (mail-tycjpn01olkn2014.outbound.protection.outlook.com [40.92.99.14]) by mails.dpdk.org (Postfix) with ESMTP id 88B694026A for ; Sat, 16 Sep 2023 15:15:52 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lKNYekktKEO0sQ9B1TANnCsO4T1IFwVBswOon6MKnWd2kf2T1mvhsvJ+NvIE1ZcB/diUWSLnvoLqyplnkyj7H4dhPoxNcD8XttFPH0DmLCWkMbGjFUexBY6nyHe3ygVxJZEFsyw7mc6yxEzFG88ms+MBcTrn0K4gGgvWSN3CZE1h+KnTHNMmdzOeXZ23EsF6deBfpYk6VNQ98sPU2oCr23P3h8FWpbd4O0BihTlJy8lDs2znW2OQZ29iMg23iyUShmxLF6QLsljSeekqA7HjihcyzWm3Evf65U4wkl0dJMWlCI5ktw2XRSR4H6JfMZZxa23li77FzH+iAa4MD7tXkg== 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=ErW9dsHt2PRYMpmPbafjMt9NWg1OFIqp/NH6k4Mdr8sCwv0uUEEcbhV2VaPV7w8/wCIsnJsvIREu2kmRWlqhrs6pWcLJF5hJc3uMZWh/kmmNBIGQqUGNYOE/SFpJy0CaI9g8EZYCfWcG2kKpGRFEmsoRRXAJK7uMy05jc5mUGFN91ojI3uMb28QZbhiFuzkT5GcjfLx+t2Z7z8LbwBChagPWvNiDcOcoudi09Lbiv6LA6DLUwTLFNuJhLgnyCFMfGVqlKpxGjIhwANIJ4IGnIEnEnT3szPF/yvZ6j0bgkpFmQoHNPgJGIViTfXZkl58EqpUY6PUmZnsPh8hNzHbG7A== 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=Qp3eaLg8eAwTerpdXCWy8SnyEbeHql6+hmVabcdnoW2FEkG31iZFOATukbi3PSAESVgvOKUl01eqLZXPQ79O8QN5+cYaMCwTxCtHxJQMPlH3eF+p1yAxKOUbHjWcFrcM2G83oa3GgBfSpe41/wDmzCUKqofBNqNkri1KEf+AdvfBSpYWHnfQ8PG+sLIK/ob4OVX0uNfr9AHLPfDYPFsEWeTQbVihyZ0cG6IhSwesJTa+726M9PaAljGqRl6sJPebGuVm72IUrSKnYo3qrZw3NtA+hNQxCp7ZwbbVa0UZe4ugESEMtktOnwe2n89dWgP0As0oTdkP0se+bvvdmLpCNQ== Received: from TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM (2603:1096:404:8039::14) by TYWP286MB3786.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:400::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6813.12; Sat, 16 Sep 2023 13:15:50 +0000 Received: from TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM ([fe80::5cc3:f4e1:628b:7520]) by TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM ([fe80::5cc3:f4e1:628b:7520%7]) with mapi id 15.20.6813.012; Sat, 16 Sep 2023 13:15:50 +0000 From: Ric Li To: dev@dpdk.org Cc: Dmitry Kozlyuk , Narcisa Ana Maria Vasile , Dmitry Malloy , Pallavi Kadam Subject: [PATCH 2/2] doc: add MSYS2 building guide Date: Sat, 16 Sep 2023 21:15:20 +0800 Message-ID: X-Mailer: git-send-email 2.42.0 In-Reply-To: <20230916131521.2217-1-ricmli@outlook.com> References: <20230916131521.2217-1-ricmli@outlook.com> X-TMN: [obZd7MJPJ9qttwZKtAXEZN27R9XpVXwZ] X-ClientProxiedBy: SG2PR03CA0094.apcprd03.prod.outlook.com (2603:1096:4:7c::22) To TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM (2603:1096:404:8039::14) X-Microsoft-Original-Message-ID: <20230916131521.2217-2-ricmli@outlook.com> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: TYAP286MB0300:EE_|TYWP286MB3786:EE_ X-MS-Office365-Filtering-Correlation-Id: 1e5d3e34-3782-436c-c18c-08dbb6b70bec X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: sH7iFBdAj4Y1asVmvGAZmOD8LD2NWh+k8iegscSPku5qg1zkpDwvBGp79/Vw0vwcxx5iuEz8lAkuLFCXoThzYPx4vpwalzYDMNcSolO09af4Vb8dZgn0My83Fx+LMO5Q303+zTlA+njeZEEX4lTK7ybwmGXmKdXHBpoWklO2ohmGtT2OZR+lqcaEXjgtJkbYTrsKE7uP5swlWf9UX5B/YpRDWR825cSqQn6BvC6bDLRmLrKE1sapWwhS86bRHUET+fmUAFDEZ7YXdhSfw6ZZRqI0Ix5+xgRqXYPN3+O4NKPhL9zx6WRdm+z9gWkzO2n90TvSNtoDA4TcrvYSGvkt9DfbgaTTPfPZbH2g1PA99nunDCFOiWwVWekc4skoaOUYKUVyt4BxiIzHs9lhEq07ttBDsS28z9GOKaQ5YJxT+XWIGAWeMFNzYOV0/CJtE96SCPXzQXXj9OnQJyhl9iRvzB9w2IdDl1moadJtkN6w9r6TDVA8osSNFfHTseRlAQLDGCnE+ISxxLephrcvE+8btngKbp0JZy2xBJNwlNwEgB4= X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 4Nl7fWRAJdXPedbGkE+ZVK6sNRu4dtYtVQCQi71FmTkcUryVHjpqD2C1EcDhyiy/GmMj93AAYtHEn7l0OaHPPOPark6yTe/rRKYWnWExylKEV2zdUIaFgnACz+h4eFwJhrFnBV5jGrqh3ju36+i8fZJ/+oprg7epox8cbu0QG82HLb3h9tS6PkRM+Xe8UeVoDedoUuPEod5Ar/2AfigGnlV47md37H7HaOZyrNnxlbnN2ZatJWkMcEywHkgo3B9Axi1NurzKdF4OoGz2QoV+UEWib1FcYpw7rEFpZ3ha3eVz7aE7IQuCuNsxOtgSeUS396UMOkWIU2yu9fInrmN5bk5ZIZIIbpEQom5zrlOiYxRifhW7+VqISX9AikXhqOUwPSXEjkSZeixFKxkeyvUel66z+n4HhDCNAgYQWWwGs2kQHNZmTPtSVPXHb52x8Vj59xWatFKdD1sqb4Vu7c8W1CgNlAEGIASf1lk8KeeWrvrnbLscqWQzcA0e90jBYfcb0mi/BHt/GP4tF/TtzYiWhkCh1jDdeCFBdP4GNZZyzLAu6UXMtyupv+ZdchaZYG2Z766xW6IyG9XpC02W9Ly7ZmcJDtTvzWzaDvGQGWc24uZEKu/8njoJwfvHPcNsZpiPAmDOXS/cD7Go3VTtED28LDL4HKrTvMp1cxRdv6HoSA0RNtzcMKGqRppgULvtwoUckmd/kLCUH6I9MkMlXMfDz3rcdMVT3BLOtI6r/msYPqXBDdb1/6P6+HQ++YeXixt8/XD9hNYnyF/MmxxM4Gazilp9oA1qmRTGAnufRNG62PhfD/U54Wurj+9SFyrRQYDG+rg8NiQsW0OBZ3K7qbwtJftpFO+HArMi68xcSWChzL/9MaX6f+Sc0c/RrNB0ixJbVL5j/OU/Oz7UzsOqO8oW+gC4dc7T2zjeAwNkqSXgmu59qTNRuInOVLjZb9ZVtBuAaO5feQDpm6mLyaMiHSPu2vrxrowsm4Rq6R7ifz5JTKXCHzhRml5noyl53735kHzRL+n+fVtSeAVPYGHmUxyRYf2MhJf1Sa/IEk5zqPMHzaZ2bcsWAdBz0Vu1lC1STNJ+kft9rqtMqxkIyOm+2H11UW5R9VmKntiA+4r9tD0pWinXsnQDK7XnqL9SZ7bUhjygKNNSvYRdlV8EreBQ3pwFDKwY39nv/XSN+SQqfXi6Er9pryaT/+64pkmsyGG7tPveL++I8B0Rb2XEJOF7tUxv3g== X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 1e5d3e34-3782-436c-c18c-08dbb6b70bec X-MS-Exchange-CrossTenant-AuthSource: TYAP286MB0300.JPNP286.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Sep 2023 13:15:50.0413 (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: TYWP286MB3786 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