Merge branch 'readdir' (readdir speedup and sanity checking)
[linux-block.git] / include / linux / bitops.h
CommitLineData
b2441318 1/* SPDX-License-Identifier: GPL-2.0 */
1da177e4
LT
2#ifndef _LINUX_BITOPS_H
3#define _LINUX_BITOPS_H
4#include <asm/types.h>
8bd9cb51 5#include <linux/bits.h>
1da177e4 6
f5a1a536
AS
7/* Set bits in the first 'n' bytes when loaded from memory */
8#ifdef __LITTLE_ENDIAN
9# define aligned_byte_mask(n) ((1UL << 8*(n))-1)
10#else
11# define aligned_byte_mask(n) (~0xffUL << (BITS_PER_LONG - 8 - 8*(n)))
12#endif
13
9144d75e
CW
14#define BITS_PER_TYPE(type) (sizeof(type) * BITS_PER_BYTE)
15#define BITS_TO_LONGS(nr) DIV_ROUND_UP(nr, BITS_PER_TYPE(long))
10ef6b0d 16
4677d4a5
BP
17extern unsigned int __sw_hweight8(unsigned int w);
18extern unsigned int __sw_hweight16(unsigned int w);
19extern unsigned int __sw_hweight32(unsigned int w);
20extern unsigned long __sw_hweight64(__u64 w);
21
1da177e4
LT
22/*
23 * Include this here because some architectures need generic_ffs/fls in
24 * scope
25 */
26#include <asm/bitops.h>
27
984b3f57 28#define for_each_set_bit(bit, addr, size) \
1e2ad28f
RR
29 for ((bit) = find_first_bit((addr), (size)); \
30 (bit) < (size); \
31 (bit) = find_next_bit((addr), (size), (bit) + 1))
32
33/* same as for_each_set_bit() but use bit as value to start with */
307b1cd7 34#define for_each_set_bit_from(bit, addr, size) \
1e2ad28f
RR
35 for ((bit) = find_next_bit((addr), (size), (bit)); \
36 (bit) < (size); \
3e037454
SN
37 (bit) = find_next_bit((addr), (size), (bit) + 1))
38
03f4a822
AM
39#define for_each_clear_bit(bit, addr, size) \
40 for ((bit) = find_first_zero_bit((addr), (size)); \
41 (bit) < (size); \
42 (bit) = find_next_zero_bit((addr), (size), (bit) + 1))
43
44/* same as for_each_clear_bit() but use bit as value to start with */
45#define for_each_clear_bit_from(bit, addr, size) \
46 for ((bit) = find_next_zero_bit((addr), (size), (bit)); \
47 (bit) < (size); \
48 (bit) = find_next_zero_bit((addr), (size), (bit) + 1))
49
1a1d48a4 50static inline int get_bitmask_order(unsigned int count)
1da177e4
LT
51{
52 int order;
9f41699e 53
1da177e4
LT
54 order = fls(count);
55 return order; /* We could be slightly more clever with -1 here... */
56}
57
1a1d48a4 58static __always_inline unsigned long hweight_long(unsigned long w)
1da177e4 59{
e9bebd6f 60 return sizeof(w) == 4 ? hweight32(w) : hweight64(w);
1da177e4
LT
61}
62
f2ea0f5f
AD
63/**
64 * rol64 - rotate a 64-bit value left
65 * @word: value to rotate
66 * @shift: bits to roll
67 */
68static inline __u64 rol64(__u64 word, unsigned int shift)
69{
ef4d6f6b 70 return (word << (shift & 63)) | (word >> ((-shift) & 63));
f2ea0f5f
AD
71}
72
73/**
74 * ror64 - rotate a 64-bit value right
75 * @word: value to rotate
76 * @shift: bits to roll
77 */
78static inline __u64 ror64(__u64 word, unsigned int shift)
79{
ef4d6f6b 80 return (word >> (shift & 63)) | (word << ((-shift) & 63));
f2ea0f5f
AD
81}
82
45f8bde0 83/**
1da177e4 84 * rol32 - rotate a 32-bit value left
1da177e4
LT
85 * @word: value to rotate
86 * @shift: bits to roll
87 */
88static inline __u32 rol32(__u32 word, unsigned int shift)
89{
ef4d6f6b 90 return (word << (shift & 31)) | (word >> ((-shift) & 31));
1da177e4
LT
91}
92
45f8bde0 93/**
1da177e4 94 * ror32 - rotate a 32-bit value right
1da177e4
LT
95 * @word: value to rotate
96 * @shift: bits to roll
97 */
98static inline __u32 ror32(__u32 word, unsigned int shift)
99{
ef4d6f6b 100 return (word >> (shift & 31)) | (word << ((-shift) & 31));
1da177e4
LT
101}
102
3afe3925
HH
103/**
104 * rol16 - rotate a 16-bit value left
105 * @word: value to rotate
106 * @shift: bits to roll
107 */
108static inline __u16 rol16(__u16 word, unsigned int shift)
109{
ef4d6f6b 110 return (word << (shift & 15)) | (word >> ((-shift) & 15));
3afe3925
HH
111}
112
113/**
114 * ror16 - rotate a 16-bit value right
115 * @word: value to rotate
116 * @shift: bits to roll
117 */
118static inline __u16 ror16(__u16 word, unsigned int shift)
119{
ef4d6f6b 120 return (word >> (shift & 15)) | (word << ((-shift) & 15));
3afe3925
HH
121}
122
123/**
124 * rol8 - rotate an 8-bit value left
125 * @word: value to rotate
126 * @shift: bits to roll
127 */
128static inline __u8 rol8(__u8 word, unsigned int shift)
129{
ef4d6f6b 130 return (word << (shift & 7)) | (word >> ((-shift) & 7));
3afe3925
HH
131}
132
133/**
134 * ror8 - rotate an 8-bit value right
135 * @word: value to rotate
136 * @shift: bits to roll
137 */
138static inline __u8 ror8(__u8 word, unsigned int shift)
139{
ef4d6f6b 140 return (word >> (shift & 7)) | (word << ((-shift) & 7));
3afe3925 141}
7919a57b
AH
142
143/**
144 * sign_extend32 - sign extend a 32-bit value using specified bit as sign-bit
145 * @value: value to sign extend
146 * @index: 0 based bit index (0<=index<32) to sign bit
e2eb53aa
MK
147 *
148 * This is safe to use for 16- and 8-bit types as well.
7919a57b
AH
149 */
150static inline __s32 sign_extend32(__u32 value, int index)
151{
152 __u8 shift = 31 - index;
153 return (__s32)(value << shift) >> shift;
154}
3afe3925 155
48e203e2
MK
156/**
157 * sign_extend64 - sign extend a 64-bit value using specified bit as sign-bit
158 * @value: value to sign extend
159 * @index: 0 based bit index (0<=index<64) to sign bit
160 */
161static inline __s64 sign_extend64(__u64 value, int index)
162{
163 __u8 shift = 63 - index;
164 return (__s64)(value << shift) >> shift;
165}
166
962749af
AM
167static inline unsigned fls_long(unsigned long l)
168{
169 if (sizeof(l) == 4)
170 return fls(l);
171 return fls64(l);
172}
173
252e5c6e 174static inline int get_count_order(unsigned int count)
175{
176 int order;
177
178 order = fls(count) - 1;
179 if (count & (count - 1))
180 order++;
181 return order;
182}
183
184/**
185 * get_count_order_long - get order after rounding @l up to power of 2
186 * @l: parameter
187 *
188 * it is same as get_count_order() but with long type parameter
189 */
190static inline int get_count_order_long(unsigned long l)
191{
192 if (l == 0UL)
193 return -1;
194 else if (l & (l - 1UL))
195 return (int)fls_long(l);
196 else
197 return (int)fls_long(l) - 1;
198}
199
952043ac
SW
200/**
201 * __ffs64 - find first set bit in a 64 bit word
202 * @word: The 64 bit word
203 *
204 * On 64 bit arches this is a synomyn for __ffs
205 * The result is not defined if no bits are set, so check that @word
206 * is non-zero before calling this.
207 */
208static inline unsigned long __ffs64(u64 word)
209{
210#if BITS_PER_LONG == 32
211 if (((u32)word) == 0UL)
212 return __ffs((u32)(word >> 32)) + 32;
213#elif BITS_PER_LONG != 64
214#error BITS_PER_LONG not 32 or 64
215#endif
216 return __ffs((unsigned long)word);
217}
218
5307e2ad
LW
219/**
220 * assign_bit - Assign value to a bit in memory
221 * @nr: the bit to set
222 * @addr: the address to start counting from
223 * @value: the value to assign
224 */
225static __always_inline void assign_bit(long nr, volatile unsigned long *addr,
226 bool value)
227{
228 if (value)
229 set_bit(nr, addr);
230 else
231 clear_bit(nr, addr);
232}
233
234static __always_inline void __assign_bit(long nr, volatile unsigned long *addr,
235 bool value)
236{
237 if (value)
238 __set_bit(nr, addr);
239 else
240 __clear_bit(nr, addr);
241}
242
64970b68 243#ifdef __KERNEL__
77b9bd9c 244
00a1a053 245#ifndef set_mask_bits
18127429 246#define set_mask_bits(ptr, mask, bits) \
00a1a053 247({ \
18127429
MS
248 const typeof(*(ptr)) mask__ = (mask), bits__ = (bits); \
249 typeof(*(ptr)) old__, new__; \
00a1a053
TT
250 \
251 do { \
18127429
MS
252 old__ = READ_ONCE(*(ptr)); \
253 new__ = (old__ & ~mask__) | bits__; \
254 } while (cmpxchg(ptr, old__, new__) != old__); \
00a1a053 255 \
1db604f6 256 old__; \
00a1a053
TT
257})
258#endif
259
85ad1d13 260#ifndef bit_clear_unless
edfa8728 261#define bit_clear_unless(ptr, clear, test) \
85ad1d13 262({ \
edfa8728
MS
263 const typeof(*(ptr)) clear__ = (clear), test__ = (test);\
264 typeof(*(ptr)) old__, new__; \
85ad1d13
GJ
265 \
266 do { \
edfa8728
MS
267 old__ = READ_ONCE(*(ptr)); \
268 new__ = old__ & ~clear__; \
269 } while (!(old__ & test__) && \
270 cmpxchg(ptr, old__, new__) != old__); \
85ad1d13 271 \
edfa8728 272 !(old__ & test__); \
85ad1d13
GJ
273})
274#endif
275
19de85ef 276#ifndef find_last_bit
ab53d472
RR
277/**
278 * find_last_bit - find the last set bit in a memory region
279 * @addr: The address to start the search at
2c57a0e2 280 * @size: The number of bits to search
ab53d472 281 *
2c57a0e2 282 * Returns the bit number of the last set bit, or size.
ab53d472
RR
283 */
284extern unsigned long find_last_bit(const unsigned long *addr,
285 unsigned long size);
19de85ef 286#endif
ab53d472 287
64970b68 288#endif /* __KERNEL__ */
1da177e4 289#endif