blob: 4cac4e1a72ffc8d81f5c2acc6d88cea0c32117b2 [file] [log] [blame]
Greg Kroah-Hartmanb2441312017-11-01 15:07:57 +01001/* SPDX-License-Identifier: GPL-2.0 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002#ifndef _LINUX_BITOPS_H
3#define _LINUX_BITOPS_H
4#include <asm/types.h>
5
Jiri Slabyd05be132007-10-18 23:40:31 -07006#ifdef __KERNEL__
Jiri Slaby93043ec2007-10-18 23:40:35 -07007#define BIT(nr) (1UL << (nr))
Srinivas Pandruvadabfd1ff62013-10-11 16:54:59 -07008#define BIT_ULL(nr) (1ULL << (nr))
Jiri Slabyd05be132007-10-18 23:40:31 -07009#define BIT_MASK(nr) (1UL << ((nr) % BITS_PER_LONG))
10#define BIT_WORD(nr) ((nr) / BITS_PER_LONG)
Srinivas Pandruvadabfd1ff62013-10-11 16:54:59 -070011#define BIT_ULL_MASK(nr) (1ULL << ((nr) % BITS_PER_LONG_LONG))
12#define BIT_ULL_WORD(nr) ((nr) / BITS_PER_LONG_LONG)
Jiri Slabyd05be132007-10-18 23:40:31 -070013#define BITS_PER_BYTE 8
Eric Dumazetede9c692008-04-29 00:58:35 -070014#define BITS_TO_LONGS(nr) DIV_ROUND_UP(nr, BITS_PER_BYTE * sizeof(long))
Jiri Slabyd05be132007-10-18 23:40:31 -070015#endif
16
Chen, Gong10ef6b02013-10-18 14:29:07 -070017/*
18 * Create a contiguous bitmask starting at bit position @l and ending at
19 * position @h. For example
20 * GENMASK_ULL(39, 21) gives us the 64bit vector 0x000000ffffe00000.
21 */
Maxime COQUELIN00b4d9a12014-11-06 10:54:19 +010022#define GENMASK(h, l) \
Matthias Kaehlckec32ee3d2017-09-08 16:14:33 -070023 (((~0UL) - (1UL << (l)) + 1) & (~0UL >> (BITS_PER_LONG - 1 - (h))))
Maxime COQUELIN00b4d9a12014-11-06 10:54:19 +010024
25#define GENMASK_ULL(h, l) \
Matthias Kaehlckec32ee3d2017-09-08 16:14:33 -070026 (((~0ULL) - (1ULL << (l)) + 1) & \
27 (~0ULL >> (BITS_PER_LONG_LONG - 1 - (h))))
Chen, Gong10ef6b02013-10-18 14:29:07 -070028
Borislav Petkov4677d4a2010-05-03 14:57:11 +020029extern unsigned int __sw_hweight8(unsigned int w);
30extern unsigned int __sw_hweight16(unsigned int w);
31extern unsigned int __sw_hweight32(unsigned int w);
32extern unsigned long __sw_hweight64(__u64 w);
33
Linus Torvalds1da177e2005-04-16 15:20:36 -070034/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070035 * Include this here because some architectures need generic_ffs/fls in
36 * scope
37 */
38#include <asm/bitops.h>
39
Akinobu Mita984b3f52010-03-05 13:41:37 -080040#define for_each_set_bit(bit, addr, size) \
Robert Richter1e2ad282011-11-18 12:35:21 +010041 for ((bit) = find_first_bit((addr), (size)); \
42 (bit) < (size); \
43 (bit) = find_next_bit((addr), (size), (bit) + 1))
44
45/* same as for_each_set_bit() but use bit as value to start with */
Akinobu Mita307b1cd2012-03-23 15:02:03 -070046#define for_each_set_bit_from(bit, addr, size) \
Robert Richter1e2ad282011-11-18 12:35:21 +010047 for ((bit) = find_next_bit((addr), (size), (bit)); \
48 (bit) < (size); \
Shannon Nelson3e037452007-10-16 01:27:40 -070049 (bit) = find_next_bit((addr), (size), (bit) + 1))
50
Akinobu Mita03f4a822012-03-23 15:02:04 -070051#define for_each_clear_bit(bit, addr, size) \
52 for ((bit) = find_first_zero_bit((addr), (size)); \
53 (bit) < (size); \
54 (bit) = find_next_zero_bit((addr), (size), (bit) + 1))
55
56/* same as for_each_clear_bit() but use bit as value to start with */
57#define for_each_clear_bit_from(bit, addr, size) \
58 for ((bit) = find_next_zero_bit((addr), (size), (bit)); \
59 (bit) < (size); \
60 (bit) = find_next_zero_bit((addr), (size), (bit) + 1))
61
Denys Vlasenko1a1d48a2015-08-04 16:15:14 +020062static inline int get_bitmask_order(unsigned int count)
Linus Torvalds1da177e2005-04-16 15:20:36 -070063{
64 int order;
Peter Zijlstra9f416992010-01-22 15:59:29 +010065
Linus Torvalds1da177e2005-04-16 15:20:36 -070066 order = fls(count);
67 return order; /* We could be slightly more clever with -1 here... */
68}
69
Denys Vlasenko1a1d48a2015-08-04 16:15:14 +020070static __always_inline unsigned long hweight_long(unsigned long w)
Linus Torvalds1da177e2005-04-16 15:20:36 -070071{
Akinobu Mitae9bebd62006-03-26 01:39:55 -080072 return sizeof(w) == 4 ? hweight32(w) : hweight64(w);
Linus Torvalds1da177e2005-04-16 15:20:36 -070073}
74
Robert P. J. Day45f8bde2007-01-26 00:57:09 -080075/**
Alexey Dobriyanf2ea0f52012-01-14 21:44:49 +030076 * rol64 - rotate a 64-bit value left
77 * @word: value to rotate
78 * @shift: bits to roll
79 */
80static inline __u64 rol64(__u64 word, unsigned int shift)
81{
82 return (word << shift) | (word >> (64 - shift));
83}
84
85/**
86 * ror64 - rotate a 64-bit value right
87 * @word: value to rotate
88 * @shift: bits to roll
89 */
90static inline __u64 ror64(__u64 word, unsigned int shift)
91{
92 return (word >> shift) | (word << (64 - shift));
93}
94
95/**
Linus Torvalds1da177e2005-04-16 15:20:36 -070096 * rol32 - rotate a 32-bit value left
Linus Torvalds1da177e2005-04-16 15:20:36 -070097 * @word: value to rotate
98 * @shift: bits to roll
99 */
100static inline __u32 rol32(__u32 word, unsigned int shift)
101{
Sasha Levind7e35df2015-12-03 22:04:01 -0500102 return (word << shift) | (word >> ((-shift) & 31));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700103}
104
Robert P. J. Day45f8bde2007-01-26 00:57:09 -0800105/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700106 * ror32 - rotate a 32-bit value right
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107 * @word: value to rotate
108 * @shift: bits to roll
109 */
110static inline __u32 ror32(__u32 word, unsigned int shift)
111{
112 return (word >> shift) | (word << (32 - shift));
113}
114
Harvey Harrison3afe3922008-03-28 14:16:01 -0700115/**
116 * rol16 - rotate a 16-bit value left
117 * @word: value to rotate
118 * @shift: bits to roll
119 */
120static inline __u16 rol16(__u16 word, unsigned int shift)
121{
122 return (word << shift) | (word >> (16 - shift));
123}
124
125/**
126 * ror16 - rotate a 16-bit value right
127 * @word: value to rotate
128 * @shift: bits to roll
129 */
130static inline __u16 ror16(__u16 word, unsigned int shift)
131{
132 return (word >> shift) | (word << (16 - shift));
133}
134
135/**
136 * rol8 - rotate an 8-bit value left
137 * @word: value to rotate
138 * @shift: bits to roll
139 */
140static inline __u8 rol8(__u8 word, unsigned int shift)
141{
142 return (word << shift) | (word >> (8 - shift));
143}
144
145/**
146 * ror8 - rotate an 8-bit value right
147 * @word: value to rotate
148 * @shift: bits to roll
149 */
150static inline __u8 ror8(__u8 word, unsigned int shift)
151{
152 return (word >> shift) | (word << (8 - shift));
153}
154
Andreas Herrmann7919a572010-08-30 19:04:01 +0000155/**
156 * sign_extend32 - sign extend a 32-bit value using specified bit as sign-bit
157 * @value: value to sign extend
158 * @index: 0 based bit index (0<=index<32) to sign bit
Martin Kepplingere2eb53a2015-11-06 16:30:58 -0800159 *
160 * This is safe to use for 16- and 8-bit types as well.
Andreas Herrmann7919a572010-08-30 19:04:01 +0000161 */
162static inline __s32 sign_extend32(__u32 value, int index)
163{
164 __u8 shift = 31 - index;
165 return (__s32)(value << shift) >> shift;
166}
167
Martin Kepplinger48e203e2015-11-06 16:31:02 -0800168/**
169 * sign_extend64 - sign extend a 64-bit value using specified bit as sign-bit
170 * @value: value to sign extend
171 * @index: 0 based bit index (0<=index<64) to sign bit
172 */
173static inline __s64 sign_extend64(__u64 value, int index)
174{
175 __u8 shift = 63 - index;
176 return (__s64)(value << shift) >> shift;
177}
178
Andrew Morton962749a2006-03-25 03:08:01 -0800179static inline unsigned fls_long(unsigned long l)
180{
181 if (sizeof(l) == 4)
182 return fls(l);
183 return fls64(l);
184}
185
zijun_hu252e5c62016-10-07 16:57:26 -0700186static inline int get_count_order(unsigned int count)
187{
188 int order;
189
190 order = fls(count) - 1;
191 if (count & (count - 1))
192 order++;
193 return order;
194}
195
196/**
197 * get_count_order_long - get order after rounding @l up to power of 2
198 * @l: parameter
199 *
200 * it is same as get_count_order() but with long type parameter
201 */
202static inline int get_count_order_long(unsigned long l)
203{
204 if (l == 0UL)
205 return -1;
206 else if (l & (l - 1UL))
207 return (int)fls_long(l);
208 else
209 return (int)fls_long(l) - 1;
210}
211
Steven Whitehouse952043a2009-04-23 08:48:15 +0100212/**
213 * __ffs64 - find first set bit in a 64 bit word
214 * @word: The 64 bit word
215 *
216 * On 64 bit arches this is a synomyn for __ffs
217 * The result is not defined if no bits are set, so check that @word
218 * is non-zero before calling this.
219 */
220static inline unsigned long __ffs64(u64 word)
221{
222#if BITS_PER_LONG == 32
223 if (((u32)word) == 0UL)
224 return __ffs((u32)(word >> 32)) + 32;
225#elif BITS_PER_LONG != 64
226#error BITS_PER_LONG not 32 or 64
227#endif
228 return __ffs((unsigned long)word);
229}
230
Lukas Wunner5307e2a2017-10-12 12:40:10 +0200231/**
232 * assign_bit - Assign value to a bit in memory
233 * @nr: the bit to set
234 * @addr: the address to start counting from
235 * @value: the value to assign
236 */
237static __always_inline void assign_bit(long nr, volatile unsigned long *addr,
238 bool value)
239{
240 if (value)
241 set_bit(nr, addr);
242 else
243 clear_bit(nr, addr);
244}
245
246static __always_inline void __assign_bit(long nr, volatile unsigned long *addr,
247 bool value)
248{
249 if (value)
250 __set_bit(nr, addr);
251 else
252 __clear_bit(nr, addr);
253}
254
Alexander van Heukelum64970b62008-03-11 16:17:19 +0100255#ifdef __KERNEL__
Alexander van Heukelum77b9bd92008-04-01 11:46:19 +0200256
Theodore Ts'o00a1a052014-03-30 10:20:01 -0400257#ifndef set_mask_bits
258#define set_mask_bits(ptr, _mask, _bits) \
259({ \
260 const typeof(*ptr) mask = (_mask), bits = (_bits); \
261 typeof(*ptr) old, new; \
262 \
263 do { \
Mark Rutland6aa7de02017-10-23 14:07:29 -0700264 old = READ_ONCE(*ptr); \
Theodore Ts'o00a1a052014-03-30 10:20:01 -0400265 new = (old & ~mask) | bits; \
266 } while (cmpxchg(ptr, old, new) != old); \
267 \
268 new; \
269})
270#endif
271
Guoqing Jiang85ad1d12016-05-03 22:22:13 -0400272#ifndef bit_clear_unless
273#define bit_clear_unless(ptr, _clear, _test) \
274({ \
275 const typeof(*ptr) clear = (_clear), test = (_test); \
276 typeof(*ptr) old, new; \
277 \
278 do { \
Mark Rutland6aa7de02017-10-23 14:07:29 -0700279 old = READ_ONCE(*ptr); \
Guoqing Jiang85ad1d12016-05-03 22:22:13 -0400280 new = old & ~clear; \
281 } while (!(old & test) && \
282 cmpxchg(ptr, old, new) != old); \
283 \
284 !(old & test); \
285})
286#endif
287
Akinobu Mita19de85e2011-05-26 16:26:09 -0700288#ifndef find_last_bit
Rusty Russellab53d472009-01-01 10:12:19 +1030289/**
290 * find_last_bit - find the last set bit in a memory region
291 * @addr: The address to start the search at
Yury Norov2c57a0e2015-04-16 12:43:13 -0700292 * @size: The number of bits to search
Rusty Russellab53d472009-01-01 10:12:19 +1030293 *
Yury Norov2c57a0e2015-04-16 12:43:13 -0700294 * Returns the bit number of the last set bit, or size.
Rusty Russellab53d472009-01-01 10:12:19 +1030295 */
296extern unsigned long find_last_bit(const unsigned long *addr,
297 unsigned long size);
Akinobu Mita19de85e2011-05-26 16:26:09 -0700298#endif
Rusty Russellab53d472009-01-01 10:12:19 +1030299
Alexander van Heukelum64970b62008-03-11 16:17:19 +0100300#endif /* __KERNEL__ */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700301#endif