LCOV - code coverage report
Current view: top level - lib/util - bit_array.c (source / functions) Hit Total Coverage
Test: ut_cov_unit.info Lines: 172 195 88.2 %
Date: 2024-12-16 20:54:29 Functions: 28 31 90.3 %

          Line data    Source code
       1             : /*   SPDX-License-Identifier: BSD-3-Clause
       2             :  *   Copyright (C) 2016 Intel Corporation.
       3             :  *   All rights reserved.
       4             :  */
       5             : 
       6             : #include "spdk/stdinc.h"
       7             : 
       8             : #include "spdk/bit_array.h"
       9             : #include "spdk/bit_pool.h"
      10             : #include "spdk/env.h"
      11             : 
      12             : #include "spdk/likely.h"
      13             : #include "spdk/util.h"
      14             : 
      15             : typedef uint64_t spdk_bit_array_word;
      16             : #define SPDK_BIT_ARRAY_WORD_TZCNT(x)    (__builtin_ctzll(x))
      17             : #define SPDK_BIT_ARRAY_WORD_POPCNT(x)   (__builtin_popcountll(x))
      18             : #define SPDK_BIT_ARRAY_WORD_C(x)        ((spdk_bit_array_word)(x))
      19             : #define SPDK_BIT_ARRAY_WORD_BYTES       sizeof(spdk_bit_array_word)
      20             : #define SPDK_BIT_ARRAY_WORD_BITS        (SPDK_BIT_ARRAY_WORD_BYTES * 8)
      21             : #define SPDK_BIT_ARRAY_WORD_INDEX_SHIFT spdk_u32log2(SPDK_BIT_ARRAY_WORD_BITS)
      22             : #define SPDK_BIT_ARRAY_WORD_INDEX_MASK  ((1u << SPDK_BIT_ARRAY_WORD_INDEX_SHIFT) - 1)
      23             : 
      24             : struct spdk_bit_array {
      25             :         uint32_t bit_count;
      26             :         spdk_bit_array_word words[];
      27             : };
      28             : 
      29             : struct spdk_bit_array *
      30        4047 : spdk_bit_array_create(uint32_t num_bits)
      31             : {
      32        4047 :         struct spdk_bit_array *ba = NULL;
      33             : 
      34        4047 :         spdk_bit_array_resize(&ba, num_bits);
      35             : 
      36        4047 :         return ba;
      37             : }
      38             : 
      39             : void
      40        4065 : spdk_bit_array_free(struct spdk_bit_array **bap)
      41             : {
      42             :         struct spdk_bit_array *ba;
      43             : 
      44        4065 :         if (!bap) {
      45           1 :                 return;
      46             :         }
      47             : 
      48        4064 :         ba = *bap;
      49        4064 :         *bap = NULL;
      50        4064 :         spdk_free(ba);
      51             : }
      52             : 
      53             : static inline uint32_t
      54       12866 : bit_array_word_count(uint32_t num_bits)
      55             : {
      56       12866 :         return (num_bits + SPDK_BIT_ARRAY_WORD_BITS - 1) >> SPDK_BIT_ARRAY_WORD_INDEX_SHIFT;
      57             : }
      58             : 
      59             : static inline spdk_bit_array_word
      60       18389 : bit_array_word_mask(uint32_t num_bits)
      61             : {
      62       18389 :         assert(num_bits < SPDK_BIT_ARRAY_WORD_BITS);
      63       18389 :         return (SPDK_BIT_ARRAY_WORD_C(1) << num_bits) - 1;
      64             : }
      65             : 
      66             : int
      67        7753 : spdk_bit_array_resize(struct spdk_bit_array **bap, uint32_t num_bits)
      68             : {
      69             :         struct spdk_bit_array *new_ba;
      70             :         uint32_t old_word_count, new_word_count;
      71             :         size_t new_size;
      72             : 
      73             :         /*
      74             :          * Max number of bits allowed is UINT32_MAX - 1, because we use UINT32_MAX to denote
      75             :          * when a set or cleared bit cannot be found.
      76             :          */
      77        7753 :         if (!bap || num_bits == UINT32_MAX) {
      78           1 :                 return -EINVAL;
      79             :         }
      80             : 
      81        7752 :         new_word_count = bit_array_word_count(num_bits);
      82        7752 :         new_size = offsetof(struct spdk_bit_array, words) + new_word_count * SPDK_BIT_ARRAY_WORD_BYTES;
      83             : 
      84             :         /*
      85             :          * Always keep one extra word with a 0 and a 1 past the actual required size so that the
      86             :          * find_first functions can just keep going until they match.
      87             :          */
      88        7752 :         new_size += SPDK_BIT_ARRAY_WORD_BYTES;
      89             : 
      90        7752 :         new_ba = (struct spdk_bit_array *)spdk_realloc(*bap, new_size, 64);
      91        7752 :         if (!new_ba) {
      92           0 :                 return -ENOMEM;
      93             :         }
      94             : 
      95             :         /*
      96             :          * Set up special extra word (see above comment about find_first_clear).
      97             :          *
      98             :          * This is set to 0b10 so that find_first_clear will find a 0 at the very first
      99             :          * bit past the end of the buffer, and find_first_set will find a 1 at the next bit
     100             :          * past that.
     101             :          */
     102        7752 :         new_ba->words[new_word_count] = 0x2;
     103             : 
     104        7752 :         if (*bap == NULL) {
     105        4047 :                 old_word_count = 0;
     106        4047 :                 new_ba->bit_count = 0;
     107             :         } else {
     108        3705 :                 old_word_count = bit_array_word_count(new_ba->bit_count);
     109             :         }
     110             : 
     111        7752 :         if (new_word_count > old_word_count) {
     112             :                 /* Zero out new entries */
     113        4156 :                 memset(&new_ba->words[old_word_count], 0,
     114        4156 :                        (new_word_count - old_word_count) * SPDK_BIT_ARRAY_WORD_BYTES);
     115        3596 :         } else if (new_word_count == old_word_count && num_bits < new_ba->bit_count) {
     116             :                 /* Make sure any existing partial last word is cleared beyond the new num_bits. */
     117             :                 uint32_t last_word_bits;
     118             :                 spdk_bit_array_word mask;
     119             : 
     120           6 :                 last_word_bits = num_bits & SPDK_BIT_ARRAY_WORD_INDEX_MASK;
     121           6 :                 mask = bit_array_word_mask(last_word_bits);
     122           6 :                 new_ba->words[old_word_count - 1] &= mask;
     123             :         }
     124             : 
     125        7752 :         new_ba->bit_count = num_bits;
     126        7752 :         *bap = new_ba;
     127        7752 :         return 0;
     128             : }
     129             : 
     130             : uint32_t
     131       17043 : spdk_bit_array_capacity(const struct spdk_bit_array *ba)
     132             : {
     133       17043 :         return ba->bit_count;
     134             : }
     135             : 
     136             : static inline int
     137      173406 : bit_array_get_word(const struct spdk_bit_array *ba, uint32_t bit_index,
     138             :                    uint32_t *word_index, uint32_t *word_bit_index)
     139             : {
     140      173406 :         if (spdk_unlikely(bit_index >= ba->bit_count)) {
     141         142 :                 return -EINVAL;
     142             :         }
     143             : 
     144      173264 :         *word_index = bit_index >> SPDK_BIT_ARRAY_WORD_INDEX_SHIFT;
     145      173264 :         *word_bit_index = bit_index & SPDK_BIT_ARRAY_WORD_INDEX_MASK;
     146             : 
     147      173264 :         return 0;
     148             : }
     149             : 
     150             : bool
     151       57975 : spdk_bit_array_get(const struct spdk_bit_array *ba, uint32_t bit_index)
     152             : {
     153       57975 :         uint32_t word_index, word_bit_index;
     154             : 
     155       57975 :         if (bit_array_get_word(ba, bit_index, &word_index, &word_bit_index)) {
     156         140 :                 return false;
     157             :         }
     158             : 
     159       57835 :         return (ba->words[word_index] >> word_bit_index) & 1U;
     160             : }
     161             : 
     162             : int
     163      103206 : spdk_bit_array_set(struct spdk_bit_array *ba, uint32_t bit_index)
     164             : {
     165      103206 :         uint32_t word_index, word_bit_index;
     166             : 
     167      103206 :         if (bit_array_get_word(ba, bit_index, &word_index, &word_bit_index)) {
     168           1 :                 return -EINVAL;
     169             :         }
     170             : 
     171      103205 :         ba->words[word_index] |= (SPDK_BIT_ARRAY_WORD_C(1) << word_bit_index);
     172      103205 :         return 0;
     173             : }
     174             : 
     175             : void
     176       12225 : spdk_bit_array_clear(struct spdk_bit_array *ba, uint32_t bit_index)
     177             : {
     178       12225 :         uint32_t word_index, word_bit_index;
     179             : 
     180       12225 :         if (bit_array_get_word(ba, bit_index, &word_index, &word_bit_index)) {
     181             :                 /*
     182             :                  * Clearing past the end of the bit array is a no-op, since bit past the end
     183             :                  * are implicitly 0.
     184             :                  */
     185           1 :                 return;
     186             :         }
     187             : 
     188       12224 :         ba->words[word_index] &= ~(SPDK_BIT_ARRAY_WORD_C(1) << word_bit_index);
     189             : }
     190             : 
     191             : static inline uint32_t
     192       18386 : bit_array_find_first(const struct spdk_bit_array *ba, uint32_t start_bit_index,
     193             :                      spdk_bit_array_word xor_mask)
     194             : {
     195             :         uint32_t word_index, first_word_bit_index;
     196             :         spdk_bit_array_word word, first_word_mask;
     197             :         const spdk_bit_array_word *words, *cur_word;
     198             : 
     199       18386 :         if (spdk_unlikely(start_bit_index >= ba->bit_count)) {
     200           3 :                 return ba->bit_count;
     201             :         }
     202             : 
     203       18383 :         word_index = start_bit_index >> SPDK_BIT_ARRAY_WORD_INDEX_SHIFT;
     204       18383 :         words = ba->words;
     205       18383 :         cur_word = &words[word_index];
     206             : 
     207             :         /*
     208             :          * Special case for first word: skip start_bit_index % SPDK_BIT_ARRAY_WORD_BITS bits
     209             :          * within the first word.
     210             :          */
     211       18383 :         first_word_bit_index = start_bit_index & SPDK_BIT_ARRAY_WORD_INDEX_MASK;
     212       18383 :         first_word_mask = bit_array_word_mask(first_word_bit_index);
     213             : 
     214       18383 :         word = (*cur_word ^ xor_mask) & ~first_word_mask;
     215             : 
     216             :         /*
     217             :          * spdk_bit_array_resize() guarantees that an extra word with a 1 and a 0 will always be
     218             :          * at the end of the words[] array, so just keep going until a word matches.
     219             :          */
     220       24042 :         while (word == 0) {
     221        5659 :                 word = *++cur_word ^ xor_mask;
     222             :         }
     223             : 
     224       18383 :         return ((uintptr_t)cur_word - (uintptr_t)words) * 8 + SPDK_BIT_ARRAY_WORD_TZCNT(word);
     225             : }
     226             : 
     227             : 
     228             : uint32_t
     229        1726 : spdk_bit_array_find_first_set(const struct spdk_bit_array *ba, uint32_t start_bit_index)
     230             : {
     231             :         uint32_t bit_index;
     232             : 
     233        1726 :         bit_index = bit_array_find_first(ba, start_bit_index, 0);
     234             : 
     235             :         /*
     236             :          * If we ran off the end of the array and found the 1 bit in the extra word,
     237             :          * return UINT32_MAX to indicate no actual 1 bits were found.
     238             :          */
     239        1726 :         if (bit_index >= ba->bit_count) {
     240         373 :                 bit_index = UINT32_MAX;
     241             :         }
     242             : 
     243        1726 :         return bit_index;
     244             : }
     245             : 
     246             : uint32_t
     247       16660 : spdk_bit_array_find_first_clear(const struct spdk_bit_array *ba, uint32_t start_bit_index)
     248             : {
     249             :         uint32_t bit_index;
     250             : 
     251       16660 :         bit_index = bit_array_find_first(ba, start_bit_index, SPDK_BIT_ARRAY_WORD_C(-1));
     252             : 
     253             :         /*
     254             :          * If we ran off the end of the array and found the 0 bit in the extra word,
     255             :          * return UINT32_MAX to indicate no actual 0 bits were found.
     256             :          */
     257       16660 :         if (bit_index >= ba->bit_count) {
     258         512 :                 bit_index = UINT32_MAX;
     259             :         }
     260             : 
     261       16660 :         return bit_index;
     262             : }
     263             : 
     264             : uint32_t
     265        1409 : spdk_bit_array_count_set(const struct spdk_bit_array *ba)
     266             : {
     267        1409 :         const spdk_bit_array_word *cur_word = ba->words;
     268        1409 :         uint32_t word_count = bit_array_word_count(ba->bit_count);
     269        1409 :         uint32_t set_count = 0;
     270             : 
     271       13039 :         while (word_count--) {
     272             :                 /*
     273             :                  * No special treatment is needed for the last (potentially partial) word, since
     274             :                  * spdk_bit_array_resize() makes sure the bits past bit_count are cleared.
     275             :                  */
     276       11630 :                 set_count += SPDK_BIT_ARRAY_WORD_POPCNT(*cur_word++);
     277             :         }
     278             : 
     279        1409 :         return set_count;
     280             : }
     281             : 
     282             : uint32_t
     283        1244 : spdk_bit_array_count_clear(const struct spdk_bit_array *ba)
     284             : {
     285        1244 :         return ba->bit_count - spdk_bit_array_count_set(ba);
     286             : }
     287             : 
     288             : void
     289        2845 : spdk_bit_array_store_mask(const struct spdk_bit_array *ba, void *mask)
     290             : {
     291             :         uint32_t size, i;
     292        2845 :         uint32_t num_bits = spdk_bit_array_capacity(ba);
     293             : 
     294        2845 :         size = num_bits / CHAR_BIT;
     295        2845 :         memcpy(mask, ba->words, size);
     296             : 
     297        2910 :         for (i = 0; i < num_bits % CHAR_BIT; i++) {
     298          65 :                 if (spdk_bit_array_get(ba, i + size * CHAR_BIT)) {
     299           6 :                         ((uint8_t *)mask)[size] |= (1U << i);
     300             :                 } else {
     301          59 :                         ((uint8_t *)mask)[size] &= ~(1U << i);
     302             :                 }
     303             :         }
     304        2845 : }
     305             : 
     306             : void
     307         662 : spdk_bit_array_load_mask(struct spdk_bit_array *ba, const void *mask)
     308             : {
     309             :         uint32_t size, i;
     310         662 :         uint32_t num_bits = spdk_bit_array_capacity(ba);
     311             : 
     312         662 :         size = num_bits / CHAR_BIT;
     313         662 :         memcpy(ba->words, mask, size);
     314             : 
     315         667 :         for (i = 0; i < num_bits % CHAR_BIT; i++) {
     316           5 :                 if (((uint8_t *)mask)[size] & (1U << i)) {
     317           1 :                         spdk_bit_array_set(ba, i + size * CHAR_BIT);
     318             :                 } else {
     319           4 :                         spdk_bit_array_clear(ba, i + size * CHAR_BIT);
     320             :                 }
     321             :         }
     322         662 : }
     323             : 
     324             : void
     325           1 : spdk_bit_array_clear_mask(struct spdk_bit_array *ba)
     326             : {
     327             :         uint32_t size, i;
     328           1 :         uint32_t num_bits = spdk_bit_array_capacity(ba);
     329             : 
     330           1 :         size = num_bits / CHAR_BIT;
     331           1 :         memset(ba->words, 0, size);
     332             : 
     333           6 :         for (i = 0; i < num_bits % CHAR_BIT; i++) {
     334           5 :                 spdk_bit_array_clear(ba, i + size * CHAR_BIT);
     335             :         }
     336           1 : }
     337             : 
     338             : struct spdk_bit_pool {
     339             :         struct spdk_bit_array   *array;
     340             :         uint32_t                lowest_free_bit;
     341             :         uint32_t                free_count;
     342             : };
     343             : 
     344             : struct spdk_bit_pool *
     345          10 : spdk_bit_pool_create(uint32_t num_bits)
     346             : {
     347          10 :         struct spdk_bit_pool *pool = NULL;
     348          10 :         struct spdk_bit_array *array;
     349             : 
     350          10 :         array = spdk_bit_array_create(num_bits);
     351          10 :         if (array == NULL) {
     352           0 :                 return NULL;
     353             :         }
     354             : 
     355          10 :         pool = calloc(1, sizeof(*pool));
     356          10 :         if (pool == NULL) {
     357           0 :                 spdk_bit_array_free(&array);
     358           0 :                 return NULL;
     359             :         }
     360             : 
     361          10 :         pool->array = array;
     362          10 :         pool->lowest_free_bit = 0;
     363          10 :         pool->free_count = num_bits;
     364             : 
     365          10 :         return pool;
     366             : }
     367             : 
     368             : struct spdk_bit_pool *
     369         943 : spdk_bit_pool_create_from_array(struct spdk_bit_array *array)
     370             : {
     371         943 :         struct spdk_bit_pool *pool = NULL;
     372             : 
     373         943 :         pool = calloc(1, sizeof(*pool));
     374         943 :         if (pool == NULL) {
     375           0 :                 return NULL;
     376             :         }
     377             : 
     378         943 :         pool->array = array;
     379         943 :         pool->lowest_free_bit = spdk_bit_array_find_first_clear(array, 0);
     380         943 :         pool->free_count = spdk_bit_array_count_clear(array);
     381             : 
     382         943 :         return pool;
     383             : }
     384             : 
     385             : void
     386        1008 : spdk_bit_pool_free(struct spdk_bit_pool **ppool)
     387             : {
     388             :         struct spdk_bit_pool *pool;
     389             : 
     390        1008 :         if (!ppool) {
     391           0 :                 return;
     392             :         }
     393             : 
     394        1008 :         pool = *ppool;
     395        1008 :         *ppool = NULL;
     396        1008 :         if (pool != NULL) {
     397         953 :                 spdk_bit_array_free(&pool->array);
     398         953 :                 free(pool);
     399             :         }
     400             : }
     401             : 
     402             : int
     403           0 : spdk_bit_pool_resize(struct spdk_bit_pool **ppool, uint32_t num_bits)
     404             : {
     405             :         struct spdk_bit_pool *pool;
     406             :         int rc;
     407             : 
     408           0 :         assert(ppool != NULL);
     409             : 
     410           0 :         pool = *ppool;
     411           0 :         rc = spdk_bit_array_resize(&pool->array, num_bits);
     412           0 :         if (rc) {
     413           0 :                 return rc;
     414             :         }
     415             : 
     416           0 :         pool->lowest_free_bit = spdk_bit_array_find_first_clear(pool->array, 0);
     417           0 :         pool->free_count = spdk_bit_array_count_clear(pool->array);
     418             : 
     419           0 :         return 0;
     420             : }
     421             : 
     422             : uint32_t
     423        3860 : spdk_bit_pool_capacity(const struct spdk_bit_pool *pool)
     424             : {
     425        3860 :         return spdk_bit_array_capacity(pool->array);
     426             : }
     427             : 
     428             : bool
     429       20515 : spdk_bit_pool_is_allocated(const struct spdk_bit_pool *pool, uint32_t bit_index)
     430             : {
     431       20515 :         return spdk_bit_array_get(pool->array, bit_index);
     432             : }
     433             : 
     434             : uint32_t
     435       10283 : spdk_bit_pool_allocate_bit(struct spdk_bit_pool *pool)
     436             : {
     437       10283 :         uint32_t bit_index = pool->lowest_free_bit;
     438             : 
     439       10283 :         if (bit_index == UINT32_MAX) {
     440           0 :                 return UINT32_MAX;
     441             :         }
     442             : 
     443       10283 :         spdk_bit_array_set(pool->array, bit_index);
     444       10283 :         pool->lowest_free_bit = spdk_bit_array_find_first_clear(pool->array, bit_index);
     445       10283 :         pool->free_count--;
     446       10283 :         return bit_index;
     447             : }
     448             : 
     449             : void
     450        2996 : spdk_bit_pool_free_bit(struct spdk_bit_pool *pool, uint32_t bit_index)
     451             : {
     452        2996 :         assert(spdk_bit_array_get(pool->array, bit_index) == true);
     453             : 
     454        2996 :         spdk_bit_array_clear(pool->array, bit_index);
     455        2996 :         if (pool->lowest_free_bit > bit_index) {
     456        1584 :                 pool->lowest_free_bit = bit_index;
     457             :         }
     458        2996 :         pool->free_count++;
     459        2996 : }
     460             : 
     461             : uint32_t
     462           0 : spdk_bit_pool_count_allocated(const struct spdk_bit_pool *pool)
     463             : {
     464           0 :         return spdk_bit_array_capacity(pool->array) - pool->free_count;
     465             : }
     466             : 
     467             : uint32_t
     468          10 : spdk_bit_pool_count_free(const struct spdk_bit_pool *pool)
     469             : {
     470          10 :         return pool->free_count;
     471             : }
     472             : 
     473             : void
     474         829 : spdk_bit_pool_store_mask(const struct spdk_bit_pool *pool, void *mask)
     475             : {
     476         829 :         spdk_bit_array_store_mask(pool->array, mask);
     477         829 : }
     478             : 
     479             : void
     480          10 : spdk_bit_pool_load_mask(struct spdk_bit_pool *pool, const void *mask)
     481             : {
     482          10 :         spdk_bit_array_load_mask(pool->array, mask);
     483          10 :         pool->lowest_free_bit = spdk_bit_array_find_first_clear(pool->array, 0);
     484          10 :         pool->free_count = spdk_bit_array_count_clear(pool->array);
     485          10 : }
     486             : 
     487             : void
     488           0 : spdk_bit_pool_free_all_bits(struct spdk_bit_pool *pool)
     489             : {
     490           0 :         spdk_bit_array_clear_mask(pool->array);
     491           0 :         pool->lowest_free_bit = 0;
     492           0 :         pool->free_count = spdk_bit_array_capacity(pool->array);
     493           0 : }

Generated by: LCOV version 1.15