2 files changed, 13 insertions, 0 deletions

diff --git a/firmware/buflib.c b/firmware/buflib.c
index 27a6965ee0..8d5fe1eef3 100644
--- a/firmware/buflib.c
+++ b/firmware/buflib.c
@@ -55,6 +55,8 @@
  * to find the start of the character array (and therefore the start of the
  * entire block) when only the handle or payload start is known.
  *
+ * UPDATE BUFLIB_ALLOC_OVERHEAD (buflib.h) WHEN THIS COOKIE CHANGES!
+ *
  * Example:
  * |<- alloc block #1 ->|<- unalloc block ->|<- alloc block #2      ->|<-handle table->|
  * |L|H|C|cccc|L2|crc|XXXXXX|-L|YYYYYYYYYYYYYYYY|L|H|C|cc|L2|crc|XXXXXXXXXXXXX|AAA|
diff --git a/firmware/include/buflib.h b/firmware/include/buflib.h
index e912429b1f..1bae3e7a3f 100644
--- a/firmware/include/buflib.h
+++ b/firmware/include/buflib.h
@@ -54,6 +54,17 @@ struct buflib_context
 };
 
 /**
+ * This declares the minimal overhead that is required per alloc. These
+ * are bytes that are allocated from the context's pool in addition
+ * to the actually requested number of bytes.
+ *
+ * The total number of bytes consumed by an allocation is
+ * BUFLIB_ALLOC_OVERHEAD + requested bytes + strlen(<name passed to
+ * buflib_alloc_ex()) + pad to pointer size
+ */
+#define BUFLIB_ALLOC_OVERHEAD (6*sizeof(union buflib_data))
+
+/**
  * Callbacks used by the buflib to inform allocation that compaction
  * is happening (before data is moved)
  *