[PATCHv6,3/9] api: odp_buffer.h: undefined behavior description

Message ID 1423084051-12962-4-git-send-email-ola.liljedahl@linaro.org
State New
Headers show

Commit Message

Ola Liljedahl Feb. 4, 2015, 9:07 p.m.
Signed-off-by: Ola Liljedahl <ola.liljedahl@linaro.org>
---
(This document/code contribution attached is provided under the terms of
agreement LES-LTM-21309)

 include/odp/api/buffer.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

Patch

diff --git a/include/odp/api/buffer.h b/include/odp/api/buffer.h
index 09bddf2..e0e25b0 100644
--- a/include/odp/api/buffer.h
+++ b/include/odp/api/buffer.h
@@ -88,7 +88,9 @@  uint32_t odp_buffer_size(odp_buffer_t buf);
 /**
  * Tests if buffer is valid
  *
- * @param buf      Buffer handle
+ * @param buf      Buffer handle (possibly invalid)
+ * @note This is the only buffer API function which accepts invalid buffer
+ * handles (any bit value) without causing undefined behavior.
  *
  * @retval 1 Buffer handle represents a valid buffer.
  * @retval 0 Buffer handle does not represent a valid buffer.