]>
git.saurik.com Git - apple/xnu.git/blob - bsd/dev/dtrace/blist.c
2 * BLIST.C - Bitmap allocator/deallocator, using a radix tree with hinting
4 * (c)Copyright 1998, Matthew Dillon. Terms for use and redistribution
5 * are covered by the BSD Copyright as found in /usr/src/COPYRIGHT.
7 * This module implements a general bitmap allocator/deallocator. The
8 * allocator eats around 2 bits per 'block'. The module does not
9 * try to interpret the meaning of a 'block' other then to return
10 * SWAPBLK_NONE on an allocation failure.
12 * A radix tree is used to maintain the bitmap. Two radix constants are
13 * involved: One for the bitmaps contained in the leaf nodes (typically
14 * 32), and one for the meta nodes (typically 16). Both meta and leaf
15 * nodes have a hint field. This field gives us a hint as to the largest
16 * free contiguous range of blocks under the node. It may contain a
17 * value that is too high, but will never contain a value that is too
18 * low. When the radix tree is searched, allocation failures in subtrees
21 * The radix tree also implements two collapsed states for meta nodes:
22 * the ALL-ALLOCATED state and the ALL-FREE state. If a meta node is
23 * in either of these two states, all information contained underneath
24 * the node is considered stale. These states are used to optimize
25 * allocation and freeing operations.
27 * The hinting greatly increases code efficiency for allocations while
28 * the general radix structure optimizes both allocations and frees. The
29 * radix tree should be able to operate well no matter how much
30 * fragmentation there is and no matter how large a bitmap is used.
32 * Unlike the rlist code, the blist code wires all necessary memory at
33 * creation time. Neither allocations nor frees require interaction with
34 * the memory subsystem. In contrast, the rlist code may allocate memory
35 * on an rlist_free() call. The non-blocking features of the blist code
36 * are used to great advantage in the swap code (vm/nswap_pager.c). The
37 * rlist code uses a little less overall memory then the blist code (but
38 * due to swap interleaving not all that much less), but the blist code
39 * scales much, much better.
41 * LAYOUT: The radix tree is layed out recursively using a
42 * linear array. Each meta node is immediately followed (layed out
43 * sequentially in memory) by BLIST_META_RADIX lower level nodes. This
44 * is a recursive structure but one that can be easily scanned through
45 * a very simple 'skip' calculation. In order to support large radixes,
46 * portions of the tree may reside outside our memory allocation. We
47 * handle this with an early-termination optimization (when bighint is
48 * set to -1) on the scan. The memory allocation is only large enough
49 * to cover the number of blocks requested at creation time even if it
50 * must be encompassed in larger root-node radix.
52 * NOTE: the allocator cannot currently allocate more then
53 * BLIST_BMAP_RADIX blocks per call. It will panic with 'allocation too
54 * large' if you try. This is an area that could use improvement. The
55 * radix is large enough that this restriction does not effect the swap
56 * system, though. Currently only the allocation code is effected by
57 * this algorithmic unfeature. The freeing code can handle arbitrary
60 * This code can be compiled stand-alone for debugging.
62 * $FreeBSD: src/sys/kern/subr_blist.c,v 1.5.2.1 2000/03/17 10:47:29 ps Exp $
65 #if !defined(__APPLE__)
68 #include <sys/param.h>
69 #include <sys/systm.h>
71 #include <sys/kernel.h>
72 #include <sys/blist.h>
73 #include <sys/malloc.h>
75 #include <vm/vm_object.h>
76 #include <vm/vm_kern.h>
77 #include <vm/vm_extern.h>
78 #include <vm/vm_page.h>
82 #ifndef BLIST_NO_DEBUG
86 #define SWAPBLK_NONE ((daddr_t)-1)
88 #include <sys/types.h>
94 #define malloc(a,b,c) malloc(a)
95 #define free(a,b) free(a)
97 typedef unsigned int u_daddr_t
;
99 #include <sys/blist.h>
101 void panic(const char *ctl
, ...);
104 #else /* is MacOS X */
107 #define _KERNEL /* Solaris vs. Darwin */
111 typedef unsigned int u_daddr_t
;
113 #include <sys/param.h>
114 #include <sys/systm.h>
115 #include <sys/lock.h>
116 #include <sys/kernel.h>
117 /* #include <sys/blist.h> */
119 #include <sys/malloc.h>
121 #define SWAPBLK_NONE ((daddr_t)-1)
122 #define malloc _MALLOC
124 #define M_SWAP M_TEMP
126 #endif /* __APPLE__ */
129 * static support functions
132 static daddr_t
blst_leaf_alloc(blmeta_t
*scan
, daddr_t blk
, int count
);
133 static daddr_t
blst_meta_alloc(blmeta_t
*scan
, daddr_t blk
,
134 daddr_t count
, daddr_t radix
, int skip
);
135 static void blst_leaf_free(blmeta_t
*scan
, daddr_t relblk
, int count
);
136 static void blst_meta_free(blmeta_t
*scan
, daddr_t freeBlk
, daddr_t count
,
137 daddr_t radix
, int skip
, daddr_t blk
);
138 static void blst_copy(blmeta_t
*scan
, daddr_t blk
, daddr_t radix
,
139 daddr_t skip
, blist_t dest
, daddr_t count
);
140 static daddr_t
blst_radix_init(blmeta_t
*scan
, daddr_t radix
,
141 int skip
, daddr_t count
);
143 static void blst_radix_print(blmeta_t
*scan
, daddr_t blk
,
144 daddr_t radix
, int skip
, int tab
);
148 static MALLOC_DEFINE(M_SWAP
, "SWAP", "Swap space");
152 * blist_create() - create a blist capable of handling up to the specified
155 * blocks must be greater then 0
157 * The smallest blist consists of a single leaf node capable of
158 * managing BLIST_BMAP_RADIX blocks.
162 blist_create(daddr_t blocks
)
169 * Calculate radix and skip field used for scanning.
171 radix
= BLIST_BMAP_RADIX
;
173 while (radix
< blocks
) {
174 radix
<<= BLIST_META_RADIX_SHIFT
;
175 skip
= (skip
+ 1) << BLIST_META_RADIX_SHIFT
;
178 bl
= malloc(sizeof(struct blist
), M_SWAP
, M_WAITOK
);
180 bzero(bl
, sizeof(*bl
));
182 bl
->bl_blocks
= blocks
;
183 bl
->bl_radix
= radix
;
185 bl
->bl_rootblks
= 1 +
186 blst_radix_init(NULL
, bl
->bl_radix
, bl
->bl_skip
, blocks
);
187 bl
->bl_root
= malloc(sizeof(blmeta_t
) * bl
->bl_rootblks
, M_SWAP
, M_WAITOK
);
189 #if defined(BLIST_DEBUG)
191 "BLIST representing %d blocks (%d MB of swap)"
192 ", requiring %dK of ram\n",
194 bl
->bl_blocks
* 4 / 1024,
195 (bl
->bl_rootblks
* sizeof(blmeta_t
) + 1023) / 1024
197 printf("BLIST raw radix tree contains %d records\n", bl
->bl_rootblks
);
199 blst_radix_init(bl
->bl_root
, bl
->bl_radix
, bl
->bl_skip
, blocks
);
205 blist_destroy(blist_t bl
)
207 free(bl
->bl_root
, M_SWAP
);
212 * blist_alloc() - reserve space in the block bitmap. Return the base
213 * of a contiguous region or SWAPBLK_NONE if space could
218 blist_alloc(blist_t bl
, daddr_t count
)
220 daddr_t blk
= SWAPBLK_NONE
;
223 if (bl
->bl_radix
== BLIST_BMAP_RADIX
)
224 blk
= blst_leaf_alloc(bl
->bl_root
, 0, count
);
226 blk
= blst_meta_alloc(bl
->bl_root
, 0, count
,
227 bl
->bl_radix
, bl
->bl_skip
);
228 if (blk
!= SWAPBLK_NONE
)
229 bl
->bl_free
-= count
;
235 * blist_free() - free up space in the block bitmap. Return the base
236 * of a contiguous region. Panic if an inconsistancy is
241 blist_free(blist_t bl
, daddr_t blkno
, daddr_t count
)
244 if (bl
->bl_radix
== BLIST_BMAP_RADIX
)
245 blst_leaf_free(bl
->bl_root
, blkno
, count
);
247 blst_meta_free(bl
->bl_root
, blkno
, count
,
248 bl
->bl_radix
, bl
->bl_skip
, 0);
249 bl
->bl_free
+= count
;
254 * blist_resize() - resize an existing radix tree to handle the
255 * specified number of blocks. This will reallocate
256 * the tree and transfer the previous bitmap to the new
257 * one. When extending the tree you can specify whether
258 * the new blocks are to left allocated or freed.
262 blist_resize(blist_t
*pbl
, daddr_t count
, int freenew
)
264 blist_t newbl
= blist_create(count
);
268 if (count
> save
->bl_blocks
)
269 count
= save
->bl_blocks
;
270 blst_copy(save
->bl_root
, 0, save
->bl_radix
, save
->bl_skip
, newbl
, count
);
273 * If resizing upwards, should we free the new space or not?
275 if (freenew
&& count
< newbl
->bl_blocks
)
276 blist_free(newbl
, count
, newbl
->bl_blocks
- count
);
283 * blist_print() - dump radix tree
287 blist_print(blist_t bl
)
290 blst_radix_print(bl
->bl_root
, 0, bl
->bl_radix
, bl
->bl_skip
, 4);
296 /************************************************************************
297 * ALLOCATION SUPPORT FUNCTIONS *
298 ************************************************************************
300 * These support functions do all the actual work. They may seem
301 * rather longish, but that's because I've commented them up. The
302 * actual code is straight forward.
307 * blist_leaf_alloc() - allocate at a leaf in the radix tree (a bitmap).
309 * This is the core of the allocator and is optimized for the 1 block
310 * and the BLIST_BMAP_RADIX block allocation cases. Other cases are
311 * somewhat slower. The 1 block allocation case is log2 and extremely
316 blst_leaf_alloc(blmeta_t
*scan
, daddr_t blk
, int count
)
318 u_daddr_t orig
= scan
->u
.bmu_bitmap
;
322 * Optimize bitmap all-allocated case. Also, count = 1
323 * case assumes at least 1 bit is free in the bitmap, so
324 * we have to take care of this case here.
326 scan
->bm_bighint
= 0;
327 return(SWAPBLK_NONE
);
331 * Optimized code to allocate one bit out of the bitmap
334 int j
= BLIST_BMAP_RADIX
/2;
337 mask
= (u_daddr_t
)-1 >> (BLIST_BMAP_RADIX
/2);
340 if ((orig
& mask
) == 0) {
347 scan
->u
.bmu_bitmap
&= ~(1 << r
);
350 if (count
<= BLIST_BMAP_RADIX
) {
352 * non-optimized code to allocate N bits out of the bitmap.
353 * The more bits, the faster the code runs. It will run
354 * the slowest allocating 2 bits, but since there aren't any
355 * memory ops in the core loop (or shouldn't be, anyway),
356 * you probably won't notice the difference.
359 int n
= BLIST_BMAP_RADIX
- count
;
362 mask
= (u_daddr_t
)-1 >> n
;
364 for (j
= 0; j
<= n
; ++j
) {
365 if ((orig
& mask
) == mask
) {
366 scan
->u
.bmu_bitmap
&= ~mask
;
373 * We couldn't allocate count in this subtree, update bighint.
375 scan
->bm_bighint
= count
- 1;
376 return(SWAPBLK_NONE
);
380 * blist_meta_alloc() - allocate at a meta in the radix tree.
382 * Attempt to allocate at a meta node. If we can't, we update
383 * bighint and return a failure. Updating bighint optimize future
384 * calls that hit this node. We have to check for our collapse cases
385 * and we have a few optimizations strewn in as well.
389 blst_meta_alloc(blmeta_t
*scan
, daddr_t blk
, daddr_t count
, daddr_t radix
,
393 int next_skip
= (skip
>> BLIST_META_RADIX_SHIFT
);
395 if (scan
->u
.bmu_avail
== 0) {
397 * ALL-ALLOCATED special case
399 scan
->bm_bighint
= count
;
400 return(SWAPBLK_NONE
);
403 if (scan
->u
.bmu_avail
== radix
) {
404 radix
>>= BLIST_META_RADIX_SHIFT
;
407 * ALL-FREE special case, initialize uninitialize
410 for (i
= 1; i
<= skip
; i
+= next_skip
) {
411 if (scan
[i
].bm_bighint
== (daddr_t
)-1)
413 if (next_skip
== 1) {
414 scan
[i
].u
.bmu_bitmap
= (u_daddr_t
)-1;
415 scan
[i
].bm_bighint
= BLIST_BMAP_RADIX
;
417 scan
[i
].bm_bighint
= radix
;
418 scan
[i
].u
.bmu_avail
= radix
;
422 radix
>>= BLIST_META_RADIX_SHIFT
;
425 for (i
= 1; i
<= skip
; i
+= next_skip
) {
426 if (count
<= scan
[i
].bm_bighint
) {
428 * count fits in object
432 r
= blst_leaf_alloc(&scan
[i
], blk
, count
);
434 r
= blst_meta_alloc(&scan
[i
], blk
, count
,
435 radix
, next_skip
- 1);
436 if (r
!= SWAPBLK_NONE
) {
437 scan
->u
.bmu_avail
-= count
;
438 if (scan
->bm_bighint
> scan
->u
.bmu_avail
)
439 scan
->bm_bighint
= scan
->u
.bmu_avail
;
442 } else if (scan
[i
].bm_bighint
== (daddr_t
)-1) {
447 } else if (count
> radix
) {
449 * count does not fit in object even if it were
452 panic("blist_meta_alloc: allocation too large");
458 * We couldn't allocate count in this subtree, update bighint.
460 if (scan
->bm_bighint
>= count
)
461 scan
->bm_bighint
= count
- 1;
462 return(SWAPBLK_NONE
);
466 * BLST_LEAF_FREE() - free allocated block from leaf bitmap
471 blst_leaf_free(blmeta_t
*scan
, daddr_t blk
, int count
)
474 * free some data in this bitmap
477 * 0000111111111110000
481 int n
= blk
& (BLIST_BMAP_RADIX
- 1);
484 mask
= ((u_daddr_t
)-1 << n
) &
485 ((u_daddr_t
)-1 >> (BLIST_BMAP_RADIX
- count
- n
));
487 if (scan
->u
.bmu_bitmap
& mask
)
488 panic("blst_radix_free: freeing free block");
489 scan
->u
.bmu_bitmap
|= mask
;
492 * We could probably do a better job here. We are required to make
493 * bighint at least as large as the biggest contiguous block of
494 * data. If we just shoehorn it, a little extra overhead will
495 * be incured on the next allocation (but only that one typically).
497 scan
->bm_bighint
= BLIST_BMAP_RADIX
;
501 * BLST_META_FREE() - free allocated blocks from radix tree meta info
503 * This support routine frees a range of blocks from the bitmap.
504 * The range must be entirely enclosed by this radix node. If a
505 * meta node, we break the range down recursively to free blocks
506 * in subnodes (which means that this code can free an arbitrary
507 * range whereas the allocation code cannot allocate an arbitrary
512 blst_meta_free(blmeta_t
*scan
, daddr_t freeBlk
, daddr_t count
, daddr_t radix
,
513 int skip
, daddr_t blk
)
516 int next_skip
= (skip
>> BLIST_META_RADIX_SHIFT
);
519 printf("FREE (%x,%d) FROM (%x,%d)\n",
525 if (scan
->u
.bmu_avail
== 0) {
527 * ALL-ALLOCATED special case, with possible
528 * shortcut to ALL-FREE special case.
530 scan
->u
.bmu_avail
= count
;
531 scan
->bm_bighint
= count
;
533 if (count
!= radix
) {
534 for (i
= 1; i
<= skip
; i
+= next_skip
) {
535 if (scan
[i
].bm_bighint
== (daddr_t
)-1)
537 scan
[i
].bm_bighint
= 0;
539 scan
[i
].u
.bmu_bitmap
= 0;
541 scan
[i
].u
.bmu_avail
= 0;
546 scan
->u
.bmu_avail
+= count
;
547 /* scan->bm_bighint = radix; */
551 * ALL-FREE special case.
554 if (scan
->u
.bmu_avail
== radix
)
556 if (scan
->u
.bmu_avail
> radix
)
557 panic("blst_meta_free: freeing already free blocks (%d) %d/%d", count
, scan
->u
.bmu_avail
, radix
);
560 * Break the free down into its components
563 radix
>>= BLIST_META_RADIX_SHIFT
;
565 i
= (freeBlk
- blk
) / radix
;
567 i
= i
* next_skip
+ 1;
569 while (i
<= skip
&& blk
< freeBlk
+ count
) {
572 v
= blk
+ radix
- freeBlk
;
576 if (scan
->bm_bighint
== (daddr_t
)-1)
577 panic("blst_meta_free: freeing unexpected range");
580 blst_leaf_free(&scan
[i
], freeBlk
, v
);
582 blst_meta_free(&scan
[i
], freeBlk
, v
, radix
,
584 if (scan
->bm_bighint
< scan
[i
].bm_bighint
)
585 scan
->bm_bighint
= scan
[i
].bm_bighint
;
594 * BLIST_RADIX_COPY() - copy one radix tree to another
596 * Locates free space in the source tree and frees it in the destination
597 * tree. The space may not already be free in the destination.
600 static void blst_copy(blmeta_t
*scan
, daddr_t blk
, daddr_t radix
,
601 daddr_t skip
, blist_t dest
, daddr_t count
)
610 if (radix
== BLIST_BMAP_RADIX
) {
611 u_daddr_t v
= scan
->u
.bmu_bitmap
;
613 if (v
== (u_daddr_t
)-1) {
614 blist_free(dest
, blk
, count
);
618 for (i
= 0; i
< BLIST_BMAP_RADIX
&& i
< count
; ++i
)
620 blist_free(dest
, blk
+ i
, 1);
630 * Source all allocated, leave dest allocated
632 if (scan
->u
.bmu_avail
== 0)
634 if (scan
->u
.bmu_avail
== radix
) {
636 * Source all free, free entire dest
639 blist_free(dest
, blk
, count
);
641 blist_free(dest
, blk
, radix
);
645 radix
>>= BLIST_META_RADIX_SHIFT
;
646 next_skip
= (skip
>> BLIST_META_RADIX_SHIFT
);
648 for (i
= 1; count
&& i
<= skip
; i
+= next_skip
) {
649 if (scan
[i
].bm_bighint
== (daddr_t
)-1)
652 if (count
>= radix
) {
680 * BLST_RADIX_INIT() - initialize radix tree
682 * Initialize our meta structures and bitmaps and calculate the exact
683 * amount of space required to manage 'count' blocks - this space may
684 * be considerably less then the calculated radix due to the large
685 * RADIX values we use.
689 blst_radix_init(blmeta_t
*scan
, daddr_t radix
, int skip
, daddr_t count
)
693 daddr_t memindex
= 0;
699 if (radix
== BLIST_BMAP_RADIX
) {
701 scan
->bm_bighint
= 0;
702 scan
->u
.bmu_bitmap
= 0;
708 * Meta node. If allocating the entire object we can special
709 * case it. However, we need to figure out how much memory
710 * is required to manage 'count' blocks, so we continue on anyway.
714 scan
->bm_bighint
= 0;
715 scan
->u
.bmu_avail
= 0;
718 radix
>>= BLIST_META_RADIX_SHIFT
;
719 next_skip
= (skip
>> BLIST_META_RADIX_SHIFT
);
721 for (i
= 1; i
<= skip
; i
+= next_skip
) {
722 if (count
>= radix
) {
724 * Allocate the entire object
726 memindex
= i
+ blst_radix_init(
727 ((scan
) ? &scan
[i
] : NULL
),
733 } else if (count
> 0) {
735 * Allocate a partial object
737 memindex
= i
+ blst_radix_init(
738 ((scan
) ? &scan
[i
] : NULL
),
746 * Add terminator and break out
749 scan
[i
].bm_bighint
= (daddr_t
)-1;
761 blst_radix_print(blmeta_t
*scan
, daddr_t blk
, daddr_t radix
, int skip
, int tab
)
767 if (radix
== BLIST_BMAP_RADIX
) {
769 "%*.*s(%04x,%d): bitmap %08x big=%d\n",
778 if (scan
->u
.bmu_avail
== 0) {
780 "%*.*s(%04x,%d) ALL ALLOCATED\n",
787 if (scan
->u
.bmu_avail
== radix
) {
789 "%*.*s(%04x,%d) ALL FREE\n",
798 "%*.*s(%04x,%d): subtree (%d/%d) big=%d {\n",
806 radix
>>= BLIST_META_RADIX_SHIFT
;
807 next_skip
= (skip
>> BLIST_META_RADIX_SHIFT
);
810 for (i
= 1; i
<= skip
; i
+= next_skip
) {
811 if (scan
[i
].bm_bighint
== (daddr_t
)-1) {
813 "%*.*s(%04x,%d): Terminator\n",
842 main(int ac
, char **av
)
848 for (i
= 1; i
< ac
; ++i
) {
849 const char *ptr
= av
[i
];
851 size
= strtol(ptr
, NULL
, 0);
855 fprintf(stderr
, "Bad option: %s\n", ptr
- 2);
858 bl
= blist_create(size
);
859 blist_free(bl
, 0, size
);
867 printf("%d/%d/%d> ", bl
->bl_free
, size
, bl
->bl_radix
);
869 if (fgets(buf
, sizeof(buf
), stdin
) == NULL
)
873 if (sscanf(buf
+ 1, "%d", &count
) == 1) {
874 blist_resize(&bl
, count
, 1);
882 if (sscanf(buf
+ 1, "%d", &count
) == 1) {
883 daddr_t blk
= blist_alloc(bl
, count
);
884 printf(" R=%04x\n", blk
);
890 if (sscanf(buf
+ 1, "%x %d", &da
, &count
) == 2) {
891 blist_free(bl
, da
, count
);
915 panic(const char *ctl
, ...)
920 vfprintf(stderr
, ctl
, va
);
921 fprintf(stderr
, "\n");