blob: 9a874deee6e2824d1189124ef7d0117a5ae98e4f [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifndef _LINUX_BITOPS_H
2#define _LINUX_BITOPS_H
3#include <asm/types.h>
4
Jiri Slabyd05be132007-10-18 23:40:31 -07005#ifdef __KERNEL__
Jiri Slaby93043ec2007-10-18 23:40:35 -07006#define BIT(nr) (1UL << (nr))
Srinivas Pandruvadabfd1ff62013-10-11 16:54:59 -07007#define BIT_ULL(nr) (1ULL << (nr))
Jiri Slabyd05be132007-10-18 23:40:31 -07008#define BIT_MASK(nr) (1UL << ((nr) % BITS_PER_LONG))
9#define BIT_WORD(nr) ((nr) / BITS_PER_LONG)
Srinivas Pandruvadabfd1ff62013-10-11 16:54:59 -070010#define BIT_ULL_MASK(nr) (1ULL << ((nr) % BITS_PER_LONG_LONG))
11#define BIT_ULL_WORD(nr) ((nr) / BITS_PER_LONG_LONG)
Jiri Slabyd05be132007-10-18 23:40:31 -070012#define BITS_PER_BYTE 8
Eric Dumazetede9c692008-04-29 00:58:35 -070013#define BITS_TO_LONGS(nr) DIV_ROUND_UP(nr, BITS_PER_BYTE * sizeof(long))
Jiri Slabyd05be132007-10-18 23:40:31 -070014#endif
15
Chen, Gong10ef6b02013-10-18 14:29:07 -070016/*
17 * Create a contiguous bitmask starting at bit position @l and ending at
18 * position @h. For example
19 * GENMASK_ULL(39, 21) gives us the 64bit vector 0x000000ffffe00000.
20 */
Maxime COQUELIN00b4d9a12014-11-06 10:54:19 +010021#define GENMASK(h, l) \
Matthias Kaehlckec32ee3d2017-09-08 16:14:33 -070022 (((~0UL) - (1UL << (l)) + 1) & (~0UL >> (BITS_PER_LONG - 1 - (h))))
Maxime COQUELIN00b4d9a12014-11-06 10:54:19 +010023
24#define GENMASK_ULL(h, l) \
Matthias Kaehlckec32ee3d2017-09-08 16:14:33 -070025 (((~0ULL) - (1ULL << (l)) + 1) & \
26 (~0ULL >> (BITS_PER_LONG_LONG - 1 - (h))))
Chen, Gong10ef6b02013-10-18 14:29:07 -070027
Borislav Petkov4677d4a2010-05-03 14:57:11 +020028extern unsigned int __sw_hweight8(unsigned int w);
29extern unsigned int __sw_hweight16(unsigned int w);
30extern unsigned int __sw_hweight32(unsigned int w);
31extern unsigned long __sw_hweight64(__u64 w);
32
Linus Torvalds1da177e2005-04-16 15:20:36 -070033/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070034 * Include this here because some architectures need generic_ffs/fls in
35 * scope
36 */
37#include <asm/bitops.h>
38
Akinobu Mita984b3f52010-03-05 13:41:37 -080039#define for_each_set_bit(bit, addr, size) \
Robert Richter1e2ad282011-11-18 12:35:21 +010040 for ((bit) = find_first_bit((addr), (size)); \
41 (bit) < (size); \
42 (bit) = find_next_bit((addr), (size), (bit) + 1))
43
44/* same as for_each_set_bit() but use bit as value to start with */
Akinobu Mita307b1cd2012-03-23 15:02:03 -070045#define for_each_set_bit_from(bit, addr, size) \
Robert Richter1e2ad282011-11-18 12:35:21 +010046 for ((bit) = find_next_bit((addr), (size), (bit)); \
47 (bit) < (size); \
Shannon Nelson3e037452007-10-16 01:27:40 -070048 (bit) = find_next_bit((addr), (size), (bit) + 1))
49
Akinobu Mita03f4a822012-03-23 15:02:04 -070050#define for_each_clear_bit(bit, addr, size) \
51 for ((bit) = find_first_zero_bit((addr), (size)); \
52 (bit) < (size); \
53 (bit) = find_next_zero_bit((addr), (size), (bit) + 1))
54
55/* same as for_each_clear_bit() but use bit as value to start with */
56#define for_each_clear_bit_from(bit, addr, size) \
57 for ((bit) = find_next_zero_bit((addr), (size), (bit)); \
58 (bit) < (size); \
59 (bit) = find_next_zero_bit((addr), (size), (bit) + 1))
60
Denys Vlasenko1a1d48a2015-08-04 16:15:14 +020061static inline int get_bitmask_order(unsigned int count)
Linus Torvalds1da177e2005-04-16 15:20:36 -070062{
63 int order;
Peter Zijlstra9f416992010-01-22 15:59:29 +010064
Linus Torvalds1da177e2005-04-16 15:20:36 -070065 order = fls(count);
66 return order; /* We could be slightly more clever with -1 here... */
67}
68
Denys Vlasenko1a1d48a2015-08-04 16:15:14 +020069static __always_inline unsigned long hweight_long(unsigned long w)
Linus Torvalds1da177e2005-04-16 15:20:36 -070070{
Akinobu Mitae9bebd62006-03-26 01:39:55 -080071 return sizeof(w) == 4 ? hweight32(w) : hweight64(w);
Linus Torvalds1da177e2005-04-16 15:20:36 -070072}
73
Robert P. J. Day45f8bde2007-01-26 00:57:09 -080074/**
Alexey Dobriyanf2ea0f52012-01-14 21:44:49 +030075 * rol64 - rotate a 64-bit value left
76 * @word: value to rotate
77 * @shift: bits to roll
78 */
79static inline __u64 rol64(__u64 word, unsigned int shift)
80{
81 return (word << shift) | (word >> (64 - shift));
82}
83
84/**
85 * ror64 - rotate a 64-bit value right
86 * @word: value to rotate
87 * @shift: bits to roll
88 */
89static inline __u64 ror64(__u64 word, unsigned int shift)
90{
91 return (word >> shift) | (word << (64 - shift));
92}
93
94/**
Linus Torvalds1da177e2005-04-16 15:20:36 -070095 * rol32 - rotate a 32-bit value left
Linus Torvalds1da177e2005-04-16 15:20:36 -070096 * @word: value to rotate
97 * @shift: bits to roll
98 */
99static inline __u32 rol32(__u32 word, unsigned int shift)
100{
Sasha Levind7e35df2015-12-03 22:04:01 -0500101 return (word << shift) | (word >> ((-shift) & 31));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700102}
103
Robert P. J. Day45f8bde2007-01-26 00:57:09 -0800104/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700105 * ror32 - rotate a 32-bit value right
Linus Torvalds1da177e2005-04-16 15:20:36 -0700106 * @word: value to rotate
107 * @shift: bits to roll
108 */
109static inline __u32 ror32(__u32 word, unsigned int shift)
110{
111 return (word >> shift) | (word << (32 - shift));
112}
113
Harvey Harrison3afe3922008-03-28 14:16:01 -0700114/**
115 * rol16 - rotate a 16-bit value left
116 * @word: value to rotate
117 * @shift: bits to roll
118 */
119static inline __u16 rol16(__u16 word, unsigned int shift)
120{
121 return (word << shift) | (word >> (16 - shift));
122}
123
124/**
125 * ror16 - rotate a 16-bit value right
126 * @word: value to rotate
127 * @shift: bits to roll
128 */
129static inline __u16 ror16(__u16 word, unsigned int shift)
130{
131 return (word >> shift) | (word << (16 - shift));
132}
133
134/**
135 * rol8 - rotate an 8-bit value left
136 * @word: value to rotate
137 * @shift: bits to roll
138 */
139static inline __u8 rol8(__u8 word, unsigned int shift)
140{
141 return (word << shift) | (word >> (8 - shift));
142}
143
144/**
145 * ror8 - rotate an 8-bit value right
146 * @word: value to rotate
147 * @shift: bits to roll
148 */
149static inline __u8 ror8(__u8 word, unsigned int shift)
150{
151 return (word >> shift) | (word << (8 - shift));
152}
153
Andreas Herrmann7919a572010-08-30 19:04:01 +0000154/**
155 * sign_extend32 - sign extend a 32-bit value using specified bit as sign-bit
156 * @value: value to sign extend
157 * @index: 0 based bit index (0<=index<32) to sign bit
Martin Kepplingere2eb53a2015-11-06 16:30:58 -0800158 *
159 * This is safe to use for 16- and 8-bit types as well.
Andreas Herrmann7919a572010-08-30 19:04:01 +0000160 */
161static inline __s32 sign_extend32(__u32 value, int index)
162{
163 __u8 shift = 31 - index;
164 return (__s32)(value << shift) >> shift;
165}
166
Martin Kepplinger48e203e2015-11-06 16:31:02 -0800167/**
168 * sign_extend64 - sign extend a 64-bit value using specified bit as sign-bit
169 * @value: value to sign extend
170 * @index: 0 based bit index (0<=index<64) to sign bit
171 */
172static inline __s64 sign_extend64(__u64 value, int index)
173{
174 __u8 shift = 63 - index;
175 return (__s64)(value << shift) >> shift;
176}
177
Andrew Morton962749a2006-03-25 03:08:01 -0800178static inline unsigned fls_long(unsigned long l)
179{
180 if (sizeof(l) == 4)
181 return fls(l);
182 return fls64(l);
183}
184
zijun_hu252e5c62016-10-07 16:57:26 -0700185static inline int get_count_order(unsigned int count)
186{
187 int order;
188
189 order = fls(count) - 1;
190 if (count & (count - 1))
191 order++;
192 return order;
193}
194
195/**
196 * get_count_order_long - get order after rounding @l up to power of 2
197 * @l: parameter
198 *
199 * it is same as get_count_order() but with long type parameter
200 */
201static inline int get_count_order_long(unsigned long l)
202{
203 if (l == 0UL)
204 return -1;
205 else if (l & (l - 1UL))
206 return (int)fls_long(l);
207 else
208 return (int)fls_long(l) - 1;
209}
210
Steven Whitehouse952043a2009-04-23 08:48:15 +0100211/**
212 * __ffs64 - find first set bit in a 64 bit word
213 * @word: The 64 bit word
214 *
215 * On 64 bit arches this is a synomyn for __ffs
216 * The result is not defined if no bits are set, so check that @word
217 * is non-zero before calling this.
218 */
219static inline unsigned long __ffs64(u64 word)
220{
221#if BITS_PER_LONG == 32
222 if (((u32)word) == 0UL)
223 return __ffs((u32)(word >> 32)) + 32;
224#elif BITS_PER_LONG != 64
225#error BITS_PER_LONG not 32 or 64
226#endif
227 return __ffs((unsigned long)word);
228}
229
Lukas Wunner5307e2a2017-10-12 12:40:10 +0200230/**
231 * assign_bit - Assign value to a bit in memory
232 * @nr: the bit to set
233 * @addr: the address to start counting from
234 * @value: the value to assign
235 */
236static __always_inline void assign_bit(long nr, volatile unsigned long *addr,
237 bool value)
238{
239 if (value)
240 set_bit(nr, addr);
241 else
242 clear_bit(nr, addr);
243}
244
245static __always_inline void __assign_bit(long nr, volatile unsigned long *addr,
246 bool value)
247{
248 if (value)
249 __set_bit(nr, addr);
250 else
251 __clear_bit(nr, addr);
252}
253
Alexander van Heukelum64970b62008-03-11 16:17:19 +0100254#ifdef __KERNEL__
Alexander van Heukelum77b9bd92008-04-01 11:46:19 +0200255
Theodore Ts'o00a1a052014-03-30 10:20:01 -0400256#ifndef set_mask_bits
257#define set_mask_bits(ptr, _mask, _bits) \
258({ \
259 const typeof(*ptr) mask = (_mask), bits = (_bits); \
260 typeof(*ptr) old, new; \
261 \
262 do { \
263 old = ACCESS_ONCE(*ptr); \
264 new = (old & ~mask) | bits; \
265 } while (cmpxchg(ptr, old, new) != old); \
266 \
267 new; \
268})
269#endif
270
Guoqing Jiang85ad1d12016-05-03 22:22:13 -0400271#ifndef bit_clear_unless
272#define bit_clear_unless(ptr, _clear, _test) \
273({ \
274 const typeof(*ptr) clear = (_clear), test = (_test); \
275 typeof(*ptr) old, new; \
276 \
277 do { \
278 old = ACCESS_ONCE(*ptr); \
279 new = old & ~clear; \
280 } while (!(old & test) && \
281 cmpxchg(ptr, old, new) != old); \
282 \
283 !(old & test); \
284})
285#endif
286
Akinobu Mita19de85e2011-05-26 16:26:09 -0700287#ifndef find_last_bit
Rusty Russellab53d472009-01-01 10:12:19 +1030288/**
289 * find_last_bit - find the last set bit in a memory region
290 * @addr: The address to start the search at
Yury Norov2c57a0e2015-04-16 12:43:13 -0700291 * @size: The number of bits to search
Rusty Russellab53d472009-01-01 10:12:19 +1030292 *
Yury Norov2c57a0e2015-04-16 12:43:13 -0700293 * Returns the bit number of the last set bit, or size.
Rusty Russellab53d472009-01-01 10:12:19 +1030294 */
295extern unsigned long find_last_bit(const unsigned long *addr,
296 unsigned long size);
Akinobu Mita19de85e2011-05-26 16:26:09 -0700297#endif
Rusty Russellab53d472009-01-01 10:12:19 +1030298
Alexander van Heukelum64970b62008-03-11 16:17:19 +0100299#endif /* __KERNEL__ */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700300#endif