From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.8 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 92D21C65BD0 for ; Fri, 5 Oct 2018 23:18:40 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 5904D206B2 for ; Fri, 5 Oct 2018 23:18:40 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=joelfernandes.org header.i=@joelfernandes.org header.b="EFAyFhAV" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 5904D206B2 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=joelfernandes.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729359AbeJFGTd (ORCPT ); Sat, 6 Oct 2018 02:19:33 -0400 Received: from mail-pf1-f195.google.com ([209.85.210.195]:36137 "EHLO mail-pf1-f195.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729323AbeJFGTc (ORCPT ); Sat, 6 Oct 2018 02:19:32 -0400 Received: by mail-pf1-f195.google.com with SMTP id l81-v6so661653pfg.3 for ; Fri, 05 Oct 2018 16:18:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=joelfernandes.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=GGAqxr0F89ju3bhRty+29lvrmYJBGdCM+Kjt6JTCbOI=; b=EFAyFhAV1BIxvRq2BYQcFC7zJBWdPRY8+Dtk9krt6Tv6dIJ3iL89lRCgci3eRjHyft rfLEW4y/Nu9xVp2GeUpsYoWBq5ExXwUwWQJ3K8IlA7rUaDGZEHQ9RDErxfx3JV0GH3dT qOqsY3xp5FSfc+blysbdDYDwbpBKvCzCFZOVY= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=GGAqxr0F89ju3bhRty+29lvrmYJBGdCM+Kjt6JTCbOI=; b=KUZyKmSRd7Vy/vX8ph2gyLfWHSNiNnG3OV4OpGLAnQfw2bGiaE585Bpu9jkTecxtbf IhVGd7hsDvETiP0qS8d4gbuLB8wlg0M+Wh8txqOM9K6X4b9tzMdmo0Nq9pWSiAH5QmEB dJHReG5eXSh088DFWm0baeDcwjLoOHhRUXcVAc0DeSonuto+MLTRLxbJ3RClSZnA09fu V47hroF/OLoQrEHYxS6AYObuhUnBWctLYkxUmfSpLmSD9cKJ3r+L4bdfpdAuhpMm+irL sGJ34UPWSZ0n8YtsOz2KftrPSbxRrJd7yHJ/iDvOdFq7C2XuGgx88fsxGYccXT5oWhOU lxsQ== X-Gm-Message-State: ABuFfoiQNBO3iw17GWOubw0Y8QnxAK+iMtfTPV+fIwSxBKCoNEFwr7iN +HFbyfWVUHEKP7pT8CJ6k7C96c6GOS4= X-Google-Smtp-Source: ACcGV60FlVkU3W/TdcigKZUyjnqE4NCtHrOIHI5LmCEUTW1hliEJg/vKubOv/rtvuwG8yiUWiNvlnQ== X-Received: by 2002:a65:47cb:: with SMTP id f11-v6mr12326568pgs.166.1538781516548; Fri, 05 Oct 2018 16:18:36 -0700 (PDT) Received: from joelaf.mtv.corp.google.com ([2620:0:1000:1601:3aef:314f:b9ea:889f]) by smtp.gmail.com with ESMTPSA id q76-v6sm16641028pfa.18.2018.10.05.16.18.34 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 05 Oct 2018 16:18:35 -0700 (PDT) From: "Joel Fernandes (Google)" To: linux-kernel@vger.kernel.org Cc: "Joel Fernandes (Google)" , Jonathan Corbet , Josh Triplett , Lai Jiangshan , linux-doc@vger.kernel.org, Mathieu Desnoyers , "Paul E. McKenney" , Steven Rostedt , pantin@google.com Subject: [PATCH RFC 5/5] doc: rcu: Encourage use of rcu_barrier in checklist Date: Fri, 5 Oct 2018 16:18:14 -0700 Message-Id: <20181005231815.170433-6-joel@joelfernandes.org> X-Mailer: git-send-email 2.19.0.605.g01d371f741-goog In-Reply-To: <20181005231815.170433-1-joel@joelfernandes.org> References: <20181005231815.170433-1-joel@joelfernandes.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The checklist suggests rcu_barrier_bh for RCU-bh and similarly for sched, however these APIs are now implemented as rcu_barrier itself due to the RCU consolidation. It may also be removed in the future, so lets correct the doc to encourage use of the rcu_barrier() API itself. Similar changes are made in previous patches. Signed-off-by: Joel Fernandes (Google) --- Documentation/RCU/checklist.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/RCU/checklist.txt b/Documentation/RCU/checklist.txt index b90ad1b0665a..6f469864d9f5 100644 --- a/Documentation/RCU/checklist.txt +++ b/Documentation/RCU/checklist.txt @@ -442,8 +442,8 @@ over a rather long period of time, but improvements are always welcome! You instead need to use one of the barrier functions: o call_rcu() -> rcu_barrier() - o call_rcu_bh() -> rcu_barrier_bh() - o call_rcu_sched() -> rcu_barrier_sched() + o call_rcu_bh() -> rcu_barrier() + o call_rcu_sched() -> rcu_barrier() o call_srcu() -> srcu_barrier() However, these barrier functions are absolutely -not- guaranteed -- 2.19.0.605.g01d371f741-goog