292 lines
		
	
	
	
		
			7.3 KiB
			
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			292 lines
		
	
	
	
		
			7.3 KiB
			
		
	
	
	
		
			C
		
	
	
	
	
	
| #include <stdio.h>
 | |
| #include <stdlib.h>
 | |
| #include <string.h>
 | |
| 
 | |
| #include <helpers/bitmask.h>
 | |
| 
 | |
| /* How many bits in an unsigned long */
 | |
| #define bitsperlong (8 * sizeof(unsigned long))
 | |
| 
 | |
| /* howmany(a,b) : how many elements of size b needed to hold all of a */
 | |
| #define howmany(x, y) (((x)+((y)-1))/(y))
 | |
| 
 | |
| /* How many longs in mask of n bits */
 | |
| #define longsperbits(n) howmany(n, bitsperlong)
 | |
| 
 | |
| #define max(a, b) ((a) > (b) ? (a) : (b))
 | |
| 
 | |
| /*
 | |
|  * Allocate and free `struct bitmask *`
 | |
|  */
 | |
| 
 | |
| /* Allocate a new `struct bitmask` with a size of n bits */
 | |
| struct bitmask *bitmask_alloc(unsigned int n)
 | |
| {
 | |
| 	struct bitmask *bmp;
 | |
| 
 | |
| 	bmp = malloc(sizeof(*bmp));
 | |
| 	if (bmp == 0)
 | |
| 		return 0;
 | |
| 	bmp->size = n;
 | |
| 	bmp->maskp = calloc(longsperbits(n), sizeof(unsigned long));
 | |
| 	if (bmp->maskp == 0) {
 | |
| 		free(bmp);
 | |
| 		return 0;
 | |
| 	}
 | |
| 	return bmp;
 | |
| }
 | |
| 
 | |
| /* Free `struct bitmask` */
 | |
| void bitmask_free(struct bitmask *bmp)
 | |
| {
 | |
| 	if (bmp == 0)
 | |
| 		return;
 | |
| 	free(bmp->maskp);
 | |
| 	bmp->maskp = (unsigned long *)0xdeadcdef;  /* double free tripwire */
 | |
| 	free(bmp);
 | |
| }
 | |
| 
 | |
| /*
 | |
|  * The routines _getbit() and _setbit() are the only
 | |
|  * routines that actually understand the layout of bmp->maskp[].
 | |
|  *
 | |
|  * On little endian architectures, this could simply be an array of
 | |
|  * bytes.  But the kernel layout of bitmasks _is_ visible to userspace
 | |
|  * via the sched_(set/get)affinity calls in Linux 2.6, and on big
 | |
|  * endian architectures, it is painfully obvious that this is an
 | |
|  * array of unsigned longs.
 | |
|  */
 | |
| 
 | |
| /* Return the value (0 or 1) of bit n in bitmask bmp */
 | |
| static unsigned int _getbit(const struct bitmask *bmp, unsigned int n)
 | |
| {
 | |
| 	if (n < bmp->size)
 | |
| 		return (bmp->maskp[n/bitsperlong] >> (n % bitsperlong)) & 1;
 | |
| 	else
 | |
| 		return 0;
 | |
| }
 | |
| 
 | |
| /* Set bit n in bitmask bmp to value v (0 or 1) */
 | |
| static void _setbit(struct bitmask *bmp, unsigned int n, unsigned int v)
 | |
| {
 | |
| 	if (n < bmp->size) {
 | |
| 		if (v)
 | |
| 			bmp->maskp[n/bitsperlong] |= 1UL << (n % bitsperlong);
 | |
| 		else
 | |
| 			bmp->maskp[n/bitsperlong] &=
 | |
| 				~(1UL << (n % bitsperlong));
 | |
| 	}
 | |
| }
 | |
| 
 | |
| /*
 | |
|  * When parsing bitmask lists, only allow numbers, separated by one
 | |
|  * of the allowed next characters.
 | |
|  *
 | |
|  * The parameter 'sret' is the return from a sscanf "%u%c".  It is
 | |
|  * -1 if the sscanf input string was empty.  It is 0 if the first
 | |
|  * character in the sscanf input string was not a decimal number.
 | |
|  * It is 1 if the unsigned number matching the "%u" was the end of the
 | |
|  * input string.  It is 2 if one or more additional characters followed
 | |
|  * the matched unsigned number.  If it is 2, then 'nextc' is the first
 | |
|  * character following the number.  The parameter 'ok_next_chars'
 | |
|  * is the nul-terminated list of allowed next characters.
 | |
|  *
 | |
|  * The mask term just scanned was ok if and only if either the numbers
 | |
|  * matching the %u were all of the input or if the next character in
 | |
|  * the input past the numbers was one of the allowed next characters.
 | |
|  */
 | |
| static int scan_was_ok(int sret, char nextc, const char *ok_next_chars)
 | |
| {
 | |
| 	return sret == 1 ||
 | |
| 		(sret == 2 && strchr(ok_next_chars, nextc) != NULL);
 | |
| }
 | |
| 
 | |
| static const char *nexttoken(const char *q,  int sep)
 | |
| {
 | |
| 	if (q)
 | |
| 		q = strchr(q, sep);
 | |
| 	if (q)
 | |
| 		q++;
 | |
| 	return q;
 | |
| }
 | |
| 
 | |
| /* Set a single bit i in bitmask */
 | |
| struct bitmask *bitmask_setbit(struct bitmask *bmp, unsigned int i)
 | |
| {
 | |
| 	_setbit(bmp, i, 1);
 | |
| 	return bmp;
 | |
| }
 | |
| 
 | |
| /* Set all bits in bitmask: bmp = ~0 */
 | |
| struct bitmask *bitmask_setall(struct bitmask *bmp)
 | |
| {
 | |
| 	unsigned int i;
 | |
| 	for (i = 0; i < bmp->size; i++)
 | |
| 		_setbit(bmp, i, 1);
 | |
| 	return bmp;
 | |
| }
 | |
| 
 | |
| /* Clear all bits in bitmask: bmp = 0 */
 | |
| struct bitmask *bitmask_clearall(struct bitmask *bmp)
 | |
| {
 | |
| 	unsigned int i;
 | |
| 	for (i = 0; i < bmp->size; i++)
 | |
| 		_setbit(bmp, i, 0);
 | |
| 	return bmp;
 | |
| }
 | |
| 
 | |
| /* True if all bits are clear */
 | |
| int bitmask_isallclear(const struct bitmask *bmp)
 | |
| {
 | |
| 	unsigned int i;
 | |
| 	for (i = 0; i < bmp->size; i++)
 | |
| 		if (_getbit(bmp, i))
 | |
| 			return 0;
 | |
| 	return 1;
 | |
| }
 | |
| 
 | |
| /* True if specified bit i is set */
 | |
| int bitmask_isbitset(const struct bitmask *bmp, unsigned int i)
 | |
| {
 | |
| 	return _getbit(bmp, i);
 | |
| }
 | |
| 
 | |
| /* Number of lowest set bit (min) */
 | |
| unsigned int bitmask_first(const struct bitmask *bmp)
 | |
| {
 | |
| 	return bitmask_next(bmp, 0);
 | |
| }
 | |
| 
 | |
| /* Number of highest set bit (max) */
 | |
| unsigned int bitmask_last(const struct bitmask *bmp)
 | |
| {
 | |
| 	unsigned int i;
 | |
| 	unsigned int m = bmp->size;
 | |
| 	for (i = 0; i < bmp->size; i++)
 | |
| 		if (_getbit(bmp, i))
 | |
| 			m = i;
 | |
| 	return m;
 | |
| }
 | |
| 
 | |
| /* Number of next set bit at or above given bit i */
 | |
| unsigned int bitmask_next(const struct bitmask *bmp, unsigned int i)
 | |
| {
 | |
| 	unsigned int n;
 | |
| 	for (n = i; n < bmp->size; n++)
 | |
| 		if (_getbit(bmp, n))
 | |
| 			break;
 | |
| 	return n;
 | |
| }
 | |
| 
 | |
| /*
 | |
|  * Parses a comma-separated list of numbers and ranges of numbers,
 | |
|  * with optional ':%u' strides modifying ranges, into provided bitmask.
 | |
|  * Some examples of input lists and their equivalent simple list:
 | |
|  *	Input		Equivalent to
 | |
|  *	0-3		0,1,2,3
 | |
|  *	0-7:2		0,2,4,6
 | |
|  *	1,3,5-7		1,3,5,6,7
 | |
|  *	0-3:2,8-15:4	0,2,8,12
 | |
|  */
 | |
| int bitmask_parselist(const char *buf, struct bitmask *bmp)
 | |
| {
 | |
| 	const char *p, *q;
 | |
| 
 | |
| 	bitmask_clearall(bmp);
 | |
| 
 | |
| 	q = buf;
 | |
| 	while (p = q, q = nexttoken(q, ','), p) {
 | |
| 		unsigned int a;		/* begin of range */
 | |
| 		unsigned int b;		/* end of range */
 | |
| 		unsigned int s;		/* stride */
 | |
| 		const char *c1, *c2;	/* next tokens after '-' or ',' */
 | |
| 		char nextc;		/* char after sscanf %u match */
 | |
| 		int sret;		/* sscanf return (number of matches) */
 | |
| 
 | |
| 		sret = sscanf(p, "%u%c", &a, &nextc);
 | |
| 		if (!scan_was_ok(sret, nextc, ",-"))
 | |
| 			goto err;
 | |
| 		b = a;
 | |
| 		s = 1;
 | |
| 		c1 = nexttoken(p, '-');
 | |
| 		c2 = nexttoken(p, ',');
 | |
| 		if (c1 != NULL && (c2 == NULL || c1 < c2)) {
 | |
| 			sret = sscanf(c1, "%u%c", &b, &nextc);
 | |
| 			if (!scan_was_ok(sret, nextc, ",:"))
 | |
| 				goto err;
 | |
| 			c1 = nexttoken(c1, ':');
 | |
| 			if (c1 != NULL && (c2 == NULL || c1 < c2)) {
 | |
| 				sret = sscanf(c1, "%u%c", &s, &nextc);
 | |
| 				if (!scan_was_ok(sret, nextc, ","))
 | |
| 					goto err;
 | |
| 			}
 | |
| 		}
 | |
| 		if (!(a <= b))
 | |
| 			goto err;
 | |
| 		if (b >= bmp->size)
 | |
| 			goto err;
 | |
| 		while (a <= b) {
 | |
| 			_setbit(bmp, a, 1);
 | |
| 			a += s;
 | |
| 		}
 | |
| 	}
 | |
| 	return 0;
 | |
| err:
 | |
| 	bitmask_clearall(bmp);
 | |
| 	return -1;
 | |
| }
 | |
| 
 | |
| /*
 | |
|  * emit(buf, buflen, rbot, rtop, len)
 | |
|  *
 | |
|  * Helper routine for bitmask_displaylist().  Write decimal number
 | |
|  * or range to buf+len, suppressing output past buf+buflen, with optional
 | |
|  * comma-prefix.  Return len of what would be written to buf, if it
 | |
|  * all fit.
 | |
|  */
 | |
| 
 | |
| static inline int emit(char *buf, int buflen, int rbot, int rtop, int len)
 | |
| {
 | |
| 	if (len > 0)
 | |
| 		len += snprintf(buf + len, max(buflen - len, 0), ",");
 | |
| 	if (rbot == rtop)
 | |
| 		len += snprintf(buf + len, max(buflen - len, 0), "%d", rbot);
 | |
| 	else
 | |
| 		len += snprintf(buf + len, max(buflen - len, 0), "%d-%d",
 | |
| 				rbot, rtop);
 | |
| 	return len;
 | |
| }
 | |
| 
 | |
| /*
 | |
|  * Write decimal list representation of bmp to buf.
 | |
|  *
 | |
|  * Output format is a comma-separated list of decimal numbers and
 | |
|  * ranges.  Consecutively set bits are shown as two hyphen-separated
 | |
|  * decimal numbers, the smallest and largest bit numbers set in
 | |
|  * the range.  Output format is compatible with the format
 | |
|  * accepted as input by bitmap_parselist().
 | |
|  *
 | |
|  * The return value is the number of characters which would be
 | |
|  * generated for the given input, excluding the trailing '\0', as
 | |
|  * per ISO C99.
 | |
|  */
 | |
| 
 | |
| int bitmask_displaylist(char *buf, int buflen, const struct bitmask *bmp)
 | |
| {
 | |
| 	int len = 0;
 | |
| 	/* current bit is 'cur', most recently seen range is [rbot, rtop] */
 | |
| 	unsigned int cur, rbot, rtop;
 | |
| 
 | |
| 	if (buflen > 0)
 | |
| 		*buf = 0;
 | |
| 	rbot = cur = bitmask_first(bmp);
 | |
| 	while (cur < bmp->size) {
 | |
| 		rtop = cur;
 | |
| 		cur = bitmask_next(bmp, cur+1);
 | |
| 		if (cur >= bmp->size || cur > rtop + 1) {
 | |
| 			len = emit(buf, buflen, rbot, rtop, len);
 | |
| 			rbot = cur;
 | |
| 		}
 | |
| 	}
 | |
| 	return len;
 | |
| }
 | 
