Received: by 2002:a05:6358:489b:b0:bb:da1:e618 with SMTP id x27csp696571rwn; Thu, 15 Sep 2022 05:18:52 -0700 (PDT) X-Google-Smtp-Source: AA6agR53iOCRq2vQJfOIQvAqnAHCw3AFeD6GpRj3QWPPkO2+czEJ/zTnAOyvMJIxuY0X9q23s74F X-Received: by 2002:aa7:cd05:0:b0:44f:2776:2ff with SMTP id b5-20020aa7cd05000000b0044f277602ffmr31888898edw.49.1663244332252; Thu, 15 Sep 2022 05:18:52 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1663244332; cv=none; d=google.com; s=arc-20160816; b=rZvRwt0PXG/IF/emUPRvrFUU5V8zicyT+VCLnKXMdEaE+X0V9A6zYC3j/anGhLfftC xtEjusdJAuAgPienIBtub6KBzKbGXyms4tCKAHoXI07by5AEPGFnxLJ8ulNqozR599WD /9zO5U8q6M3YpD67VvvW7Q+fko+TOyUBaJQzNqhB6hpZhiVwBWD+F4sQOqzPLCgZ9AjH 78YtZ8s2grc2il7F8yoZPopzuFq282BOAUl2Nh5Ywzr3Q9p4OJ6l9Sz7Qb4w9fednJwc 7DsH3NOJjBbzxujs84NmgzT+iqP/h14cSRhMD6WgDxFop8gxFz17kY8Gbrm9OTh8dgui Ihaw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:in-reply-to:from :references:to:content-language:subject:user-agent:mime-version:date :message-id:dkim-signature; bh=qnMPBaAj1F3T+8uZYN8jbU4xqXRIMovL97bP0OzxrFk=; b=DhZXu47VEHidMcl9UKtPPxjBR/Yavad95ph73Co648RGxr5Z6W7HuoRwkODZfccSZU ED834J2vlCM6fDfYpEwinLMFqwIQeBVxdjQqXpskPVPm88BKWffWGOlkCUE2Q3/57Izn 7MBhFVa7je21hxDX8+0XIHv+f4tOalecY4zSHTTZr0IsLDPA1HaAYVuvEb4d/aN7cu6X a7vbTWFyG67ZBq6S7IgtE/NxqZdHldaN8XRUqTHbS0W6C52+YIAdY/KoDeDvfmKKS541 PEdm3ihVCL1jCWtbEKxBSDwvNTC7oZzD0v4f53+/BXEyr2Ax5TnnxX3VwgGjMukCw1AY pfCg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b="RU8hZBI/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id gn25-20020a1709070d1900b0077b2e822b8fsi3724216ejc.76.2022.09.15.05.18.26; Thu, 15 Sep 2022 05:18:52 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b="RU8hZBI/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229669AbiIOMQf (ORCPT + 99 others); Thu, 15 Sep 2022 08:16:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55786 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229449AbiIOMQe (ORCPT ); Thu, 15 Sep 2022 08:16:34 -0400 Received: from mail-pf1-x436.google.com (mail-pf1-x436.google.com [IPv6:2607:f8b0:4864:20::436]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9594999B76; Thu, 15 Sep 2022 05:16:33 -0700 (PDT) Received: by mail-pf1-x436.google.com with SMTP id c198so17852208pfc.13; Thu, 15 Sep 2022 05:16:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:to :content-language:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date; bh=qnMPBaAj1F3T+8uZYN8jbU4xqXRIMovL97bP0OzxrFk=; b=RU8hZBI/8Ck49RloIrjJgsj+xZtizolgAaWkd130ApklbJmxi6clWXsXoN7u7tfcaP p6Njbr14DJqQ1e2AlQYXjcuYP8XcAeyKrdU62m56NHeCYG/wZG9FUxwgzyvdmXqGbr6C PJQmOf414VMDGjQjNWhrd0KflKApcIef2nRCgfSCyALTTJXOhQsR10c+FSBy+TqY/ZXM TZcHB9xFxx8GgE8pYf2OzXvB1lIbY/HL9Af7yO7c0pvs/nBou2BLN6RqYeYttrxWgHTn VKb/pwkzwZTJ8AQ0HpxWmgts5HCcGVg3bWSatpEXw6gW/pfLPk/1S7dMilY2oqUtP/Ek VI6A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:to :content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date; bh=qnMPBaAj1F3T+8uZYN8jbU4xqXRIMovL97bP0OzxrFk=; b=Ywtl0SltZxZPGJWm14tKRMK27O8UgqboxUqmD91xDcYZhy5Tb2QKpEaT3/oecGCW45 W4y1VbUhFuUtow+N2+KJJZRT8UYQV7m6yJKacuZlh53uYp9vq5XJSY8J2c0WIYbNn9nC KaS8CQ95MaXKabyjjvsiqqwebjgwOb4RfvZ3NOLi/v+L5CCKZSwCPA+1JabS7B4NXJU0 YX0MKy4XCA1h9kc0fSv92Y3iAdF2bbNv8kq9uhoLjsJb6kM/uwMxzzpB4waxhtrTQXxY bzWYgcoiU6O2RRvsxMiXXD8kB8K9TCj4X2nQVQhArxakp4S9VdH1xB+ow6Li1cNBFyBl WXvg== X-Gm-Message-State: ACgBeo1Y5GnO9CyfkXrfaplBxfUULWLKYNac1ZPeanhugvvp+UzjrUsr EqyF+QVecEq7dtz2QJCMF2c= X-Received: by 2002:a63:8bc8:0:b0:438:bc9e:edc4 with SMTP id j191-20020a638bc8000000b00438bc9eedc4mr21054588pge.20.1663244193024; Thu, 15 Sep 2022 05:16:33 -0700 (PDT) Received: from [192.168.43.80] (subs02-180-214-232-22.three.co.id. [180.214.232.22]) by smtp.gmail.com with ESMTPSA id q9-20020a170902f34900b001768b6f9a97sm12657259ple.147.2022.09.15.05.16.27 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 15 Sep 2022 05:16:32 -0700 (PDT) Message-ID: <6698eda3-977b-902f-ba23-89cfd674c121@gmail.com> Date: Thu, 15 Sep 2022 19:16:23 +0700 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.13.0 Subject: Re: [PATCH] locking/memory-barriers.txt: Improve documentation for writel() usage Content-Language: en-US To: Parav Pandit , stern@rowland.harvard.edu, parri.andrea@gmail.com, will@kernel.org, peterz@infradead.org, boqun.feng@gmail.com, npiggin@gmail.com, dhowells@redhat.com, j.alglave@ucl.ac.uk, luc.maranget@inria.fr, paulmck@kernel.org, akiyks@gmail.com, dlustig@nvidia.com, joel@joelfernandes.org, corbet@lwn.net, linux-kernel@vger.kernel.org, linux-arch@vger.kernel.org, linux-doc@vger.kernel.org References: <20220915050106.650813-1-parav@nvidia.com> From: Bagas Sanjaya In-Reply-To: <20220915050106.650813-1-parav@nvidia.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-2.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,NICE_REPLY_A, RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_WEB,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 9/15/22 12:01, Parav Pandit wrote: > The cited commit [1] describes that when using writel(), explcit wmb() > is not needed. However, it should have said that dma_wmb() is not > needed. > > Hence update the example to be more accurate that matches the current > implementation and document section of dma_wmb()/dma_rmb(). > > [1] commit 5846581e3563 ("locking/memory-barriers.txt: Fix broken DMA vs. MMIO ordering example") Just say the blamed commit without using numbered references. -- An old man doll... just what I always wanted! - Clara