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 82E7C46555 for ; Thu, 10 Apr 2025 20:44:39 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 5EDEF40698; Thu, 10 Apr 2025 20:44:39 +0200 (CEST) Received: from mail.loongson.cn (mail.loongson.cn [114.242.206.163]) by mails.dpdk.org (Postfix) with ESMTP id BA8A8402ED for ; Thu, 10 Apr 2025 20:44:37 +0200 (CEST) Received: from loongson.cn (unknown [10.40.64.71]) by gateway (Coremail) with SMTP id _____8CxeXGSEfhn6Ze3AA--.42764S3; Fri, 11 Apr 2025 02:44:34 +0800 (CST) Received: from localhost.localdomain (unknown [10.40.64.71]) by front1 (Coremail) with SMTP id qMiowMCx7MSQEfhnC+N4AA--.32360S3; Fri, 11 Apr 2025 02:44:32 +0800 (CST) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by localhost.localdomain (8.15.2/8.15.2) with ESMTPS id 53AI8NjI1956975 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NOT); Fri, 11 Apr 2025 02:08:23 +0800 Received: (from root@localhost) by localhost.localdomain (8.15.2/8.15.2/Submit) id 53AI8Nu51956974; Fri, 11 Apr 2025 02:08:23 +0800 Date: Fri, 11 Apr 2025 02:08:23 +0800 From: qemudev@loongson.cn Message-Id: <202504101808.53AI8Nu51956974@localhost.localdomain> Content-Type: text/plain; charset="utf-8" Subject: |WARNING| pw152873 [PATCH v2] doc: reword flow offload and api docs In-Reply-To: <20250410183931.40881-1-nandinipersad361@gmail.com> References: <20250410183931.40881-1-nandinipersad361@gmail.com> To: test-report@dpdk.org Cc: Nandini Persad , zhoumin@loongson.cn X-CM-TRANSID: qMiowMCx7MSQEfhnC+N4AA--.32360S3 X-CM-SenderInfo: pthp3vthy6z05rqj20fqof0/1tbiAgEID2f2-2QV2QABsD X-Coremail-Antispam: 1Uk129KBj93XoWxJF4fury3XF4fWw4xGFWDJrc_yoWrur1UpF n3Jr92qFy7Jryjgr47Jw45tryUJwn5J398tF1xtry8X3y5Ar45Ar1UJFW8JryUGry8AryU tFyUJw1UJr1UJFXCm3ZEXasCq-sJn29KB7ZKAUJUUUUU529EdanIXcx71UUUUU7KY7ZEXa sCq-sGcSsGvfJ3Ic02F40EFcxC0VAKzVAqx4xG6I80ebIjqfuFe4nvWSU5nxnvy29KBjDU 0xBIdaVrnRJUUUyEb4IE77IF4wAFF20E14v26r1j6r4UM7CY07I20VC2zVCF04k26cxKx2 IYs7xG6rWj6s0DM7CIcVAFz4kK6r106r15M28lY4IEw2IIxxk0rwA2F7IY1VAKz4vEj48v e4kI8wA2z4x0Y4vE2Ix0cI8IcVAFwI0_Gr0_Xr1l84ACjcxK6xIIjxv20xvEc7CjxVAFwI 0_Gr0_Cr1l84ACjcxK6I8E87Iv67AKxVWxJr0_GcWl84ACjcxK6I8E87Iv6xkF7I0E14v2 6F4UJVW0owAS0I0E0xvYzxvE52x082IY62kv0487Mc804VCY07AIYIkI8VC2zVCFFI0UMc 02F40EFcxC0VAKzVAqx4xG6I80ewAv7VC0I7IYx2IY67AKxVWUGVWUXwAv7VC2z280aVAF wI0_Jr0_Gr1lOx8S6xCaFVCjc4AY6r1j6r4UM4kE6xkIj40Ew7xC0wCF04k20xvY0x0EwI xGrwCFx2IqxVCFs4IE7xkEbVWUJVW8JwC20s026c02F40E14v26r1j6r18MI8I3I0E7480 Y4vE14v26r106r1rMI8E67AF67kF1VAFwI0_Jrv_JF1lIxkGc2Ij64vIr41lIxAIcVC0I7 IYx2IY67AKxVWUJVWUCwCI42IY6xIIjxv20xvEc7CjxVAFwI0_Jr0_Gr1lIxAIcVCF04k2 6cxKx2IYs7xG6r1j6r1xMIIF0xvEx4A2jsIE14v26r1j6r4UMIIF0xvEx4A2jsIEc7CjxV AFwI0_Jr0_GrUvcSsGvfC2KfnxnUUI43ZEXa7IU80ksDUUUUU== 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/152873 _apply patch failure_ Submitter: Nandini Persad Date: Thu, 10 Apr 2025 11:39:31 -0700 DPDK git baseline: Repo:dpdk-next-net Branch: main CommitID: b69fb7abb6d211cb74284029c6cdb2066b9ac0e9 Apply patch set 152873 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...