1 #ifndef _ASM_X86_BITOPS_H
2 #define _ASM_X86_BITOPS_H
5 * Copyright 1992, Linus Torvalds.
7 * Note: inlines with more than a single statement should be marked
8 * __always_inline to avoid problems with older gcc's inlining heuristics.
11 #ifndef _LINUX_BITOPS_H
12 #error only <linux/bitops.h> can be included directly
15 #include <linux/compiler.h>
16 #include <asm/alternative.h>
17 #include <asm/rmwcc.h>
18 #include <asm/barrier.h>
20 #if BITS_PER_LONG == 32
21 # define _BITOPS_LONG_SHIFT 5
22 #elif BITS_PER_LONG == 64
23 # define _BITOPS_LONG_SHIFT 6
25 # error "Unexpected BITS_PER_LONG"
28 #define BIT_64(n) (U64_C(1) << (n))
31 * These have to be done with inline assembly: that way the bit-setting
32 * is guaranteed to be atomic. All bit operations return 0 if the bit
33 * was cleared before the operation and != 0 if it was not.
35 * bit 0 is the LSB of addr; bit 32 is the LSB of (addr+1).
38 #if __GNUC__ < 4 || (__GNUC__ == 4 && __GNUC_MINOR__ < 1)
39 /* Technically wrong, but this avoids compilation errors on some gcc
41 #define BITOP_ADDR(x) "=m" (*(volatile long *) (x))
43 #define BITOP_ADDR(x) "+m" (*(volatile long *) (x))
46 #define ADDR BITOP_ADDR(addr)
49 * We do the locked ops that don't return the old value as
50 * a mask operation on a byte.
52 #define IS_IMMEDIATE(nr) (__builtin_constant_p(nr))
53 #define CONST_MASK_ADDR(nr, addr) BITOP_ADDR((void *)(addr) + ((nr)>>3))
54 #define CONST_MASK(nr) (1 << ((nr) & 7))
57 * set_bit - Atomically set a bit in memory
59 * @addr: the address to start counting from
61 * This function is atomic and may not be reordered. See __set_bit()
62 * if you do not require the atomic guarantees.
64 * Note: there are no guarantees that this function will not be reordered
65 * on non x86 architectures, so if you are writing portable code,
66 * make sure not to rely on its reordering guarantees.
68 * Note that @nr may be almost arbitrarily large; this function is not
69 * restricted to acting on a single-word quantity.
71 static __always_inline
void
72 set_bit(long nr
, volatile unsigned long *addr
)
74 if (IS_IMMEDIATE(nr
)) {
75 asm volatile(LOCK_PREFIX
"orb %1,%0"
76 : CONST_MASK_ADDR(nr
, addr
)
77 : "iq" ((u8
)CONST_MASK(nr
))
80 asm volatile(LOCK_PREFIX
"bts %1,%0"
81 : BITOP_ADDR(addr
) : "Ir" (nr
) : "memory");
86 * __set_bit - Set a bit in memory
88 * @addr: the address to start counting from
90 * Unlike set_bit(), this function is non-atomic and may be reordered.
91 * If it's called on the same region of memory simultaneously, the effect
92 * may be that only one operation succeeds.
94 static __always_inline
void __set_bit(long nr
, volatile unsigned long *addr
)
96 asm volatile("bts %1,%0" : ADDR
: "Ir" (nr
) : "memory");
100 * clear_bit - Clears a bit in memory
102 * @addr: Address to start counting from
104 * clear_bit() is atomic and may not be reordered. However, it does
105 * not contain a memory barrier, so if it is used for locking purposes,
106 * you should call smp_mb__before_atomic() and/or smp_mb__after_atomic()
107 * in order to ensure changes are visible on other processors.
109 static __always_inline
void
110 clear_bit(long nr
, volatile unsigned long *addr
)
112 if (IS_IMMEDIATE(nr
)) {
113 asm volatile(LOCK_PREFIX
"andb %1,%0"
114 : CONST_MASK_ADDR(nr
, addr
)
115 : "iq" ((u8
)~CONST_MASK(nr
)));
117 asm volatile(LOCK_PREFIX
"btr %1,%0"
124 * clear_bit_unlock - Clears a bit in memory
126 * @addr: Address to start counting from
128 * clear_bit() is atomic and implies release semantics before the memory
129 * operation. It can be used for an unlock.
131 static __always_inline
void clear_bit_unlock(long nr
, volatile unsigned long *addr
)
137 static __always_inline
void __clear_bit(long nr
, volatile unsigned long *addr
)
139 asm volatile("btr %1,%0" : ADDR
: "Ir" (nr
));
143 * __clear_bit_unlock - Clears a bit in memory
145 * @addr: Address to start counting from
147 * __clear_bit() is non-atomic and implies release semantics before the memory
148 * operation. It can be used for an unlock if no other CPUs can concurrently
149 * modify other bits in the word.
151 * No memory barrier is required here, because x86 cannot reorder stores past
152 * older loads. Same principle as spin_unlock.
154 static __always_inline
void __clear_bit_unlock(long nr
, volatile unsigned long *addr
)
157 __clear_bit(nr
, addr
);
161 * __change_bit - Toggle a bit in memory
162 * @nr: the bit to change
163 * @addr: the address to start counting from
165 * Unlike change_bit(), this function is non-atomic and may be reordered.
166 * If it's called on the same region of memory simultaneously, the effect
167 * may be that only one operation succeeds.
169 static __always_inline
void __change_bit(long nr
, volatile unsigned long *addr
)
171 asm volatile("btc %1,%0" : ADDR
: "Ir" (nr
));
175 * change_bit - Toggle a bit in memory
177 * @addr: Address to start counting from
179 * change_bit() is atomic and may not be reordered.
180 * Note that @nr may be almost arbitrarily large; this function is not
181 * restricted to acting on a single-word quantity.
183 static __always_inline
void change_bit(long nr
, volatile unsigned long *addr
)
185 if (IS_IMMEDIATE(nr
)) {
186 asm volatile(LOCK_PREFIX
"xorb %1,%0"
187 : CONST_MASK_ADDR(nr
, addr
)
188 : "iq" ((u8
)CONST_MASK(nr
)));
190 asm volatile(LOCK_PREFIX
"btc %1,%0"
197 * test_and_set_bit - Set a bit and return its old value
199 * @addr: Address to count from
201 * This operation is atomic and cannot be reordered.
202 * It also implies a memory barrier.
204 static __always_inline
bool test_and_set_bit(long nr
, volatile unsigned long *addr
)
206 GEN_BINARY_RMWcc(LOCK_PREFIX
"bts", *addr
, "Ir", nr
, "%0", c
);
210 * test_and_set_bit_lock - Set a bit and return its old value for lock
212 * @addr: Address to count from
214 * This is the same as test_and_set_bit on x86.
216 static __always_inline
bool
217 test_and_set_bit_lock(long nr
, volatile unsigned long *addr
)
219 return test_and_set_bit(nr
, addr
);
223 * __test_and_set_bit - Set a bit and return its old value
225 * @addr: Address to count from
227 * This operation is non-atomic and can be reordered.
228 * If two examples of this operation race, one can appear to succeed
229 * but actually fail. You must protect multiple accesses with a lock.
231 static __always_inline
bool __test_and_set_bit(long nr
, volatile unsigned long *addr
)
237 : CC_OUT(c
) (oldbit
), ADDR
243 * test_and_clear_bit - Clear a bit and return its old value
245 * @addr: Address to count from
247 * This operation is atomic and cannot be reordered.
248 * It also implies a memory barrier.
250 static __always_inline
bool test_and_clear_bit(long nr
, volatile unsigned long *addr
)
252 GEN_BINARY_RMWcc(LOCK_PREFIX
"btr", *addr
, "Ir", nr
, "%0", c
);
256 * __test_and_clear_bit - Clear a bit and return its old value
258 * @addr: Address to count from
260 * This operation is non-atomic and can be reordered.
261 * If two examples of this operation race, one can appear to succeed
262 * but actually fail. You must protect multiple accesses with a lock.
264 * Note: the operation is performed atomically with respect to
265 * the local CPU, but not other CPUs. Portable code should not
266 * rely on this behaviour.
267 * KVM relies on this behaviour on x86 for modifying memory that is also
268 * accessed from a hypervisor on the same CPU if running in a VM: don't change
269 * this without also updating arch/x86/kernel/kvm.c
271 static __always_inline
bool __test_and_clear_bit(long nr
, volatile unsigned long *addr
)
275 asm volatile("btr %2,%1\n\t"
277 : CC_OUT(c
) (oldbit
), ADDR
282 /* WARNING: non atomic and it can be reordered! */
283 static __always_inline
bool __test_and_change_bit(long nr
, volatile unsigned long *addr
)
287 asm volatile("btc %2,%1\n\t"
289 : CC_OUT(c
) (oldbit
), ADDR
290 : "Ir" (nr
) : "memory");
296 * test_and_change_bit - Change a bit and return its old value
298 * @addr: Address to count from
300 * This operation is atomic and cannot be reordered.
301 * It also implies a memory barrier.
303 static __always_inline
bool test_and_change_bit(long nr
, volatile unsigned long *addr
)
305 GEN_BINARY_RMWcc(LOCK_PREFIX
"btc", *addr
, "Ir", nr
, "%0", c
);
308 static __always_inline
bool constant_test_bit(long nr
, const volatile unsigned long *addr
)
310 return ((1UL << (nr
& (BITS_PER_LONG
-1))) &
311 (addr
[nr
>> _BITOPS_LONG_SHIFT
])) != 0;
314 static __always_inline
bool variable_test_bit(long nr
, volatile const unsigned long *addr
)
318 asm volatile("bt %2,%1\n\t"
321 : "m" (*(unsigned long *)addr
), "Ir" (nr
));
326 #if 0 /* Fool kernel-doc since it doesn't do macros yet */
328 * test_bit - Determine whether a bit is set
329 * @nr: bit number to test
330 * @addr: Address to start counting from
332 static bool test_bit(int nr
, const volatile unsigned long *addr
);
335 #define test_bit(nr, addr) \
336 (__builtin_constant_p((nr)) \
337 ? constant_test_bit((nr), (addr)) \
338 : variable_test_bit((nr), (addr)))
341 * __ffs - find first set bit in word
342 * @word: The word to search
344 * Undefined if no bit exists, so code should check against 0 first.
346 static __always_inline
unsigned long __ffs(unsigned long word
)
355 * ffz - find first zero bit in word
356 * @word: The word to search
358 * Undefined if no zero exists, so code should check against ~0UL first.
360 static __always_inline
unsigned long ffz(unsigned long word
)
369 * __fls: find last set bit in word
370 * @word: The word to search
372 * Undefined if no set bit exists, so code should check against 0 first.
374 static __always_inline
unsigned long __fls(unsigned long word
)
386 * ffs - find first set bit in word
387 * @x: the word to search
389 * This is defined the same way as the libc and compiler builtin ffs
390 * routines, therefore differs in spirit from the other bitops.
392 * ffs(value) returns 0 if value is 0 or the position of the first
393 * set bit if value is nonzero. The first (least significant) bit
396 static __always_inline
int ffs(int x
)
402 * AMD64 says BSFL won't clobber the dest reg if x==0; Intel64 says the
403 * dest reg is undefined if x==0, but their CPU architect says its
404 * value is written to set it to the same as before, except that the
405 * top 32 bits will be cleared.
407 * We cannot do this on 32 bits because at the very least some
408 * 486 CPUs did not behave this way.
412 : "rm" (x
), "0" (-1));
413 #elif defined(CONFIG_X86_CMOV)
416 : "=&r" (r
) : "rm" (x
), "r" (-1));
421 "1:" : "=r" (r
) : "rm" (x
));
427 * fls - find last set bit in word
428 * @x: the word to search
430 * This is defined in a similar way as the libc and compiler builtin
431 * ffs, but returns the position of the most significant set bit.
433 * fls(value) returns 0 if value is 0 or the position of the last
434 * set bit if value is nonzero. The last (most significant) bit is
437 static __always_inline
int fls(int x
)
443 * AMD64 says BSRL won't clobber the dest reg if x==0; Intel64 says the
444 * dest reg is undefined if x==0, but their CPU architect says its
445 * value is written to set it to the same as before, except that the
446 * top 32 bits will be cleared.
448 * We cannot do this on 32 bits because at the very least some
449 * 486 CPUs did not behave this way.
453 : "rm" (x
), "0" (-1));
454 #elif defined(CONFIG_X86_CMOV)
457 : "=&r" (r
) : "rm" (x
), "rm" (-1));
462 "1:" : "=r" (r
) : "rm" (x
));
468 * fls64 - find last set bit in a 64-bit word
469 * @x: the word to search
471 * This is defined in a similar way as the libc and compiler builtin
472 * ffsll, but returns the position of the most significant set bit.
474 * fls64(value) returns 0 if value is 0 or the position of the last
475 * set bit if value is nonzero. The last (most significant) bit is
479 static __always_inline
int fls64(__u64 x
)
483 * AMD64 says BSRQ won't clobber the dest reg if x==0; Intel64 says the
484 * dest reg is undefined if x==0, but their CPU architect says its
485 * value is written to set it to the same as before.
493 #include <asm-generic/bitops/fls64.h>
496 #include <asm-generic/bitops/find.h>
498 #include <asm-generic/bitops/sched.h>
500 #include <asm/arch_hweight.h>
502 #include <asm-generic/bitops/const_hweight.h>
504 #include <asm-generic/bitops/le.h>
506 #include <asm-generic/bitops/ext2-atomic-setbit.h>
508 #endif /* __KERNEL__ */
509 #endif /* _ASM_X86_BITOPS_H */