From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 8DF04464CC for ; Mon, 31 Mar 2025 23:42:34 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 89C6F40A6F; Mon, 31 Mar 2025 23:42:34 +0200 (CEST) Received: from mail.loongson.cn (mail.loongson.cn [114.242.206.163]) by mails.dpdk.org (Postfix) with ESMTP id 1862C40A6C for ; Mon, 31 Mar 2025 23:42:31 +0200 (CEST) Received: from loongson.cn (unknown [10.40.64.71]) by gateway (Coremail) with SMTP id _____8BxYa9FDOtnQfKsAA--.51559S3; Tue, 01 Apr 2025 05:42:30 +0800 (CST) Received: from localhost.localdomain (unknown [10.40.64.71]) by front1 (Coremail) with SMTP id qMiowMAxj8VEDOtnV8BpAA--.56758S3; Tue, 01 Apr 2025 05:42:28 +0800 (CST) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by localhost.localdomain (8.15.2/8.15.2) with ESMTPS id 52VL6Lp01003767 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NOT); Tue, 1 Apr 2025 05:06:21 +0800 Received: (from root@localhost) by localhost.localdomain (8.15.2/8.15.2/Submit) id 52VL6K181003766; Tue, 1 Apr 2025 05:06:20 +0800 Date: Tue, 1 Apr 2025 05:06:20 +0800 From: qemudev@loongson.cn Message-Id: <202503312106.52VL6K181003766@localhost.localdomain> Content-Type: text/plain; charset="utf-8" Subject: |WARNING| pw152698 [PATCH] doc: reword flow offload and api docs In-Reply-To: <20250331214036.17295-1-nandinipersad361@gmail.com> References: <20250331214036.17295-1-nandinipersad361@gmail.com> To: test-report@dpdk.org Cc: Nandini Persad , zhoumin@loongson.cn X-CM-TRANSID: qMiowMAxj8VEDOtnV8BpAA--.56758S3 X-CM-SenderInfo: pthp3vthy6z05rqj20fqof0/1tbiAQESD2fpyU8O1wACsO X-Coremail-Antispam: 1Uk129KBj93XoWxJF43Cw1DCryUCr47CFyrZrc_yoWrur1UpF n3Jr92qFy7Jryjgr47Jw45tryUJw1rJ3yDtF1xtry8X3y5Ar45Ar1UJFW8JryUGry8A34U AFyUJw1UJryUJrXCm3ZEXasCq-sJn29KB7ZKAUJUUUU8529EdanIXcx71UUUUU7KY7ZEXa sCq-sGcSsGvfJ3Ic02F40EFcxC0VAKzVAqx4xG6I80ebIjqfuFe4nvWSU5nxnvy29KBjDU 0xBIdaVrnRJUUUk0b4IE77IF4wAFF20E14v26r1j6r4UM7CY07I20VC2zVCF04k26cxKx2 IYs7xG6rWj6s0DM7CIcVAFz4kK6r1j6r18M28lY4IEw2IIxxk0rwA2F7IY1VAKz4vEj48v e4kI8wA2z4x0Y4vE2Ix0cI8IcVAFwI0_Gr0_Xr1l84ACjcxK6xIIjxv20xvEc7CjxVAFwI 0_Gr0_Cr1l84ACjcxK6I8E87Iv67AKxVW8Jr0_Cr1UM28EF7xvwVC2z280aVCY1x0267AK xVW8Jr0_Cr1UM2AIxVAIcxkEcVAq07x20xvEncxIr21l57IF6xkI12xvs2x26I8E6xACxx 1l5I8CrVACY4xI64kE6c02F40Ex7xfMcIj6xIIjxv20xvE14v26r106r15McIj6I8E87Iv 67AKxVWUJVW8JwAm72CE4IkC6x0Yz7v_Jr0_Gr1lw4CEc2x0rVAKj4xxMxAIw28IcxkI7V AKI48JMxC20s026xCaFVCjc4AY6r1j6r4UMI8I3I0E5I8CrVAFwI0_Jr0_Jr4lx2IqxVCj r7xvwVAFwI0_JrI_JrWlx4CE17CEb7AF67AKxVWUXVWUAwCIc40Y0x0EwIxGrwCI42IY6x IIjxv20xvE14v26r1j6r1xMIIF0xvE2Ix0cI8IcVCY1x0267AKxVWUJVW8JwCI42IY6xAI w20EY4v20xvaj40_Jr0_JF4lIxAIcVC2z280aVAFwI0_Jr0_Gr1lIxAIcVC2z280aVCY1x 0267AKxVWUJVW8JbIYCTnIWIevJa73UjIFyTuYvjxUFGYLDUUUU X-BeenThere: test-report@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: automatic DPDK test reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: test-report-bounces@dpdk.org Test-Label: loongarch-compilation Test-Status: WARNING http://dpdk.org/patch/152698 _apply patch failure_ Submitter: Nandini Persad Date: Mon, 31 Mar 2025 14:40:36 -0700 DPDK git baseline: Repo:dpdk-next-net Branch: main CommitID: f3cb237103aada7bc83fd3f40929fb6fb3e58c3b Apply patch set 152698 failed: Checking patch doc/guides/prog_guide/ethdev/flow_offload.rst... error: while searching for: (Ethernet) and L4 (UDP). Doing so is only allowed at the bottom and at the top of the stack. Meta item types ~~~~~~~~~~~~~~~ They match meta-data or affect pattern processing instead of matching packet data directly, most of them do not need a specification structure. This particularity allows them to be specified anywhere in the stack without causing any side effect. Item: ``END`` ^^^^^^^^^^^^^ End marker for item lists. Prevents further processing of items, thereby ending the pattern. - Its numeric value is 0 for convenience. - PMD support is mandatory. - ``spec``, ``last`` and ``mask`` are ignored. . _table_rte_flow_item_end: . table:: END +----------+---------+ | Field | Value | +==========+=========+ | ``spec`` | ignored | +----------+---------+ | ``last`` | ignored | +----------+---------+ | ``mask`` | ignored | +----------+---------+ Item: ``VOID`` ^^^^^^^^^^^^^^ Used as a placeholder for convenience. It is ignored and simply discarded by PMDs. - PMD support is mandatory. - ``spec``, ``last`` and ``mask`` are ignored. . _table_rte_flow_item_void: . table:: VOID +----------+---------+ | Field | Value | +==========+=========+ | ``spec`` | ignored | +----------+---------+ | ``last`` | ignored | +----------+---------+ | ``mask`` | ignored | +----------+---------+ One usage example for this type is generating rules that share a common prefix quickly without reallocating memory, only by updating item types: . _table_rte_flow_item_void_example: . table:: TCP, UDP or ICMP as L4 +-------+--------------------+ | Index | Item | +=======+====================+ | 0 | Ethernet | +-------+--------------------+ | 1 | IPv4 | +-------+------+------+------+ | 2 | UDP | VOID | VOID | +-------+------+------+------+ | 3 | VOID | TCP | VOID | +-------+------+------+------+ | 4 | VOID | VOID | ICMP | +-------+------+------+------+ | 5 | END | +-------+--------------------+ Item: ``INVERT`` ^^^^^^^^^^^^^^^^ Inverted matching, i.e. process packets that do not match the pattern. - ``spec``, ``last`` and ``mask`` are ignored. . _table_rte_flow_item_invert: . table:: INVERT +----------+---------+ | Field | Value | +==========+=========+ | ``spec`` | ignored | +----------+---------+ | ``last`` | ignored | +----------+---------+ | ``mask`` | ignored | +----------+---------+ Usage example, matching non-TCPv4 packets only: . _table_rte_flow_item_invert_example: . table:: Anything but TCPv4 +-------+----------+ | Index | Item | +=======+==========+ | 0 | INVERT | +-------+----------+ | 1 | Ethernet | +-------+----------+ | 2 | IPv4 | +-------+----------+ | 3 | TCP | +-------+----------+ | 4 | END | +-------+----------+ Item: ``PORT_ID`` ^^^^^^^^^^^^^^^^^ This item is deprecated. Consider: - `Item: PORT_REPRESENTOR`_ - `Item: REPRESENTED_PORT`_ Matches traffic originating from (ingress) or going to (egress) a given DPDK port ID. Normally only supported if the port ID in question is known by the underlying PMD and related to the device the flow rule is created against. - Default ``mask`` matches the specified DPDK port ID. . _table_rte_flow_item_port_id: . table:: PORT_ID +----------+----------+-----------------------------+ | Field | Subfield | Value | +==========+==========+=============================+ | ``spec`` | ``id`` | DPDK port ID | +----------+----------+-----------------------------+ | ``last`` | ``id`` | upper range value | +----------+----------+-----------------------------+ | ``mask`` | ``id`` | zeroed to match any port ID | +----------+----------+-----------------------------+ Item: ``MARK`` ^^^^^^^^^^^^^^ Matches an arbitrary integer value which was set using the ``MARK`` action error: patch failed: doc/guides/prog_guide/ethdev/flow_offload.rst:412 error: doc/guides/prog_guide/ethdev/flow_offload.rst: patch does not apply Checking patch lib/ethdev/rte_flow.h...