/usr/share/doc/libbitmask-dev/README is in libbitmask-dev 2.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | Bitmasks provide multi-word bit masks and operations thereon to
do such things as set and clear bits, intersect and union masks,
query bits, and display and parse masks.
The initial intended use for these bitmasks is to represent sets
of CPUs and Memory Nodes, when configuring large SMP and NUMA
systems. However there is little in the semantics of bitmasks
that is specific to this particular use, and bitmasks should be
usable for other purposes that had similar design requirements.
These bitmasks share the same underlying layout as the bitmasks
used by the Linux kernel to represent sets of CPUs and Memory
Nodes. Unlike the kernel bitmasks, these bitmasks use dynamically
allocated memory and are manipulated via a pointer. This enables
a program to work correctly on systems with various numbers of
CPUs and Nodes, without recompilation.
There is a related cpuset library which uses the bitmask
type provided here to represent sets of CPUs and Memory
Nodes. The internal representation (as an array of unsigned
longs, in little endian order) is directly compatible with the
'sched_setaffinity(2)' and 'sched_getaffinity(2)' system calls
(added in Linux 2.6).
|