[util] Add util allocator.h interface

The allocator is a interface for types that expose allocator functions
for use in container templates like node_map (usage coming soon).

Also added an implementation for the kernel heap allocator.

src/kernel/heap_allocator.cpp

@@ -102,6 +102,30 @@ heap_allocator::free(void *p)
     register_free_block(block, block->order);
 }
 
+void *
+heap_allocator::reallocate(void *p, size_t old_length, size_t new_length)
+{
+    if (!p) {
+        kassert(old_length == 0,
+            "Attempt to reallocate from null with non-zero old_length");
+        return allocate(new_length);
+    }
+
+    block_info *info = m_map.find(map_key(p));
+    kassert(info, "Attempt to reallocate unknown block");
+    if (!info)
+        return nullptr;
+
+    if (new_length <= (1 << info->order))
+        return p;
+
+    void *new_block = allocate(new_length);
+    memcpy(new_block, p, old_length);
+    free(p);
+
+    return new_block;
+}
+
 heap_allocator::free_header *
 heap_allocator::pop_free(unsigned order)
 {

src/kernel/heap_allocator.h

@@ -30,6 +30,10 @@ public:
     /// \arg p  A pointer previously retuned by allocate()
     void free(void *p);
 
+    /// Grow the given allocation if possible, or return a new
+    /// allocation with the contents copied over.
+    void * reallocate(void *p, size_t old_length, size_t new_length);
+
     /// Minimum block size is (2^min_order). Must be at least 6.
     static const unsigned min_order = 6;  // 2^6  == 64 B
 
@@ -102,3 +106,15 @@ protected:
 
     heap_allocator(const heap_allocator &) = delete;
 };
+
+extern heap_allocator &g_kernel_heap;
+
+/// A class implementing util's allocator interface using the kernel heap
+struct heap_allocated
+{
+    inline static void * allocate(size_t size) { return g_kernel_heap.allocate(size); }
+    inline static void free(void *p) { g_kernel_heap.free(p); }
+    inline static void * realloc(void *p, size_t oldsize, size_t newsize) {
+        return g_kernel_heap.reallocate(p, oldsize, newsize);
+    }
+};