---
name: "__bitmap_parse"
section: "9"
platform: "linux"
package: "linux-manual-4.9"
version: "4.9.228-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/__bitmap_parse"
---

# \_\_bitmap\_parse(9)

convert an ASCII hex string into a bitmap.

## NAME

\_\_bitmap\_parse - convert an ASCII hex string into a bitmap.

## SYNOPSIS

**int \_\_bitmap\_parse(const char \*** *buf***, unsigned int** *buflen***, int** *is\_user***, unsigned long \*** *maskp***, int** *nmaskbits***);**

## ARGUMENTS

*buf*

pointer to buffer containing string.

*buflen*

buffer size in bytes. If string is smaller than this then it must be terminated with a \\0.

*is\_user*

location of buffer, 0 indicates kernel space

*maskp*

pointer to bitmap array that will contain result.

*nmaskbits*

size of bitmap, in bits.

## DESCRIPTION

Commas group hex digits into chunks. Each chunk defines exactly 32 bits of the resultant bitmask. No chunk may specify a value larger than 32 bits (**-EOVERFLOW**), and if a chunk specifies a smaller value then leading 0-bits are prepended. **-EINVAL** is returned for illegal characters and for grouping errors such as “1,,5”, “,44”, “,” and "". Leading and trailing whitespace accepted, but not embedded whitespace.

## COPYRIGHT