Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

tools/include: Remove ACCESS_ONCE()

There are no longer any usersapce uses of ACCESS_ONCE(), so we can
remove the definition from our userspace <linux/compiler.h>, which is
only used by tools in the kernel directory (i.e. it isn't a uapi
header).

This patch removes the ACCESS_ONCE() definition, and updates comments
which referred to it. At the same time, some inconsistent and redundant
whitespace is removed from comments.

Tested-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
Signed-off-by: Mark Rutland <mark.rutland@arm.com>
Cc: Arnaldo Carvalho de Melo <acme@redhat.com>
Cc: Joe Perches <joe@perches.com>
Cc: Linus Torvalds <torvalds@linux-foundation.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: apw@canonical.com
Link: http://lkml.kernel.org/r/20171127103824.36526-3-mark.rutland@arm.com
Signed-off-by: Ingo Molnar <mingo@kernel.org>

authored by

Mark Rutland and committed by
Ingo Molnar
2a22f692 f971e511

+9 -12
+9 -12
tools/include/linux/compiler.h
··· 84 84 85 85 #define uninitialized_var(x) x = *(&(x)) 86 86 87 - #define ACCESS_ONCE(x) (*(volatile typeof(x) *)&(x)) 88 - 89 87 #include <linux/types.h> 90 88 91 89 /* ··· 133 135 /* 134 136 * Prevent the compiler from merging or refetching reads or writes. The 135 137 * compiler is also forbidden from reordering successive instances of 136 - * READ_ONCE, WRITE_ONCE and ACCESS_ONCE (see below), but only when the 137 - * compiler is aware of some particular ordering. One way to make the 138 - * compiler aware of ordering is to put the two invocations of READ_ONCE, 139 - * WRITE_ONCE or ACCESS_ONCE() in different C statements. 138 + * READ_ONCE and WRITE_ONCE, but only when the compiler is aware of some 139 + * particular ordering. One way to make the compiler aware of ordering is to 140 + * put the two invocations of READ_ONCE or WRITE_ONCE in different C 141 + * statements. 140 142 * 141 - * In contrast to ACCESS_ONCE these two macros will also work on aggregate 142 - * data types like structs or unions. If the size of the accessed data 143 - * type exceeds the word size of the machine (e.g., 32 bits or 64 bits) 144 - * READ_ONCE() and WRITE_ONCE() will fall back to memcpy and print a 145 - * compile-time warning. 143 + * These two macros will also work on aggregate data types like structs or 144 + * unions. If the size of the accessed data type exceeds the word size of 145 + * the machine (e.g., 32 bits or 64 bits) READ_ONCE() and WRITE_ONCE() will 146 + * fall back to memcpy and print a compile-time warning. 146 147 * 147 148 * Their two major use cases are: (1) Mediating communication between 148 149 * process-level code and irq/NMI handlers, all running on the same CPU, 149 - * and (2) Ensuring that the compiler does not fold, spindle, or otherwise 150 + * and (2) Ensuring that the compiler does not fold, spindle, or otherwise 150 151 * mutilate accesses that either do not require ordering or that interact 151 152 * with an explicit memory barrier or atomic instruction that provides the 152 153 * required ordering.