get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/117736/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 117736,
    "url": "https://patches.dpdk.org/api/patches/117736/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/patch/20221009202541.352724-3-yuanx.wang@intel.com/",
    "project": {
        "id": 1,
        "url": "https://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": "<20221009202541.352724-3-yuanx.wang@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20221009202541.352724-3-yuanx.wang@intel.com",
    "date": "2022-10-09T20:25:39",
    "name": "[v9,2/4] ethdev: introduce protocol hdr based buffer split",
    "commit_ref": null,
    "pull_url": null,
    "state": "accepted",
    "archived": true,
    "hash": "4988f557ea1d13feeccc65a03920c2214ddfdf09",
    "submitter": {
        "id": 2087,
        "url": "https://patches.dpdk.org/api/people/2087/?format=api",
        "name": "Wang, YuanX",
        "email": "yuanx.wang@intel.com"
    },
    "delegate": {
        "id": 3961,
        "url": "https://patches.dpdk.org/api/users/3961/?format=api",
        "username": "arybchenko",
        "first_name": "Andrew",
        "last_name": "Rybchenko",
        "email": "andrew.rybchenko@oktetlabs.ru"
    },
    "mbox": "https://patches.dpdk.org/project/dpdk/patch/20221009202541.352724-3-yuanx.wang@intel.com/mbox/",
    "series": [
        {
            "id": 25061,
            "url": "https://patches.dpdk.org/api/series/25061/?format=api",
            "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=25061",
            "date": "2022-10-09T20:25:37",
            "name": "support protocol based buffer split",
            "version": 9,
            "mbox": "https://patches.dpdk.org/series/25061/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/patches/117736/comments/",
    "check": "success",
    "checks": "https://patches.dpdk.org/api/patches/117736/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 A18DBA0542;\n\tSun,  9 Oct 2022 14:39:48 +0200 (CEST)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 93EB542686;\n\tSun,  9 Oct 2022 14:39:48 +0200 (CEST)",
            "from mga05.intel.com (mga05.intel.com [192.55.52.43])\n by mails.dpdk.org (Postfix) with ESMTP id 173B8410D7\n for <dev@dpdk.org>; Sun,  9 Oct 2022 14:39:45 +0200 (CEST)",
            "from orsmga008.jf.intel.com ([10.7.209.65])\n by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 09 Oct 2022 05:39:45 -0700",
            "from unknown (HELO localhost.localdomain) ([10.239.252.55])\n by orsmga008-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 09 Oct 2022 05:39:40 -0700"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1665319186; x=1696855186;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=f/rXV2mV4XIDm6JbgkYs/Y9M80Kv7Txr6gUSEpC1/Gw=;\n b=Y1pRBPe/2ivD/qUF2a1jpN1fQjF6w2AMlg21hk48ZdboBBN9ptv9eKkP\n z7BIEgo3Le0kphl6NAVG6k4sCKPhAx2UJ8DJuT50fQGERxeVCWXo/Ipk4\n ZMd6X3DekHgLYVAmVnkfwtMqn2xbJO1/Xx94fQQXb2d7XyTelwUtI0ia+\n M7w4pKUJWR3gdQQ0Giw0DwX8invITHxRPRHoIdsiQdDYR/Yqcjzz5n0Pu\n fJmOeFJImwauRWUtsv/GVuc5+XN3gxVY1bg3pels7QvOQplrPpDOjvueZ\n Ftg4jsSNijaRnPw+gctBKU+Gp13VAiiZNPaJpsOJIjkLukaIaYp7lNaaC A==;",
        "X-IronPort-AV": [
            "E=McAfee;i=\"6500,9779,10494\"; a=\"390357881\"",
            "E=Sophos;i=\"5.95,171,1661842800\"; d=\"scan'208\";a=\"390357881\"",
            "E=McAfee;i=\"6500,9779,10494\"; a=\"656628321\"",
            "E=Sophos;i=\"5.95,171,1661842800\"; d=\"scan'208\";a=\"656628321\""
        ],
        "From": "Yuan Wang <yuanx.wang@intel.com>",
        "To": "dev@dpdk.org, Thomas Monjalon <thomas@monjalon.net>,\n Ferruh Yigit <ferruh.yigit@amd.com>,\n Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>",
        "Cc": "ferruh.yigit@xilinx.com, mdr@ashroe.eu, xiaoyun.li@intel.com,\n aman.deep.singh@intel.com, yuying.zhang@intel.com, qi.z.zhang@intel.com,\n qiming.yang@intel.com, jerinjacobk@gmail.com, viacheslavo@nvidia.com,\n stephen@networkplumber.org, xuan.ding@intel.com, hpothula@marvell.com,\n yaqi.tang@intel.com, Yuan Wang <yuanx.wang@intel.com>,\n Wenxuan Wu <wenxuanx.wu@intel.com>",
        "Subject": "[PATCH v9 2/4] ethdev: introduce protocol hdr based buffer split",
        "Date": "Mon, 10 Oct 2022 04:25:39 +0800",
        "Message-Id": "<20221009202541.352724-3-yuanx.wang@intel.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20221009202541.352724-1-yuanx.wang@intel.com>",
        "References": "<20220812181552.2908067-1-yuanx.wang@intel.com>\n <20221009202541.352724-1-yuanx.wang@intel.com>",
        "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": "Currently, Rx buffer split supports length based split. With Rx queue\noffload RTE_ETH_RX_OFFLOAD_BUFFER_SPLIT enabled and Rx packet segment\nconfigured, PMD will be able to split the received packets into\nmultiple segments.\n\nHowever, length based buffer split is not suitable for NICs that do split\nbased on protocol headers. Given an arbitrarily variable length in Rx\npacket segment, it is almost impossible to pass a fixed protocol header to\ndriver. Besides, the existence of tunneling results in the composition of\na packet is various, which makes the situation even worse.\n\nThis patch extends current buffer split to support protocol header based\nbuffer split. A new proto_hdr field is introduced in the reserved field\nof rte_eth_rxseg_split structure to specify protocol header. The proto_hdr\nfield defines the split position of packet, splitting will always happen\nafter the protocol header defined in the Rx packet segment. When Rx queue\noffload RTE_ETH_RX_OFFLOAD_BUFFER_SPLIT is enabled and corresponding\nprotocol header is configured, driver will split the ingress packets into\nmultiple segments.\n\nExamples for proto_hdr field defines:\nTo split after ETH-IPV4-UDP, it should be defined as\nproto_hdr = RTE_PTYPE_L2_ETHER | RTE_PTYPE_L3_IPV4_EXT_UNKNOWN |\n            RTE_PTYPE_L4_UDP\n\nFor inner ETH-IPV4-UDP, it should be defined as\nproto_hdr = RTE_PTYPE_TUNNEL_GRENAT | RTE_PTYPE_INNER_L2_ETHER |\n            RTE_PTYPE_INNER_L3_IPV4_EXT_UNKNOWN | RTE_PTYPE_INNER_L4_UDP\n\nIf the protocol header is repeated with the previously defined one,\nthe repeated part should be omitted. For example, split after ETH, ETH-IPV4\nand ETH-IPV4-UDP, it should be defined as\nproto_hdr0 = RTE_PTYPE_L2_ETHER\nproto_hdr1 = RTE_PTYPE_L3_IPV4_EXT_UNKNOWN\nproto_hdr2 = RTE_PTYPE_L4_UDP\n\nstruct rte_eth_rxseg_split {\n        struct rte_mempool *mp;\n        uint16_t length;\n        uint16_t offset;\n        uint32_t proto_hdr;\n};\n\nIf protocol header split can be supported by a PMD, the\nrte_eth_buffer_split_get_supported_hdr_ptypes function can\nbe used to obtain a list of these protocol headers.\n\nFor example, let's suppose we configured the Rx queue with the\nfollowing segments:\n        seg0 - pool0, proto_hdr0=RTE_PTYPE_L2_ETHER | RTE_PTYPE_L3_IPV4,\n               off0=2B\n        seg1 - pool1, proto_hdr1=RTE_PTYPE_L4_UDP, off1=128B\n        seg2 - pool2, proto_hdr2=0, off1=0B\n\nThe packet consists of ETH_IPV4_UDP_PAYLOAD will be split like\nfollowing:\n        seg0 - ipv4 header @ RTE_PKTMBUF_HEADROOM + 2 in mbuf from pool0\n        seg1 - udp header @ 128 in mbuf from pool1\n        seg2 - payload @ 0 in mbuf from pool2\n\nNow buffer split can be configured in two modes. User can choose length\nor protocol header to configure buffer split according to NIC's\ncapability. For length based buffer split, the mp, length, offset field\nin Rx packet segment should be configured, while the proto_hdr field\nmust be 0. For protocol header based buffer split, the mp, offset,\nproto_hdr field in Rx packet segment should be configured, while the\nlength field must be 0.\n\nNote: When protocol header split is enabled, NIC may receive packets\nwhich do not match all the protocol headers within the Rx segments.\nAt this point, NIC will have two possible split behaviors according to\nmatching results, one is exact match, another is longest match.\nThe split result of NIC must belong to one of them.\n\nThe exact match means NIC only do split when the packets exactly match all\nthe protocol headers in the segments. Otherwise, the whole packet will be\nput into the last valid mempool. The longest match means NIC will do split\nuntil packets mismatch the protocol header in the segments. The rest will\nbe put into the last valid pool.\n\nPseudo-code for exact match:\nFOR each seg in segs except last one\n    IF proto_hdr is not matched THEN\n        BREAK\n    END IF\nEND FOR\nIF loop breaked THEN\n    put whole pkt in last seg\nELSE\n    put protocol header in each seg\n    put everything else in last seg\nEND IF\n\nPseudo-code for longest match:\nFOR each seg in segs except last one\n    IF proto_hdr is matched THEN\n        put protocol header in seg\n    ELSE\n        BREAK\n    END IF\nEND FOR\nput everything else in last seg\n\nThe split limitations imposed by underlying driver is reported in the\nrte_eth_dev_info->rx_seg_capa field. The memory attributes for the split\nparts may differ either, dpdk memory and external memory, respectively.\n\nSigned-off-by: Yuan Wang <yuanx.wang@intel.com>\nSigned-off-by: Xuan Ding <xuan.ding@intel.com>\nSigned-off-by: Wenxuan Wu <wenxuanx.wu@intel.com>\n---\n doc/guides/rel_notes/release_22_11.rst |  7 ++\n lib/ethdev/rte_ethdev.c                | 95 +++++++++++++++++++++++---\n lib/ethdev/rte_ethdev.h                | 37 +++++++++-\n 3 files changed, 127 insertions(+), 12 deletions(-)",
    "diff": "diff --git a/doc/guides/rel_notes/release_22_11.rst b/doc/guides/rel_notes/release_22_11.rst\nindex 16aca14bab..b4329d4cb0 100644\n--- a/doc/guides/rel_notes/release_22_11.rst\n+++ b/doc/guides/rel_notes/release_22_11.rst\n@@ -193,6 +193,8 @@ New Features\n \n   * Added ``rte_eth_buffer_split_get_supported_hdr_ptypes()``, to get supported\n     header protocols of a PMD to split.\n+  * Supported protocol-based buffer split using added ``proto_hdr``\n+    in structure ``rte_eth_rxseg_split``.\n \n \n Removed Items\n@@ -338,6 +340,11 @@ API Changes\n   for per-queue packet split offload,\n   which is configured by ``rte_eth_rxseg_split``.\n \n+* ethdev: The ``reserved`` field in the ``rte_eth_rxseg_split`` structure is\n+  replaced with ``proto_hdr`` to support protocol header based buffer split.\n+  User can choose length or protocol header to configure buffer split\n+  according to NIC's capability.\n+\n * ethdev: Changed the type of the parameter ``rate`` of the function\n   ``rte_eth_set_queue_rate_limit()`` from ``uint16_t`` to ``uint32_t``\n   to support more than 64 Gbps.\ndiff --git a/lib/ethdev/rte_ethdev.c b/lib/ethdev/rte_ethdev.c\nindex 79d1f9b993..3696d4f044 100644\n--- a/lib/ethdev/rte_ethdev.c\n+++ b/lib/ethdev/rte_ethdev.c\n@@ -1687,15 +1687,38 @@ rte_eth_check_rx_mempool(struct rte_mempool *mp, uint16_t offset,\n }\n \n static int\n-rte_eth_rx_queue_check_split(const struct rte_eth_rxseg_split *rx_seg,\n-\t\t\t     uint16_t n_seg, uint32_t *mbp_buf_size,\n-\t\t\t     const struct rte_eth_dev_info *dev_info)\n+eth_dev_buffer_split_get_supported_hdrs_helper(uint16_t port_id, uint32_t **ptypes)\n+{\n+\tint cnt;\n+\n+\tcnt = rte_eth_buffer_split_get_supported_hdr_ptypes(port_id, NULL, 0);\n+\tif (cnt <= 0)\n+\t\treturn cnt;\n+\n+\t*ptypes = malloc(sizeof(uint32_t) * cnt);\n+\tif (*ptypes == NULL)\n+\t\treturn -ENOMEM;\n+\n+\treturn rte_eth_buffer_split_get_supported_hdr_ptypes(port_id, *ptypes, cnt);\n+}\n+\n+static int\n+rte_eth_rx_queue_check_split(uint16_t port_id,\n+\t\t\tconst struct rte_eth_rxseg_split *rx_seg,\n+\t\t\tuint16_t n_seg, uint32_t *mbp_buf_size,\n+\t\t\tconst struct rte_eth_dev_info *dev_info)\n {\n \tconst struct rte_eth_rxseg_capa *seg_capa = &dev_info->rx_seg_capa;\n \tstruct rte_mempool *mp_first;\n \tuint32_t offset_mask;\n \tuint16_t seg_idx;\n \tint ret;\n+\tint ptype_cnt;\n+\tuint32_t *ptypes, prev_proto_hdrs;\n+\tint i;\n+\n+\tret = 0;\n+\tprev_proto_hdrs = RTE_PTYPE_UNKNOWN;\n \n \tif (n_seg > seg_capa->max_nseg) {\n \t\tRTE_ETHDEV_LOG(ERR,\n@@ -1709,42 +1732,92 @@ rte_eth_rx_queue_check_split(const struct rte_eth_rxseg_split *rx_seg,\n \t */\n \tmp_first = rx_seg[0].mp;\n \toffset_mask = RTE_BIT32(seg_capa->offset_align_log2) - 1;\n+\n+\tptypes = NULL;\n+\tptype_cnt = eth_dev_buffer_split_get_supported_hdrs_helper(port_id, &ptypes);\n+\n \tfor (seg_idx = 0; seg_idx < n_seg; seg_idx++) {\n \t\tstruct rte_mempool *mpl = rx_seg[seg_idx].mp;\n \t\tuint32_t length = rx_seg[seg_idx].length;\n \t\tuint32_t offset = rx_seg[seg_idx].offset;\n+\t\tuint32_t proto_hdr = rx_seg[seg_idx].proto_hdr;\n \n \t\tif (mpl == NULL) {\n \t\t\tRTE_ETHDEV_LOG(ERR, \"null mempool pointer\\n\");\n-\t\t\treturn -EINVAL;\n+\t\t\tret = -EINVAL;\n+\t\t\tgoto out;\n \t\t}\n \t\tif (seg_idx != 0 && mp_first != mpl &&\n \t\t    seg_capa->multi_pools == 0) {\n \t\t\tRTE_ETHDEV_LOG(ERR, \"Receiving to multiple pools is not supported\\n\");\n-\t\t\treturn -ENOTSUP;\n+\t\t\tret = -ENOTSUP;\n+\t\t\tgoto out;\n \t\t}\n \t\tif (offset != 0) {\n \t\t\tif (seg_capa->offset_allowed == 0) {\n \t\t\t\tRTE_ETHDEV_LOG(ERR, \"Rx segmentation with offset is not supported\\n\");\n-\t\t\t\treturn -ENOTSUP;\n+\t\t\t\tret = -ENOTSUP;\n+\t\t\t\tgoto out;\n \t\t\t}\n \t\t\tif (offset & offset_mask) {\n \t\t\t\tRTE_ETHDEV_LOG(ERR, \"Rx segmentation invalid offset alignment %u, %u\\n\",\n \t\t\t\t\t       offset,\n \t\t\t\t\t       seg_capa->offset_align_log2);\n-\t\t\t\treturn -EINVAL;\n+\t\t\t\tret = -EINVAL;\n+\t\t\t\tgoto out;\n \t\t\t}\n \t\t}\n \n \t\toffset += seg_idx != 0 ? 0 : RTE_PKTMBUF_HEADROOM;\n \t\t*mbp_buf_size = rte_pktmbuf_data_room_size(mpl);\n-\t\tlength = length != 0 ? length : *mbp_buf_size;\n+\t\tif (proto_hdr != 0) {\n+\t\t\t/* Split based on protocol headers. */\n+\t\t\tif (length != 0) {\n+\t\t\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\t\t\"Do not set length split and protocol split within a segment\\n\"\n+\t\t\t\t\t);\n+\t\t\t\tret = -EINVAL;\n+\t\t\t\tgoto out;\n+\t\t\t}\n+\t\t\tif ((proto_hdr & prev_proto_hdrs) != 0) {\n+\t\t\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\t\t\"Repeat with previous protocol headers or proto-split after length-based split\\n\"\n+\t\t\t\t\t);\n+\t\t\t\tret = -EINVAL;\n+\t\t\t\tgoto out;\n+\t\t\t}\n+\t\t\tif (ptype_cnt <= 0) {\n+\t\t\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\t\t\"Port %u failed to get supported buffer split header protocols\\n\",\n+\t\t\t\t\tport_id);\n+\t\t\t\tret = -ENOTSUP;\n+\t\t\t\tgoto out;\n+\t\t\t}\n+\t\t\tfor (i = 0; i < ptype_cnt; i++) {\n+\t\t\t\tif ((prev_proto_hdrs | proto_hdr) == ptypes[i])\n+\t\t\t\t\tbreak;\n+\t\t\t}\n+\t\t\tif (i == ptype_cnt) {\n+\t\t\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\t\t\"Requested Rx split header protocols 0x%x is not supported.\\n\",\n+\t\t\t\t\tproto_hdr);\n+\t\t\t\tret = -EINVAL;\n+\t\t\t\tgoto out;\n+\t\t\t}\n+\t\t\tprev_proto_hdrs |= proto_hdr;\n+\t\t} else {\n+\t\t\t/* Split at fixed length. */\n+\t\t\tlength = length != 0 ? length : *mbp_buf_size;\n+\t\t\tprev_proto_hdrs = RTE_PTYPE_ALL_MASK;\n+\t\t}\n \n \t\tret = rte_eth_check_rx_mempool(mpl, offset, length);\n \t\tif (ret != 0)\n-\t\t\treturn ret;\n+\t\t\tgoto out;\n \t}\n-\treturn 0;\n+out:\n+\tfree(ptypes);\n+\treturn ret;\n }\n \n static int\n@@ -1846,7 +1919,7 @@ rte_eth_rx_queue_setup(uint16_t port_id, uint16_t rx_queue_id,\n \t\tn_seg = rx_conf->rx_nseg;\n \n \t\tif (rx_offloads & RTE_ETH_RX_OFFLOAD_BUFFER_SPLIT) {\n-\t\t\tret = rte_eth_rx_queue_check_split(rx_seg, n_seg,\n+\t\t\tret = rte_eth_rx_queue_check_split(port_id, rx_seg, n_seg,\n \t\t\t\t\t\t\t   &mbp_buf_size,\n \t\t\t\t\t\t\t   &dev_info);\n \t\t\tif (ret != 0)\ndiff --git a/lib/ethdev/rte_ethdev.h b/lib/ethdev/rte_ethdev.h\nindex f9da569179..811c029bf8 100644\n--- a/lib/ethdev/rte_ethdev.h\n+++ b/lib/ethdev/rte_ethdev.h\n@@ -994,6 +994,9 @@ struct rte_eth_txmode {\n  *   specified in the first array element, the second buffer, from the\n  *   pool in the second element, and so on.\n  *\n+ * - The proto_hdrs in the elements define the split position of\n+ *   received packets.\n+ *\n  * - The offsets from the segment description elements specify\n  *   the data offset from the buffer beginning except the first mbuf.\n  *   The first segment offset is added with RTE_PKTMBUF_HEADROOM.\n@@ -1015,12 +1018,44 @@ struct rte_eth_txmode {\n  *     - pool from the last valid element\n  *     - the buffer size from this pool\n  *     - zero offset\n+ *\n+ * - Length based buffer split:\n+ *     - mp, length, offset should be configured.\n+ *     - The proto_hdr field must be 0.\n+ *\n+ * - Protocol header based buffer split:\n+ *     - mp, offset, proto_hdr should be configured.\n+ *     - The length field must be 0.\n+ *     - The proto_hdr field in the last segment should be 0.\n+ *\n+ * - When protocol header split is enabled, NIC may receive packets\n+ *   which do not match all the protocol headers within the Rx segments.\n+ *   At this point, NIC will have two possible split behaviors according to\n+ *   matching results, one is exact match, another is longest match.\n+ *   The split result of NIC must belong to one of them.\n+ *   The exact match means NIC only do split when the packets exactly match all\n+ *   the protocol headers in the segments. Otherwise, the whole packet will be\n+ *   put into the last valid mempool. The longest match means NIC will do split\n+ *   until packets mismatch the protocol header in the segments. The rest will\n+ *   be put into the last valid pool.\n  */\n struct rte_eth_rxseg_split {\n \tstruct rte_mempool *mp; /**< Memory pool to allocate segment from. */\n \tuint16_t length; /**< Segment data length, configures split point. */\n \tuint16_t offset; /**< Data offset from beginning of mbuf data buffer. */\n-\tuint32_t reserved; /**< Reserved field. */\n+\t/**\n+\t * Proto_hdr defines a bit mask of the protocol sequence as RTE_PTYPE_*,\n+\t * configures split point. The last RTE_PTYPE* in the mask indicates the\n+\t * split position.\n+\t *\n+\t * If one protocol header is defined to split packets into two segments,\n+\t * for non-tunneling packets, the complete protocol sequence should be defined.\n+\t * For tunneling packets, for simplicity, only the tunnel and inner part of\n+\t * comple protocol sequence is required.\n+\t * If several protocol headers are defined to split packets into multi-segments,\n+\t * the repeated parts of adjacent segments should be omitted.\n+\t */\n+\tuint32_t proto_hdr;\n };\n \n /**\n",
    "prefixes": [
        "v9",
        "2/4"
    ]
}