Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/96469/?format=api
http://patchwork.dpdk.org/api/patches/96469/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20210730155700.32574-1-olivier.matz@6wind.com/", "project": { "id": 1, "url": "http://patchwork.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": "<20210730155700.32574-1-olivier.matz@6wind.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20210730155700.32574-1-olivier.matz@6wind.com", "date": "2021-07-30T15:57:01", "name": "doc: announce renaming of mbuf offload flags", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "670ba61fad988445d24dce8b575d0b94cafedebe", "submitter": { "id": 8, "url": "http://patchwork.dpdk.org/api/people/8/?format=api", "name": "Olivier Matz", "email": "olivier.matz@6wind.com" }, "delegate": { "id": 1, "url": "http://patchwork.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20210730155700.32574-1-olivier.matz@6wind.com/mbox/", "series": [ { "id": 18103, "url": "http://patchwork.dpdk.org/api/series/18103/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=18103", "date": "2021-07-30T15:57:01", "name": "doc: announce renaming of mbuf offload flags", "version": 1, "mbox": "http://patchwork.dpdk.org/series/18103/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/patches/96469/comments/", "check": "warning", "checks": "http://patchwork.dpdk.org/api/patches/96469/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 1BCC0A0C40;\n\tFri, 30 Jul 2021 17:58:09 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 9352240040;\n\tFri, 30 Jul 2021 17:58:08 +0200 (CEST)", "from mail-wr1-f53.google.com (mail-wr1-f53.google.com\n [209.85.221.53]) by mails.dpdk.org (Postfix) with ESMTP id D20194003F\n for <dev@dpdk.org>; Fri, 30 Jul 2021 17:58:06 +0200 (CEST)", "by mail-wr1-f53.google.com with SMTP id c16so11871632wrp.13\n for <dev@dpdk.org>; Fri, 30 Jul 2021 08:58:06 -0700 (PDT)", "from gojira.dev.6wind.com (host.78.145.23.62.rev.coltfrance.com.\n [62.23.145.78])\n by smtp.gmail.com with ESMTPSA id y197sm2328142wmc.7.2021.07.30.08.58.05\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Fri, 30 Jul 2021 08:58:05 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=6wind.com; s=google;\n h=from:to:cc:subject:date:message-id:mime-version\n :content-transfer-encoding;\n bh=/XXOBMRzklqo94Ynh9oQuWGcYv77mqdT8LZVQWvs3WY=;\n b=PISSfS8pls/6mmlq1t/LHJonHGxknAlpFee9SK7OYBYrE7dsuefcrniSMdOpkYviqx\n J52Rmo2fS5kg3u1NgwSH70PB+2oZIh2KD5qo4gsaVxUsTVV3uF1FESVdLlh1QINFJgZq\n jUK2xF8wtitVUC9QuNj5a/SJVvG1tGU0gIaHsaQikk7n8q9Yu6KDYJI5BoJoX/W2ypGZ\n 62vUpKme5sO1vxoNhWG7UM/K+kovflgEjOtnxSUqqNfInrWLhGG/UnNmFjNq+hX1JU88\n ocqDO1xfCn+46xQplZBjxIRF8L3yMF2jsPU8IRNRrGIspXFANIXJYs0jDvltAbBwBT1y\n fkCg==", "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:mime-version\n :content-transfer-encoding;\n bh=/XXOBMRzklqo94Ynh9oQuWGcYv77mqdT8LZVQWvs3WY=;\n b=dWPJcaGiHsd1Cjnvd6D6p6eAmkQ1Gbjv2oWj8VgJOVDJosUPrQPBhfqxUeGzbAvVNR\n 0c09i7dyUFgRnCZUxpt4Zam/FtvxUopGaGKnaLMixFBfN/jwpW9gszz3+RsSSJNjjF3P\n BuBCRI+FDTXKZpirURQ832gzb1gLdHkbHvt+Vp0hd/pmcKKKl5aCEdO07G0qn1P0kB9z\n xYzwzwF5R12xB0aXHkP2bTeFkjAY57FY471GQ803PkLX1RRrL9FE0Y1EIdkIcyQgjbpH\n jY+SuV3stH9akzSBFogfMG0CrnYO0zB0ju33R3HZkaoh+jZ4UV8PZ/1t3nV5LjMWsoxX\n 5X/w==", "X-Gm-Message-State": "AOAM532xWqeCktDvEnIh4DcvPB8SZAO5UiORkHpfXAC/8lurBk3R+FIU\n Ddu4IC0b3fnONx3eXeRacGwCRC874eDBTPgP", "X-Google-Smtp-Source": "\n ABdhPJyJwIvDrldFkWQI9+laKgJzcJ7vijG+6d3vZ0z+SOFeEJO4+r+ZD0buUO0EyrkpB+Z53qGpYg==", "X-Received": "by 2002:adf:ecc9:: with SMTP id s9mr3755393wro.306.1627660686426;\n Fri, 30 Jul 2021 08:58:06 -0700 (PDT)", "From": "Olivier Matz <olivier.matz@6wind.com>", "To": "dev@dpdk.org", "Cc": "Ray Kinsella <mdr@ashroe.eu>", "Date": "Fri, 30 Jul 2021 17:57:01 +0200", "Message-Id": "<20210730155700.32574-1-olivier.matz@6wind.com>", "X-Mailer": "git-send-email 2.29.2", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Subject": "[dpdk-dev] [PATCH] doc: announce renaming of mbuf offload flags", "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", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "The mbuf offload flags do not match the DPDK namespace (they are\nnot prefixed by RTE_). Announce their rename in 21.11, and the\nremoval of the old names in 22.11.\n\nA draft coccinelle script is provided to anticipate what the\nrenaming will be.\n\nSigned-off-by: Olivier Matz <olivier.matz@6wind.com>\n---\n .../cocci/prefix_mbuf_offload_flags.cocci | 436 ++++++++++++++++++\n doc/guides/rel_notes/deprecation.rst | 5 +\n 2 files changed, 441 insertions(+)\n create mode 100644 devtools/cocci/prefix_mbuf_offload_flags.cocci", "diff": "diff --git a/devtools/cocci/prefix_mbuf_offload_flags.cocci b/devtools/cocci/prefix_mbuf_offload_flags.cocci\nnew file mode 100644\nindex 0000000000..8bfc7c29d1\n--- /dev/null\n+++ b/devtools/cocci/prefix_mbuf_offload_flags.cocci\n@@ -0,0 +1,436 @@\n+//\n+// Rename mbuf offload flags (and some other defines) to have\n+// an RTE_ prefix.\n+// This only replaces usages in C code, so it is advised to\n+// check for missing occurences with:\n+// for f in $(git ls-tree --full-tree -r --name-only HEAD); do\n+// if [ \"$(file -b --mime-encoding $f)\" != binary ]; then\n+// sed -i -e 's,PKT_RX_,RTE_MBUF_F_RX_,g' \\\n+// -e 's,PKT_TX_,RTE_MBUF_F_TX_,g' \\\n+// -e 's,EXT_ATTACHED_MBUF,RTE_MBUF_F_EXTERNAL,g' \\\n+// -e 's,IND_ATTACHED_MBUF,RTE_MBUF_F_INDIRECT,g' \\\n+// -e 's,PKT_FIRST_FREE,RTE_MBUF_F_FIRST_FREE,g' \\\n+// -e 's,PKT_LAST_FREE,RTE_MBUF_F_LAST_FREE,g' $f\n+// fi\n+// done\n+//\n+@@\n+@@\n+\n+- PKT_RX_VLAN\n++ RTE_MBUF_F_RX_VLAN\n+\n+@@\n+@@\n+\n+- PKT_RX_RSS_HASH\n++ RTE_MBUF_F_RX_RSS_HASH\n+\n+@@\n+@@\n+\n+- PKT_RX_FDIR\n++ RTE_MBUF_F_RX_FDIR\n+\n+@@\n+@@\n+\n+- PKT_RX_L4_CKSUM_BAD\n++ RTE_MBUF_F_RX_L4_CKSUM_BAD\n+\n+@@\n+@@\n+\n+- PKT_RX_IP_CKSUM_BAD\n++ RTE_MBUF_F_RX_IP_CKSUM_BAD\n+\n+@@\n+@@\n+\n+- PKT_RX_OUTER_IP_CKSUM_BAD\n++ RTE_MBUF_F_RX_OUTER_IP_CKSUM_BAD\n+\n+@@\n+@@\n+\n+- PKT_RX_EIP_CKSUM_BAD\n++ RTE_MBUF_F_RX_EIP_CKSUM_BAD\n+\n+@@\n+@@\n+\n+- PKT_RX_VLAN_STRIPPED\n++ RTE_MBUF_F_RX_VLAN_STRIPPED\n+\n+@@\n+@@\n+\n+- PKT_RX_IP_CKSUM_MASK\n++ RTE_MBUF_F_RX_IP_CKSUM_MASK\n+\n+@@\n+@@\n+\n+- PKT_RX_IP_CKSUM_UNKNOWN\n++ RTE_MBUF_F_RX_IP_CKSUM_UNKNOWN\n+\n+@@\n+@@\n+\n+- PKT_RX_IP_CKSUM_BAD\n++ RTE_MBUF_F_RX_IP_CKSUM_BAD\n+\n+@@\n+@@\n+\n+- PKT_RX_IP_CKSUM_GOOD\n++ RTE_MBUF_F_RX_IP_CKSUM_GOOD\n+\n+@@\n+@@\n+\n+- PKT_RX_IP_CKSUM_NONE\n++ RTE_MBUF_F_RX_IP_CKSUM_NONE\n+\n+@@\n+@@\n+\n+- PKT_RX_L4_CKSUM_MASK\n++ RTE_MBUF_F_RX_L4_CKSUM_MASK\n+\n+@@\n+@@\n+\n+- PKT_RX_L4_CKSUM_UNKNOWN\n++ RTE_MBUF_F_RX_L4_CKSUM_UNKNOWN\n+\n+@@\n+@@\n+\n+- PKT_RX_L4_CKSUM_BAD\n++ RTE_MBUF_F_RX_L4_CKSUM_BAD\n+\n+@@\n+@@\n+\n+- PKT_RX_L4_CKSUM_GOOD\n++ RTE_MBUF_F_RX_L4_CKSUM_GOOD\n+\n+@@\n+@@\n+\n+- PKT_RX_L4_CKSUM_NONE\n++ RTE_MBUF_F_RX_L4_CKSUM_NONE\n+\n+@@\n+@@\n+\n+- PKT_RX_IEEE1588_PTP\n++ RTE_MBUF_F_RX_IEEE1588_PTP\n+\n+@@\n+@@\n+\n+- PKT_RX_IEEE1588_TMST\n++ RTE_MBUF_F_RX_IEEE1588_TMST\n+\n+@@\n+@@\n+\n+- PKT_RX_FDIR_ID\n++ RTE_MBUF_F_RX_FDIR_ID\n+\n+@@\n+@@\n+\n+- PKT_RX_FDIR_FLX\n++ RTE_MBUF_F_RX_FDIR_FLX\n+\n+@@\n+@@\n+\n+- PKT_RX_QINQ_STRIPPED\n++ RTE_MBUF_F_RX_QINQ_STRIPPED\n+\n+@@\n+@@\n+\n+- PKT_RX_LRO\n++ RTE_MBUF_F_RX_LRO\n+\n+@@\n+@@\n+\n+- PKT_RX_SEC_OFFLOAD\n++ RTE_MBUF_F_RX_SEC_OFFLOAD\n+\n+@@\n+@@\n+\n+- PKT_RX_SEC_OFFLOAD_FAILED\n++ RTE_MBUF_F_RX_SEC_OFFLOAD_FAILED\n+\n+@@\n+@@\n+\n+- PKT_RX_QINQ\n++ RTE_MBUF_F_RX_QINQ\n+\n+@@\n+@@\n+\n+- PKT_RX_OUTER_L4_CKSUM_MASK\n++ RTE_MBUF_F_RX_OUTER_L4_CKSUM_MASK\n+\n+@@\n+@@\n+\n+- PKT_RX_OUTER_L4_CKSUM_UNKNOWN\n++ RTE_MBUF_F_RX_OUTER_L4_CKSUM_UNKNOWN\n+\n+@@\n+@@\n+\n+- PKT_RX_OUTER_L4_CKSUM_BAD\n++ RTE_MBUF_F_RX_OUTER_L4_CKSUM_BAD\n+\n+@@\n+@@\n+\n+- PKT_RX_OUTER_L4_CKSUM_GOOD\n++ RTE_MBUF_F_RX_OUTER_L4_CKSUM_GOOD\n+\n+@@\n+@@\n+\n+- PKT_RX_OUTER_L4_CKSUM_INVALID\n++ RTE_MBUF_F_RX_OUTER_L4_CKSUM_INVALID\n+\n+@@\n+@@\n+\n+- PKT_FIRST_FREE\n++ RTE_MBUF_F_FIRST_FREE\n+\n+@@\n+@@\n+\n+- PKT_LAST_FREE\n++ RTE_MBUF_F_LAST_FREE\n+\n+@@\n+@@\n+\n+- PKT_TX_OUTER_UDP_CKSUM\n++ RTE_MBUF_F_TX_OUTER_UDP_CKSUM\n+\n+@@\n+@@\n+\n+- PKT_TX_UDP_SEG\n++ RTE_MBUF_F_TX_UDP_SEG\n+\n+@@\n+@@\n+\n+- PKT_TX_SEC_OFFLOAD\n++ RTE_MBUF_F_TX_SEC_OFFLOAD\n+\n+@@\n+@@\n+\n+- PKT_TX_MACSEC\n++ RTE_MBUF_F_TX_MACSEC\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_VXLAN\n++ RTE_MBUF_F_TX_TUNNEL_VXLAN\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_GRE\n++ RTE_MBUF_F_TX_TUNNEL_GRE\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_IPIP\n++ RTE_MBUF_F_TX_TUNNEL_IPIP\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_GENEVE\n++ RTE_MBUF_F_TX_TUNNEL_GENEVE\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_MPLSINUDP\n++ RTE_MBUF_F_TX_TUNNEL_MPLSINUDP\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_VXLAN_GPE\n++ RTE_MBUF_F_TX_TUNNEL_VXLAN_GPE\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_GTP\n++ RTE_MBUF_F_TX_TUNNEL_GTP\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_IP\n++ RTE_MBUF_F_TX_TUNNEL_IP\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_UDP\n++ RTE_MBUF_F_TX_TUNNEL_UDP\n+\n+@@\n+@@\n+\n+- PKT_TX_TUNNEL_MASK\n++ RTE_MBUF_F_TX_TUNNEL_MASK\n+\n+@@\n+@@\n+\n+- PKT_TX_QINQ\n++ RTE_MBUF_F_TX_QINQ\n+\n+@@\n+@@\n+\n+- PKT_TX_QINQ_PKT\n++ RTE_MBUF_F_TX_QINQ_PKT\n+\n+@@\n+@@\n+\n+- PKT_TX_TCP_SEG\n++ RTE_MBUF_F_TX_TCP_SEG\n+\n+@@\n+@@\n+\n+- PKT_TX_IEEE1588_TMST\n++ RTE_MBUF_F_TX_IEEE1588_TMST\n+\n+@@\n+@@\n+\n+- PKT_TX_L4_NO_CKSUM\n++ RTE_MBUF_F_TX_L4_NO_CKSUM\n+\n+@@\n+@@\n+\n+- PKT_TX_TCP_CKSUM\n++ RTE_MBUF_F_TX_TCP_CKSUM\n+\n+@@\n+@@\n+\n+- PKT_TX_SCTP_CKSUM\n++ RTE_MBUF_F_TX_SCTP_CKSUM\n+\n+@@\n+@@\n+\n+- PKT_TX_UDP_CKSUM\n++ RTE_MBUF_F_TX_UDP_CKSUM\n+\n+@@\n+@@\n+\n+- PKT_TX_L4_MASK\n++ RTE_MBUF_F_TX_L4_MASK\n+\n+@@\n+@@\n+\n+- PKT_TX_IP_CKSUM\n++ RTE_MBUF_F_TX_IP_CKSUM\n+\n+@@\n+@@\n+\n+- PKT_TX_IPV4\n++ RTE_MBUF_F_TX_IPV4\n+\n+@@\n+@@\n+\n+- PKT_TX_IPV6\n++ RTE_MBUF_F_TX_IPV6\n+\n+@@\n+@@\n+\n+- PKT_TX_VLAN\n++ RTE_MBUF_F_TX_VLAN\n+\n+@@\n+@@\n+\n+- PKT_TX_VLAN_PKT\n++ RTE_MBUF_F_TX_VLAN_PKT\n+\n+@@\n+@@\n+\n+- PKT_TX_OUTER_IP_CKSUM\n++ RTE_MBUF_F_TX_OUTER_IP_CKSUM\n+\n+@@\n+@@\n+\n+- PKT_TX_OUTER_IPV4\n++ RTE_MBUF_F_TX_OUTER_IPV4\n+\n+@@\n+@@\n+\n+- PKT_TX_OUTER_IPV6\n++ RTE_MBUF_F_TX_OUTER_IPV6\n+\n+@@\n+@@\n+\n+- PKT_TX_OFFLOAD_MASK\n++ RTE_MBUF_F_TX_OFFLOAD_MASK\n+\n+@@\n+@@\n+\n+- EXT_ATTACHED_MBUF\n++ RTE_MBUF_F_EXTERNAL\n+\n+@@\n+@@\n+\n+- IND_ATTACHED_MBUF\n++ RTE_MBUF_F_INDIRECT\n+\n+@@\n+@@\n+\n+- PKT_TX_DYNF_METADATA\n++ RTE_MBUF_F_TX_DYNF_METADATA\n+\n+@@\n+@@\n+\n+- PKT_RX_DYNF_METADATA\n++ RTE_MBUF_F_RX_DYNF_METADATA\n+\ndiff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst\nindex 9584d6bfd7..04cb141de7 100644\n--- a/doc/guides/rel_notes/deprecation.rst\n+++ b/doc/guides/rel_notes/deprecation.rst\n@@ -147,3 +147,8 @@ Deprecation Notices\n * cmdline: ``cmdline`` structure will be made opaque to hide platform-specific\n content. On Linux and FreeBSD, supported prior to DPDK 20.11,\n original structure will be kept until DPDK 21.11.\n+\n+* mbuf: The mbuf offload flags ``PKT_*`` will be renamed as ``RTE_MBUF_F_*``.\n+ A compatibility layer will be kept until DPDK 22.11, except for the flags\n+ that are already deprecated (ex: ``PKT_RX_L4_CKSUM_BAD``), which will\n+ be removed.\n", "prefixes": [] }{ "id": 96469, "url": "