Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/65614/?format=api
{ "id": 65614, "url": "http://patches.dpdk.org/api/patches/65614/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20200206064426.45697-8-dmitry.kozliuk@gmail.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20200206064426.45697-8-dmitry.kozliuk@gmail.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20200206064426.45697-8-dmitry.kozliuk@gmail.com", "date": "2020-02-06T06:44:26", "name": "[v2,7/7] doc: guide for Windows build using MinGW-w64", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "a5600902e00b0bd0e2e331fed2946ce6ca664b23", "submitter": { "id": 1581, "url": "http://patches.dpdk.org/api/people/1581/?format=api", "name": "Dmitry Kozlyuk", "email": "dmitry.kozliuk@gmail.com" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20200206064426.45697-8-dmitry.kozliuk@gmail.com/mbox/", "series": [ { "id": 8442, "url": "http://patches.dpdk.org/api/series/8442/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=8442", "date": "2020-02-06T06:44:19", "name": "MinGW-w64 support", "version": 2, "mbox": "http://patches.dpdk.org/series/8442/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/65614/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/65614/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id EBD09A04FA;\n\tThu, 6 Feb 2020 07:46:13 +0100 (CET)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 347101C114;\n\tThu, 6 Feb 2020 07:44:50 +0100 (CET)", "from mail-lf1-f68.google.com (mail-lf1-f68.google.com\n [209.85.167.68]) by dpdk.org (Postfix) with ESMTP id A4D851C0BC\n for <dev@dpdk.org>; Thu, 6 Feb 2020 07:44:45 +0100 (CET)", "by mail-lf1-f68.google.com with SMTP id n25so3292215lfl.0\n for <dev@dpdk.org>; Wed, 05 Feb 2020 22:44:45 -0800 (PST)", "from localhost.localdomain (broadband-37-110-65-23.ip.moscow.rt.ru.\n [37.110.65.23])\n by smtp.googlemail.com with ESMTPSA id o19sm939669lji.54.2020.02.05.22.44.44\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Wed, 05 Feb 2020 22:44:44 -0800 (PST)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;\n h=from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding;\n bh=T+BJHT9aLjhplHlmKvEnoRrPkDvHR4a9vEMOo5TQDKc=;\n b=GVAGOePWw3U3eGhD3Kfhzj/AQ++pdWAqUAgoG4KSjpiGmy0tRMdtj1eIBPQkHTTElR\n AiIEa4DjT8wyYhrgn/SpPoyZpjBRWttzdKvuKqP8bZfmW6LrVjUvITsS/QOhRkSnV4V5\n PHHSVNt3WAaMWApDdUh/tk+O8Vi+ny+9riAv3BKYHUA1Y/J8w5+qND6+uTW9NzfJWSsl\n KZ48jKjO7uJQd7stqL2FiwEkx0wDgM/sivHbsXPb52hxFCGdApqO+RJhtA7xsa/zxj0q\n UcR0OYj2kDnDKyFYyAvds9pduatI9X+4v1bn5r6XNj0m1tNJ5sqApsJx/XD/JcUR8oYm\n xHSw==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20161025;\n h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n :references:mime-version:content-transfer-encoding;\n bh=T+BJHT9aLjhplHlmKvEnoRrPkDvHR4a9vEMOo5TQDKc=;\n b=h1kBaPeV1220s/0K8LEiPe5pUjXTjopXk89rgrGwdMD8E1N6rLS1lwZxOQ2Sjp84c+\n cXLxcnUnKLJGSuW/9NIxpvWqkc6HkBkZhnrmhalMJlBSXld6waJd7O+z7Z+OhDEOYOtp\n SAIwn2igBTNgNiCNqBwO1ySZLP7kSUBNAW1KZ317aSBBiwADhxuASvqAm+sRE1v+2BtG\n EcWBuVbkItXUG43hkPji5aWspEX3S2DCv6pDwb8f4fUfOikFUeTtuoJtiC2gvYAt8GAF\n 5svcs8kS+mKU5XJKWvHpfp44p6HoXlQmDOeO6QE/7xUenQUYXc70gg/etREaIb8M4icy\n oeng==", "X-Gm-Message-State": "APjAAAWkDYaLeU4fizwzePFq/kxRrNj4oWwa+Tw++iH4clC2d/soYsN0\n PrFm4VXI8JJcyjvma5RUNYcp0nSQxfQ=", "X-Google-Smtp-Source": "\n APXvYqzKwbe9GUCZsg0fFQKLJ52uEkPucEgKcSSFHZeGM9n9U3npILqO7/VpHdKXpPzgeW4yKxtoKA==", "X-Received": "by 2002:ac2:4436:: with SMTP id w22mr903460lfl.185.1580971484884;\n Wed, 05 Feb 2020 22:44:44 -0800 (PST)", "From": "Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>", "To": "dev@dpdk.org", "Cc": "Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>,\n Harini Ramakrishnan <harini.ramakrishnan@microsoft.com>,\n Omar Cardona <ocardona@microsoft.com>,\n Pallavi Kadam <pallavi.kadam@intel.com>,\n Ranjit Menon <ranjit.menon@intel.com>,\n John McNamara <john.mcnamara@intel.com>,\n Marko Kovacevic <marko.kovacevic@intel.com>", "Date": "Thu, 6 Feb 2020 09:44:26 +0300", "Message-Id": "<20200206064426.45697-8-dmitry.kozliuk@gmail.com>", "X-Mailer": "git-send-email 2.25.0", "In-Reply-To": "<20200206064426.45697-1-dmitry.kozliuk@gmail.com>", "References": "<20200206064426.45697-1-dmitry.kozliuk@gmail.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Subject": "[dpdk-dev] [PATCH v2 7/7] doc: guide for Windows build using\n\tMinGW-w64", "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>,\n <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>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "Instructions for different toolchains presented as options on the\ncorresponging steps of the guide, so that common parts may be reused.\n\nSigned-off-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>\n---\n doc/guides/windows_gsg/build_dpdk.rst | 65 +++++++++++++++++++++++----\n 1 file changed, 56 insertions(+), 9 deletions(-)", "diff": "diff --git a/doc/guides/windows_gsg/build_dpdk.rst b/doc/guides/windows_gsg/build_dpdk.rst\nindex 6711e07e2..6d093d235 100644\n--- a/doc/guides/windows_gsg/build_dpdk.rst\n+++ b/doc/guides/windows_gsg/build_dpdk.rst\n@@ -7,15 +7,22 @@ Compiling the DPDK Target from Source\n System Requirements\n -------------------\n \n-The DPDK and its applications require the Clang-LLVM C compiler\n-and Microsoft MSVC linker.\n+Building the DPDK and its applications requires one of the following\n+environments:\n+\n+* The Clang-LLVM C compiler and Microsoft MSVC linker.\n+* The MinGW-w64 toolchain (either native or cross).\n+\n The Meson Build system is used to prepare the sources for compilation\n with the Ninja backend.\n The installation of these tools is covered in this section.\n \n \n+Option 1. Clang-LLVM C Compiler and Microsoft MSVC Linker\n+---------------------------------------------------------\n+\n Install the Compiler\n---------------------\n+~~~~~~~~~~~~~~~~~~~~\n \n Download and install the clang compiler from\n `LLVM website <http://releases.llvm.org/download.html>`_.\n@@ -25,7 +32,7 @@ For example, Clang-LLVM direct download link::\n \n \n Install the Linker\n-------------------\n+~~~~~~~~~~~~~~~~~~\n \n Download and install the Build Tools for Visual Studio to link and build the\n files on windows,\n@@ -34,6 +41,15 @@ When installing build tools, select the \"Visual C++ build tools\" option\n and ensure the Windows SDK is selected.\n \n \n+Option 2. MinGW-w64 Toolchain\n+-----------------------------\n+\n+Obtain the latest version from\n+`MinGW-w64 website <http://mingw-w64.org/doku.php/download>`_.\n+On Windows, install to a folder without spaces in its name, like ``C:\\MinGW``.\n+This path is assumed for the rest of this guide.\n+\n+\n Install the Build System\n ------------------------\n \n@@ -43,6 +59,14 @@ A good option to choose is the MSI installer for both meson and ninja together::\n \n \thttp://mesonbuild.com/Getting-meson.html#installing-meson-and-ninja-with-the-msi-installer%22\n \n+.. warning::\n+\n+ Meson 0.53 has `issue #6431 <https://github.com/mesonbuild/meson/issues/6431>`_\n+ that prevents cross-compilation and another linker issue with Clang\n+ (`workaround patch <https://github.com/mesonbuild/meson/pull/6483>`_).\n+ Meson 0.47.1 is recommended, Meson 0.52 can also be used if new features\n+ are required.\n+\n Install the Backend\n -------------------\n \n@@ -56,23 +80,41 @@ Build the code\n The build environment is setup to build the EAL and the helloworld example by\n default.\n \n-Using the ninja backend\n-~~~~~~~~~~~~~~~~~~~~~~~~\n+Option 1. Native Build on Windows\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n \n-Specifying the compiler might be required to complete the meson command.\n+When using Clang-LLVM, specifying the compiler might be required to complete\n+the meson command:\n \n .. code-block:: console\n \n set CC=clang\n \n+When using MinGW-w64, it is sufficient to have toolchain executables in PATH:\n+\n+.. code-block:: console\n+\n+ set PATH=C:\\MinGW\\mingw64\\bin;%PATH%\n+\n To compile the examples, the flag ``-Dexamples`` is required.\n \n .. code-block:: console\n \n cd C:\\Users\\me\\dpdk\n meson -Dexamples=helloworld build\n- cd build\n- ninja\n+ ninja -C build\n+\n+Option 2. Cross-Compile with MinGW-w64\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n+The cross-file option must be specified for Meson.\n+Depending on the distribution, paths in this file may need adjustments.\n+\n+.. code-block:: console\n+\n+ meson --cross-file config/x86/meson_mingw.txt -Dexamples=helloworld build\n+ ninja -C build\n+\n \n Run the helloworld example\n ==========================\n@@ -87,3 +129,8 @@ Navigate to the examples in the build directory and run `dpdk-helloworld.exe`.\n hello from core 3\n hello from core 0\n hello from core 2\n+\n+Note for MinGW-w64: applications are linked to ``libwinpthread-1.dll``\n+by default. To run the example, either add toolchain executables directory\n+to the PATH or copy the library to the working directory.\n+Alternatively, static linking may be used (mind the LGPLv2.1 license).\n", "prefixes": [ "v2", "7/7" ] }