Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/65405/?format=api
{ "id": 65405, "url": "http://patches.dpdk.org/api/patches/65405/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20200131030744.19596-7-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": "<20200131030744.19596-7-dmitry.kozliuk@gmail.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20200131030744.19596-7-dmitry.kozliuk@gmail.com", "date": "2020-01-31T03:07:44", "name": "[6/6] doc: guide for Windows build using MinGW-w64", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "1a922db02f6a322a05c64ca66020232d777e4dce", "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/20200131030744.19596-7-dmitry.kozliuk@gmail.com/mbox/", "series": [ { "id": 8371, "url": "http://patches.dpdk.org/api/series/8371/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=8371", "date": "2020-01-31T03:07:38", "name": "MinGW-w64 support", "version": 1, "mbox": "http://patches.dpdk.org/series/8371/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/65405/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/65405/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 51F2EA0524;\n\tFri, 31 Jan 2020 04:08:53 +0100 (CET)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 643B41C0D8;\n\tFri, 31 Jan 2020 04:08:05 +0100 (CET)", "from mail-lj1-f195.google.com (mail-lj1-f195.google.com\n [209.85.208.195]) by dpdk.org (Postfix) with ESMTP id A15C31C0B9\n for <dev@dpdk.org>; Fri, 31 Jan 2020 04:07:57 +0100 (CET)", "by mail-lj1-f195.google.com with SMTP id q8so5620464ljb.2\n for <dev@dpdk.org>; Thu, 30 Jan 2020 19:07:57 -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 e12sm3630332lfc.70.2020.01.30.19.07.56\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Thu, 30 Jan 2020 19:07:56 -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=kYup3UILgKLePgHKM51+bveaaI7180cEgRh4dsMKBa4=;\n b=mP/KPbSzsLjC2pdTwYUzpiVZ7/T8SDzM6PPQD9WQvEororD2VRTSZ3CnF5TBeP/pI1\n fdijYAgpcNFiAspiceFTnvsKBVAnKx/WaKk0R2iSadOMFtwAaU6r7XKnq0SneI89OmOO\n QzitjZ2P6vU6f9XuOBEVu3Emb6NqDgQG0rvbIjjmI3dLaHVp1O4P6kwRJLlGIq1APxag\n WmKCK/ZnqveJJgMH8sCi2gvvNmBz8BvbmNhJDiayWrmUmyBkCDWtRZDNbfLT3Ry05/wD\n BGY8oceSP6NRxoMlArwCz9rw/dr4K9AzUnUZKKaOKf+BY+CZD+qd5op8souljOgkNcFa\n nRZA==", "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=kYup3UILgKLePgHKM51+bveaaI7180cEgRh4dsMKBa4=;\n b=l73+uHXfRPOsqBj260fZhsLeh5ms5YfRzx6150gIgjruuKbG2PCu0DwTsSOPi99fgw\n HtQeVC9LPyk9HV3D4BoiqdaFPM0bQdcvyOgf/+5cdZAKf3RPRDg6hhz5Ln8BE0+ODjv7\n AQri4HYLNkSwy02sGco5cA7EL3QIjArHny+4MIwIEhWdguHp2ulSO8cRs43Q1gRMFDMj\n ryuBv9Es+pM22Vq9NU+kmHwei5WGSi358+ihMUF3acC/QKR/IRV0LYQCnpDTmwosGSFN\n 2iB5zRUHiZpo7xmktWrtF8sMFLk/2pV069qINvf9TxlBUfCTKoToRs5NjOpOwO8vPSBJ\n y+QQ==", "X-Gm-Message-State": "APjAAAU703cvgQVSzzdyNns5fj7laprvzf1xcm2RiWxDz8m7Kgkldd0B\n lwaiv3/bATSvj7jFL1rBpicss8GMeFWS2Q==", "X-Google-Smtp-Source": "\n APXvYqxmQi9M5pEEtDfes3rpzGZiki4TrYjU+lRaed5VfJBCRuEr7BwE1Bulh3ynLlBhWNyWUogi2g==", "X-Received": "by 2002:a2e:88c5:: with SMTP id a5mr4707961ljk.201.1580440076869;\n Thu, 30 Jan 2020 19:07:56 -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": "Fri, 31 Jan 2020 06:07:44 +0300", "Message-Id": "<20200131030744.19596-7-dmitry.kozliuk@gmail.com>", "X-Mailer": "git-send-email 2.25.0", "In-Reply-To": "<20200131030744.19596-1-dmitry.kozliuk@gmail.com>", "References": "<20200131030744.19596-1-dmitry.kozliuk@gmail.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Subject": "[dpdk-dev] [PATCH 6/6] doc: guide for Windows build using MinGW-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>", "diff": "diff --git a/doc/guides/windows_gsg/build_dpdk.rst b/doc/guides/windows_gsg/build_dpdk.rst\nindex 6711e07e2..eabc459fb 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@@ -56,23 +72,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 meson_mingw.txt -Dexamples=helloworld build\n+ ninja -C build\n+\n \n Run the helloworld example\n ==========================\n@@ -87,3 +121,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": [ "6/6" ] }