X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=include%2Flttng%2Faction%2Fnotify.h;h=04f468561dd57a18ef686fefa123d72c88521f0b;hp=6c0d0ca257aee4ddab8ec61a870833beb1cbe877;hb=a109f1c6acc90b8ca847ebe2d68b67601e250541;hpb=e6de708a1e089f7f87be625bd703ff7309939739

diff --git a/include/lttng/action/notify.h b/include/lttng/action/notify.h
index 6c0d0ca25..04f468561 100644
--- a/include/lttng/action/notify.h
+++ b/include/lttng/action/notify.h
@@ -24,6 +24,17 @@ struct lttng_action;
 extern "C" {
 #endif
 
+/*
+ * Create a newly allocated notification action object.
+ *
+ * A "notify" action will emit a notification to all clients which have an
+ * open notification channel. In order to receive this notification, clients
+ * must have subscribed to a condition equivalent to the one paired to this
+ * notify action in a trigger.
+ *
+ * Returns a new action on success, NULL on failure. This action must be
+ * destroyed using lttng_action_destroy().
+ */
 extern struct lttng_action *lttng_action_notify_create(void);
 
 #ifdef __cplusplus