Blame jemalloc/include/jemalloc/internal/bitmap.h

Packit 345191
#ifndef JEMALLOC_INTERNAL_BITMAP_H
Packit 345191
#define JEMALLOC_INTERNAL_BITMAP_H
Packit 345191
Packit 345191
#include "jemalloc/internal/arena_types.h"
Packit 345191
#include "jemalloc/internal/bit_util.h"
Packit 345191
#include "jemalloc/internal/sc.h"
Packit 345191
Packit 345191
typedef unsigned long bitmap_t;
Packit 345191
#define LG_SIZEOF_BITMAP	LG_SIZEOF_LONG
Packit 345191
Packit 345191
/* Maximum bitmap bit count is 2^LG_BITMAP_MAXBITS. */
Packit 345191
#if LG_SLAB_MAXREGS > LG_CEIL(SC_NSIZES)
Packit 345191
/* Maximum bitmap bit count is determined by maximum regions per slab. */
Packit 345191
#  define LG_BITMAP_MAXBITS	LG_SLAB_MAXREGS
Packit 345191
#else
Packit 345191
/* Maximum bitmap bit count is determined by number of extent size classes. */
Packit 345191
#  define LG_BITMAP_MAXBITS	LG_CEIL(SC_NSIZES)
Packit 345191
#endif
Packit 345191
#define BITMAP_MAXBITS		(ZU(1) << LG_BITMAP_MAXBITS)
Packit 345191
Packit 345191
/* Number of bits per group. */
Packit 345191
#define LG_BITMAP_GROUP_NBITS		(LG_SIZEOF_BITMAP + 3)
Packit 345191
#define BITMAP_GROUP_NBITS		(1U << LG_BITMAP_GROUP_NBITS)
Packit 345191
#define BITMAP_GROUP_NBITS_MASK		(BITMAP_GROUP_NBITS-1)
Packit 345191
Packit 345191
/*
Packit 345191
 * Do some analysis on how big the bitmap is before we use a tree.  For a brute
Packit 345191
 * force linear search, if we would have to call ffs_lu() more than 2^3 times,
Packit 345191
 * use a tree instead.
Packit 345191
 */
Packit 345191
#if LG_BITMAP_MAXBITS - LG_BITMAP_GROUP_NBITS > 3
Packit 345191
#  define BITMAP_USE_TREE
Packit 345191
#endif
Packit 345191
Packit 345191
/* Number of groups required to store a given number of bits. */
Packit 345191
#define BITMAP_BITS2GROUPS(nbits)					\
Packit 345191
    (((nbits) + BITMAP_GROUP_NBITS_MASK) >> LG_BITMAP_GROUP_NBITS)
Packit 345191
Packit 345191
/*
Packit 345191
 * Number of groups required at a particular level for a given number of bits.
Packit 345191
 */
Packit 345191
#define BITMAP_GROUPS_L0(nbits)						\
Packit 345191
    BITMAP_BITS2GROUPS(nbits)
Packit 345191
#define BITMAP_GROUPS_L1(nbits)						\
Packit 345191
    BITMAP_BITS2GROUPS(BITMAP_BITS2GROUPS(nbits))
Packit 345191
#define BITMAP_GROUPS_L2(nbits)						\
Packit 345191
    BITMAP_BITS2GROUPS(BITMAP_BITS2GROUPS(BITMAP_BITS2GROUPS((nbits))))
Packit 345191
#define BITMAP_GROUPS_L3(nbits)						\
Packit 345191
    BITMAP_BITS2GROUPS(BITMAP_BITS2GROUPS(BITMAP_BITS2GROUPS(		\
Packit 345191
	BITMAP_BITS2GROUPS((nbits)))))
Packit 345191
#define BITMAP_GROUPS_L4(nbits)						\
Packit 345191
    BITMAP_BITS2GROUPS(BITMAP_BITS2GROUPS(BITMAP_BITS2GROUPS(		\
Packit 345191
	BITMAP_BITS2GROUPS(BITMAP_BITS2GROUPS((nbits))))))
Packit 345191
Packit 345191
/*
Packit 345191
 * Assuming the number of levels, number of groups required for a given number
Packit 345191
 * of bits.
Packit 345191
 */
Packit 345191
#define BITMAP_GROUPS_1_LEVEL(nbits)					\
Packit 345191
    BITMAP_GROUPS_L0(nbits)
Packit 345191
#define BITMAP_GROUPS_2_LEVEL(nbits)					\
Packit 345191
    (BITMAP_GROUPS_1_LEVEL(nbits) + BITMAP_GROUPS_L1(nbits))
Packit 345191
#define BITMAP_GROUPS_3_LEVEL(nbits)					\
Packit 345191
    (BITMAP_GROUPS_2_LEVEL(nbits) + BITMAP_GROUPS_L2(nbits))
Packit 345191
#define BITMAP_GROUPS_4_LEVEL(nbits)					\
Packit 345191
    (BITMAP_GROUPS_3_LEVEL(nbits) + BITMAP_GROUPS_L3(nbits))
Packit 345191
#define BITMAP_GROUPS_5_LEVEL(nbits)					\
Packit 345191
    (BITMAP_GROUPS_4_LEVEL(nbits) + BITMAP_GROUPS_L4(nbits))
Packit 345191
Packit 345191
/*
Packit 345191
 * Maximum number of groups required to support LG_BITMAP_MAXBITS.
Packit 345191
 */
Packit 345191
#ifdef BITMAP_USE_TREE
Packit 345191
Packit 345191
#if LG_BITMAP_MAXBITS <= LG_BITMAP_GROUP_NBITS
Packit 345191
#  define BITMAP_GROUPS(nbits)	BITMAP_GROUPS_1_LEVEL(nbits)
Packit 345191
#  define BITMAP_GROUPS_MAX	BITMAP_GROUPS_1_LEVEL(BITMAP_MAXBITS)
Packit 345191
#elif LG_BITMAP_MAXBITS <= LG_BITMAP_GROUP_NBITS * 2
Packit 345191
#  define BITMAP_GROUPS(nbits)	BITMAP_GROUPS_2_LEVEL(nbits)
Packit 345191
#  define BITMAP_GROUPS_MAX	BITMAP_GROUPS_2_LEVEL(BITMAP_MAXBITS)
Packit 345191
#elif LG_BITMAP_MAXBITS <= LG_BITMAP_GROUP_NBITS * 3
Packit 345191
#  define BITMAP_GROUPS(nbits)	BITMAP_GROUPS_3_LEVEL(nbits)
Packit 345191
#  define BITMAP_GROUPS_MAX	BITMAP_GROUPS_3_LEVEL(BITMAP_MAXBITS)
Packit 345191
#elif LG_BITMAP_MAXBITS <= LG_BITMAP_GROUP_NBITS * 4
Packit 345191
#  define BITMAP_GROUPS(nbits)	BITMAP_GROUPS_4_LEVEL(nbits)
Packit 345191
#  define BITMAP_GROUPS_MAX	BITMAP_GROUPS_4_LEVEL(BITMAP_MAXBITS)
Packit 345191
#elif LG_BITMAP_MAXBITS <= LG_BITMAP_GROUP_NBITS * 5
Packit 345191
#  define BITMAP_GROUPS(nbits)	BITMAP_GROUPS_5_LEVEL(nbits)
Packit 345191
#  define BITMAP_GROUPS_MAX	BITMAP_GROUPS_5_LEVEL(BITMAP_MAXBITS)
Packit 345191
#else
Packit 345191
#  error "Unsupported bitmap size"
Packit 345191
#endif
Packit 345191
Packit 345191
/*
Packit 345191
 * Maximum number of levels possible.  This could be statically computed based
Packit 345191
 * on LG_BITMAP_MAXBITS:
Packit 345191
 *
Packit 345191
 * #define BITMAP_MAX_LEVELS \
Packit 345191
 *     (LG_BITMAP_MAXBITS / LG_SIZEOF_BITMAP) \
Packit 345191
 *     + !!(LG_BITMAP_MAXBITS % LG_SIZEOF_BITMAP)
Packit 345191
 *
Packit 345191
 * However, that would not allow the generic BITMAP_INFO_INITIALIZER() macro, so
Packit 345191
 * instead hardcode BITMAP_MAX_LEVELS to the largest number supported by the
Packit 345191
 * various cascading macros.  The only additional cost this incurs is some
Packit 345191
 * unused trailing entries in bitmap_info_t structures; the bitmaps themselves
Packit 345191
 * are not impacted.
Packit 345191
 */
Packit 345191
#define BITMAP_MAX_LEVELS	5
Packit 345191
Packit 345191
#define BITMAP_INFO_INITIALIZER(nbits) {				\
Packit 345191
	/* nbits. */							\
Packit 345191
	nbits,								\
Packit 345191
	/* nlevels. */							\
Packit 345191
	(BITMAP_GROUPS_L0(nbits) > BITMAP_GROUPS_L1(nbits)) +		\
Packit 345191
	    (BITMAP_GROUPS_L1(nbits) > BITMAP_GROUPS_L2(nbits)) +	\
Packit 345191
	    (BITMAP_GROUPS_L2(nbits) > BITMAP_GROUPS_L3(nbits)) +	\
Packit 345191
	    (BITMAP_GROUPS_L3(nbits) > BITMAP_GROUPS_L4(nbits)) + 1,	\
Packit 345191
	/* levels. */							\
Packit 345191
	{								\
Packit 345191
		{0},							\
Packit 345191
		{BITMAP_GROUPS_L0(nbits)},				\
Packit 345191
		{BITMAP_GROUPS_L1(nbits) + BITMAP_GROUPS_L0(nbits)},	\
Packit 345191
		{BITMAP_GROUPS_L2(nbits) + BITMAP_GROUPS_L1(nbits) +	\
Packit 345191
		    BITMAP_GROUPS_L0(nbits)},				\
Packit 345191
		{BITMAP_GROUPS_L3(nbits) + BITMAP_GROUPS_L2(nbits) +	\
Packit 345191
		    BITMAP_GROUPS_L1(nbits) + BITMAP_GROUPS_L0(nbits)},	\
Packit 345191
		{BITMAP_GROUPS_L4(nbits) + BITMAP_GROUPS_L3(nbits) +	\
Packit 345191
		     BITMAP_GROUPS_L2(nbits) + BITMAP_GROUPS_L1(nbits)	\
Packit 345191
		     + BITMAP_GROUPS_L0(nbits)}				\
Packit 345191
	}								\
Packit 345191
}
Packit 345191
Packit 345191
#else /* BITMAP_USE_TREE */
Packit 345191
Packit 345191
#define BITMAP_GROUPS(nbits)	BITMAP_BITS2GROUPS(nbits)
Packit 345191
#define BITMAP_GROUPS_MAX	BITMAP_BITS2GROUPS(BITMAP_MAXBITS)
Packit 345191
Packit 345191
#define BITMAP_INFO_INITIALIZER(nbits) {				\
Packit 345191
	/* nbits. */							\
Packit 345191
	nbits,								\
Packit 345191
	/* ngroups. */							\
Packit 345191
	BITMAP_BITS2GROUPS(nbits)					\
Packit 345191
}
Packit 345191
Packit 345191
#endif /* BITMAP_USE_TREE */
Packit 345191
Packit 345191
typedef struct bitmap_level_s {
Packit 345191
	/* Offset of this level's groups within the array of groups. */
Packit 345191
	size_t group_offset;
Packit 345191
} bitmap_level_t;
Packit 345191
Packit 345191
typedef struct bitmap_info_s {
Packit 345191
	/* Logical number of bits in bitmap (stored at bottom level). */
Packit 345191
	size_t nbits;
Packit 345191
Packit 345191
#ifdef BITMAP_USE_TREE
Packit 345191
	/* Number of levels necessary for nbits. */
Packit 345191
	unsigned nlevels;
Packit 345191
Packit 345191
	/*
Packit 345191
	 * Only the first (nlevels+1) elements are used, and levels are ordered
Packit 345191
	 * bottom to top (e.g. the bottom level is stored in levels[0]).
Packit 345191
	 */
Packit 345191
	bitmap_level_t levels[BITMAP_MAX_LEVELS+1];
Packit 345191
#else /* BITMAP_USE_TREE */
Packit 345191
	/* Number of groups necessary for nbits. */
Packit 345191
	size_t ngroups;
Packit 345191
#endif /* BITMAP_USE_TREE */
Packit 345191
} bitmap_info_t;
Packit 345191
Packit 345191
void bitmap_info_init(bitmap_info_t *binfo, size_t nbits);
Packit 345191
void bitmap_init(bitmap_t *bitmap, const bitmap_info_t *binfo, bool fill);
Packit 345191
size_t bitmap_size(const bitmap_info_t *binfo);
Packit 345191
Packit 345191
static inline bool
Packit 345191
bitmap_full(bitmap_t *bitmap, const bitmap_info_t *binfo) {
Packit 345191
#ifdef BITMAP_USE_TREE
Packit 345191
	size_t rgoff = binfo->levels[binfo->nlevels].group_offset - 1;
Packit 345191
	bitmap_t rg = bitmap[rgoff];
Packit 345191
	/* The bitmap is full iff the root group is 0. */
Packit 345191
	return (rg == 0);
Packit 345191
#else
Packit 345191
	size_t i;
Packit 345191
Packit 345191
	for (i = 0; i < binfo->ngroups; i++) {
Packit 345191
		if (bitmap[i] != 0) {
Packit 345191
			return false;
Packit 345191
		}
Packit 345191
	}
Packit 345191
	return true;
Packit 345191
#endif
Packit 345191
}
Packit 345191
Packit 345191
static inline bool
Packit 345191
bitmap_get(bitmap_t *bitmap, const bitmap_info_t *binfo, size_t bit) {
Packit 345191
	size_t goff;
Packit 345191
	bitmap_t g;
Packit 345191
Packit 345191
	assert(bit < binfo->nbits);
Packit 345191
	goff = bit >> LG_BITMAP_GROUP_NBITS;
Packit 345191
	g = bitmap[goff];
Packit 345191
	return !(g & (ZU(1) << (bit & BITMAP_GROUP_NBITS_MASK)));
Packit 345191
}
Packit 345191
Packit 345191
static inline void
Packit 345191
bitmap_set(bitmap_t *bitmap, const bitmap_info_t *binfo, size_t bit) {
Packit 345191
	size_t goff;
Packit 345191
	bitmap_t *gp;
Packit 345191
	bitmap_t g;
Packit 345191
Packit 345191
	assert(bit < binfo->nbits);
Packit 345191
	assert(!bitmap_get(bitmap, binfo, bit));
Packit 345191
	goff = bit >> LG_BITMAP_GROUP_NBITS;
Packit 345191
	gp = &bitmap[goff];
Packit 345191
	g = *gp;
Packit 345191
	assert(g & (ZU(1) << (bit & BITMAP_GROUP_NBITS_MASK)));
Packit 345191
	g ^= ZU(1) << (bit & BITMAP_GROUP_NBITS_MASK);
Packit 345191
	*gp = g;
Packit 345191
	assert(bitmap_get(bitmap, binfo, bit));
Packit 345191
#ifdef BITMAP_USE_TREE
Packit 345191
	/* Propagate group state transitions up the tree. */
Packit 345191
	if (g == 0) {
Packit 345191
		unsigned i;
Packit 345191
		for (i = 1; i < binfo->nlevels; i++) {
Packit 345191
			bit = goff;
Packit 345191
			goff = bit >> LG_BITMAP_GROUP_NBITS;
Packit 345191
			gp = &bitmap[binfo->levels[i].group_offset + goff];
Packit 345191
			g = *gp;
Packit 345191
			assert(g & (ZU(1) << (bit & BITMAP_GROUP_NBITS_MASK)));
Packit 345191
			g ^= ZU(1) << (bit & BITMAP_GROUP_NBITS_MASK);
Packit 345191
			*gp = g;
Packit 345191
			if (g != 0) {
Packit 345191
				break;
Packit 345191
			}
Packit 345191
		}
Packit 345191
	}
Packit 345191
#endif
Packit 345191
}
Packit 345191
Packit 345191
/* ffu: find first unset >= bit. */
Packit 345191
static inline size_t
Packit 345191
bitmap_ffu(const bitmap_t *bitmap, const bitmap_info_t *binfo, size_t min_bit) {
Packit 345191
	assert(min_bit < binfo->nbits);
Packit 345191
Packit 345191
#ifdef BITMAP_USE_TREE
Packit 345191
	size_t bit = 0;
Packit 345191
	for (unsigned level = binfo->nlevels; level--;) {
Packit 345191
		size_t lg_bits_per_group = (LG_BITMAP_GROUP_NBITS * (level +
Packit 345191
		    1));
Packit 345191
		bitmap_t group = bitmap[binfo->levels[level].group_offset + (bit
Packit 345191
		    >> lg_bits_per_group)];
Packit 345191
		unsigned group_nmask = (unsigned)(((min_bit > bit) ? (min_bit -
Packit 345191
		    bit) : 0) >> (lg_bits_per_group - LG_BITMAP_GROUP_NBITS));
Packit 345191
		assert(group_nmask <= BITMAP_GROUP_NBITS);
Packit 345191
		bitmap_t group_mask = ~((1LU << group_nmask) - 1);
Packit 345191
		bitmap_t group_masked = group & group_mask;
Packit 345191
		if (group_masked == 0LU) {
Packit 345191
			if (group == 0LU) {
Packit 345191
				return binfo->nbits;
Packit 345191
			}
Packit 345191
			/*
Packit 345191
			 * min_bit was preceded by one or more unset bits in
Packit 345191
			 * this group, but there are no other unset bits in this
Packit 345191
			 * group.  Try again starting at the first bit of the
Packit 345191
			 * next sibling.  This will recurse at most once per
Packit 345191
			 * non-root level.
Packit 345191
			 */
Packit 345191
			size_t sib_base = bit + (ZU(1) << lg_bits_per_group);
Packit 345191
			assert(sib_base > min_bit);
Packit 345191
			assert(sib_base > bit);
Packit 345191
			if (sib_base >= binfo->nbits) {
Packit 345191
				return binfo->nbits;
Packit 345191
			}
Packit 345191
			return bitmap_ffu(bitmap, binfo, sib_base);
Packit 345191
		}
Packit 345191
		bit += ((size_t)(ffs_lu(group_masked) - 1)) <<
Packit 345191
		    (lg_bits_per_group - LG_BITMAP_GROUP_NBITS);
Packit 345191
	}
Packit 345191
	assert(bit >= min_bit);
Packit 345191
	assert(bit < binfo->nbits);
Packit 345191
	return bit;
Packit 345191
#else
Packit 345191
	size_t i = min_bit >> LG_BITMAP_GROUP_NBITS;
Packit 345191
	bitmap_t g = bitmap[i] & ~((1LU << (min_bit & BITMAP_GROUP_NBITS_MASK))
Packit 345191
	    - 1);
Packit 345191
	size_t bit;
Packit 345191
	do {
Packit 345191
		bit = ffs_lu(g);
Packit 345191
		if (bit != 0) {
Packit 345191
			return (i << LG_BITMAP_GROUP_NBITS) + (bit - 1);
Packit 345191
		}
Packit 345191
		i++;
Packit 345191
		g = bitmap[i];
Packit 345191
	} while (i < binfo->ngroups);
Packit 345191
	return binfo->nbits;
Packit 345191
#endif
Packit 345191
}
Packit 345191
Packit 345191
/* sfu: set first unset. */
Packit 345191
static inline size_t
Packit 345191
bitmap_sfu(bitmap_t *bitmap, const bitmap_info_t *binfo) {
Packit 345191
	size_t bit;
Packit 345191
	bitmap_t g;
Packit 345191
	unsigned i;
Packit 345191
Packit 345191
	assert(!bitmap_full(bitmap, binfo));
Packit 345191
Packit 345191
#ifdef BITMAP_USE_TREE
Packit 345191
	i = binfo->nlevels - 1;
Packit 345191
	g = bitmap[binfo->levels[i].group_offset];
Packit 345191
	bit = ffs_lu(g) - 1;
Packit 345191
	while (i > 0) {
Packit 345191
		i--;
Packit 345191
		g = bitmap[binfo->levels[i].group_offset + bit];
Packit 345191
		bit = (bit << LG_BITMAP_GROUP_NBITS) + (ffs_lu(g) - 1);
Packit 345191
	}
Packit 345191
#else
Packit 345191
	i = 0;
Packit 345191
	g = bitmap[0];
Packit 345191
	while ((bit = ffs_lu(g)) == 0) {
Packit 345191
		i++;
Packit 345191
		g = bitmap[i];
Packit 345191
	}
Packit 345191
	bit = (i << LG_BITMAP_GROUP_NBITS) + (bit - 1);
Packit 345191
#endif
Packit 345191
	bitmap_set(bitmap, binfo, bit);
Packit 345191
	return bit;
Packit 345191
}
Packit 345191
Packit 345191
static inline void
Packit 345191
bitmap_unset(bitmap_t *bitmap, const bitmap_info_t *binfo, size_t bit) {
Packit 345191
	size_t goff;
Packit 345191
	bitmap_t *gp;
Packit 345191
	bitmap_t g;
Packit 345191
	UNUSED bool propagate;
Packit 345191
Packit 345191
	assert(bit < binfo->nbits);
Packit 345191
	assert(bitmap_get(bitmap, binfo, bit));
Packit 345191
	goff = bit >> LG_BITMAP_GROUP_NBITS;
Packit 345191
	gp = &bitmap[goff];
Packit 345191
	g = *gp;
Packit 345191
	propagate = (g == 0);
Packit 345191
	assert((g & (ZU(1) << (bit & BITMAP_GROUP_NBITS_MASK))) == 0);
Packit 345191
	g ^= ZU(1) << (bit & BITMAP_GROUP_NBITS_MASK);
Packit 345191
	*gp = g;
Packit 345191
	assert(!bitmap_get(bitmap, binfo, bit));
Packit 345191
#ifdef BITMAP_USE_TREE
Packit 345191
	/* Propagate group state transitions up the tree. */
Packit 345191
	if (propagate) {
Packit 345191
		unsigned i;
Packit 345191
		for (i = 1; i < binfo->nlevels; i++) {
Packit 345191
			bit = goff;
Packit 345191
			goff = bit >> LG_BITMAP_GROUP_NBITS;
Packit 345191
			gp = &bitmap[binfo->levels[i].group_offset + goff];
Packit 345191
			g = *gp;
Packit 345191
			propagate = (g == 0);
Packit 345191
			assert((g & (ZU(1) << (bit & BITMAP_GROUP_NBITS_MASK)))
Packit 345191
			    == 0);
Packit 345191
			g ^= ZU(1) << (bit & BITMAP_GROUP_NBITS_MASK);
Packit 345191
			*gp = g;
Packit 345191
			if (!propagate) {
Packit 345191
				break;
Packit 345191
			}
Packit 345191
		}
Packit 345191
	}
Packit 345191
#endif /* BITMAP_USE_TREE */
Packit 345191
}
Packit 345191
Packit 345191
#endif /* JEMALLOC_INTERNAL_BITMAP_H */