Received: by 2002:ac0:a582:0:0:0:0:0 with SMTP id m2-v6csp1011721imm; Fri, 5 Oct 2018 16:19:07 -0700 (PDT) X-Google-Smtp-Source: ACcGV62zwdwfPlJ3pWjhWVKvuFSXyh852dKJ1dDWkgDcVy6r8c/6BUnutD5dcREeKKbxQQFG36H8 X-Received: by 2002:a17:902:5590:: with SMTP id g16-v6mr13538375pli.46.1538781547846; Fri, 05 Oct 2018 16:19:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1538781547; cv=none; d=google.com; s=arc-20160816; b=NuftQRYgNijn8Fu6ksJsQ6k9oin3Y3AD1JPn2Nahq4wuz9mlucrKsc35wap6ow5w/I mU0XuCUVFsOzuzSJRT+kUilZHtlikPhZuHi7om8RYZCcnwnj8w9Zyhdi4rPkmL7qEcr3 maUkKu5D3+iFV/FdMHPmn+mDcVYB3FVd46mNuqSgtxAqdKWR5/7K2DEqZF+757o6TQ2W LijaIajuBZyJUjsMo79BNSrNh1V46+xqvMazpw8If70lT4HKqW10RmkuzPGqUYRe54vq xUfx5gDeo75uFizLUyBveTmp718RZ8ZNIkDxi9lr58juGzLX7YCEsxTCjc4x/NN/lhU6 cONA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=GGAqxr0F89ju3bhRty+29lvrmYJBGdCM+Kjt6JTCbOI=; b=u49VMJVdEKvKrX/QeoiukwudNrSPuMSETwCv7o05AjsVUCU0PckhuCckIF9mKTrLzt ulVNdsxV7iHpvVzLU8Hjl2olLgb77mjpfzayry66XMQMQlqZ0ciAsTS3VldCNFkPh++9 dUkDpEnVjAbWAfn1YmFzhGX/b5DMK1XUQbN/kKD4+P23KuAtx8zUqj5TRzKFnfqhiJ2C OCelIOBND7pkpQk/sqUYcNt23vP6OsmjvmSeGL5JvC5dN5PKX+2zmzifz1GsHjYsSjx4 eAogs+eGmAeXDvLx2/kZmmBIHDQf6rWiBi5uORAbVhc6+42bDZ+P8knYaS1Gc8+6bWPp GS8Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@joelfernandes.org header.s=google header.b=EFAyFhAV; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id c3-v6si1210053pfi.110.2018.10.05.16.18.51; Fri, 05 Oct 2018 16:19:07 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@joelfernandes.org header.s=google header.b=EFAyFhAV; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729343AbeJFGTd (ORCPT + 99 others); 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-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