Permit custom consumer registration to a session

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

diff --git a/include/lttng/lttng.h b/include/lttng/lttng.h
index 3f96a24b695819560047dccf43831ade3fa46609..1bdb66c61e12dcbcccac846398b078d01f95cc28 100644 (file)
--- a/include/lttng/lttng.h
+++ b/include/lttng/lttng.h
@@ -293,6 +293,17 @@ extern int lttng_set_tracing_group(const char *name);
  */
 extern const char *lttng_get_readable_code(int code);
 
+/*
+ * This call permits to register an "outside consumer" to a session and a lttng
+ * domain. No consumer will be spawned and all fds/commands will go through the
+ * socket path given (socket_path).
+ *
+ * NOTE: At the moment, if you use the liblttkconsumerd, you can only use the
+ * command socket. The error socket is not supported yet for roaming consumers.
+ */
+extern int lttng_register_consumer(struct lttng_handle *handle,
+               const char *socket_path);
+
 /*
  * Start tracing for *all* registered trace (kernel and user-space).
  */