Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/119871/?format=api
{ "id": 119871, "url": "http://patches.dpdk.org/api/patches/119871/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20221115173516.33051-1-stephen@networkplumber.org/", "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": "<20221115173516.33051-1-stephen@networkplumber.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20221115173516.33051-1-stephen@networkplumber.org", "date": "2022-11-15T17:35:16", "name": "doc: avoid meson deprecation in setup", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "4d6b15312f5f76930674af4aea99a2a4f307b3a4", "submitter": { "id": 27, "url": "http://patches.dpdk.org/api/people/27/?format=api", "name": "Stephen Hemminger", "email": "stephen@networkplumber.org" }, "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/20221115173516.33051-1-stephen@networkplumber.org/mbox/", "series": [ { "id": 25771, "url": "http://patches.dpdk.org/api/series/25771/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=25771", "date": "2022-11-15T17:35:16", "name": "doc: avoid meson deprecation in setup", "version": 1, "mbox": "http://patches.dpdk.org/series/25771/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/119871/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/119871/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 3E2D1A0547;\n\tTue, 15 Nov 2022 18:35:23 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id CE9FD40F18;\n\tTue, 15 Nov 2022 18:35:22 +0100 (CET)", "from mail-pf1-f182.google.com (mail-pf1-f182.google.com\n [209.85.210.182])\n by mails.dpdk.org (Postfix) with ESMTP id 8BAD040E03\n for <dev@dpdk.org>; Tue, 15 Nov 2022 18:35:20 +0100 (CET)", "by mail-pf1-f182.google.com with SMTP id k22so14758108pfd.3\n for <dev@dpdk.org>; Tue, 15 Nov 2022 09:35:20 -0800 (PST)", "from hermes.local (204-195-120-218.wavecable.com. [204.195.120.218])\n by smtp.gmail.com with ESMTPSA id\n mp14-20020a17090b190e00b0020ae09e9724sm8600906pjb.53.2022.11.15.09.35.17\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Tue, 15 Nov 2022 09:35:18 -0800 (PST)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=networkplumber-org.20210112.gappssmtp.com; s=20210112;\n h=content-transfer-encoding:mime-version:message-id:date:subject:cc\n :to:from:from:to:cc:subject:date:message-id:reply-to;\n bh=r+A/KE3ZEZqPzYqgD8UX3Bep9lfZYnFHEc8OqQ8/xew=;\n b=Nt0+D7+1k3WD/7Bsyr/6ohOR0dtoi2VJxmPe05m8CtLXoxV7pvr9Ml1hjA3TZd4QOg\n HmlpWplqYHASN6S2tUrlwNBAqj1XVqClCxq0y7zWwdA8UhgbAvI6y2SFMy0J9NlXyVcd\n wBaFgedKtqxnp/zF9/k6ubuVVQ9S0HPahlovefIxN/ljNBoXct5W4lxsXnllX6e99H/y\n wVjAQOjIt5SlEFTQUeUjOOk0iCRIZ8l5zegb6r5Z4Gr34seeVO6zHcnb4xVHYFOZRtWJ\n dY36vb/esfhdUCqcWFRW9EkyiS1FdNDpPrdrMPLwy4CC5O3ocOHHJ2X9TyPL7WGPjfDo\n tBfA==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20210112;\n h=content-transfer-encoding:mime-version:message-id:date:subject:cc\n :to:from:x-gm-message-state:from:to:cc:subject:date:message-id\n :reply-to;\n bh=r+A/KE3ZEZqPzYqgD8UX3Bep9lfZYnFHEc8OqQ8/xew=;\n b=7VgkYGpUrshcEilsHR0CGtIgsHHgeKBVfmauh39wJTM3psqJ17OE9To+4Vav6u7OdT\n DHsqPcWmhVLCBtvvUpX+E3HX7iMKCIFW+3dq9fQicttHO4PUGGp42/hcEUSGpF3va9YK\n lsBH9aPAr/59c+SRNjttq6H/wy4bSYK6eY4nQlV9dr75EbqqLPf8R/tqgam2W9wIdP4C\n HCMcZB6M/Qb092MNUpklraTBVpISz2jRZ5jTiq+JZCwpUjcWSV75I+mxwgw9inkaE9J2\n +irrG8eA6Lf/aEZOKb8A7vQB4nCIp4dogMCBUkMlBtoJcaNqo5nnPL/G8IPDUuAkBlif\n bA2A==", "X-Gm-Message-State": "ANoB5pmym5u0NDqCZHJOGtQHsnwzond9g0QE+vFEc5GOGhbLEz8nSAnM\n HT1j6ZybhTJ8LXut4EhgxV++yXgR8QfTZw==", "X-Google-Smtp-Source": "\n AA0mqf6+7xXHuj2WlN7h9che5uN4rzp8Xoq3QvemeR5gCsr1qytrra1f59oxhQnDl5YQwc7JLR7e3A==", "X-Received": "by 2002:a62:18c7:0:b0:572:725f:338d with SMTP id\n 190-20020a6218c7000000b00572725f338dmr3855050pfy.1.1668533719216;\n Tue, 15 Nov 2022 09:35:19 -0800 (PST)", "From": "Stephen Hemminger <stephen@networkplumber.org>", "To": "dev@dpdk.org", "Cc": "Stephen Hemminger <stephen@networkplumber.org>,\n Ruifeng Wang <ruifeng.wang@arm.com>,\n Zhangfei Gao <zhangfei.gao@linaro.org>,\n Bruce Richardson <bruce.richardson@intel.com>,\n Elena Agostini <eagostini@nvidia.com>,\n Shepard Siegel <shepard.siegel@atomicrules.com>,\n Ed Czeck <ed.czeck@atomicrules.com>,\n John Miller <john.miller@atomicrules.com>, Zyta Szpak <zr@semihalf.com>,\n Liron Himi <lironh@marvell.com>,\n Nithin Dabilpuram <ndabilpuram@marvell.com>,\n Kiran Kumar K <kirankumark@marvell.com>,\n Sunil Kumar Kori <skori@marvell.com>, Satha Rao <skoteshwar@marvell.com>,\n David Hunt <david.hunt@intel.com>", "Subject": "[PATCH] doc: avoid meson deprecation in setup", "Date": "Tue, 15 Nov 2022 09:35:16 -0800", "Message-Id": "<20221115173516.33051-1-stephen@networkplumber.org>", "X-Mailer": "git-send-email 2.35.1", "MIME-Version": "1.0", "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": "The command \"meson build\" causes a deprecation warning with meson 0.64.0.\n WARNING: Running the setup command as `meson [options]` instead of `meson setup [options]` is ambiguous and deprecated.\n\nTherefore fix the examples in the documentation.\n\nSigned-off-by: Stephen Hemminger <stephen@networkplumber.org>\n---\n doc/guides/cryptodevs/armv8.rst | 2 +-\n doc/guides/cryptodevs/uadk.rst | 2 +-\n doc/guides/freebsd_gsg/build_dpdk.rst | 2 +-\n doc/guides/gpus/cuda.rst | 4 ++--\n doc/guides/howto/openwrt.rst | 4 ++--\n doc/guides/nics/ark.rst | 2 +-\n doc/guides/nics/mvneta.rst | 2 +-\n doc/guides/nics/mvpp2.rst | 2 +-\n doc/guides/platform/bluefield.rst | 4 ++--\n doc/guides/platform/cnxk.rst | 4 ++--\n doc/guides/platform/octeontx.rst | 8 ++++----\n doc/guides/prog_guide/build-sdk-meson.rst | 4 ++--\n doc/guides/prog_guide/lto.rst | 2 +-\n doc/guides/prog_guide/profile_app.rst | 2 +-\n doc/guides/sample_app_ug/vm_power_management.rst | 14 ++++++--------\n 15 files changed, 28 insertions(+), 30 deletions(-)", "diff": "diff --git a/doc/guides/cryptodevs/armv8.rst b/doc/guides/cryptodevs/armv8.rst\nindex 8963f66a206c..1a006754cbe4 100644\n--- a/doc/guides/cryptodevs/armv8.rst\n+++ b/doc/guides/cryptodevs/armv8.rst\n@@ -47,7 +47,7 @@ To build DPDK with this virtual crypto PMD, the user is required to:\n \n .. code-block:: console\n \n- meson build\n+ meson setup build\n ninja -C build\n \n The corresponding device can be created only if the following features\ndiff --git a/doc/guides/cryptodevs/uadk.rst b/doc/guides/cryptodevs/uadk.rst\nindex 1325eaca3f0a..9af6b88a5a54 100644\n--- a/doc/guides/cryptodevs/uadk.rst\n+++ b/doc/guides/cryptodevs/uadk.rst\n@@ -87,7 +87,7 @@ Test steps\n \n cd dpdk\n mkdir build\n- meson build (--reconfigure)\n+ meson setup build (--reconfigure)\n cd build\n ninja\n sudo ninja install\ndiff --git a/doc/guides/freebsd_gsg/build_dpdk.rst b/doc/guides/freebsd_gsg/build_dpdk.rst\nindex d335b97cfc1e..514d18c8700e 100644\n--- a/doc/guides/freebsd_gsg/build_dpdk.rst\n+++ b/doc/guides/freebsd_gsg/build_dpdk.rst\n@@ -44,7 +44,7 @@ Building DPDK\n The following commands can be used to build and install DPDK on a system.\n The final, install, step generally needs to be run as root::\n \n- meson build\n+ meson setup build\n cd build\n ninja\n ninja install\ndiff --git a/doc/guides/gpus/cuda.rst b/doc/guides/gpus/cuda.rst\nindex 55fc7d1e8626..dc5b0aa603c4 100644\n--- a/doc/guides/gpus/cuda.rst\n+++ b/doc/guides/gpus/cuda.rst\n@@ -25,7 +25,7 @@ Three ways:\n \n - Set ``export CFLAGS=-I/usr/local/cuda/include`` before building\n - Add CFLAGS in the meson command line ``CFLAGS=-I/usr/local/cuda/include meson build``\n-- Add the ``-Dc_args`` in meson command line ``meson build -Dc_args=-I/usr/local/cuda/include``\n+- Add the ``-Dc_args`` in meson command line ``meson setup build -Dc_args=-I/usr/local/cuda/include``\n \n If headers are not found, the CUDA GPU driver library is not built.\n \n@@ -51,7 +51,7 @@ An example would be:\n \n .. code-block:: console\n \n- $ meson build -Dc_args=\"-I/usr/local/cuda/include -I/path/to/gdrcopy/include\"\n+ $ meson setup build -Dc_args=\"-I/usr/local/cuda/include -I/path/to/gdrcopy/include\"\n \n If headers are not found, the CUDA GPU driver library is built without the CPU map capability\n and will return error if the application invokes the gpudev ``rte_gpu_mem_cpu_map`` function.\ndiff --git a/doc/guides/howto/openwrt.rst b/doc/guides/howto/openwrt.rst\nindex e1d7db2a9054..8a9155ebf457 100644\n--- a/doc/guides/howto/openwrt.rst\n+++ b/doc/guides/howto/openwrt.rst\n@@ -100,8 +100,8 @@ first.\n ar = 'x86_64-openwrt-linux-ar'\n strip = 'x86_64-openwrt-linux-strip'\n \n- meson builddir --cross-file openwrt-cross\n- ninja -C builddir\n+ meson setup build --cross-file openwrt-cross\n+ ninja -C build\n \n Running DPDK application on OpenWrt\n -----------------------------------\ndiff --git a/doc/guides/nics/ark.rst b/doc/guides/nics/ark.rst\nindex 591e41799ca0..ba00f14e8029 100644\n--- a/doc/guides/nics/ark.rst\n+++ b/doc/guides/nics/ark.rst\n@@ -282,7 +282,7 @@ CFLAGS environment prior to the meson build step. I.e.,\n .. code-block:: console\n \n export CFLAGS=\"-DRTE_LIBRTE_ARK_MIN_TX_PKTLEN=60\"\n- meson build\n+ meson setup build\n \n \n Supported ARK RTL PCIe Instances\ndiff --git a/doc/guides/nics/mvneta.rst b/doc/guides/nics/mvneta.rst\nindex b7f279c3cb16..2ee2637a58f3 100644\n--- a/doc/guides/nics/mvneta.rst\n+++ b/doc/guides/nics/mvneta.rst\n@@ -117,7 +117,7 @@ Add path to libmusdk.pc in PKG_CONFIG_PATH environment variable.\n .. code-block:: console\n \n export PKG_CONFIG_PATH=$<musdk_install_dir>/lib/pkgconfig/:$PKG_CONFIG_PATH\n- meson build --cross-file config/arm/arm64_armada_linux_gcc\n+ meson setup build --cross-file config/arm/arm64_armada_linux_gcc\n ninja -C build\n \n \ndiff --git a/doc/guides/nics/mvpp2.rst b/doc/guides/nics/mvpp2.rst\nindex e40fed72868c..cbfa47afd870 100644\n--- a/doc/guides/nics/mvpp2.rst\n+++ b/doc/guides/nics/mvpp2.rst\n@@ -133,7 +133,7 @@ Add path to libmusdk.pc in PKG_CONFIG_PATH environment variable.\n \n export PKG_CONFIG_PATH=$<musdk_install_dir>/lib/pkgconfig/:$PKG_CONFIG_PATH\n \n- meson build --cross-file config/arm/arm64_armada_linux_gcc\n+ meson setup build --cross-file config/arm/arm64_armada_linux_gcc\n ninja -C build\n \n \ndiff --git a/doc/guides/platform/bluefield.rst b/doc/guides/platform/bluefield.rst\nindex 3e3078c85e69..09486747b12f 100644\n--- a/doc/guides/platform/bluefield.rst\n+++ b/doc/guides/platform/bluefield.rst\n@@ -61,7 +61,7 @@ rdma-core library with corresponding kernel drivers is required.\n \n .. code-block:: console\n \n- meson build\n+ meson setup build\n ninja -C build\n \n Cross Compilation\n@@ -115,5 +115,5 @@ Then, untar the tarball at the cross toolchain directory on the x86 host.\n \n .. code-block:: console\n \n- meson build --cross-file config/arm/arm64_bluefield_linux_gcc\n+ meson setup build --cross-file config/arm/arm64_bluefield_linux_gcc\n ninja -C build\ndiff --git a/doc/guides/platform/cnxk.rst b/doc/guides/platform/cnxk.rst\nindex 562ed7d7a6cd..f2de6bb5963d 100644\n--- a/doc/guides/platform/cnxk.rst\n+++ b/doc/guides/platform/cnxk.rst\n@@ -606,14 +606,14 @@ CN9K:\n \n .. code-block:: console\n \n- meson build --cross-file config/arm/arm64_cn9k_linux_gcc\n+ meson setup build --cross-file config/arm/arm64_cn9k_linux_gcc\n ninja -C build\n \n CN10K:\n \n .. code-block:: console\n \n- meson build --cross-file config/arm/arm64_cn10k_linux_gcc\n+ meson setup build --cross-file config/arm/arm64_cn10k_linux_gcc\n ninja -C build\n \n .. note::\ndiff --git a/doc/guides/platform/octeontx.rst b/doc/guides/platform/octeontx.rst\nindex 42ddb1762efa..1459dc7109be 100644\n--- a/doc/guides/platform/octeontx.rst\n+++ b/doc/guides/platform/octeontx.rst\n@@ -94,14 +94,14 @@ drivers can be compiled with the following steps,\n \n .. code-block:: console\n \n- meson build -Dexamples=<application>\n+ meson setup build -Dexamples=<application>\n ninja -C build\n \n The example applications can be compiled using the following:\n \n .. code-block:: console\n \n- meson build -Dexamples=<application>\n+ meson setup build -Dexamples=<application>\n ninja -C build\n \n Cross Compilation\n@@ -127,7 +127,7 @@ Now this build system can be used to build applications for **OCTEON TX** :sup:`\n .. code-block:: console\n \n cd <dpdk directory>\n- meson build --cross-file config/arm/arm64_thunderx_linux_gcc\n+ meson setup build --cross-file config/arm/arm64_thunderx_linux_gcc\n ninja -C build\n \n The example applications can be compiled using the following:\n@@ -135,7 +135,7 @@ The example applications can be compiled using the following:\n .. code-block:: console\n \n cd <dpdk directory>\n- meson build --cross-file config/arm/arm64_thunderx_linux_gcc -Dexamples=<application>\n+ meson setup build --cross-file config/arm/arm64_thunderx_linux_gcc -Dexamples=<application>\n ninja -C build\n \n .. note::\ndiff --git a/doc/guides/prog_guide/build-sdk-meson.rst b/doc/guides/prog_guide/build-sdk-meson.rst\nindex 58d9b553a0e2..c1d738e02f42 100644\n--- a/doc/guides/prog_guide/build-sdk-meson.rst\n+++ b/doc/guides/prog_guide/build-sdk-meson.rst\n@@ -9,7 +9,7 @@ Summary\n For many platforms, compiling and installing DPDK should work using the\n following set of commands::\n \n-\tmeson build\n+\tmeson setup build\n \tcd build\n \tninja\n \tninja install\n@@ -57,7 +57,7 @@ Configuring the Build\n ----------------------\n \n To configure a build, run the meson tool, passing the path to the directory\n-to be used for the build e.g. ``meson build``, as shown above. If calling\n+to be used for the build e.g. ``meson setup build``, as shown above. If calling\n meson from somewhere other than the root directory of the DPDK project the\n path to the root directory should be passed as the first parameter, and the\n build path as the second. For example, to build DPDK in /tmp/dpdk-build::\ndiff --git a/doc/guides/prog_guide/lto.rst b/doc/guides/prog_guide/lto.rst\nindex f79c449598b0..ff9f47a8f4ee 100644\n--- a/doc/guides/prog_guide/lto.rst\n+++ b/doc/guides/prog_guide/lto.rst\n@@ -30,4 +30,4 @@ Link time optimization can be enabled by setting meson built-in 'b_lto' option:\n \n .. code-block:: console\n \n- meson build -Db_lto=true\n+ meson setup build -Db_lto=true\ndiff --git a/doc/guides/prog_guide/profile_app.rst b/doc/guides/prog_guide/profile_app.rst\nindex bd6700ef850b..0aff6c18a2ae 100644\n--- a/doc/guides/prog_guide/profile_app.rst\n+++ b/doc/guides/prog_guide/profile_app.rst\n@@ -42,7 +42,7 @@ and recompile the DPDK:\n \n .. code-block:: console\n \n- meson build\n+ meson setup build\n meson configure build -Dc_args=-DRTE_ETHDEV_PROFILE_WITH_VTUNE\n ninja -C build\n \ndiff --git a/doc/guides/sample_app_ug/vm_power_management.rst b/doc/guides/sample_app_ug/vm_power_management.rst\nindex 9ce87956c9fb..ca7d38d0dfd1 100644\n--- a/doc/guides/sample_app_ug/vm_power_management.rst\n+++ b/doc/guides/sample_app_ug/vm_power_management.rst\n@@ -255,11 +255,10 @@ To build just the ``vm_power_manager`` application using ``meson``/``ninja``:\n .. code-block:: console\n \n cd dpdk\n- meson build\n- cd build\n- ninja\n+ meson setup build\n+ ninja -C build\n meson configure -Dexamples=vm_power_manager\n- ninja\n+ ninja -C build\n \n The resulting binary is ``dpdk/build/examples/dpdk-vm_power_manager``.\n \n@@ -494,11 +493,10 @@ To build just the ``vm_power_manager`` application using ``meson``/``ninja``:\n .. code-block:: console\n \n cd dpdk\n- meson build\n- cd build\n- ninja\n+ meson setup build\n+ ninja -C build\n meson configure -Dexamples=vm_power_manager/guest_cli\n- ninja\n+ ninja -C build\n \n The resulting binary is ``dpdk/build/examples/guest_cli``.\n \n", "prefixes": [] }