{"id":2223658,"url":"http://patchwork.ozlabs.org/api/1.1/patches/2223658/?format=json","web_url":"http://patchwork.ozlabs.org/project/netfilter-devel/patch/20260415223309.95527-1-pablo@netfilter.org/","project":{"id":26,"url":"http://patchwork.ozlabs.org/api/1.1/projects/26/?format=json","name":"Netfilter Development","link_name":"netfilter-devel","list_id":"netfilter-devel.vger.kernel.org","list_email":"netfilter-devel@vger.kernel.org","web_url":null,"scm_url":null,"webscm_url":null},"msgid":"<20260415223309.95527-1-pablo@netfilter.org>","date":"2026-04-15T22:33:07","name":"[nf,v3,1/3] rculist: add list_splice_rcu() for private lists","commit_ref":null,"pull_url":null,"state":"changes-requested","archived":false,"hash":"3ab9ef6053b3ca1d8f1c87534bae5b7f60ab9f0a","submitter":{"id":1315,"url":"http://patchwork.ozlabs.org/api/1.1/people/1315/?format=json","name":"Pablo Neira Ayuso","email":"pablo@netfilter.org"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/netfilter-devel/patch/20260415223309.95527-1-pablo@netfilter.org/mbox/","series":[{"id":500049,"url":"http://patchwork.ozlabs.org/api/1.1/series/500049/?format=json","web_url":"http://patchwork.ozlabs.org/project/netfilter-devel/list/?series=500049","date":"2026-04-15T22:33:07","name":"[nf,v3,1/3] rculist: add list_splice_rcu() for private lists","version":3,"mbox":"http://patchwork.ozlabs.org/series/500049/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2223658/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2223658/checks/","tags":{},"headers":{"Return-Path":"\n <netfilter-devel+bounces-11943-incoming=patchwork.ozlabs.org@vger.kernel.org>","X-Original-To":["incoming@patchwork.ozlabs.org","netfilter-devel@vger.kernel.org"],"Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=netfilter.org header.i=@netfilter.org\n header.a=rsa-sha256 header.s=2025 header.b=kf9LaL/r;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=104.64.211.4; helo=sin.lore.kernel.org;\n envelope-from=netfilter-devel+bounces-11943-incoming=patchwork.ozlabs.org@vger.kernel.org;\n receiver=patchwork.ozlabs.org)","smtp.subspace.kernel.org;\n\tdkim=pass (2048-bit key) header.d=netfilter.org header.i=@netfilter.org\n header.b=\"kf9LaL/r\"","smtp.subspace.kernel.org;\n arc=none smtp.client-ip=217.70.190.124","smtp.subspace.kernel.org;\n dmarc=none (p=none dis=none) header.from=netfilter.org","smtp.subspace.kernel.org;\n spf=pass smtp.mailfrom=netfilter.org"],"Received":["from sin.lore.kernel.org (sin.lore.kernel.org [104.64.211.4])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fwwsP4d1tz1yG9\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 16 Apr 2026 08:33:29 +1000 (AEST)","from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby sin.lore.kernel.org (Postfix) with ESMTP id 10B3F30200FC\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 15 Apr 2026 22:33:20 +0000 (UTC)","from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 4FBF7388E51;\n\tWed, 15 Apr 2026 22:33:18 +0000 (UTC)","from mail.netfilter.org (mail.netfilter.org [217.70.190.124])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby smtp.subspace.kernel.org (Postfix) with ESMTPS id 7D3F6364EB0\n\tfor <netfilter-devel@vger.kernel.org>; Wed, 15 Apr 2026 22:33:15 +0000 (UTC)","from localhost.localdomain (mail-agni [217.70.190.124])\n\tby mail.netfilter.org (Postfix) with ESMTPSA id 1041F600B9;\n\tThu, 16 Apr 2026 00:33:12 +0200 (CEST)"],"ARC-Seal":"i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1776292397; cv=none;\n b=ihH2ePhnfGsH/s9VhW/SjQY3xVZHx0t0DiKnzJ8pBPE3K3RAP7J/ILmwbx88jj3zzm0Ggq+mnhGLFxB/MAernl+1mTNDERHq8p0y7av1xMCTGQKJoiLiJFPhxW7fYbOHrpY/51eIA748j1AKnVWg/76O1fb6yx1lfYGjSKPeZto=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1776292397; c=relaxed/simple;\n\tbh=o63cZQCtcJdWzsfwaBnOzSylLO1uUllSuooGy93dwIU=;\n\th=From:To:Cc:Subject:Date:Message-ID:MIME-Version;\n b=SpqIZ5rw3moDqONbaFbTI7Twp4VTk+6VZc22ObMG8vTksuT8npyFnx09ke+gUxTDh6XL8GTvg8ZkSzVLYDMe7VFjNQnGOut/1yKlLOho8OkqfcSH6fVMHnrikYJvsBkQ4ZDm/5f54AKivLtS6lHZJmbxUSaLoxfCB3N+l4DVaTM=","ARC-Authentication-Results":"i=1; smtp.subspace.kernel.org;\n dmarc=none (p=none dis=none) header.from=netfilter.org;\n spf=pass smtp.mailfrom=netfilter.org;\n dkim=pass (2048-bit key) header.d=netfilter.org header.i=@netfilter.org\n header.b=kf9LaL/r; arc=none smtp.client-ip=217.70.190.124","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=netfilter.org;\n\ts=2025; t=1776292393;\n\tbh=oocH5WbpYY0EAID3hjac+owoCHI8pb7lHZMAbRtlH04=;\n\th=From:To:Cc:Subject:Date:From;\n\tb=kf9LaL/rsa9LIEJtczO8EuYohmitGNmLEplLqwXZV8Fx2GNvGbnoYLO6r/qbwlKc4\n\t 02Cm6ULDiJn4mc+Ewp//X21u88zfCkRODj3X+UDJ/K7TVcuOKyQWFUQs9oZ59XaotU\n\t ntVDc8sA0vhoeLZf4LTsmH35YBspZLUjhchNLE1veQG6ACJHOAlOuAg7PbFvYBK+p9\n\t zjELlJe/YBhM1NX/F3OUqCHAqNnM6la6VlX7KDoe7lVMSOGL36fn4vwUYIISm0jMUc\n\t Iu8KRIL9dYOOYsE1A/o3+rD9Hf4y12n+fL9K4VJd2lGV3fLfExU59Veru1EZqbzzMf\n\t 4+rUoFBKeydLg==","From":"Pablo Neira Ayuso <pablo@netfilter.org>","To":"netfilter-devel@vger.kernel.org","Cc":"fw@strlen.de","Subject":"[PATCH nf,v3 1/3] rculist: add list_splice_rcu() for private lists","Date":"Thu, 16 Apr 2026 00:33:07 +0200","Message-ID":"<20260415223309.95527-1-pablo@netfilter.org>","X-Mailer":"git-send-email 2.47.3","Precedence":"bulk","X-Mailing-List":"netfilter-devel@vger.kernel.org","List-Id":"<netfilter-devel.vger.kernel.org>","List-Subscribe":"<mailto:netfilter-devel+subscribe@vger.kernel.org>","List-Unsubscribe":"<mailto:netfilter-devel+unsubscribe@vger.kernel.org>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit"},"content":"This patch adds a helper function, list_splice_rcu(), to safely splice\na private (non-RCU-protected) list into an RCU-protected list.\n\nThe function ensures that only the pointer visible to RCU readers\n(prev->next) is updated using rcu_assign_pointer(), while the rest of\nthe list manipulations are performed with regular assignments, as the\nsource list is private and not visible to concurrent RCU readers.\n\nThis is useful for moving elements from a private list into a global\nRCU-protected list, ensuring safe publication for RCU readers.\nSubsystems with some sort of batching mechanism from userspace can\nbenefit from this new function.\n\nThe function __list_splice_rcu() has been added for clarity and to\nfollow the same pattern as in the existing list_splice*() interfaces,\nwhere there is a check to ensure that that the list to splice is not\nempty. Note that __list_splice_rcu() has no documentation for this\nreason.\n\nReviewed-by: Paul E. McKenney <paulmck@kernel.org>\nSigned-off-by: Pablo Neira Ayuso <pablo@netfilter.org>\n---\nv3: added Reviewed-by: tag.\n\n include/linux/rculist.h | 29 +++++++++++++++++++++++++++++\n 1 file changed, 29 insertions(+)","diff":"diff --git a/include/linux/rculist.h b/include/linux/rculist.h\nindex 2abba7552605..e3bc44225692 100644\n--- a/include/linux/rculist.h\n+++ b/include/linux/rculist.h\n@@ -261,6 +261,35 @@ static inline void list_replace_rcu(struct list_head *old,\n \told->prev = LIST_POISON2;\n }\n \n+static inline void __list_splice_rcu(struct list_head *list,\n+\t\t\t\t     struct list_head *prev,\n+\t\t\t\t     struct list_head *next)\n+{\n+\tstruct list_head *first = list->next;\n+\tstruct list_head *last = list->prev;\n+\n+\tlast->next = next;\n+\tfirst->prev = prev;\n+\tnext->prev = last;\n+\trcu_assign_pointer(list_next_rcu(prev), first);\n+}\n+\n+/**\n+ * list_splice_rcu - splice a non-RCU list into an RCU-protected list,\n+ *                   designed for stacks.\n+ * @list:\tthe non RCU-protected list to splice\n+ * @head:\tthe place in the existing RCU-protected list to splice\n+ *\n+ * The list pointed to by @head can be RCU-read traversed concurrently with\n+ * this function.\n+ */\n+static inline void list_splice_rcu(struct list_head *list,\n+\t\t\t\t   struct list_head *head)\n+{\n+\tif (!list_empty(list))\n+\t\t__list_splice_rcu(list, head, head->next);\n+}\n+\n /**\n  * __list_splice_init_rcu - join an RCU-protected list into an existing list.\n  * @list:\tthe RCU-protected list to splice\n","prefixes":["nf","v3","1/3"]}