summaryrefslogtreecommitdiffstats
path: root/arch/x86/include/asm/bitops.h
diff options
context:
space:
mode:
authorMichael S. Tsirkin2012-06-24 18:24:42 +0200
committerAvi Kivity2012-06-25 11:38:35 +0200
commitd0a69d6321ca759bb8d47803d06ba8571ab42d07 (patch)
tree6b94990e0b4d43251740fa60deef29148bce9d58 /arch/x86/include/asm/bitops.h
parentKVM guest: guest side for eoi avoidance (diff)
downloadkernel-qcow2-linux-d0a69d6321ca759bb8d47803d06ba8571ab42d07.tar.gz
kernel-qcow2-linux-d0a69d6321ca759bb8d47803d06ba8571ab42d07.tar.xz
kernel-qcow2-linux-d0a69d6321ca759bb8d47803d06ba8571ab42d07.zip
x86, bitops: note on __test_and_clear_bit atomicity
__test_and_clear_bit is actually atomic with respect to the local CPU. Add a note saying that KVM on x86 relies on this behaviour so people don't accidentaly break it. Also warn not to rely on this in portable code. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Signed-off-by: Avi Kivity <avi@redhat.com>
Diffstat (limited to 'arch/x86/include/asm/bitops.h')
-rw-r--r--arch/x86/include/asm/bitops.h7
1 files changed, 7 insertions, 0 deletions
diff --git a/arch/x86/include/asm/bitops.h b/arch/x86/include/asm/bitops.h
index a6983b277220..72f5009deb5a 100644
--- a/arch/x86/include/asm/bitops.h
+++ b/arch/x86/include/asm/bitops.h
@@ -264,6 +264,13 @@ static inline int test_and_clear_bit(int nr, volatile unsigned long *addr)
* This operation is non-atomic and can be reordered.
* If two examples of this operation race, one can appear to succeed
* but actually fail. You must protect multiple accesses with a lock.
+ *
+ * Note: the operation is performed atomically with respect to
+ * the local CPU, but not other CPUs. Portable code should not
+ * rely on this behaviour.
+ * KVM relies on this behaviour on x86 for modifying memory that is also
+ * accessed from a hypervisor on the same CPU if running in a VM: don't change
+ * this without also updating arch/x86/kernel/kvm.c
*/
static inline int __test_and_clear_bit(int nr, volatile unsigned long *addr)
{