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:     Akira Yokosawa <akiyks@gmail.com>
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>,
        Dan Lustig <dlustig@nvidia.com>,
        "joel@joelfernandes.org" <joel@joelfernandes.org>,
        "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 v2] locking/memory-barriers.txt: Improve documentation for
 writel() example
Thread-Topic: [PATCH v2] locking/memory-barriers.txt: Improve documentation
 for writel() example
Thread-Index: AQHY2KgAyntXB8tE2EqVYIIWW3s9264AqswAgAAHyZA=
Date:   Thu, 6 Oct 2022 03:25:48 +0000
Message-ID: <PH0PR12MB5481D87865AA1F5A21A334DFDC5C9@PH0PR12MB5481.namprd12.prod.outlook.com>
References: <20221005104749.157444-1-parav@nvidia.com>
 <6a6941fb-53a0-cdd2-9783-590cb959d4e7@gmail.com>
In-Reply-To: <6a6941fb-53a0-cdd2-9783-590cb959d4e7@gmail.com>
Accept-Language: en-US
Content-Language: en-US
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?utf-8?B?aEF5ckdzakdtL29qRUFBYVZrT21RYkFVbmpZVEtQRDF3MUoxVk9mbk1Sd1Fq?=
 =?utf-8?B?dHUrVko3aWtIQjJEL2ovUFNJeUhDWlVtcE9iUXovYks2STU4ajAzVGdhTFd3?=
 =?utf-8?B?S2xZdXFxeldRcEtYV1V4aEJqTkE2ZUZxY0hCWkp1UjhSS0Z4Rk9GY3NOcFQw?=
 =?utf-8?B?NDJWdWJTT1R3Z0hKbDFGck9sUkFHYW1OaU5La2cxeXhJWlRKTms2Sks3MUsr?=
 =?utf-8?B?NzZ5enVTbkJaYlFBT3ZCSkU5SUtxRUNNbDB2bG03VWFQS3AwVXlkaE1FRVpK?=
 =?utf-8?B?MTBPOFdqNERkVm1QY0V3L0p1V1V2dkd2cnh2SDVDRUgybXQ0NXIyN1lhbnFY?=
 =?utf-8?B?cXNGcDdpZmMrVXc2azZZSDZKeTc2SVpSUGhsTW9Hb1I1QVVidHBaemlXbVh5?=
 =?utf-8?B?cUFBT2VQbHllU2d4Q0RWaVlJT0hqZlBKd0dIRU44b3lwdFNGZHdYM09CUkFF?=
 =?utf-8?B?MEY0WVlYZktRb25PbWNBcW8yWkFzbnhlV0V2ZGNBVDM1UHlmRE1nSDFQNUlo?=
 =?utf-8?B?SkhGV3o1RHNnYjJJemRhY1ZYZEpkaGxDbHdLcTZMMlpnU3pUTEVTWTN4NFpl?=
 =?utf-8?B?QVF0K0NKdDBQYXArUW9CeURpbDdmV3FJWFhnWDBLL0I0RFhqKzhWSWVxSlpl?=
 =?utf-8?B?NkoyRmd1Vm1YZEhJZ0p2dUxab3BOOTZOSFFEek1NN3hPRitKaHVsbnZsbVBq?=
 =?utf-8?B?eGd2NDhFWlVKcXBWeXlqc3o1cjlERFFoWE9jZFcrMytqVURyT01ocEp6L0hy?=
 =?utf-8?B?aVJ5Q0ZiSmFBR2M3aWZ4OHRiNi9oS2pmcUJpMzMwSzZLNkNQZFQvODMrWlZ4?=
 =?utf-8?B?cEQ1WVVSVUZWQ3IvOVgvaEQrREl4VHN3dFFKMkdXWTBSSjJ4Q0p1RG1XYlRY?=
 =?utf-8?B?cjRUZEY3ZUNEc1RURDdvSi9vQ3hBVUwxenFxU01RWlpoNHhCYXFZNU50OGVU?=
 =?utf-8?B?c0F4Tm1ucXk4QUtNTWc4UnJTZWlhM3VMS21pZ1ZWSDBqTE94ZmNOMEZXZjFm?=
 =?utf-8?B?bFVCTVYrTTcwempaNFFtRXdORGtpenAxRVlvNUlqbytueWFRK2JzTVNFMkx0?=
 =?utf-8?B?NzhDdWpGRmxJdTVnUTF3RU5OTzB0YnQ2RUhSVWQ4aUMzMnpFUVQxamxzL1NC?=
 =?utf-8?B?SHZ6TW80a093MTBWeFE1SGlMV2tOQnZyckhaQUVNRXZSN2NUTWlSMEI4d1Av?=
 =?utf-8?B?eXJuUE44SjlRU1Q5d3o0S29WU2VxeUhHSFFjV3ZreFFjRjVudmFXMXI3ZU9P?=
 =?utf-8?B?V1Raais4RXVmcjd2dEFpbzgwYkc3ejJFRVR0cTBsYnc4bkZIaEEzcWs3Y2R4?=
 =?utf-8?B?QUUwV2sramMzeEV5SzhBSGVOa0xFZTFBd0xKaWJYRFBUMTVFTjUrbzJpeWFi?=
 =?utf-8?B?TWdCUitLNUFKN0dOVVRRYVRGalg4UW04MEhuZjFqdEVlajNJOG9sOUFxdUFj?=
 =?utf-8?B?SXRUZG9XbUg1eTZpNmZwamtwalQzVzlVM1RuRFZ0ZGJUcjFnaytWcUxUbXRR?=
 =?utf-8?B?bmdialJKamRVRzhMODNaSUROck9hbTZHSy9abEFjY21HcE01VEtMMDdPa3J1?=
 =?utf-8?B?S3RHU2ZlM3Rha1ZSVUhWemowSTcwVTVGUDVvWGpXSnZtekU0SC90NStrZ0lv?=
 =?utf-8?B?T2xpNytrN3IraFZrRDlIYnFYYUJKamlEVllwdDFEajVUaWhYK2pvTFhaZ3RE?=
 =?utf-8?B?SVFBWllRN0dNTlVnZnBwbGoxYWNlU09KelRGZFNCN2ZXbjBzQ0U1Qkg2UmUv?=
 =?utf-8?B?Y1pkOTRSMDMvdnc5cWJkOE45NG1wbUdUMDQ5Vk5UY3gyYXlveFMvVmIxTXRj?=
 =?utf-8?B?MllWVklhbjJlTnBScHQvYU9aUmd0ckFQQnA4a1d1WXduenREc0sweHorVzlu?=
 =?utf-8?B?aStVWEJXUGd6MmhQeGV0ZnJGTEowdjZLWkNqek00UVNTS0Z3cnAxcHl5THpa?=
 =?utf-8?B?dFdXRmVtNjlNWHVTOWFqRmRTQU15bmJUdXA2aFZzb3ZrQnNJdUZ1SGpnVktm?=
 =?utf-8?B?WENhTFpQSHh6eitjNnAxem1jVFZFQjBERjNwNW9ZMVpNSFhma2VGNHgwQVpC?=
 =?utf-8?B?Nk9KdjZtVzFtZS95SFkwOGtNeEtUNVB6MnoyZXlEL1NURVpRdS9ROHlacllo?=
 =?utf-8?Q?1uZU=3D?=
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: 1f7b6595-4742-4cae-0a6f-08daa74a7683
X-MS-Exchange-CrossTenant-originalarrivaltime: 06 Oct 2022 03:25:48.3908
 (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: 6gNHjgMV8LKTUqyMoheoeVduN5pfJZthYvvoGpV+QcZ9aK/x1FxOgwa4/LA8OTu8GpGGQA0FHDtnoR2wRNxS4A==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN9PR12MB5131
X-Spam-Status: No, score=-1.1 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

DQo+IEZyb206IEFraXJhIFlva29zYXdhIDxha2l5a3NAZ21haWwuY29tPg0KPiBTZW50OiBUaHVy
c2RheSwgT2N0b2JlciA2LCAyMDIyIDg6MTggQU0NCj4gDQo+IEhpLA0KPiANCj4gTWF5YmUgSSdt
IHRvbyBuaXQtcGlja3ksIGJ1dCBzZWUgYmVsb3c6DQo+IA0KPiBPbiBXZWQsIDUgT2N0IDIwMjIg
MTM6NDc6NDkgKzAzMDAsIFBhcmF2IFBhbmRpdCB3cm90ZToNCj4gPiBUaGUgY2l0ZWQgY29tbWl0
IGRlc2NyaWJlcyB0aGF0IHdoZW4gdXNpbmcgd3JpdGVsKCksIGV4cGxjaXQgd21iKCkgaXMNCj4g
PiBub3QgbmVlZGVkLiB3bWIoKSBpcyBhbiBleHBlbnNpdmUgYmFycmllci4gd3JpdGVsKCkgdXNl
cyB0aGUgbmVlZGVkDQo+ID4gcGxhdGZvcm0gc3BlY2lmaWMgYmFycmllciBpbnN0ZWFkIG9mIGV4
cGVuc2l2ZSB3bWIoKS4NCj4gPg0KPiA+IEhlbmNlIHVwZGF0ZSB0aGUgZXhhbXBsZSB0byBiZSBt
b3JlIGFjY3VyYXRlIHRoYXQgbWF0Y2hlcyB0aGUgY3VycmVudA0KPiA+IGltcGxlbWVudGF0aW9u
Lg0KPiA+DQo+ID4gY29tbWl0IDU4NDY1ODFlMzU2MyAoImxvY2tpbmcvbWVtb3J5LWJhcnJpZXJz
LnR4dDogRml4IGJyb2tlbiBETUEgdnMuDQo+ID4gTU1JTyBvcmRlcmluZyBleGFtcGxlIikNCj4g
DQo+IFlvdSBjYW4gY2l0ZSB0aGUgY29tbWl0IGluIHRoZSBDaGFuZ2Vsb2cgdGV4dC4NCj4gSnVz
dCBzYXk6DQo+DQpJIHByZWZlciB0byBhbm5vdGF0ZSB0aGUgbG9uZyBjb21taXQgYXMgYSBzZXBh
cmF0ZSBsaW5lLiBUaGlzIG1ha2VzIHRoZSBkZXNjcmlwdGlvbiBzZW50ZW5jZSBlYXN5IHRvIHJl
YWQuDQogDQo+ICAgICBDb21taXQgNTg0NjU4MWUzNTYzICgibG9ja2luZy9tZW1vcnktYmFycmll
cnMudHh0OiBGaXggYnJva2VuIERNQSB2cy4NCj4gICAgIE1NSU8gb3JkZXJpbmcgZXhhbXBsZSIp
IGRlc2NyaWJlcyB0aGF0IHdoZW4gdXNpbmcgd3JpdGVsKCksIC4uLg0KPiANCj4gQWxzbywgYSBi
bGFuayBsaW5lIGlzIG5lZWRlZCBhYm92ZSBTLW8tYiB0YWdzIGFzIGEgZGVsaW1pdGVyLg0KPiAN
CkFkZGluZyBibGFuayBsaW5lIGluIHYzLg0KDQpbLi5dDQo+IElmIHlvdSBwZXJtaXQgYSBzbGln
aHRseSBsb25nIGxpbmUgaGVyZSwgdGhpcyBodW5rIHdvdWxkIGJlIG11Y2ggZWFzaWVyIHRvDQo+
IGNvbXBhcmU6DQo+IA0KVHJ1ZSwgYnV0IGRvY3VtZW50IGNyb3NzZXMgdGhlIDgwIGxpbmVzLiBT
byBJIHdpbGwga2VlcCB0aGUgZXhpc3RpbmcgYWxpZ25tZW50IG9mIDgwIGNoYXJhY3RlcnMgcGVy
IGxpbmUuDQoNCj4gKyAgICAgYSBkbWFfd21iKCkuICBOb3RlIHRoYXQsIHdoZW4gdXNpbmcgd3Jp
dGVsKCksIGEgcHJpb3IgYmFycmllciBpcw0KPiArIG5vdCBuZWVkZWQNCj4gICAgICAgdG8gZ3Vh
cmFudGVlIHRoYXQgdGhlIGNhY2hlIGNvaGVyZW50IG1lbW9yeSB3cml0ZXMgaGF2ZSBjb21wbGV0
ZWQNCj4gYmVmb3JlDQo+ICAgICAgIHdyaXRpbmcgdG8gdGhlIE1NSU8gcmVnaW9uLiAgVGhlIGNo
ZWFwZXIgd3JpdGVsX3JlbGF4ZWQoKSBkb2VzIG5vdA0KPiBwcm92aWRlDQo+ICsgICAgIHRoaXMg
Z3VhcmFudGVlIGFuZCBtdXN0IG5vdCBiZSB1c2VkIGhlcmUuIEhlbmNlLCB3cml0ZVgoKSBpcyBh
bHdheXMNCj4gKyAgICAgcHJlZmVycmVkIHdoaWNoIGluc2VydHMgbmVlZGVkIHBsYXRmb3JtIHNw
ZWNpZmljIGJhcnJpZXIgYmVmb3JlIHdyaXRpbmcNCj4gdG8NCj4gKyAgICAgdGhlIHNwZWNpZmll
ZCBNTUlPIHJlZ2lvbi4NCj4gDQo+IFRoYXQgc2FpZCwgSSBkb24ndCBmZWVsIGNvbWZvcnRhYmxl
IHdpdGggdGhlIHNlbnRlbmNlIHlvdSBhZGRlZC4NCj4gSXQgbG9va3MgdG8gbWUgaXQgaXMgcmVk
dW5kYW50IGJlY2F1c2Ugc3VjaCBhIGd1YXJhbnRlZSBvZiB3cml0ZVgoKSBpcyBhbHJlYWR5DQo+
IGNvdmVyZWQgaW4gdGhlIHNlY3Rpb24gb2YgIktFUk5FTCBJL08gQkFSUklFUiBFRkZFQ1RTIi4N
Cj4gU2VlIHRoZSByZWxldmFudCBleHBsYW5hdGlvbiBxdW90ZWQgYmVsb3c6DQo+DQpJIG9ic2Vy
dmVkIHRoYXQgdG9vLCBidXQgSSB0aG91Z2h0IGl0IGlzIHdvcnRoIHNob3J0IG5vdGUgdG8gYWRk
IGFsb25nIHdpdGggdGhpcyBleGFtcGxlLg0KQnV0IEkgYWdyZWUgc2luY2UgdGhlIG5leHQgcGFy
YSByZWZlcnMgdG8gaXQgYW55d2F5LCBJIHdpbGwgZHJvcCB0aGlzIDJuZCBhZGRpdGlvbiBpbiB2
My4NCiANCj4gCTMuIEEgd3JpdGVYKCkgYnkgYSBDUFUgdGhyZWFkIHRvIHRoZSBwZXJpcGhlcmFs
IHdpbGwgZmlyc3Qgd2FpdCBmb3IgdGhlDQo+IAkgICBjb21wbGV0aW9uIG9mIGFsbCBwcmlvciB3
cml0ZXMgdG8gbWVtb3J5IGVpdGhlciBpc3N1ZWQgYnksIG9yDQo+IAkgICBwcm9wYWdhdGVkIHRv
LCB0aGUgc2FtZSB0aHJlYWQuIFRoaXMgZW5zdXJlcyB0aGF0IHdyaXRlcyBieSB0aGUNCj4gQ1BV
DQo+IAkgICB0byBhbiBvdXRib3VuZCBETUEgYnVmZmVyIGFsbG9jYXRlZCBieSBkbWFfYWxsb2Nf
Y29oZXJlbnQoKSB3aWxsDQo+IGJlDQo+IAkgICB2aXNpYmxlIHRvIGEgRE1BIGVuZ2luZSB3aGVu
IHRoZSBDUFUgd3JpdGVzIHRvIGl0cyBNTUlPIGNvbnRyb2wNCj4gCSAgIHJlZ2lzdGVyIHRvIHRy
aWdnZXIgdGhlIHRyYW5zZmVyLg0KPiANCj4gQWxzbyBwbGVhc2Ugbm90IHRoYXQgdGhpcyBkb2N1
bWVudCBzaG91bGQgbm90IGRlc2NyaWJlIGFueSBpbXBsZW1lbnRhdGlvbg0KPiBkZXRhaWxzIG9m
IHRob3NlIGFjY2Vzc29ycy4gVGhpcyBkb2N1bWVudCBpcyBub3QgbWVhbnQgYXMgYW4gaW1wbGVt
ZW50YXRpb24NCj4gZ3VpZGUsIGJ1dCBhIGd1aWRlIGZvciBrZXJuZWwgZGV2ZWxvcGVycyB3aG8g
dXNlIHRoZW0uIFRoaXMgaXMgY2xlYXJseQ0KPiBtZW50aW9uZWQgaW4gIkRJU0NMQUlNRVIiIGF0
IHRoZSB0b3Agb2YgdGhpcyBmaWxlLg0KPiANCkluIHRoZSBkaXNjbGFpbWVyIHNlY3Rpb24gSSBk
aWRu4oCZdCBzZWUgYW55IG9iamVjdGlvbiB0byAiZGVzY3JpYmUgYW55IGltcGxlbWVudGF0aW9u
Ii4gOikNCkZvciBleGFtcGxlLCBkaXNjbGFpbWVyIGl0c2VsZiB0ZWxscyB0aGF0IGEgYmFycmll
ciBtYXkgYmUgbm8tb3AgdGFsa2luZyBhYm91dCBhIHBvc3NpYmxlIGltcGxlbWVudGF0aW9uIG9u
IGEgcGxhdGZvcm0uDQoNCkJ1dCBJIGFncmVlIHRvIHlvdXIgYWJvdmUgcG9pbnQgdGhhdCBhYm92
ZSAjMyBhbHJlYWR5IGNvdmVycyB3aXRoIG15IGFkZGl0aW9uLg0KSGVuY2UsIEkgd2lsbCBkcm9w
IHRoYXQgcGFydCBpbiB2My4NClRoYW5rcyBmb3IgdGhlIHJldmlldy4NCg0KPiAgICAgICAgIFRo
YW5rcywgQWtpcmENCj4gDQo+ID4gKyAgICAgbmVlZGVkIHRvIGd1YXJhbnRlZSB0aGF0IHRoZSBj
YWNoZSBjb2hlcmVudCBtZW1vcnkgd3JpdGVzIGhhdmUNCj4gY29tcGxldGVkDQo+ID4gKyAgICAg
YmVmb3JlIHdyaXRpbmcgdG8gdGhlIE1NSU8gcmVnaW9uLiAgVGhlIGNoZWFwZXIgd3JpdGVsX3Jl
bGF4ZWQoKSBkb2VzDQo+IG5vdA0KPiA+ICsgICAgIHByb3ZpZGUgdGhpcyBndWFyYW50ZWUgYW5k
IG11c3Qgbm90IGJlIHVzZWQgaGVyZS4gSGVuY2UsIHdyaXRlWCgpIGlzDQo+IGFsd2F5cw0KPiA+
ICsgICAgIHByZWZlcnJlZCB3aGljaCBpbnNlcnRzIG5lZWRlZCBwbGF0Zm9ybSBzcGVjaWZpYyBi
YXJyaWVyIGJlZm9yZSB3cml0aW5nDQo+IHRvDQo+ID4gKyAgICAgdGhlIHNwZWNpZmllZCBNTUlP
IHJlZ2lvbi4NCj4gPg0KPiA+ICAgICAgIFNlZSB0aGUgc3Vic2VjdGlvbiAiS2VybmVsIEkvTyBi
YXJyaWVyIGVmZmVjdHMiIGZvciBtb3JlIGluZm9ybWF0aW9uIG9uDQo+ID4gICAgICAgcmVsYXhl
ZCBJL08gYWNjZXNzb3JzIGFuZCB0aGUgRG9jdW1lbnRhdGlvbi9jb3JlLWFwaS9kbWEtYXBpLnJz
dA0KPiA+IGZpbGUgZm9yDQo=