fix: relayd: unaligned access in trace_chunk_registry_ht_key_hash

[lttng-tools.git] / include / lttng / endpoint.h

diff --git a/include/lttng/endpoint.h b/include/lttng/endpoint.h
index fcd787018e54d1ea1adc94f7786d7c79b2440da7..e27ac3b015b8b039c451dff6411fef20a2829b17 100644 (file)
--- 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
 }