1 files changed, 12 insertions, 0 deletions
diff --git a/magic_buddy/magic_buddy.h b/magic_buddy/magic_buddy.h
index a25ceb7..167397b 100644
--- a/magic_buddy/magic_buddy.h
+++ b/magic_buddy/magic_buddy.h
@@ -1,4 +1,5 @@
 #pragma once
+
 #include <stdint.h>
 #include <stddef.h>
 
@@ -12,35 +13,44 @@ struct buddy {
     void *base;
 };
 
+// Note: O(1) below means linear in the number of address bits.
+
 // Initialize a buddy with (constant) global state stored in @state.
 // NOTE: after initializing the buddy, you should always pass the exact same
 // pointer in for @state in future calls. If you need to move @state, use
 // move_buddy(...).
+// O(1)
 void init_buddy(uint8_t *base, size_t size, uint8_t magic[MAGIC_COOKIE_BYTES],
                 struct buddy *state);
 
 // Allocate a block of size >= @size
+// O(1)
 void *allocate(size_t size, struct buddy *state);
 
 // Liberate a block of size @size starting at @base.
+// O(1)
 void  liberate(void *base, size_t size, struct buddy *state);
 
 // Print debug information for the allocator.
+// O(N) where N is number of liberated items
 void debug_buddy(struct buddy *state);
 
 // Simulates @new = allocate, memcpy(@new, @old), free(@old), with some
 // optimizations for cases where the reallocation can be done in place.
+// O(1)
 void *reallocate(void *old, size_t new_size, size_t old_size,
                  struct buddy *state);
 
 // Attempts to reserve a range [@start,@start+@size).
 // Returns 1 if success, 0 otherwise.
 // Whenever possible, we avoid writing anything into the reserved region.
+// O(1)
 int reserve(void *start, size_t size, struct buddy *state);
 
 // Update @state to assume the memory pool has been copied to
 // [@new_base,@new_base+@new_size)
 // Can *ONLY* be used when @new_size >= the existing size.
+// O(1)
 void grow_buddy(uint8_t *new_base, size_t new_size, struct buddy *state);
 
 // Update @state to only use the subset of the pool in range
@@ -49,7 +59,9 @@ void grow_buddy(uint8_t *new_base, size_t new_size, struct buddy *state);
 // This *CAN* write to anything in the old pool.
 // This *CAN* fail, in which case everything is unmodified and 0 is returned.
 // Upon success, 1 is returned.
+// O(1)
 int shrink_buddy(size_t new_size, struct buddy *state);
 
 // Used to move the global state of the buddy.
+// O(1)
 void move_buddy(struct buddy *new_state, struct buddy *old_state);