Thread (155 messages) 155 messages, 13 authors, 2016-04-14

Re: [PATCH] documentation: Add disclaimer

From: David Howells <dhowells@redhat.com>
Date: 2016-01-27 14:57:21
Also in: linux-arch, linux-arm-kernel, linux-mips, linux-s390, linux-sh, linux-um, lkml, sparclinux

Peter Zijlstra [off-list ref] wrote:
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+DISCLAIMER
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
+This document is not a specification; it is intentionally (for the sake=
 of
+brevity) and unintentionally (due to being human) incomplete. This docu=
ment is
+meant as a guide to using the various memory barriers provided by Linux=
, but
+in case of any doubt (and there are many) please ask.
+
+I repeat, this document is not a specification of what Linux expects fr=
om
+hardware.
The purpose of this document is twofold:

 (1) to specify the minimum functionality that one can rely on for any
     particular barrier, and

 (2) to provide a guide as to how to use the barriers that are available.

Note that an architecture can provide more than the minimum requirement fo=
r
any particular barrier, but if the barrier provides less than that, it is
incorrect.

Note also that it is possible that a barrier may be a no-op for an
architecture because the way that arch works renders an explicit barrier
unnecessary in that case.
+
Can you bung an extra blank line in here if you have to redo this at all?
+=3D=3D=3D=3D=3D=3D=3D=3D
+CONTENTS
+=3D=3D=3D=3D=3D=3D=3D=3D
 =
  (*) Abstract memory access model.
 =

David
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help