From a338655f0bff30e57ddbe80bd3fc0abcceb5bfa9 Mon Sep 17 00:00:00 2001
From: Thierry FOURNIER <thierry.fournier@ozon.io>
Date: Sun, 10 Dec 2017 17:14:07 +0100
Subject: [PATCH 1/2] DOC: notifications: add precisions about thread usage

Precise the terms of use the notification functions.
---
 include/proto/task.h | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/include/proto/task.h b/include/proto/task.h
index 4291482..1422bf2 100644
--- a/include/proto/task.h
+++ b/include/proto/task.h
@@ -304,6 +304,9 @@ static inline struct notification *notification_new(struct list *purge, struct l
 /* This function purge all the pending signals when the LUA execution
  * is finished. This prevent than a coprocess try to wake a deleted
  * task. This function remove the memory associated to the signal.
+ * The purge list is not locked because it is owned by only one
+ * process. before browsing this list, the caller must ensure to be
+ * the only one browser.
  */
 static inline void notification_purge(struct list *purge)
 {
@@ -325,7 +328,9 @@ static inline void notification_purge(struct list *purge)
 
 /* This function sends signals. It wakes all the tasks attached
  * to a list head, and remove the signal, and free the used
- * memory.
+ * memory. The wake list is not locked because it is owned by
+ * only one process. before browsing this list, the caller must
+ * ensure to be the only one browser.
  */
 static inline void notification_wake(struct list *wake)
 {
-- 
2.9.5

