Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/133800/?format=api
{ "id": 133800, "url": "http://patches.dpdk.org/api/patches/133800/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20231103040202.2849-3-dave@youngcopy.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": "<20231103040202.2849-3-dave@youngcopy.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20231103040202.2849-3-dave@youngcopy.com", "date": "2023-11-03T04:01:48", "name": "[v3,2/7] Section 2: Install and Build DPDK", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "eb67eaa514f499ae6dc341effb700b7cc2e7a339", "submitter": { "id": 3122, "url": "http://patches.dpdk.org/api/people/3122/?format=api", "name": "Dave Young", "email": "dave@youngcopy.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/20231103040202.2849-3-dave@youngcopy.com/mbox/", "series": [ { "id": 30128, "url": "http://patches.dpdk.org/api/series/30128/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=30128", "date": "2023-11-03T04:01:46", "name": "docs: getting started guide consolidation", "version": 3, "mbox": "http://patches.dpdk.org/series/30128/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/133800/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/133800/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 mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 4853F43274;\n\tFri, 3 Nov 2023 05:02:33 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 76742427E0;\n\tFri, 3 Nov 2023 05:02:24 +0100 (CET)", "from mail-yb1-f171.google.com (mail-yb1-f171.google.com\n [209.85.219.171])\n by mails.dpdk.org (Postfix) with ESMTP id DB5A840EDC\n for <dev@dpdk.org>; Fri, 3 Nov 2023 05:02:22 +0100 (CET)", "by mail-yb1-f171.google.com with SMTP id\n 3f1490d57ef6-d9fdc712b8fso411004276.1\n for <dev@dpdk.org>; Thu, 02 Nov 2023 21:02:22 -0700 (PDT)", "from localhost.localdomain\n ([2600:1700:20c0:a560:c076:581e:323d:c06e])\n by smtp.gmail.com with ESMTPSA id\n x64-20020a817c43000000b0059b1f6d1959sm493958ywc.101.2023.11.02.21.02.19\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Thu, 02 Nov 2023 21:02:19 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=youngcopy-com.20230601.gappssmtp.com; s=20230601; t=1698984141;\n x=1699588941;\n darn=dpdk.org;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:from:to:cc:subject:date\n :message-id:reply-to;\n bh=T0s5PJymRqJSHAfx7IZl3Fx9/NsUdw56W3yoatr8kUM=;\n b=Nr2dJ12XhlKnpIvhvQyUQQSCU1Q/kUTCcCW1uV9L9i1j8n6NtxRuryAUjaegv5amQh\n OH1K3b2iQp55/cdJAEj6/Ufny4FLmiVAX/f6JGPC6iJoKbePr/TyA9hp79SA8YJm1Ihy\n 4SFfOPeyV9Hi/ouSuljtvXlkbyV8GduLqs0pInLFynf4eLqpgsnGZOebuPDAbIbT8DEd\n FLyTRjkfyPHlVGWwxESfL+fnMMyMPX3x4MsiREhX7r6v7lGM7nzz5Fd0o4ynkMv6ciC0\n mbcmZK1s0mx1/1lMD3uX5vh4zekk9hddR+Y5mq+XnH2+lZNZu+4vbk8SDQ5iIGwlXiNe\n +1hA==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20230601; t=1698984141; x=1699588941;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc\n :subject:date:message-id:reply-to;\n bh=T0s5PJymRqJSHAfx7IZl3Fx9/NsUdw56W3yoatr8kUM=;\n b=uaXKyWgcYFv/Vq6oJyNySgqqSVc1ykY2Gk3ZFSNc1XndIY0V9O6Jjnh1NB6P3siorp\n qZuTacnQVMSPYAv1P0IZf3cbvX72g8o3BvRtG3kdBW0VsIH7krPrBrgndyluuiD/NXN5\n U1pz2n0PrvkaejYwKO/Kbjee53LLzadvRx7uZBRo7iwZh0gcYg3Hg27d8zIxIxbaBREh\n a5GBn14BMMtFH3f6PARCGQ76O/6HCrGxy8P6QvoPV0HDcas7oKOPJItxw3dA6U8VpD01\n CwuORp4p8srBWfrcYqtf6lA090RsvGtUFEMatj4FeqjlCpClSZnkwAh+a2Cx+ZtSEaIR\n BmRA==", "X-Gm-Message-State": "AOJu0Yw1OZ0kXWJg3wEMZcQXSd1uhpvCEnCkk9g11UCA4ow8MJnrAZRF\n ZdpzRe0b0qOwnTs8Pi26uouynedlgfnDyFOTi0U=", "X-Google-Smtp-Source": "\n AGHT+IHjeyRqgTJR6qC82XJXu3ueFtYBCMSAZpk2Q3utzItwrDTORQNxbPKEubOu0i8rNzoK6uv69w==", "X-Received": "by 2002:a05:690c:4803:b0:5b3:1c41:733f with SMTP id\n hc3-20020a05690c480300b005b31c41733fmr10236897ywb.5.1698984141089;\n Thu, 02 Nov 2023 21:02:21 -0700 (PDT)", "From": "David Young <dave@youngcopy.com>", "To": "dev@dpdk.org", "Cc": "Bruce Richardson <bruce.richardson@intel.com>,\n Aaron Conole <aconole@redhat.com>, David Young <dave@youngcopy.com>", "Subject": "[PATCH v3 2/7] Section 2: Install and Build DPDK", "Date": "Fri, 3 Nov 2023 00:01:48 -0400", "Message-ID": "<20231103040202.2849-3-dave@youngcopy.com>", "X-Mailer": "git-send-email 2.41.0.windows.1", "In-Reply-To": "<20231103040202.2849-1-dave@youngcopy.com>", "References": "<20231103040202.2849-1-dave@youngcopy.com>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=y", "Content-Transfer-Encoding": "8bit", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "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" }, "content": "Section 2: Install and Build DPDK - Updated based on feedback; Merged windows_install_build.rst into building_from_sources.rst; Updated Meson 0.57.x to be required for Windows.\n---\n .../building_from_sources.rst | 174 ++++++++++++++++++\n .../install_and_build/index.rst | 14 ++\n .../installing_prebuilt_packages.rst | 54 ++++++\n 3 files changed, 242 insertions(+)\n create mode 100644 doc/guides/getting_started_guide/install_and_build/building_from_sources.rst\n create mode 100644 doc/guides/getting_started_guide/install_and_build/index.rst\n create mode 100644 doc/guides/getting_started_guide/install_and_build/installing_prebuilt_packages.rst", "diff": "diff --git a/doc/guides/getting_started_guide/install_and_build/building_from_sources.rst b/doc/guides/getting_started_guide/install_and_build/building_from_sources.rst\nnew file mode 100644\nindex 0000000000..fd7e2e9b30\n--- /dev/null\n+++ b/doc/guides/getting_started_guide/install_and_build/building_from_sources.rst\n@@ -0,0 +1,174 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2010-2025 Intel Corporation.\n+\n+.. _building_from_sources:\n+\n+Building and Installing DPDK from Sources\n+=========================================\n+\n+This chapter provides a comprehensive guide for building DPDK from sources on Linux, FreeBSD, and Windows. It covers the necessary steps, prerequisites, \n+and considerations for different architectures and compilers.\n+\n+Required Tools\n+--------------\n+\n+To build DPDK, you'll need the following tools:\n+\n+- A C compiler like ``gcc`` (version 5+) or ``clang`` (version 3.6+)\n+- ``pkg-config`` or ``pkgconf``\n+- Python 3.6 or later\n+- ``meson`` (version 0.57.0) and ``ninja``\n+- ``pyelftools`` (version 0.22+)\n+\n+Platform-Specific Tool Installation\n+-----------------------------------\n+\n+Linux\n+^^^^^\n+\n+Common Tools for All Distributions:\n+\n+.. code-block:: bash\n+\n+ sudo apt install gcc pkg-config python3 meson ninja pyelftools\n+\n+Alpine\n+\n+.. code-block:: bash\n+\n+ sudo apk add alpine-sdk bsd-compat-headers\n+\n+Debian, Ubuntu, and derivatives\n+\n+.. code-block:: bash\n+\n+ sudo apt install build-essential\n+\n+Fedora and RedHat Enterprise Linux RHEL\n+\n+.. code-block:: bash\n+\n+ sudo dnf groupinstall \"Development Tools\"\n+\n+openSUSE\n+\n+.. code-block:: bash\n+\n+ sudo zypper install -t pattern devel_basis python3-pyelftools\n+\n+FreeBSD\n+^^^^^^^\n+\n+Common Tools for FreeBSD:\n+\n+.. code-block:: bash\n+\n+ pkg install gcc pkgconf python3 meson ninja pyelftools\n+\n+.. note::\n+\n+ If you're using FreeBSD, make sure kernel sources are included during the FreeBSD installation.\n+\n+Windows System Requirements\n+^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+\n+Building the DPDK and its applications on Windows 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 with the Ninja backend.\n+\n+Option 1: Clang-LLVM C Compiler and Microsoft MSVC Linker\n+\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n+\n+1. Install the Compiler: Download and install the Clang compiler from the \n+ `LLVM website <http://releases.llvm.org/>`_.\n+\n+2. Install the Linker: Download and install the Build Tools for Visual Studio from the\n+ `Microsoft website <https://visualstudio.microsoft.com/downloads/>`_.\n+ When installing build tools, select the “Visual C++ build tools” option and make sure\n+ the Windows SDK is selected.\n+\n+Option 2: MinGW-w64 Toolchain\n+\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n+\n+1. On Linux (for cross-compilation): Install MinGW-w64 via a package manager. \n+ Version 4.0.4 for Ubuntu 16.04 cannot be used due to a MinGW-w64 bug.\n+\n+2. On Windows: Obtain the latest version installer from the\n+ `MinGW-w64 repository <https://mingw-w64.org/doku.php>`_. \n+ Any thread model (POSIX or Win32) can be chosen, DPDK does not rely on it. \n+ 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+Install the Build System\n+^^^^^^^^^^^^^^^^^^^^^^^^\n+\n+Download and install the build system from the\n+`Meson website <http://mesonbuild.com/Getting-meson.html#installing-meson-and-ninja-with-the-msi-installer>`_.\n+A good option to choose is the MSI installer for both meson and ninja together.\n+Required version is Meson 0.57.x (baseline).\n+\n+Getting the DPDK Source\n+-----------------------\n+\n+Linux and FreeBSD\n+^^^^^^^^^^^^^^^^^\n+\n+.. code-block:: bash\n+\n+ wget https://fast.dpdk.org/rel/dpdk-<version>.tar.xz\n+ tar -xvf dpdk-<version>.tar.xz\n+ cd dpdk-<version>\n+\n+Windows\n+^^^^^^^\n+\n+Download the DPDK source code from `DPDK's official website <https://www.dpdk.org/>`_ or clone the repository using a Git client. Extract the downloaded archive, if applicable, and navigate to the DPDK directory.\n+\n+Navigate to the directory where the DPDK source code is located:\n+\n+.. code-block:: bash\n+\n+ cd C:\\path\\to\\dpdk-<version>\n+\n+Building DPDK\n+-------------\n+\n+Linux and FreeBSD\n+^^^^^^^^^^^^^^^^^\n+\n+.. code-block:: bash\n+\n+ meson build\n+ ninja -C build\n+\n+Windows\n+^^^^^^^\n+\n+**Option 1: Using Clang-LLVM**\n+\n+.. code-block:: bash\n+\n+ set CC=clang\n+ meson setup -Dexamples=helloworld build\n+ meson compile -C build\n+\n+**Option 2: Using MinGW-w64**\n+\n+.. code-block:: bash\n+\n+ set PATH=C:\\MinGW\\mingw64\\bin;%PATH%\n+ meson setup -Dexamples=helloworld build\n+ meson compile -C build\n+\n+.. note::\n+\n+ For detailed information on Meson build configuration options specific to DPDK, see :ref:`DPDK Meson Build Configuration Options <dpdk_meson_build_options>`.\n+\n+Cross-Compilation Instructions for Different Architectures\n+----------------------------------------------------------\n+\n+For instructions on building DPDK for ARM64, LoongArch, and RISC-V, refer to :ref:`cross_compile_dpdk`.\n\\ No newline at end of file\ndiff --git a/doc/guides/getting_started_guide/install_and_build/index.rst b/doc/guides/getting_started_guide/install_and_build/index.rst\nnew file mode 100644\nindex 0000000000..48e438282f\n--- /dev/null\n+++ b/doc/guides/getting_started_guide/install_and_build/index.rst\n@@ -0,0 +1,14 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2010-2025 Intel Corporation.\n+\n+.. _install_and_build:\n+\n+Install and Build DPDK\n+======================\n+\n+.. toctree::\n+ :maxdepth: 2\n+\n+ \n+ installing_prebuilt_packages\n+ building_from_sources\n\\ No newline at end of file\ndiff --git a/doc/guides/getting_started_guide/install_and_build/installing_prebuilt_packages.rst b/doc/guides/getting_started_guide/install_and_build/installing_prebuilt_packages.rst\nnew file mode 100644\nindex 0000000000..3e395d65f1\n--- /dev/null\n+++ b/doc/guides/getting_started_guide/install_and_build/installing_prebuilt_packages.rst\n@@ -0,0 +1,54 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2010-2025 Intel Corporation.\n+\n+.. _installing_prebuilt_packages:\n+\n+Installing Pre-built Packages\n+=============================\n+\n+Pre-built packages provide a convenient way to install DPDK without the need to compile\n+the source code manually. These packages are created and maintained by the DPDK\n+community or OS vendors and are available for various operating systems and\n+distributions.\n+\n+Available Distributions\n+-----------------------\n+\n+Linux\n+^^^^^\n+\n+Pre-built DPDK packages are available for several popular Linux distributions,\n+including but not limited to:\n+\n+Alpine\n+\n+.. code-block:: bash\n+\n+ sudo apk add dpdk\n+\n+Debian and Ubuntu and derivatives\n+\n+.. code-block:: bash\n+\n+ sudo apt-get install dpdk\n+\n+Fedora and RedHat Enterprise Linux RHEL\n+\n+.. code-block:: bash\n+\n+ sudo dnf install dpdk\n+\n+openSUSE\n+\n+.. code-block:: bash\n+\n+ sudo zypper install dpdk\n+\n+FreeBSD\n+^^^^^^^\n+\n+To install DPDK on FreeBSD, use the following command:\n+\n+.. code-block:: bash\n+\n+ sudo pkg install dpdk\n\\ No newline at end of file\n", "prefixes": [ "v3", "2/7" ] }