Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/1.1/patches/2221015/?format=api
{ "id": 2221015, "url": "http://patchwork.ozlabs.org/api/1.1/patches/2221015/?format=api", "web_url": "http://patchwork.ozlabs.org/project/openvswitch/patch/20260408170613.587902-13-aconole@redhat.com/", "project": { "id": 47, "url": "http://patchwork.ozlabs.org/api/1.1/projects/47/?format=api", "name": "Open vSwitch", "link_name": "openvswitch", "list_id": "ovs-dev.openvswitch.org", "list_email": "ovs-dev@openvswitch.org", "web_url": "http://openvswitch.org/", "scm_url": "git@github.com:openvswitch/ovs.git", "webscm_url": "https://github.com/openvswitch/ovs" }, "msgid": "<20260408170613.587902-13-aconole@redhat.com>", "date": "2026-04-08T17:06:08", "name": "[ovs-dev,RFC,12/12] Documentation: Announce and describe the conntrack offload feature.", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "e406354bb1be4481a78c90d38383ca390c3bdb5e", "submitter": { "id": 67184, "url": "http://patchwork.ozlabs.org/api/1.1/people/67184/?format=api", "name": "Aaron Conole", "email": "aconole@redhat.com" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/openvswitch/patch/20260408170613.587902-13-aconole@redhat.com/mbox/", "series": [ { "id": 499163, "url": "http://patchwork.ozlabs.org/api/1.1/series/499163/?format=api", "web_url": "http://patchwork.ozlabs.org/project/openvswitch/list/?series=499163", "date": "2026-04-08T17:05:56", "name": "ct-offload: Introduce a conntrack offload infrastructure.", "version": 1, "mbox": "http://patchwork.ozlabs.org/series/499163/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2221015/comments/", "check": "fail", "checks": "http://patchwork.ozlabs.org/api/patches/2221015/checks/", "tags": {}, "headers": { "Return-Path": "<ovs-dev-bounces@openvswitch.org>", "X-Original-To": [ "incoming@patchwork.ozlabs.org", "dev@openvswitch.org" ], "Delivered-To": [ "patchwork-incoming@legolas.ozlabs.org", "ovs-dev@lists.linuxfoundation.org" ], "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=jNiOCTmW;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org\n (client-ip=2605:bc80:3010::136; helo=smtp3.osuosl.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver=patchwork.ozlabs.org)", "smtp3.osuosl.org;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key)\n header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=jNiOCTmW", "smtp1.osuosl.org; dmarc=pass (p=quarantine dis=none)\n header.from=redhat.com", "smtp1.osuosl.org;\n dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com\n header.a=rsa-sha256 header.s=mimecast20190719 header.b=jNiOCTmW" ], "Received": [ "from smtp3.osuosl.org (smtp3.osuosl.org [IPv6:2605:bc80:3010::136])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4frTyg493Cz1xv0\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 09 Apr 2026 03:07:39 +1000 (AEST)", "from localhost (localhost [127.0.0.1])\n\tby smtp3.osuosl.org (Postfix) with ESMTP id 3A381610A0;\n\tWed, 8 Apr 2026 17:07:38 +0000 (UTC)", "from smtp3.osuosl.org ([127.0.0.1])\n by localhost (smtp3.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id RuJXu-7W7-ji; Wed, 8 Apr 2026 17:07:37 +0000 (UTC)", "from lists.linuxfoundation.org (lf-lists.osuosl.org\n [IPv6:2605:bc80:3010:104::8cd3:938])\n\tby smtp3.osuosl.org (Postfix) with ESMTPS id 5EFDA60FE6;\n\tWed, 8 Apr 2026 17:07:32 +0000 (UTC)", "from lf-lists.osuosl.org (localhost [127.0.0.1])\n\tby lists.linuxfoundation.org (Postfix) with ESMTP id 4957CC054A;\n\tWed, 8 Apr 2026 17:07:32 +0000 (UTC)", "from smtp1.osuosl.org (smtp1.osuosl.org [140.211.166.138])\n by lists.linuxfoundation.org (Postfix) with ESMTP id 18220C0549\n for <dev@openvswitch.org>; Wed, 8 Apr 2026 17:07:31 +0000 (UTC)", "from localhost (localhost [127.0.0.1])\n by smtp1.osuosl.org (Postfix) with ESMTP id 66994826C8\n for <dev@openvswitch.org>; Wed, 8 Apr 2026 17:06:46 +0000 (UTC)", "from smtp1.osuosl.org ([127.0.0.1])\n by localhost (smtp1.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id tCNQc4ZySpg4 for <dev@openvswitch.org>;\n Wed, 8 Apr 2026 17:06:45 +0000 (UTC)", "from us-smtp-delivery-124.mimecast.com\n (us-smtp-delivery-124.mimecast.com [170.10.133.124])\n by smtp1.osuosl.org (Postfix) with ESMTPS id 4D169826FF\n for <dev@openvswitch.org>; Wed, 8 Apr 2026 17:06:45 +0000 (UTC)", "from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com\n (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by\n relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n cipher=TLS_AES_256_GCM_SHA384) id us-mta-112-M4ztafzNNGSEGuU-FBeD2g-1; Wed,\n 08 Apr 2026 13:06:43 -0400", "from mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.4])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n (No client certificate requested)\n by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 0E95918005B6; Wed, 8 Apr 2026 17:06:42 +0000 (UTC)", "from RHTRH0061144.redhat.com (unknown [10.22.89.172])\n by mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id A11BA300019F; Wed, 8 Apr 2026 17:06:40 +0000 (UTC)" ], "X-Virus-Scanned": [ "amavis at osuosl.org", "amavis at osuosl.org" ], "X-Comment": "SPF check N/A for local connections -\n client-ip=2605:bc80:3010:104::8cd3:938; helo=lists.linuxfoundation.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver=<UNKNOWN> ", "DKIM-Filter": [ "OpenDKIM Filter v2.11.0 smtp3.osuosl.org 5EFDA60FE6", "OpenDKIM Filter v2.11.0 smtp1.osuosl.org 4D169826FF" ], "Received-SPF": "Pass (mailfrom) identity=mailfrom; client-ip=170.10.133.124;\n helo=us-smtp-delivery-124.mimecast.com; envelope-from=aconole@redhat.com;\n receiver=<UNKNOWN>", "DMARC-Filter": "OpenDMARC Filter v1.4.2 smtp1.osuosl.org 4D169826FF", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1775668004;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:cc:mime-version:mime-version:content-type:content-type:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=AKVaiu6XOD23ZBqRotaGMOi0GGtT2MNh+Ce+msQLRaE=;\n b=jNiOCTmWV2NoE4DeUWmlp2Pgr7vKGeJF1mw9NSxgRMBPhS//R58YoY4eeMtwyQPt0l55QM\n Z0k3rEa19pgZdr082/2OebGpg9U02cTZp136alRD2a3B4F7FgyWa+oVMAYCPzNE6JrW3nj\n nnlHLTPtQeXnR85TDh3y3CqZJSvKnOk=", "X-MC-Unique": "M4ztafzNNGSEGuU-FBeD2g-1", "X-Mimecast-MFC-AGG-ID": "M4ztafzNNGSEGuU-FBeD2g_1775668002", "To": "dev@openvswitch.org", "Date": "Wed, 8 Apr 2026 13:06:08 -0400", "Message-ID": "<20260408170613.587902-13-aconole@redhat.com>", "In-Reply-To": "<20260408170613.587902-1-aconole@redhat.com>", "References": "<20260408170613.587902-1-aconole@redhat.com>", "MIME-Version": "1.0", "X-Scanned-By": "MIMEDefang 3.4.1 on 10.30.177.4", "X-Mimecast-Spam-Score": "0", "X-Mimecast-MFC-PROC-ID": "RNfULPXT_6vYyWo-ueM31XZOm3BToc4MUh6GugtyBRw_1775668002", "X-Mimecast-Originator": "redhat.com", "Subject": "[ovs-dev] [RFC 12/12] Documentation: Announce and describe the\n conntrack offload feature.", "X-BeenThere": "ovs-dev@openvswitch.org", "X-Mailman-Version": "2.1.30", "Precedence": "list", "List-Id": "<ovs-dev.openvswitch.org>", "List-Unsubscribe": "<https://mail.openvswitch.org/mailman/options/ovs-dev>,\n <mailto:ovs-dev-request@openvswitch.org?subject=unsubscribe>", "List-Archive": "<http://mail.openvswitch.org/pipermail/ovs-dev/>", "List-Post": "<mailto:ovs-dev@openvswitch.org>", "List-Help": "<mailto:ovs-dev-request@openvswitch.org?subject=help>", "List-Subscribe": "<https://mail.openvswitch.org/mailman/listinfo/ovs-dev>,\n <mailto:ovs-dev-request@openvswitch.org?subject=subscribe>", "From": "Aaron Conole via dev <ovs-dev@openvswitch.org>", "Reply-To": "Aaron Conole <aconole@redhat.com>", "Cc": "Eli Britstein <elibr@nvidia.com>, Florian Westphal <fwestpha@redhat.com>,\n Flavio Leitner <fbl@redhat.com>", "Content-Type": "text/plain; charset=\"us-ascii\"", "Content-Transfer-Encoding": "7bit", "Errors-To": "ovs-dev-bounces@openvswitch.org", "Sender": "\"dev\" <ovs-dev-bounces@openvswitch.org>" }, "content": "Signed-off-by: Aaron Conole <aconole@redhat.com>\n---\n Documentation/automake.mk | 1 +\n Documentation/topics/index.rst | 1 +\n .../topics/userspace-conntrack-offloading.rst | 76 +++++++++++++++++++\n NEWS | 1 +\n 4 files changed, 79 insertions(+)\n create mode 100644 Documentation/topics/userspace-conntrack-offloading.rst", "diff": "diff --git a/Documentation/automake.mk b/Documentation/automake.mk\nindex ea9459b555..7b84af79ba 100644\n--- a/Documentation/automake.mk\n+++ b/Documentation/automake.mk\n@@ -59,6 +59,7 @@ DOC_SOURCE = \\\n \tDocumentation/topics/tracing.rst \\\n \tDocumentation/topics/usdt-probes.rst \\\n \tDocumentation/topics/userspace-checksum-offloading.rst \\\n+\tDocumentation/topics/userspace-conntrack-offloading.rst \\\n \tDocumentation/topics/userspace-tso.rst \\\n \tDocumentation/topics/userspace-tx-steering.rst \\\n \tDocumentation/topics/windows.rst \\\ndiff --git a/Documentation/topics/index.rst b/Documentation/topics/index.rst\nindex 9ddb145dd4..871871a3dc 100644\n--- a/Documentation/topics/index.rst\n+++ b/Documentation/topics/index.rst\n@@ -56,6 +56,7 @@ OVS\n idl-compound-indexes\n ovs-extensions\n userspace-checksum-offloading\n+ userspace-conntrack-offloading\n userspace-tx-steering\n usdt-probes\n flow-visualization\ndiff --git a/Documentation/topics/userspace-conntrack-offloading.rst b/Documentation/topics/userspace-conntrack-offloading.rst\nnew file mode 100644\nindex 0000000000..26ba838c88\n--- /dev/null\n+++ b/Documentation/topics/userspace-conntrack-offloading.rst\n@@ -0,0 +1,76 @@\n+..\n+ Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n+ not use this file except in compliance with the License. You may obtain\n+ a copy of the License at\n+\n+ http://www.apache.org/licenses/LICENSE-2.0\n+\n+ Unless required by applicable law or agreed to in writing, software\n+ distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT\n+ WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the\n+ License for the specific language governing permissions and limitations\n+ under the License.\n+\n+ Convention for heading levels in Open vSwitch documentation:\n+\n+ ======= Heading 0 (reserved for the title in a document)\n+ ------- Heading 1\n+ ~~~~~~~ Heading 2\n+ +++++++ Heading 3\n+ ''''''' Heading 4\n+\n+ Avoid deeper levels because they do not render well.\n+\n+=========================================\n+Userspace Datapath - Conntrack offloading\n+=========================================\n+\n+This document explains the internals of the Open vSwitch userspace connection\n+tracking offloading.\n+\n+Design\n+------\n+\n+Open vSwitch provides a modified BSD stack based connection tracking facility\n+which primarily processes packet-at-a-time into various state updates.\n+This runs inline with the pmd execution pipeline through the\n+`conntrack_execute` into the `process_one` call.\n+\n+The core of the offload mechanism is the `ct_offload_class` structure. This\n+structure defines the callbacks for offload providers, allowing them to\n+register for specific connection tracking events. Each offload provider\n+instance is placed in a list in priority order, and each one is called during\n+operation processing. There is a single bulked operations interface, but it\n+currently is limited to calling into each ops list facility-at-a-time.\n+\n+All offload is done under a large `ct_offload` lock to keep the offload\n+provider list coherent.\n+\n+Primary Connection Events\n+-------------------------\n+\n+The offload provider handles specific events corresponding to the lifecycle of\n+a connection. These are call-ins provided by the `ct_offload_class` structure.\n+\n+* Connection Add (conn_add) is triggered when a connection is created and\n+ committed to the connection list.\n+ When triggered, the provider receives the conn_add event to initialize\n+ tracking for the new connection.\n+* Connection Delete (conn_del) is triggered when a connection is removed.\n+ The provider receives the conn_del event to clean up resources.\n+* Connection Established (conn_established)\n+ This is a special event that occurs exactly once when the first\n+ reply-direction packet is seen for an offloaded connection.\n+ The netdev_in will contain the reply netdev. The offload provider should\n+ have access to the initial netdev from the conn_add and the reply direction\n+ from the conn_established events. This allows the provider to track both\n+ sides of the connection.\n+* Connection Update (conn_update) is called when the connection tracking (ct)\n+ expiration timer is set to run expiration processing for a connection.\n+ It asks for an update on the packet list. It returns the last-used timestamp\n+ in milliseconds since epoch, or 0 on failure.\n+\n+Configuration\n+-------------\n+Conntrack offload is configured as part of dpif offloading for userspace. It\n+utilizes the same configuration knob to enable offloading features.\ndiff --git a/NEWS b/NEWS\nindex 1a3044cbfb..80ee597abb 100644\n--- a/NEWS\n+++ b/NEWS\n@@ -3,6 +3,7 @@ Post-v3.7.0\n - Userspace datapath:\n * ARP/ND lookups for native tunnel are now rate limited. The holdout\n timer can be configured with 'tnl/neigh/retrans_time'.\n+ * Add preliminary support for conntrack offloading.\n \n \n v3.7.0 - 16 Feb 2026\n", "prefixes": [ "ovs-dev", "RFC", "12/12" ] }