1 // SPDX-License-Identifier: GPL-2.0-only
3 * Test cases for bitmap API.
6 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
8 #include <linux/bitmap.h>
9 #include <linux/init.h>
10 #include <linux/kernel.h>
11 #include <linux/module.h>
12 #include <linux/printk.h>
13 #include <linux/slab.h>
14 #include <linux/string.h>
15 #include <linux/uaccess.h>
17 #include "../tools/testing/selftests/kselftest_module.h"
19 static unsigned total_tests __initdata;
20 static unsigned failed_tests __initdata;
22 static char pbl_buffer[PAGE_SIZE] __initdata;
24 static const unsigned long exp1[] __initconst = {
27 BITMAP_FROM_U64(0x0000ffff),
28 BITMAP_FROM_U64(0xffff0000),
29 BITMAP_FROM_U64(0x55555555),
30 BITMAP_FROM_U64(0xaaaaaaaa),
31 BITMAP_FROM_U64(0x11111111),
32 BITMAP_FROM_U64(0x22222222),
33 BITMAP_FROM_U64(0xffffffff),
34 BITMAP_FROM_U64(0xfffffffe),
35 BITMAP_FROM_U64(0x3333333311111111ULL),
36 BITMAP_FROM_U64(0xffffffff77777777ULL),
40 static const unsigned long exp2[] __initconst = {
41 BITMAP_FROM_U64(0x3333333311111111ULL),
42 BITMAP_FROM_U64(0xffffffff77777777ULL),
45 /* Fibonacci sequence */
46 static const unsigned long exp2_to_exp3_mask[] __initconst = {
47 BITMAP_FROM_U64(0x008000020020212eULL),
49 /* exp3_0_1 = (exp2[0] & ~exp2_to_exp3_mask) | (exp2[1] & exp2_to_exp3_mask) */
50 static const unsigned long exp3_0_1[] __initconst = {
51 BITMAP_FROM_U64(0x33b3333311313137ULL),
53 /* exp3_1_0 = (exp2[1] & ~exp2_to_exp3_mask) | (exp2[0] & exp2_to_exp3_mask) */
54 static const unsigned long exp3_1_0[] __initconst = {
55 BITMAP_FROM_U64(0xff7fffff77575751ULL),
59 __check_eq_uint(const char *srcfile, unsigned int line,
60 const unsigned int exp_uint, unsigned int x)
63 pr_err("[%s:%u] expected %u, got %u\n",
64 srcfile, line, exp_uint, x);
72 __check_eq_bitmap(const char *srcfile, unsigned int line,
73 const unsigned long *exp_bmap, const unsigned long *bmap,
76 if (!bitmap_equal(exp_bmap, bmap, nbits)) {
77 pr_warn("[%s:%u] bitmaps contents differ: expected \"%*pbl\", got \"%*pbl\"\n",
79 nbits, exp_bmap, nbits, bmap);
86 __check_eq_pbl(const char *srcfile, unsigned int line,
87 const char *expected_pbl,
88 const unsigned long *bitmap, unsigned int nbits)
90 snprintf(pbl_buffer, sizeof(pbl_buffer), "%*pbl", nbits, bitmap);
91 if (strcmp(expected_pbl, pbl_buffer)) {
92 pr_warn("[%s:%u] expected \"%s\", got \"%s\"\n",
94 expected_pbl, pbl_buffer);
101 __check_eq_u32_array(const char *srcfile, unsigned int line,
102 const u32 *exp_arr, unsigned int exp_len,
103 const u32 *arr, unsigned int len) __used;
105 __check_eq_u32_array(const char *srcfile, unsigned int line,
106 const u32 *exp_arr, unsigned int exp_len,
107 const u32 *arr, unsigned int len)
109 if (exp_len != len) {
110 pr_warn("[%s:%u] array length differ: expected %u, got %u\n",
116 if (memcmp(exp_arr, arr, len*sizeof(*arr))) {
117 pr_warn("[%s:%u] array contents differ\n", srcfile, line);
118 print_hex_dump(KERN_WARNING, " exp: ", DUMP_PREFIX_OFFSET,
119 32, 4, exp_arr, exp_len*sizeof(*exp_arr), false);
120 print_hex_dump(KERN_WARNING, " got: ", DUMP_PREFIX_OFFSET,
121 32, 4, arr, len*sizeof(*arr), false);
128 static bool __init __check_eq_clump8(const char *srcfile, unsigned int line,
129 const unsigned int offset,
130 const unsigned int size,
131 const unsigned char *const clump_exp,
132 const unsigned long *const clump)
136 if (offset >= size) {
137 pr_warn("[%s:%u] bit offset for clump out-of-bounds: expected less than %u, got %u\n",
138 srcfile, line, size, offset);
142 exp = clump_exp[offset / 8];
144 pr_warn("[%s:%u] bit offset for zero clump: expected nonzero clump, got bit offset %u with clump value 0",
145 srcfile, line, offset);
150 pr_warn("[%s:%u] expected clump value of 0x%lX, got clump value of 0x%lX",
151 srcfile, line, exp, *clump);
158 #define __expect_eq(suffix, ...) \
162 if (!__check_eq_ ## suffix(__FILE__, __LINE__, \
170 #define expect_eq_uint(...) __expect_eq(uint, ##__VA_ARGS__)
171 #define expect_eq_bitmap(...) __expect_eq(bitmap, ##__VA_ARGS__)
172 #define expect_eq_pbl(...) __expect_eq(pbl, ##__VA_ARGS__)
173 #define expect_eq_u32_array(...) __expect_eq(u32_array, ##__VA_ARGS__)
174 #define expect_eq_clump8(...) __expect_eq(clump8, ##__VA_ARGS__)
176 static void __init test_zero_clear(void)
178 DECLARE_BITMAP(bmap, 1024);
180 /* Known way to set all bits */
181 memset(bmap, 0xff, 128);
183 expect_eq_pbl("0-22", bmap, 23);
184 expect_eq_pbl("0-1023", bmap, 1024);
186 /* single-word bitmaps */
187 bitmap_clear(bmap, 0, 9);
188 expect_eq_pbl("9-1023", bmap, 1024);
190 bitmap_zero(bmap, 35);
191 expect_eq_pbl("64-1023", bmap, 1024);
193 /* cross boundaries operations */
194 bitmap_clear(bmap, 79, 19);
195 expect_eq_pbl("64-78,98-1023", bmap, 1024);
197 bitmap_zero(bmap, 115);
198 expect_eq_pbl("128-1023", bmap, 1024);
200 /* Zeroing entire area */
201 bitmap_zero(bmap, 1024);
202 expect_eq_pbl("", bmap, 1024);
205 static void __init test_fill_set(void)
207 DECLARE_BITMAP(bmap, 1024);
209 /* Known way to clear all bits */
210 memset(bmap, 0x00, 128);
212 expect_eq_pbl("", bmap, 23);
213 expect_eq_pbl("", bmap, 1024);
215 /* single-word bitmaps */
216 bitmap_set(bmap, 0, 9);
217 expect_eq_pbl("0-8", bmap, 1024);
219 bitmap_fill(bmap, 35);
220 expect_eq_pbl("0-63", bmap, 1024);
222 /* cross boundaries operations */
223 bitmap_set(bmap, 79, 19);
224 expect_eq_pbl("0-63,79-97", bmap, 1024);
226 bitmap_fill(bmap, 115);
227 expect_eq_pbl("0-127", bmap, 1024);
229 /* Zeroing entire area */
230 bitmap_fill(bmap, 1024);
231 expect_eq_pbl("0-1023", bmap, 1024);
234 static void __init test_copy(void)
236 DECLARE_BITMAP(bmap1, 1024);
237 DECLARE_BITMAP(bmap2, 1024);
239 bitmap_zero(bmap1, 1024);
240 bitmap_zero(bmap2, 1024);
242 /* single-word bitmaps */
243 bitmap_set(bmap1, 0, 19);
244 bitmap_copy(bmap2, bmap1, 23);
245 expect_eq_pbl("0-18", bmap2, 1024);
247 bitmap_set(bmap2, 0, 23);
248 bitmap_copy(bmap2, bmap1, 23);
249 expect_eq_pbl("0-18", bmap2, 1024);
251 /* multi-word bitmaps */
252 bitmap_set(bmap1, 0, 109);
253 bitmap_copy(bmap2, bmap1, 1024);
254 expect_eq_pbl("0-108", bmap2, 1024);
256 bitmap_fill(bmap2, 1024);
257 bitmap_copy(bmap2, bmap1, 1024);
258 expect_eq_pbl("0-108", bmap2, 1024);
260 /* the following tests assume a 32- or 64-bit arch (even 128b
264 bitmap_fill(bmap2, 1024);
265 bitmap_copy(bmap2, bmap1, 109); /* ... but 0-padded til word length */
266 expect_eq_pbl("0-108,128-1023", bmap2, 1024);
268 bitmap_fill(bmap2, 1024);
269 bitmap_copy(bmap2, bmap1, 97); /* ... but aligned on word length */
270 expect_eq_pbl("0-108,128-1023", bmap2, 1024);
273 #define EXP2_IN_BITS (sizeof(exp2) * 8)
275 static void __init test_replace(void)
277 unsigned int nbits = 64;
278 unsigned int nlongs = DIV_ROUND_UP(nbits, BITS_PER_LONG);
279 DECLARE_BITMAP(bmap, 1024);
281 bitmap_zero(bmap, 1024);
282 bitmap_replace(bmap, &exp2[0 * nlongs], &exp2[1 * nlongs], exp2_to_exp3_mask, nbits);
283 expect_eq_bitmap(bmap, exp3_0_1, nbits);
285 bitmap_zero(bmap, 1024);
286 bitmap_replace(bmap, &exp2[1 * nlongs], &exp2[0 * nlongs], exp2_to_exp3_mask, nbits);
287 expect_eq_bitmap(bmap, exp3_1_0, nbits);
289 bitmap_fill(bmap, 1024);
290 bitmap_replace(bmap, &exp2[0 * nlongs], &exp2[1 * nlongs], exp2_to_exp3_mask, nbits);
291 expect_eq_bitmap(bmap, exp3_0_1, nbits);
293 bitmap_fill(bmap, 1024);
294 bitmap_replace(bmap, &exp2[1 * nlongs], &exp2[0 * nlongs], exp2_to_exp3_mask, nbits);
295 expect_eq_bitmap(bmap, exp3_1_0, nbits);
298 #define PARSE_TIME 0x1
301 struct test_bitmap_parselist{
304 const unsigned long *expected;
309 static const struct test_bitmap_parselist parselist_tests[] __initconst = {
310 #define step (sizeof(u64) / sizeof(unsigned long))
312 {0, "0", &exp1[0], 8, 0},
313 {0, "1", &exp1[1 * step], 8, 0},
314 {0, "0-15", &exp1[2 * step], 32, 0},
315 {0, "16-31", &exp1[3 * step], 32, 0},
316 {0, "0-31:1/2", &exp1[4 * step], 32, 0},
317 {0, "1-31:1/2", &exp1[5 * step], 32, 0},
318 {0, "0-31:1/4", &exp1[6 * step], 32, 0},
319 {0, "1-31:1/4", &exp1[7 * step], 32, 0},
320 {0, "0-31:4/4", &exp1[8 * step], 32, 0},
321 {0, "1-31:4/4", &exp1[9 * step], 32, 0},
322 {0, "0-31:1/4,32-63:2/4", &exp1[10 * step], 64, 0},
323 {0, "0-31:3/4,32-63:4/4", &exp1[11 * step], 64, 0},
324 {0, " ,, 0-31:3/4 ,, 32-63:4/4 ,, ", &exp1[11 * step], 64, 0},
326 {0, "0-31:1/4,32-63:2/4,64-95:3/4,96-127:4/4", exp2, 128, 0},
328 {0, "0-2047:128/256", NULL, 2048, PARSE_TIME},
330 {0, "", &exp1[12 * step], 8, 0},
331 {0, "\n", &exp1[12 * step], 8, 0},
332 {0, ",, ,, , , ,", &exp1[12 * step], 8, 0},
333 {0, " , ,, , , ", &exp1[12 * step], 8, 0},
334 {0, " , ,, , , \n", &exp1[12 * step], 8, 0},
336 {-EINVAL, "-1", NULL, 8, 0},
337 {-EINVAL, "-0", NULL, 8, 0},
338 {-EINVAL, "10-1", NULL, 8, 0},
339 {-EINVAL, "0-31:", NULL, 8, 0},
340 {-EINVAL, "0-31:0", NULL, 8, 0},
341 {-EINVAL, "0-31:0/", NULL, 8, 0},
342 {-EINVAL, "0-31:0/0", NULL, 8, 0},
343 {-EINVAL, "0-31:1/0", NULL, 8, 0},
344 {-EINVAL, "0-31:10/1", NULL, 8, 0},
345 {-EOVERFLOW, "0-98765432123456789:10/1", NULL, 8, 0},
347 {-EINVAL, "a-31", NULL, 8, 0},
348 {-EINVAL, "0-a1", NULL, 8, 0},
349 {-EINVAL, "a-31:10/1", NULL, 8, 0},
350 {-EINVAL, "0-31:a/1", NULL, 8, 0},
351 {-EINVAL, "0-\n", NULL, 8, 0},
355 static void __init __test_bitmap_parselist(int is_user)
360 DECLARE_BITMAP(bmap, 2048);
361 char *mode = is_user ? "_user" : "";
363 for (i = 0; i < ARRAY_SIZE(parselist_tests); i++) {
364 #define ptest parselist_tests[i]
367 mm_segment_t orig_fs = get_fs();
368 size_t len = strlen(ptest.in);
372 err = bitmap_parselist_user((__force const char __user *)ptest.in, len,
374 time = ktime_get() - time;
378 err = bitmap_parselist(ptest.in, bmap, ptest.nbits);
379 time = ktime_get() - time;
382 if (err != ptest.errno) {
383 pr_err("parselist%s: %d: input is %s, errno is %d, expected %d\n",
384 mode, i, ptest.in, err, ptest.errno);
388 if (!err && ptest.expected
389 && !__bitmap_equal(bmap, ptest.expected, ptest.nbits)) {
390 pr_err("parselist%s: %d: input is %s, result is 0x%lx, expected 0x%lx\n",
391 mode, i, ptest.in, bmap[0],
396 if (ptest.flags & PARSE_TIME)
397 pr_err("parselist%s: %d: input is '%s' OK, Time: %llu\n",
398 mode, i, ptest.in, time);
404 static const unsigned long parse_test[] __initconst = {
407 BITMAP_FROM_U64(0xdeadbeef),
408 BITMAP_FROM_U64(0x100000000ULL),
411 static const unsigned long parse_test2[] __initconst = {
412 BITMAP_FROM_U64(0x100000000ULL), BITMAP_FROM_U64(0xdeadbeef),
413 BITMAP_FROM_U64(0x100000000ULL), BITMAP_FROM_U64(0xbaadf00ddeadbeef),
414 BITMAP_FROM_U64(0x100000000ULL), BITMAP_FROM_U64(0x0badf00ddeadbeef),
417 static const struct test_bitmap_parselist parse_tests[] __initconst = {
418 {0, "", &parse_test[0 * step], 32, 0},
419 {0, " ", &parse_test[0 * step], 32, 0},
420 {0, "0", &parse_test[0 * step], 32, 0},
421 {0, "0\n", &parse_test[0 * step], 32, 0},
422 {0, "1", &parse_test[1 * step], 32, 0},
423 {0, "deadbeef", &parse_test[2 * step], 32, 0},
424 {0, "1,0", &parse_test[3 * step], 33, 0},
425 {0, "deadbeef,\n,0,1", &parse_test[2 * step], 96, 0},
427 {0, "deadbeef,1,0", &parse_test2[0 * 2 * step], 96, 0},
428 {0, "baadf00d,deadbeef,1,0", &parse_test2[1 * 2 * step], 128, 0},
429 {0, "badf00d,deadbeef,1,0", &parse_test2[2 * 2 * step], 124, 0},
430 {0, "badf00d,deadbeef,1,0", &parse_test2[2 * 2 * step], 124, NO_LEN},
431 {0, " badf00d,deadbeef,1,0 ", &parse_test2[2 * 2 * step], 124, 0},
432 {0, " , badf00d,deadbeef,1,0 , ", &parse_test2[2 * 2 * step], 124, 0},
433 {0, " , badf00d, ,, ,,deadbeef,1,0 , ", &parse_test2[2 * 2 * step], 124, 0},
435 {-EINVAL, "goodfood,deadbeef,1,0", NULL, 128, 0},
436 {-EOVERFLOW, "3,0", NULL, 33, 0},
437 {-EOVERFLOW, "123badf00d,deadbeef,1,0", NULL, 128, 0},
438 {-EOVERFLOW, "badf00d,deadbeef,1,0", NULL, 90, 0},
439 {-EOVERFLOW, "fbadf00d,deadbeef,1,0", NULL, 95, 0},
440 {-EOVERFLOW, "badf00d,deadbeef,1,0", NULL, 100, 0},
444 static void __init __test_bitmap_parse(int is_user)
449 DECLARE_BITMAP(bmap, 2048);
450 char *mode = is_user ? "_user" : "";
452 for (i = 0; i < ARRAY_SIZE(parse_tests); i++) {
453 struct test_bitmap_parselist test = parse_tests[i];
456 size_t len = strlen(test.in);
457 mm_segment_t orig_fs = get_fs();
461 err = bitmap_parse_user((__force const char __user *)test.in, len,
463 time = ktime_get() - time;
466 size_t len = test.flags & NO_LEN ?
467 UINT_MAX : strlen(test.in);
469 err = bitmap_parse(test.in, len, bmap, test.nbits);
470 time = ktime_get() - time;
473 if (err != test.errno) {
474 pr_err("parse%s: %d: input is %s, errno is %d, expected %d\n",
475 mode, i, test.in, err, test.errno);
479 if (!err && test.expected
480 && !__bitmap_equal(bmap, test.expected, test.nbits)) {
481 pr_err("parse%s: %d: input is %s, result is 0x%lx, expected 0x%lx\n",
482 mode, i, test.in, bmap[0],
487 if (test.flags & PARSE_TIME)
488 pr_err("parse%s: %d: input is '%s' OK, Time: %llu\n",
489 mode, i, test.in, time);
493 static void __init test_bitmap_parselist(void)
495 __test_bitmap_parselist(0);
498 static void __init test_bitmap_parselist_user(void)
500 __test_bitmap_parselist(1);
503 static void __init test_bitmap_parse(void)
505 __test_bitmap_parse(0);
508 static void __init test_bitmap_parse_user(void)
510 __test_bitmap_parse(1);
513 #define EXP1_IN_BITS (sizeof(exp1) * 8)
515 static void __init test_bitmap_arr32(void)
517 unsigned int nbits, next_bit;
518 u32 arr[EXP1_IN_BITS / 32];
519 DECLARE_BITMAP(bmap2, EXP1_IN_BITS);
521 memset(arr, 0xa5, sizeof(arr));
523 for (nbits = 0; nbits < EXP1_IN_BITS; ++nbits) {
524 bitmap_to_arr32(arr, exp1, nbits);
525 bitmap_from_arr32(bmap2, arr, nbits);
526 expect_eq_bitmap(bmap2, exp1, nbits);
528 next_bit = find_next_bit(bmap2,
529 round_up(nbits, BITS_PER_LONG), nbits);
530 if (next_bit < round_up(nbits, BITS_PER_LONG))
531 pr_err("bitmap_copy_arr32(nbits == %d:"
532 " tail is not safely cleared: %d\n",
535 if (nbits < EXP1_IN_BITS - 32)
536 expect_eq_uint(arr[DIV_ROUND_UP(nbits, 32)],
541 static void noinline __init test_mem_optimisations(void)
543 DECLARE_BITMAP(bmap1, 1024);
544 DECLARE_BITMAP(bmap2, 1024);
545 unsigned int start, nbits;
547 for (start = 0; start < 1024; start += 8) {
548 for (nbits = 0; nbits < 1024 - start; nbits += 8) {
549 memset(bmap1, 0x5a, sizeof(bmap1));
550 memset(bmap2, 0x5a, sizeof(bmap2));
552 bitmap_set(bmap1, start, nbits);
553 __bitmap_set(bmap2, start, nbits);
554 if (!bitmap_equal(bmap1, bmap2, 1024)) {
555 printk("set not equal %d %d\n", start, nbits);
558 if (!__bitmap_equal(bmap1, bmap2, 1024)) {
559 printk("set not __equal %d %d\n", start, nbits);
563 bitmap_clear(bmap1, start, nbits);
564 __bitmap_clear(bmap2, start, nbits);
565 if (!bitmap_equal(bmap1, bmap2, 1024)) {
566 printk("clear not equal %d %d\n", start, nbits);
569 if (!__bitmap_equal(bmap1, bmap2, 1024)) {
570 printk("clear not __equal %d %d\n", start,
578 static const unsigned char clump_exp[] __initconst = {
579 0x01, /* 1 bit set */
580 0x02, /* non-edge 1 bit set */
581 0x00, /* zero bits set */
582 0x38, /* 3 bits set across 4-bit boundary */
583 0x38, /* Repeated clump */
584 0x0F, /* 4 bits set */
585 0xFF, /* all bits set */
586 0x05, /* non-adjacent 2 bits set */
589 static void __init test_for_each_set_clump8(void)
591 #define CLUMP_EXP_NUMBITS 64
592 DECLARE_BITMAP(bits, CLUMP_EXP_NUMBITS);
596 /* set bitmap to test case */
597 bitmap_zero(bits, CLUMP_EXP_NUMBITS);
598 bitmap_set(bits, 0, 1); /* 0x01 */
599 bitmap_set(bits, 9, 1); /* 0x02 */
600 bitmap_set(bits, 27, 3); /* 0x28 */
601 bitmap_set(bits, 35, 3); /* 0x28 */
602 bitmap_set(bits, 40, 4); /* 0x0F */
603 bitmap_set(bits, 48, 8); /* 0xFF */
604 bitmap_set(bits, 56, 1); /* 0x05 - part 1 */
605 bitmap_set(bits, 58, 1); /* 0x05 - part 2 */
607 for_each_set_clump8(start, clump, bits, CLUMP_EXP_NUMBITS)
608 expect_eq_clump8(start, CLUMP_EXP_NUMBITS, clump_exp, &clump);
611 static void __init selftest(void)
619 test_bitmap_parse_user();
620 test_bitmap_parselist();
621 test_bitmap_parselist_user();
622 test_mem_optimisations();
623 test_for_each_set_clump8();
626 KSTM_MODULE_LOADERS(test_bitmap);
627 MODULE_AUTHOR("david decotigny <david.decotigny@googlers.com>");
628 MODULE_LICENSE("GPL");