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;
From:   Parav Pandit <parav@nvidia.com>
To:     Joel Fernandes <joel@joelfernandes.org>
CC:     "bagasdotme@gmail.com" <bagasdotme@gmail.com>,
        "arnd@arndb.de" <arnd@arndb.de>,
        "stern@rowland.harvard.edu" <stern@rowland.harvard.edu>,
        "parri.andrea@gmail.com" <parri.andrea@gmail.com>,
        "will@kernel.org" <will@kernel.org>,
        "peterz@infradead.org" <peterz@infradead.org>,
        "boqun.feng@gmail.com" <boqun.feng@gmail.com>,
        "npiggin@gmail.com" <npiggin@gmail.com>,
        "dhowells@redhat.com" <dhowells@redhat.com>,
        "j.alglave@ucl.ac.uk" <j.alglave@ucl.ac.uk>,
        "luc.maranget@inria.fr" <luc.maranget@inria.fr>,
        "paulmck@kernel.org" <paulmck@kernel.org>,
        "akiyks@gmail.com" <akiyks@gmail.com>,
        Dan Lustig <dlustig@nvidia.com>,
        "corbet@lwn.net" <corbet@lwn.net>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>,
        "linux-arch@vger.kernel.org" <linux-arch@vger.kernel.org>,
        "linux-doc@vger.kernel.org" <linux-doc@vger.kernel.org>
Subject: RE: [PATCH v1] locking/memory-barriers.txt: Improve documentation for
 writel() usage
Thread-Topic: [PATCH v1] locking/memory-barriers.txt: Improve documentation
 for writel() usage
Thread-Index: AQHY1HD1laDrRIDleEGxkmQmi+hX2a33OsCAgATzBBA=
Date:   Mon, 3 Oct 2022 05:54:53 +0000
Message-ID: <PH0PR12MB5481FE2A85C3492AF645E2FADC5B9@PH0PR12MB5481.namprd12.prod.outlook.com>
References: <20220930020355.98534-1-parav@nvidia.com>
 <CCD8EFA1-D0CF-4E57-905C-E7CA8E4DA56F@joelfernandes.org>
In-Reply-To: <CCD8EFA1-D0CF-4E57-905C-E7CA8E4DA56F@joelfernandes.org>
Accept-Language: en-US
Content-Language: en-US
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?utf-8?B?YktEdnRlaFJ1NWpnQ1YrZXhlRG44ZVlZc2dRNlUxY2NrbzlYc1YxOWx0Q2Jr?=
 =?utf-8?B?elJPSHVjRFJaVFdFWTk1TW52OW1mckhnaUp2SEtraU9XVVFMV2VxeHhCVnN5?=
 =?utf-8?B?L056MFFQT2pVUFFaYWxDUms3SkJldTk4UDRMSWY0alk1RzFEWkZzMWNhQjV1?=
 =?utf-8?B?MzMrTEVRV3FHZU5XRGpLQkIrUEZvalhGUU1HaDhMNzVuQUpTblFCUFlhYklY?=
 =?utf-8?B?TW5IUW9hQlVFdGxXaDVhb3dQSUdDZVljL0NneHJhN3BwcVJkSWQ1Zm8ra2VQ?=
 =?utf-8?B?ajIvUFk0UEdxdnNzeWp3bTB3VkZKbmtjcDBrMnlwL3VVR2tyS2MyalZ5dFl4?=
 =?utf-8?B?M1o5c292elA0MDJhTGNxSDdEWnpnN05INmwzcGZNUTBmRUhlUmNtT0ZIaEZi?=
 =?utf-8?B?UjNPYzgzWEErZ29kaE1TUmppVk51dmxyMzMwSjRxWmw0TXFPRHk4dW4vMnYy?=
 =?utf-8?B?QXQ2TTdUWHR0WEVUa0gyWTZ3elpndlpaYldGdzRYcWxuWEZiVERrRW9JZXkz?=
 =?utf-8?B?VzMyK2tkZG9ycC96MWNkdTM0VzA2TTdLUjhOZkVxZlJhb0ZZVURpamlHeEVt?=
 =?utf-8?B?cHNZeU16c1R1cGtiVnkwV0F6MnpoRXBDeGs2d3FPNjdoOGdLcG52MVN3NGYx?=
 =?utf-8?B?MHQ2Z0F1WFhNVHFwSWNwSHkrRTRkK1plbitnMS9GWkJMZzFaK1BoNE9NQW53?=
 =?utf-8?B?VG9QQmk0U0lHUGd1VkFDS0xJWGZjZkxoYnhrZTdIWFdKRll3UE1DOUZ3bVIx?=
 =?utf-8?B?RStkY0Y3N0lDdEp5cmFPSFArRE1rM0NHaGVTUlpuWno5RkpEODVTRnp4alBC?=
 =?utf-8?B?aTVlamRPZDFIWHNNN1RJcXJzQlB6NFZMQUNxOUh5SnNwbnlTUHAxVnNIK3hW?=
 =?utf-8?B?MURjQkJSMitnaW9IWkZtMVhPaWxLcFdwU1RlamlkeXlCRHU5OE1jVmhIY0lR?=
 =?utf-8?B?NExuRUlVV2EyWnRndFBEQ1VKcTFKemptLzdqbGRRbHFYUEVmSGwxeDFZOGZ2?=
 =?utf-8?B?Q1orWmpvK0h3L1Jqa1N2eEh0WVN2Tis4Y2lSdmtZMTVyaHFqUFhibWZxZm5p?=
 =?utf-8?B?MkREQXAybzJCcjBydzAyYXcwODdrdDJFWGk5dzhqSlhlN2FWZEd3QUpxdU53?=
 =?utf-8?B?NFpBdzNHcXFEWGFNemZkMzl0V3JkOVlRRHl5SnZ1ZHFkMDU2eFpwZXEwTENi?=
 =?utf-8?B?S1hjS0g3cHFPcEp4czQxblVFdHdOc3NNM1IwTk9kTjc5d3h3bTNSeUxyZTNP?=
 =?utf-8?B?RTZhQ3BGMEYrSEltek1wR1RPSGE2YVJvY3AzUlBBaUFHVUVhNWQ1dlhTQkQ5?=
 =?utf-8?B?SFphVGtjclg0Zjh3Y0xWdk5QcmEvcVJITlphNU9NNHNYeWhlRXJkaUc5czls?=
 =?utf-8?B?akdUWlZ1REhoR1EvY1RkblhERjNJaFRwZ0VQd0RzVUpyN21SSno4UEVtUDZJ?=
 =?utf-8?B?KzN6a3FlaWZjWWRzZ1IyM2s1MzNtVThuODI3dkxXcGxLYmwxeGJzTXU0N2hK?=
 =?utf-8?B?SVVCS1VUYjNCQm1iV3A2RWZCNzJrWU1idlZXZFJzREs3Zi9sbmlnelloZzlW?=
 =?utf-8?B?dWpyNUpITngrUFgxYlZKQkdSSS9CRjVNbUJHL0xkSmVtc2dMMThDWDJCdEVk?=
 =?utf-8?B?RXdQY3VGZXA2V0dQUWFQYWJ6aG5mamFmYjQ3WHUrU21GSVFyRzQ5TlNQbWdP?=
 =?utf-8?B?aVA2RWpzQm5KSDVReFpMS3FIU1JKZy90elN0SlN3djlUTkRmL2NHUzRZL0Jq?=
 =?utf-8?B?TDE0MnplSUs1Vk1ubGhwU0xFQmZRLyt1d3U4eTdFOTY4RVgxQnJEMFdJUnBT?=
 =?utf-8?B?WEFySW9mWG9LQnJVSkMvZVlIeExEYlFsVmViUi9hcUhtTGZ0V3FXV3p3bXFq?=
 =?utf-8?B?YlFMSFJlbGR0VGkzZmdVYzAwbHZKYlZTQmRCdzN2bUQ4eXJyNTNvMGNlbkU0?=
 =?utf-8?B?NkNjMHVHUEQyVnpKTWs3UVBtc29VeHY4NlJvZXk5MS9ORlBXYlM0SGI5dm9v?=
 =?utf-8?B?ZTJDdjg0dGphMmlxRndXaXA1WlllRXlxaW41eXlPMFdkOCs5VGV3VjV3SDZh?=
 =?utf-8?B?UEFoNXByeEVpeUdnOXBXRFpsenkrdE9QQUd0TjdIZ1pvR01ROWFoR3FrdVBH?=
 =?utf-8?Q?QU17gmEykijb/4FjhLrFd3oY4?=
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-OriginatorOrg: Nvidia.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: PH0PR12MB5481.namprd12.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 0d9bf3a6-ea61-4c5e-65fa-08daa503cb46
X-MS-Exchange-CrossTenant-originalarrivaltime: 03 Oct 2022 05:54:53.9595
 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 43083d15-7273-40c1-b7db-39efd9ccc17a
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: k3+UGQl89wwtreo/sf65v9xTVaonqD0G0kSLoRo0sX4Q/JBUJa2ICLiW7ciGB1JfNaT7Gl4CP5ArULsxVpvbTA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR12MB6777
X-Spam-Status: No, score=-1.7 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,
        DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FORGED_SPF_HELO,
        RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_NONE
        autolearn=no 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: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

SGkgSm9lbCwNCg0KPiBGcm9tOiBKb2VsIEZlcm5hbmRlcyA8am9lbEBqb2VsZmVybmFuZGVzLm9y
Zz4NCj4gU2VudDogRnJpZGF5LCBTZXB0ZW1iZXIgMzAsIDIwMjIgNzo0MSBBTQ0KPiANCj4gSGks
DQo+IA0KPiA+IE9uIFNlcCAyOSwgMjAyMiwgYXQgMTA6MDQgUE0sIFBhcmF2IFBhbmRpdCA8cGFy
YXZAbnZpZGlhLmNvbT4gd3JvdGU6DQo+ID4NCj4gPiDvu79UaGUgY2l0ZWQgY29tbWl0IGRlc2Ny
aWJlcyB0aGF0IHdoZW4gdXNpbmcgd3JpdGVsKCksIGV4cGxjaXQgd21iKCkgaXMNCj4gPiBub3Qg
bmVlZGVkLiB3bWIoKSBpcyBhbiBleHBlbnNpdmUgYmFycmllci4gd3JpdGVsKCkgdXNlcyB0aGUg
bmVlZGVkDQo+ID4gSS9PIGJhcnJpZXIgaW5zdGVhZCBvZiBleHBlbnNpdmUgd21iKCkuDQo+IA0K
PiBCZWNhdXNlIHlvdSBtZW50aW9uZWQgaXQgaW4gdGhlIGNvbW1pdCBtZXNzYWdlLCBXaHkgbm90
IG1lbnRpb24gaW4gdGhlDQo+IGRvY3VtZW50YXRpb24gdGV4dCBhcyB3ZWxsIHRoYXQgd3JpdGVs
KCkgaGFzIHRoZSBuZWVkZWQgSS9PIGJhcnJpZXIgaW4gaXQ/DQo+DQpJdCBpcyBhbHJlYWR5IGRv
Y3VtZW50ZWQgaW4gWzFdLg0KVGhvdWdoIFsxXSBpcyBkb2VzbuKAmXQgZGVzY3JpYmUgYWJvdXQg
dXNpbmcgSS9PIGJhcnJpZXIuDQoNClRvIGtlZXAgWzFdIGFuZCBhYm92ZSBleGFtcGxlIGluIHN5
bmMsIGFuZCB0byBhZGRyZXNzIEFraXJhJ3MgY29tbWVudCBbMl0sIGl0IG1ha2VzIHNlbnNlIHRv
IGRyb3AgSS9PIGJhcnJpZXIgZnJvbSB0aGUgYWJvdmUgZXhhbXBsZSBhbmQgcmV3b3JkIHRoZSBs
aW5lIGFzIGJlbG93DQoNCiJOb3RlIHRoYXQsIHdoZW4gdXNpbmcgd3JpdGVsKCksIGEgcHJpb3Ig
YmFycmllciBpcyBub3QgbmVlZGVkIi4NCiANClsxXSBodHRwczovL2VsaXhpci5ib290bGluLmNv
bS9saW51eC9sYXRlc3Qvc291cmNlL0RvY3VtZW50YXRpb24vbWVtb3J5LWJhcnJpZXJzLnR4dCNM
MjU1OQ0KWzJdIGh0dHBzOi8vbG9yZS5rZXJuZWwub3JnL2xrbWwvNWRiNDY1ZjMtNjk4Zi1lYmVl
LWE2NjgtMTc0MGE3MDVjZTljQGdtYWlsLmNvbS8NCj4gPg0KPiA+IEhlbmNlIHVwZGF0ZSB0aGUg
ZXhhbXBsZSB0byBiZSBtb3JlIGFjY3VyYXRlIHRoYXQgbWF0Y2hlcyB0aGUgY3VycmVudA0KPiA+
IGltcGxlbWVudGF0aW9uLg0KPiANCj4gVGhhdCB3b3VsZCBtYWtlIGl0IG1vcmUgYWNjdXJhdGUs
IHNpbmNlIGFjY3VyYWN5IGlzIHlvdXIgZ29hbC4NCj4gDQpZZXMuIEFib3ZlIG1vZGlmaWVkIHRl
eHQgbG9va3MgbW9yZSBhbGlnbmVkIHRvIHdyaXRlWCgpIGRvYy4NCldpbGwgc2VuZCB2Mi4NCg==