Received: by 2002:a05:7412:37c9:b0:e2:908c:2ebd with SMTP id jz9csp1016373rdb; Tue, 19 Sep 2023 18:25:18 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEc2zpBz7uN3IlNHNfJ6cK7X3xqqYfOveICWAXymce/3wUkLAi78UszyYIB9YhrrUT9lj0k X-Received: by 2002:a17:90a:2a84:b0:273:f10c:b6d2 with SMTP id j4-20020a17090a2a8400b00273f10cb6d2mr1656799pjd.18.1695173117468; Tue, 19 Sep 2023 18:25:17 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1695173117; cv=none; d=google.com; s=arc-20160816; b=sdYowjhH99J1TfEqqi9vrJULTwQuTEJvwXSLQT9UwR7TmlA68iMalGeKSolrlVtJyF /lC2Fj6s+GwVJZCWRvRU4YvUY0o/fHB9hKKv3OPSEA0MyvTeYiyyOhYwfa1GWT/T27v8 gk/ZsQsgEGDMNLRPClJzNVkEca+aPprBlzNZjZFEPbolo7UTaeVHNua1Aji7Y4z9dus1 3A5UZn0kXrlgbwg20zpxTo3fqVV/zR4xMrSjKw45zSVa49rSZjCX+WWg4RJjdSaYhGw0 UpbGyJ9BzyIS+xg6QPM1gBf3pauTG/hnkbIGxLCVfk0Jj87oHaoXZ6t+BmLUNMU+4nLg XZxQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=JECWNYIgvDcn1uBT/2hzcwjhsT52lJUN8GmMJpDdnx8=; fh=WWJUIZ1N55dcQeA66dUTYaCWntEZ1JmS5tIzDMDwwpk=; b=ujDmcOgQ2dU/HeWuNzx5zx1VTEStAMIobKOlGkVP6iuw1PRDBTxeR42u6JRCZ7Ylmj D+aMjpPlRKlrsCpri4TmlHhcZN2uUjDn8TDD34fF7YdXvDAl3VxXuQTEbKx+iRcRNKBv P7RnT8L0TQBKinJuZC50dWlOVVM9oq4MYy5x7/1dfGnF4KJZIwLWMZUWVw+MM1hZfnQ0 sY5Clw9DfTTswNC2eWlr/ms2s8xJ42huJ8m0pe5xrgYhO8/kewHKLUqyOlJVVl2Fvaci POSHVPFGo89RknSCDG7G3gkgehG8l0aJG9Z6AsIF2EmfwdwGB9pAT4P+ycDqSFC7jKeM ta1g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=ZCU50j2G; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:1 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Return-Path: Received: from morse.vger.email (morse.vger.email. [2620:137:e000::3:1]) by mx.google.com with ESMTPS id nu11-20020a17090b1b0b00b0026d178be5c4si457360pjb.109.2023.09.19.18.25.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 Sep 2023 18:25:17 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:1 as permitted sender) client-ip=2620:137:e000::3:1; Authentication-Results: mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=ZCU50j2G; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:1 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by morse.vger.email (Postfix) with ESMTP id D9FA4825149F; Tue, 19 Sep 2023 12:49:34 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at morse.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232991AbjISTtb (ORCPT + 99 others); Tue, 19 Sep 2023 15:49:31 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37692 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232883AbjISTt3 (ORCPT ); Tue, 19 Sep 2023 15:49:29 -0400 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 775919C for ; Tue, 19 Sep 2023 12:48:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1695152915; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=JECWNYIgvDcn1uBT/2hzcwjhsT52lJUN8GmMJpDdnx8=; b=ZCU50j2GupRCQM7aYWl9ijrdvuZZKhiu6Umju8eYwo0QuO82pz1EZKxj3OMs4jA7kLBmkK W8FP6KKvdMjANf+cJtqAUQyPSow01B4KjkAMpsjx7ik/fGqfnd8xGd3JBq9Cs53+OoE/23 w6WvFfd1P5CZUlcJRNV/AQ+vMS1cerQ= Received: from mail-lf1-f69.google.com (mail-lf1-f69.google.com [209.85.167.69]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-381-RDrhVHM2Ol-GkomkUPh-sA-1; Tue, 19 Sep 2023 15:48:34 -0400 X-MC-Unique: RDrhVHM2Ol-GkomkUPh-sA-1 Received: by mail-lf1-f69.google.com with SMTP id 2adb3069b0e04-502d8606cebso1385209e87.1 for ; Tue, 19 Sep 2023 12:48:33 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695152912; x=1695757712; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=JECWNYIgvDcn1uBT/2hzcwjhsT52lJUN8GmMJpDdnx8=; b=DBWSClSuK18Qyw0qg47eLeZEkJ0JkCPuEhpapZidkEQm53HSeLrjSXnLBxFi5eXkUe Qh312xg0bHiPLdbqX4MvR+UZ3qLxCdC/3gCs+YTY09Da57i8cg3MwuEx9BvJJ2CLjtrr uVZIzlZO/axi+JHYjdjjjTCtf9JJ/w0g7USnwXw2koPcsGlGSoIPI4w0xb1jhxSF3QKy 1zttDpSFlfYfuGAhvRK5eBJpav8YXDQHuxYHuh9JDXLKbBumJd4Niiv6kL+dPqI8x/Un n7LqYAXaeGiFdmjRXz1bqyj9Yn9RBjW3LyLfsiPeAISln8kqhfMTrEaNxdhnzhK/MliE 0bIQ== X-Gm-Message-State: AOJu0YwctLVpG4iutsq7bfOqQkqqWnaFIk1oZWxUvVr7ooVdAUV2xXGS hNySXyv+o5ZFovXb98XB0hUYtjC7pALoA3lD1KAJ1mQnZ/TNkLPMl33xJBt2JmHo/v5VBP7lMxp fbuThGPn4Dl6/XogiUqHdHbcd4QHEXV0f X-Received: by 2002:ac2:548b:0:b0:502:dbd0:6bc0 with SMTP id t11-20020ac2548b000000b00502dbd06bc0mr366657lfk.5.1695152912337; Tue, 19 Sep 2023 12:48:32 -0700 (PDT) X-Received: by 2002:ac2:548b:0:b0:502:dbd0:6bc0 with SMTP id t11-20020ac2548b000000b00502dbd06bc0mr366645lfk.5.1695152911914; Tue, 19 Sep 2023 12:48:31 -0700 (PDT) Received: from fedorinator.fritz.box ([2001:9e8:32ec:5700:c2e1:19c3:93f2:42ac]) by smtp.gmail.com with ESMTPSA id cq8-20020a056402220800b00532d2b5126bsm875426edb.94.2023.09.19.12.48.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 Sep 2023 12:48:31 -0700 (PDT) From: Philipp Stanner To: "Paul E. McKenney" , Frederic Weisbecker , Neeraj Upadhyay , Joel Fernandes , Josh Triplett , Boqun Feng , Steven Rostedt , Mathieu Desnoyers , Lai Jiangshan , Zqiang Cc: rcu@vger.kernel.org, linux-kernel@vger.kernel.org, Philipp Stanner Subject: [PATCH] rculist.h: docu: fix wrong function name Date: Tue, 19 Sep 2023 21:47:55 +0200 Message-ID: <20230919194754.20574-2-pstanner@redhat.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on morse.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (morse.vger.email [0.0.0.0]); Tue, 19 Sep 2023 12:49:35 -0700 (PDT) The header contains a comment that details why the functions list_empty_rcu() and list_first_entry_rcu() don't exist. It explains that they don't exist because standard list_empty() can be used just as well, but one can not expect sane results from a subsequent, quote, "list_first_entry_rcu()". This function (obviously) does not exist. What the comment's author actually meant was the standard list-function list_first_entry(). Change the function name in that comment from list_first_entry_rcu() to list_first_entry(). Additionally, add the parenthesis to list_first_or_null_rcu to be congruent with that entire comment's style. Signed-off-by: Philipp Stanner --- Hi! I hope this helps. I wasn't 100.000000% sure if that's correct, but I thought asking is for free 8-) Regards, P. --- include/linux/rculist.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/include/linux/rculist.h b/include/linux/rculist.h index d29740be4833..4837d8892691 100644 --- a/include/linux/rculist.h +++ b/include/linux/rculist.h @@ -331,9 +331,9 @@ static inline void list_splice_tail_init_rcu(struct list_head *list, * rcu_dereference() is not needed), which means that list_empty() can be * used anywhere you would want to use list_empty_rcu(). Just don't * expect anything useful to happen if you do a subsequent lockless - * call to list_first_entry_rcu()!!! + * call to list_first_entry()!!! * - * See list_first_or_null_rcu for an alternative. + * See list_first_or_null_rcu() for an alternative. */ /** -- 2.41.0