]> git.seodisparate.com - UDPConnection/commitdiff
Note in documentation about thread safety
authorStephen Seo <seo.disparate@gmail.com>
Mon, 1 Jan 2024 03:25:04 +0000 (12:25 +0900)
committerStephen Seo <seo.disparate@gmail.com>
Mon, 1 Jan 2024 03:25:04 +0000 (12:25 +0900)
Basically, all functions should be thread-safe unless mentioned
otherwise.

src/UDPC.h

index 81c985ba85ed22ee1a085d2a26f0dfbb680268c7..fca1b6cad9e27a502b2f97830732d800e17dfec2 100644 (file)
@@ -6,6 +6,9 @@
 /*!
  * \file UDPC.h
  * \brief Public API for UDPConnection
+ *
+ * Note that all functions are thread-safe unless mentioned otherwise in the
+ * function's documentation.
  */
 
 #ifndef UDPC_CONNECTION_H
@@ -861,8 +864,6 @@ UDPC_EXPORT const char *UDPC_atostr(UDPC_HContext ctx, UDPC_IPV6_ADDR_TYPE addr)
  * \warning The returned pointer must be freed with free(), or
  * UDPC_atostr_unsafe_free(), or UDPC_atostr_unsafe_free_ptr().
  *
- * This function is thread-safe.
- *
  * UDPC internally uses UDPC_atostr() for logging. This means that while UDPC
  * is running, a string created with UDPC_atostr() may be overwritten
  * eventually by UDPC. To avoid this situation, UDPC_atostr_unsafe() or
@@ -879,8 +880,6 @@ UDPC_EXPORT const char *UDPC_atostr_unsafe(UDPC_IPV6_ADDR_TYPE addr);
  * \warning The returned pointer must be freed with free(), or
  * UDPC_atostr_unsafe_free(), or UDPC_atostr_unsafe_free_ptr().
  *
- * This function is thread-safe.
- *
  * UDPC internally uses UDPC_atostr() for logging. This means that while UDPC
  * is running, a string created with UDPC_atostr() may be overwritten
  * eventually by UDPC. To avoid this situation, UDPC_atostr_unsafe() or
@@ -891,8 +890,6 @@ UDPC_EXPORT const char *UDPC_atostr_unsafe_cid(UDPC_ConnectionId cid);
 
 /*!
  * \brief Free an addr string created with UDPC_atostr_unsafe().
- *
- * This function is thread-safe.
  */
 UDPC_EXPORT void UDPC_atostr_unsafe_free(const char *addrBuf);
 
@@ -900,8 +897,6 @@ UDPC_EXPORT void UDPC_atostr_unsafe_free(const char *addrBuf);
  * \brief Free an addr string created with UDPC_atostr_unsafe() and zeroes the
  * pointer.
  *
- * This function is thread-safe.
- *
  * \code{.c}
  * UDPC_ConnectionId aConnectionId = ...;
  * const char *addrString = UDPC_atostr_unsafe_cid(aConnectionId);