From: Connor Abbott <cwabbott0@gmail.com>
Date: Tue, 15 Feb 2022 11:29:56 +0000 (+0100)
Subject: util/blob: Clarify rules on blob::data
X-Git-Tag: upstream/22.3.5~12517
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=c21065c87a912aa317e05d27a3e914ffbf436c66;p=platform%2Fupstream%2Fmesa.git

util/blob: Clarify rules on blob::data

Reviewed-by: Jason Ekstrand <jason.ekstrand@collabora.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/15028>
---

diff --git a/src/util/blob.h b/src/util/blob.h
index e1e156e..051eaa0 100644
--- a/src/util/blob.h
+++ b/src/util/blob.h
@@ -47,7 +47,10 @@ extern "C" {
  */
 
 struct blob {
-   /* The data actually written to the blob. */
+   /* The data actually written to the blob. Never read or write this directly
+    * when serializing, use blob_reserve_* and blob_overwrite_* instead which
+    * check for out_of_memory and handle fixed-size blobs correctly.
+    */
    uint8_t *data;
 
    /** Number of bytes that have been allocated for \c data. */