From ffcad3a54839bd6704b4cac5dfe9f52a4f299dae Mon Sep 17 00:00:00 2001
From: Tapani Pälli <tapani.palli@intel.com>
Date: Wed, 12 Nov 2014 23:16:51 -0800
Subject: glsl: Add blob_overwrite_bytes and blob_overwrite_uint32

These functions are useful when serializing an unknown number of items
to a blob. The caller can first save the current offset, write a
placeholder uint32, write out (and count) the items, then use
blob_overwrite_uint32 with the saved offset to replace the placeholder
value.

Then, when deserializing, the reader will first read the count and
know how many subsequent items to expect.

(I wrote this code after reading a very similar patch written by
Tapani when he wrote serialization code for IR. Since I re-used the
idea of his code so directly, I've credited him as the author of this
code. --Carl)

Reviewed-by: Jason Ekstrand <jason.ekstrand@intel.com>
---
 src/glsl/blob.c | 23 +++++++++++++++++++++++
 src/glsl/blob.h | 43 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 66 insertions(+)

diff --git a/src/glsl/blob.c b/src/glsl/blob.c
index a4003cf717..dd4341be96 100644
--- a/src/glsl/blob.c
+++ b/src/glsl/blob.c
@@ -100,6 +100,21 @@ blob_create(void *mem_ctx)
    return blob;
 }
 
+bool
+blob_overwrite_bytes(struct blob *blob,
+                     size_t offset,
+                     const void *bytes,
+                     size_t to_write)
+{
+   /* Detect an attempt to overwrite data out of bounds. */
+   if (offset < 0 || blob->size - offset < to_write)
+      return false;
+
+   memcpy(blob->data + offset, bytes, to_write);
+
+   return true;
+}
+
 bool
 blob_write_bytes(struct blob *blob, const void *bytes, size_t to_write)
 {
@@ -134,6 +149,14 @@ blob_write_uint32(struct blob *blob, uint32_t value)
    return blob_write_bytes(blob, &value, sizeof(value));
 }
 
+bool
+blob_overwrite_uint32 (struct blob *blob,
+                       size_t offset,
+                       uint32_t value)
+{
+   return blob_overwrite_bytes(blob, offset, &value, sizeof(value));
+}
+
 bool
 blob_write_uint64(struct blob *blob, uint64_t value)
 {
diff --git a/src/glsl/blob.h b/src/glsl/blob.h
index af32d22e49..ec903ec140 100644
--- a/src/glsl/blob.h
+++ b/src/glsl/blob.h
@@ -107,6 +107,24 @@ blob_write_bytes (struct blob *blob, const void *bytes, size_t to_write);
 uint8_t *
 blob_reserve_bytes (struct blob *blob, size_t to_write);
 
+/**
+ * Overwrite some data previously written to the blob.
+ *
+ * Writes data to an existing portion of the blob at an offset of \offset.
+ * This data range must have previously been written to the blob by one of the
+ * blob_write_* calls.
+ *
+ * For example usage, see blob_overwrite_uint32
+ *
+ * \return True unless the requested offset or offset+to_write lie outside
+ * the current blob's size.
+ */
+bool
+blob_overwrite_bytes (struct blob *blob,
+                      size_t offset,
+                      const void *bytes,
+                      size_t to_write);
+
 /**
  * Add a uint32_t to a blob.
  *
@@ -120,6 +138,31 @@ blob_reserve_bytes (struct blob *blob, size_t to_write);
 bool
 blob_write_uint32 (struct blob *blob, uint32_t value);
 
+/**
+ * Overwrite a uint32_t previously written to the blob.
+ *
+ * Writes a uint32_t value to an existing portion of the blob at an offset of
+ * \offset.  This data range must have previously been written to the blob by
+ * one of the blob_write_* calls.
+ *
+ *
+ * The expected usage is something like the following pattern:
+ *
+ *	size_t offset;
+ *
+ *	offset = blob->size;
+ *	blob_write_uint32 (blob, 0); // placeholder
+ *	... various blob write calls, writing N items ...
+ *	blob_overwrite_uint32 (blob, offset, N);
+ *
+ * \return True unless the requested position or position+to_write lie outside
+ * the current blob's size.
+ */
+bool
+blob_overwrite_uint32 (struct blob *blob,
+                       size_t offset,
+                       uint32_t value);
+
 /**
  * Add a uint64_t to a blob.
  *
-- 
cgit v1.2.3