X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=include%2Flttng%2Fendpoint.h;h=e27ac3b015b8b039c451dff6411fef20a2829b17;hb=c91ccadee5bfbc94a95540e17c879ce976caf6a2;hp=fcd787018e54d1ea1adc94f7786d7c79b2440da7;hpb=ab5be9fa2eb5ba9600a82cd18fd3cfcbac69169a;p=lttng-tools.git

diff --git a/include/lttng/endpoint.h b/include/lttng/endpoint.h
index fcd787018..e27ac3b01 100644
--- a/include/lttng/endpoint.h
+++ b/include/lttng/endpoint.h
@@ -8,12 +8,39 @@
 #ifndef LTTNG_ENDPOINT_H
 #define LTTNG_ENDPOINT_H
 
+#include <lttng/lttng-export.h>
+
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-/* Default LTTng session daemon endpoint singleton. */
-extern struct lttng_endpoint *lttng_session_daemon_notification_endpoint;
+/*
+ * Default LTTng session daemon notification endpoint singleton.
+ *
+ * For use during the creation of a notification channel. This endpoint
+ * implements the following policy to connect to a session daemon's
+ * notification delivery channel:
+ *   - If the caller is root or part of the tracing group:
+ *     - Attempt to connect to the "root" (global) session daemon,
+ *     - Fallback to the session daemon running as the caller's user.
+ *   - Otherwise (caller is an unpriviliged user):
+ *     - Attempt to connect to the session daemon running as the caller's user.
+ */
+LTTNG_EXPORT extern struct lttng_endpoint *lttng_session_daemon_notification_endpoint;
+
+/*
+ * Default LTTng session daemon command endpoint singleton.
+ *
+ * For use as part of the invocation of a command. This endpoint
+ * implements the following policy to connect to a session daemon's
+ * command channel:
+ *   - If the caller is root or part of the tracing group:
+ *     - Attempt to connect to the "root" (global) session daemon,
+ *     - Fallback to the session daemon running as the caller's user.
+ *   - Otherwise (caller is an unpriviliged user):
+ *     - Attempt to connect to the session daemon running as the caller's user.
+ */
+LTTNG_EXPORT extern struct lttng_endpoint *lttng_session_daemon_command_endpoint;
 
 #ifdef __cplusplus
 }